Apply infinite scroll to your website or web-app.
npm install infinite-scroll-loading --save- import the normal or minified version from the dist directory.
InfiniteScroll(config)
| Key | Type | DefaultValue | DataAttribute | Required |
|---|---|---|---|---|
| container | DOMElement | document.body |
null | false |
| scrollTarget | DOMElement | this.container |
null | false |
| url | String | null | data-url | true |
| request | Object | {data : "", method : "GET"} |
null | false |
| request.data | Object or Function | "" | null | false |
| request.method | String | "GET" | data-method | false |
| loading | DOMString or DOMElement | "<div class="infinite-scroll__loading"> Loading... </div>" |
null | false |
| moreButton | DOMElement | null | null | false |
| margin | Number | 500 | data-margin | false |
| onLoad | Function | null | null | false |
| onRender | Function | null | null | false |
- container: The target element that the infinite scroll should be applied to.
- scrollTarget: The element on which the scroll listener must be added to. If it is not specified the element will be the container.
- url: The url that the request must be sent to.
- request.data: The data to be sent via the request. It must be a single-level key-value Object or a Function returning an Object.
- request.method: The method of the request. By default it is
GET. - loading: The loading element. The loading element must have the class
infinite-scroll__loading. - moreButton: The button that loads the next set of data. If
moreButtonis specified, the scroll listener will be disabled. - margin: The scroll margin on which the request of the next set of data must be sent. The value is in pixels from the bottom of the scrollTop.
- onLoad: A callback function to be called after the next set of data is acquired. It has the response as its parameter and the context of the function is the container element. By default if the onLoad method is not specified, it gets the response and appends it to the container.
- onRender: A callback function to be called after the next set of data is rendered.
- allDataLoaded: A method to say that all the data is loaded and no requests must be sent anymore.
Usage:
infiniteScrollInstance.allDataLoaded(true) //to specify that all the data is loaded
infiniteScrollInstance.allDataLoaded(false) //to specify that all the data is not loaded
- unbind: A method to unbind the infinite scroll from the container.
Usage:
infiniteScrollInstance.unbind()
If you want to let the infinite scroll know that there are no more items to load and prevent it from sending requests again, you can set x-last-page header on your response from the server or return an empty string as the response.
This project is licensed under the MIT License.