The List component, which inspired by Android RecyclerView, is a core component, and it provides the most popular features for using a list of items. which support vertical and horizontal list.
It can provide excellent experience and performance while still maintaining smooth scroll and low memory usage.
Notes: The list now supports the following child components: cell, header, refresh, loading and fixed-position components. Other kinds of components will not be guaranteed to be displayed correctly.
show-scrollbar
: true/false whether show the scroll bar or not, default value is trueloadmoreoffset
: Number
default value is 0. The loadmore event will be triggered when the list is loadmoreoffset left to reach the bottom of the list view. e.g. a list has total content length of 1000, and the loadmoreoffset is set to 400, the loadmore event will be triggered when 600 has beed scrolled and there is less than 400 left.loadmoreretry
: Number
default value 0,whether to reset loadmore related UI when loadmore failed, will be deprecated in further release.offset-accuracy
:Number
default value is 0, the vertical offset distance required to trigger the scroll event.pagingEnabled
: Boolean
default value is false. supporting pager style snapping in vertical orientation. support version: . Example : pagingEnabledBoolean
default value is true. set whether list is scrollable.Please checkout Scroller Component Attributes to have a look at the inherited attributes from direct parent.
common styles: check out common styles for components
onloadmore 0.5 used with loadmoreoffset attribute. if the view has less than loadmoreoffset to scroll down, the onloadmore event will be triggered.
scroll 0.12+ used with offset-accuracy attribute. This event is fired when the list scrolls. The current contentOffset value is given in this event callback. See details in scroll event demo.
common events: check out the common events
All cells or cell's subcomponents in list support the scrollToElement API in dom module
loading is a child component that can response to the onloading event, and this event can only be triggered when the scroller/list has been scrolled down to the bottom. onloadmore is an event that will be triggered when the rest of the scroller/list is less than loadmoreoffset long.
Nested lists or scrollers within the same direction are not supported. In other words. nested lists/scroller must have different directions. For example, a vertical list nested in a vertical list or scroller is not allowed. However, a vertical list nested in a horizontal list or scroller is legal.