You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-4Lines changed: 16 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,6 +14,7 @@ Unlimited bidirectional virtual scrolling over limited viewport. A directive for
14
14
-[Usage](#usage)
15
15
-[Settings](#settings)
16
16
-[Adapter API](#adapter-api)
17
+
-[Compatibility](#compatibility)
17
18
-[Development](#development)
18
19
19
20
<br>
@@ -22,7 +23,7 @@ Unlimited bidirectional virtual scrolling over limited viewport. A directive for
22
23
23
24
Scrolling large datasets may cause performance issues. Many DOM elements, many data-bindings, many event listeners... The common way to improve the performance is to render only a small portion of the dataset visible to a user. Other dataset elements that are not visible to a user are virtualized with upward and downward empty padding elements which should provide a consistent viewport with consistent scrollbar parameters.
24
25
25
-
The \*uiScroll is a structural directive that works like \*ngFor and renders a templated element once per item from a collection. By requesting the external Datasource (the implementation of which is a developer responsibility) the \*uiScroll directive fetches necessary portion of the dataset and renders corresponded elements until the visible part of the viewport is filled out. It starts to retrieve new data to render new elements again if a user scrolls to the edge of visible element list. It dynamically destroys elements as they become invisible and recreates them if they become visible again.
26
+
The ngx-ui-scroll library provides the \*uiScroll structural directive that works like \*ngFor and renders a templated element once per item from a collection. By requesting the external Datasource (the implementation of which is a developer responsibility) the \*uiScroll directive fetches necessary portion of the dataset and renders corresponded elements until the visible part of the viewport is filled out. It starts to retrieve new data to render new elements again if a user scrolls to the edge of visible element list. It dynamically destroys elements as they become invisible and recreates them if they become visible again.
@@ -177,7 +178,7 @@ Below is the list of read-only properties of the Adapter API with descriptions a
177
178
178
179
|Name|Type|Description|
179
180
|:--|:----|:----------|
180
-
|[packageInfo](https://dhilt.github.io/ngx-ui-scroll/#adapter#package-info)|IPackages {<br> core: IPackage;<br> consumer: IPackage;<br>}<br><br>IPackage {<br> name: string;<br> version: string<br>}|Information about versions of the library ant its core. For example: "ngx-ui-scroll" v2.0.0 (consumer), "vscroll" v1.0.0 (core).|
181
+
|[packageInfo](https://dhilt.github.io/ngx-ui-scroll/#adapter#package-info)|IPackages {<br> consumer: IPackage;<br> core: IPackage;<br>}<br><br>IPackage {<br> name: string;<br> version: string<br>}|Information about versions of the library ant its core. For example: "ngx-ui-scroll" v3.1.0 (consumer), "vscroll" v1.4.3 (core).|
181
182
|[init](https://dhilt.github.io/ngx-ui-scroll/#adapter#init)|boolean|Indicates whether the Scroller is initialized ot not. |
182
183
|[init$](https://dhilt.github.io/ngx-ui-scroll/#adapter#init)|Subject<boolean>|An Observable version of "init" property. |
183
184
|[isLoading](https://dhilt.github.io/ngx-ui-scroll/#adapter#is-loading)|boolean|Indicates whether the Scroller is working ot not. |
For more information, see [Adapter demo page](https://dhilt.github.io/ngx-ui-scroll/#adapter).
226
227
228
+
229
+
<aname="compatibility"id="compatibility"></a>
230
+
### Compatibility
231
+
232
+
|ngx-ui-scroll|Angular|compiled|support|notes|
233
+
|:--|:--|:--|:--|:--|
234
+
|1|5-12|View Engine|no|no dependencies|
235
+
|2|5-12|View Engine|maintenance|vscroll is bundle-dependency|
236
+
|3|12+|Ivy|active|vscroll is peer-dependency|
237
+
238
+
227
239
### Development
228
240
229
241
There are some npm scripts available from package.json:
@@ -261,12 +273,12 @@ Also, there are some environment variables for additional customization of the d
261
273
262
274
|Name|Value|Description|
263
275
|:--|:----|:----------|
264
-
|DEV_SERVER_PORT|4200|Port the dev server (webpack) will use|
276
+
|DEV_SERVER_PORT|4200|Port the dev server (webpack) will use. Need to run `npm run start:env` instead of `npm run` to make this setting work.|
265
277
|TEST_BROWSER|default | chrome | firefox|Platform for running tests. By default a headless chrome is used; "chrome" or "firefox" are for running tests in real (chrome/ff) browser |
266
278
|TEST_SERVER_PORT|9876|Port that will be used by non-default testing browser |
267
279
268
280
Any support and participation are welcome, so feel free to <ahref="https://github.com/dhilt/ngx-ui-scroll?sponsor=1">donate</a>, submit new [Issues](https://github.com/dhilt/ngx-ui-scroll/issues) and open [Pull Requests](https://github.com/dhilt/ngx-ui-scroll/pulls).
0 commit comments