1.3.5 • Published 6 years ago
infinite-scroll-loading v1.3.5
Infinite-Scroll
Apply infinite scroll to your website or web-app.
How to start
npm install infinite-scroll-loading --save
- import the normal or minified version from the dist directory.
How to use
InfiniteScroll(config)
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 |
Docs
- 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
moreButton
is 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.
Methods
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()
Tricks
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.
License
This project is licensed under the MIT License.