0.0.4 • Published 2 years ago
@loadingio/ldpage v0.0.4
ldpage
Pagination library.
Usage
mypal = new ldpage do
fetch: ->
ld$.fetch '...' , {}, {type: \json}
.then -> return it
you can process fetched data directly in the fetch function:
mypal = new ldpage do
fetch: ->
ld$.fetch '...' , {}, {type: \json}
.then ->
render(it)
return it
see src/sample.ls.
Configuration
- host - scrolling host. for entire document, use
window
. - fetch-on-scroll - should ldpage fetch data when scrolling to the bottom of the host. default false.
- fetch - custom function to fetch data according to ldpage's status.
- use this.limit and this.offset to control the current position of fetch progress.
- should return the list fetched for ldpage to count progress.
- fetch-delay - delay before fetching when fetch is called.
- enabled - default true. set to false to disable fetching by default until explicitly enabled with toggle(v),
- boundary - default 0. if fetch-on-scroll, fetch is triggered only if remaining space for scrolling is smaller than
boundary
. largerboundary
makes fetch triggered earlier.
Method
- reset(opt) - reset page. opt:
- data - data for use in this bunch of fetch.
- init(opt) - reset page. deprecated. ( use reset instead )
- fetch - fetch data again.
- isEnd - is there anything to fetch.
- setHost(node) - set scrolling host. for entire document, use
window
. - toggle(v) - flip enabled/disabled statue. force set to v if v(true or false) is provided.
Events
- empty - fired when ldpage confirms that the list is empty.
- finish - fired when ldpage confirms that all items are fetched.
- fetch - fired when ldpage fetch a new list of data
- scroll.fetch - fired when ldpage fetch a new list of data triggered by scrolling. can happen along with
fetch
event. - fetching - fired before fetch is called.
License
MIT.