ListView.loadingBehavior property

Gets or sets a value that specifies how the ListView fetches items and adds and removes them to the Document Object Model (DOM). Don't change the value of this property after the ListView has begun loading data.


    data-win-options="{ loadingBehavior : 'value'}" >
var loadingBehavior = listView.loadingBehavior;
listView.loadingBehavior = loadingBehavior;

Property value

Type: String

One of the following values:

Value Condition

The ListView calculates the amount of items to show based on the number of items that can be displayed and the total amount of items. The ListView loads enough items to display the current page as well as the next page and the preceding page. This is the default value.


The ListView loads as many pages of items as specified by the pagesToLoad property. When automaticallyLoadPages is true, the items are loaded when the user is within the threshold scrolling amount (specified by pagesToLoadThreshold) of the end of the loaded portion of the list. When automaticallyLoadPages is false, you can manually load pages by calling the loadMorePages method. Note that, when using this mode, the ensureVisible method won't work for items that haven't loaded yet.

The ListView does not support grouped lists when the loadingBehavior is "incremental".


Minimum WinJS version

WinJS 3.0



See also