infiniteScroll - Infinite Scroll

Enables an "infinite scrolling" experience in a data view for mobile users.

Category

format

Syntax

infiniteScroll="enable|disable|auto"

Usage

This property improves the Dataview control by enabling an "infinite scrolling" experience for mobile users. With "infinite scrolling," as the user touch scrolls through mobile content, additional content is automatically loaded in. Content is fetched beforehand from a subsequent page and is added directly to the current page that is being viewed in the mobile application.

In Design mode, click All Properties and look for infiniteScroll under data or you can set the property in the page source code.

The supported values for this property are enable, disable, and auto where:

  • enable - Overrrides the application setting to activate the infinite scrolling wrapper in the dataview
  • disable - Overrides the application setting to disable the infinite scrolling wrapper in the dataview
  • auto - Default setting. Uses the application setting xsp.progressive.enhancement=[enable|disable]

This property has been implemented only for mobile views. If you use this property in a normal web page dataView, you will get an exception with the message:

Unexpected runtime error: infiniteScroll property has limited support for this control on this version. Please check documentation.

Notes on pre-existing pagination elements

This property activates the scrollablePane to implement the infinite scrolling feature. This provides an alternative, more modern, and user friendly form of pagination. As such, old pagination elements should be removed from the page.

If this property is enabled on a dataview, but the More button is not removed from the page, it will be shown as part of the page. It will continue to work as expected but will scroll with the data.