ListBase SAP SE The <code>sap.m.ListBase</code> control provides a base functionality of the <code>sap.m.List</code> and <code>sap.m.Table</code> controls. Selection, deletion, unread states and inset style are also maintained in <code>sap.m.ListBase</code>. See section "{@link topic:295e44b2d0144318bcb7bdd56bfa5189 List, List Item, and Table}" in the documentation for an introduction to subclasses of <code>sap.m.ListBase</code> control. <b>Note:</b> The ListBase including all contained items may be completely re-rendered when the data of a bound model is changed. Due to the limited hardware resources of mobile devices this can lead to longer delays for lists that contain many items. As such the usage of a list is not recommended for these use cases. 1.16 sap.ui.core/Control Defines the indentation of the container. Setting it to <code>true</code> indents the list. Defines the header text that appears in the control. <b>Note:</b> If <code>headerToolbar</code> aggregation is set, then this property is ignored. Defines the header style of the control. Possible values are <code>Standard</code> and <code>Plain</code>. No longer has any functionality. Defines the footer text that appears in the control. Defines the mode of the control (e.g. <code>None</code>, <code>SingleSelect</code>, <code>MultiSelect</code>, <code>Delete</code>). Sets the width of the control. Defines whether the items are selectable by clicking on the item itself (<code>true</code>) rather than having to set the selection control first. <b>Note:</b> The <code>SingleSelectMaster</code> mode also provides this functionality by default. Activates the unread indicator for all items, if set to <code>true</code>. This text is displayed when the control contains no items. Defines whether or not the text specified in the <code>noDataText</code> property is displayed. When this property is set to <code>true</code>, the control will automatically display a busy indicator when it detects that data is being loaded. This busy indicator blocks the interaction with the items until data loading is finished. By default, the busy indicator will be shown after one second. This behavior can be customized by setting the <code>busyIndicatorDelay</code> property. Defines if animations will be shown while switching between modes. Defines which item separator style will be used. Defines the direction of the swipe movement (e.g LeftToRight, RightToLeft, Both) to display the control defined in the <code>swipeContent</code> aggregation. If set to <code>true</code>, enables the growing feature of the control to load more items by requesting from the model. <b>Note:</b>: This feature only works when an <code>items</code> aggregation is bound. Growing must not be used together with two-way binding. Defines the number of items to be requested from the model for each grow. This property can only be used if the <code>growing</code> property is set to <code>true</code>. Defines the text displayed on the growing button. The default is a translated text ("More") coming from the message bundle. This property can only be used if the <code>growing</code> property is set to <code>true</code>. If set to true, the user can scroll down/up to load more items. Otherwise a growing button is displayed at the bottom/top of the control. <b>Note:</b> This property can only be used if the <code>growing</code> property is set to <code>true</code> and only if there is one instance of <code>sap.m.List</code> or <code>sap.m.Table</code> inside the scrollable scroll container (e.g <code>sap.m.Page</code>). Defines the direction of the growing feature. If set to <code>Downwards</code> the user has to scroll down to load more items or the growing button is displayed at the bottom. If set to <code>Upwards</code> the user has to scroll up to load more items or the growing button is displayed at the top. If set to true, this control remembers and retains the selection of the items after a binding update has been performed (e.g. sorting, filtering). <b>Note:</b> This feature works only if two-way data binding for the <code>selected</code> property of the item is not used. It also needs to be turned off if the binding context of the item does not always point to the same entry in the model, for example, if the order of the data in the <code>JSONModel</code> is changed. Defines keyboard handling behavior of the control. Defines the section of the control that remains fixed at the top of the page during vertical scrolling as long as the control is in the viewport. <b>Note:</b> Enabling sticky column headers in List controls will not have any effect. There is limited browser support. Browsers that do not support this feature are listed below: <ul> <li>IE</li> <li>Edge lower than version 41 (EdgeHTML 16)</li> <li>Firefox lower than version 59</li> </ul> There are also some known limitations. A few are given below: <ul> <li>If the control is placed in layout containers that have the <code>overflow: hidden</code> or <code>overflow: auto</code> style definition, this can prevent the sticky elements of the control from becoming fixed at the top of the viewport.</li> <li>If sticky column headers are enabled in the <code>sap.m.Table</code> control, setting focus on the column headers will let the table scroll to the top.</li> <li>A transparent toolbar design is not supported for sticky bars. The toolbar will automatically get an intransparent background color.</li> <li>This feature supports only the default height of the toolbar control.<li> </ul> Fires when selection is changed via user interaction. In <code>MultiSelect</code> mode, this event is also fired on deselection. Use the <code>selectionChange</code> event instead. The item which fired the select event. Fires when selection is changed via user interaction inside the control. The item whose selection has changed. In <code>MultiSelect</code> mode, only the up-most selected item is returned. This parameter can be used for single-selection modes. Array of items whose selection has changed. This parameter can be used for <code>MultiSelect</code> mode. Indicates whether the <code>listItem</code> parameter is selected or not. Indicates whether the select all action is triggered or not. Fires when delete icon is pressed by user. The item which fired the delete event. Fires after user's swipe action and before the <code>swipeContent</code> is shown. On the <code>swipe</code> event handler, <code>swipeContent</code> can be changed according to the swiped item. Calling the <code>preventDefault</code> method of the event cancels the swipe action. The item which fired the swipe. Aggregated <code>swipeContent</code> control that is shown on the right hand side of the item. Holds which control caused the swipe event within the item. Shows in which direction the user swipes and can have the value <code>BeginToEnd</code> (left to right in LTR languages and right to left in RTL languages) or <code>EndToBegin</code> (right to left in LTR languages and left to right in RTL languages) Fires before the new growing chunk is requested from the model. Instead, use <code>updateStarted</code> event with listening <code>changeReason</code>. Actual number of items. Total number of items. Fires after the new growing chunk has been fetched from the model and processed by the control. Instead, use "updateFinished" event. Actual number of items. Total number of items. Fires before <code>items</code> binding is updated (e.g. sorting, filtering) <b>Note:</b> Event handler should not invalidate the control. The reason of the update, e.g. Binding, Filter, Sort, Growing, Change, Refresh, Context. Actual number of items. The total count of bound items. This can be used if the <code>growing</code> property is set to <code>true</code>. Fires after <code>items</code> binding is updated and processed by the control. The reason of the update, e.g. Binding, Filter, Sort, Growing, Change, Refresh, Context. Actual number of items. The total count of bound items. This can be used if the <code>growing</code> property is set to <code>true</code>. Fires when an item is pressed unless the item's <code>type</code> property is <code>Inactive</code>. The item which fired the pressed event. The control which caused the press event within the container. Fired when the context menu is opened. When the context menu is opened, the binding context of the item is set to the given <code>contextMenu</code>. Item in which the context menu was opened. Defines the items contained within this control. User can swipe to bring in this control on the right hand side of an item. <b>Note:</b> For non-touch devices, this functionality is ignored. The header area can be used as a toolbar to add extra controls for user interactions. <b>Note:</b> When set, this overwrites the <code>headerText</code> property. A toolbar that is placed below the header to show extra information to the user. Defines the context menu of the items. Defines the message strip to display binding-related messages. Association to controls / ids which label this control (see WAI-ARIA attribute aria-labelledby). Returns selected list item. When no item is selected, "null" is returned. When "multi-selection" is enabled and multiple items are selected, only the up-most selected item is returned. Selects or deselects the given list item. The list item whose selection to be changed. This parameter is mandatory. Sets selected status of the list item. Default value is true. Returns an array containing the selected list items. If no items are selected, an empty array is returned. Sets a list item to be selected by id. In single mode the method removes the previous selection. The id of the list item whose selection to be changed. Sets selected status of the list item. Default value is true. Returns the binding contexts of the selected items. Note: This method returns an empty array if no databinding is used. Set true to include even invisible selected items(e.g. the selections from the previous filters). Removes visible selections of the current selection mode. Since version 1.16.3. This control keeps old selections after filter or sorting. Set this parameter "true" to remove all selections. Select all items in "MultiSelection" mode. Returns growing information as object with "actual" and "total" keys. Note: This function returns "null" if "growing" feature is disabled. After swipeContent is shown, user can interact with this control(e.g Tap). After interaction is done, you can/should use this method to hide swipeContent from screen. Note: If users try to tap inside of the list but outside of the swipeContent then control hides automatically. This callback function is called with two parameters(swipedListItem and swipedContent) after swipe-out animation is finished. Returns swiped list item. When no item is swiped, "null" is returned.