Skip to content

Commit 337acd1

Browse files
author
Denis Hilt
committed
Compatibility doc
1 parent 2517ffb commit 337acd1

File tree

1 file changed

+16
-4
lines changed

1 file changed

+16
-4
lines changed

README.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ Unlimited bidirectional virtual scrolling over limited viewport. A directive for
1414
- [Usage](#usage)
1515
- [Settings](#settings)
1616
- [Adapter API](#adapter-api)
17+
- [Compatibility](#compatibility)
1718
- [Development](#development)
1819

1920
<br>
@@ -22,7 +23,7 @@ Unlimited bidirectional virtual scrolling over limited viewport. A directive for
2223

2324
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.
2425

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.
2627
<p align="center">
2728
<img src="https://raw.githubusercontent.com/dhilt/ngx-ui-scroll/master/demo/assets/ngx-ui-scroll-demo.gif">
2829
</p>
@@ -177,7 +178,7 @@ Below is the list of read-only properties of the Adapter API with descriptions a
177178

178179
|Name|Type|Description|
179180
|:--|:----|:----------|
180-
|[packageInfo](https://dhilt.github.io/ngx-ui-scroll/#adapter#package-info)|IPackages {<br>&nbsp;&nbsp;core: IPackage;<br>&nbsp;&nbsp;consumer: IPackage;<br>}<br><br>IPackage {<br>&nbsp;&nbsp;name: string;<br>&nbsp;&nbsp;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>&nbsp;&nbsp;consumer: IPackage;<br>&nbsp;&nbsp;core: IPackage;<br>}<br><br>IPackage {<br>&nbsp;&nbsp;name: string;<br>&nbsp;&nbsp;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).|
181182
|[init](https://dhilt.github.io/ngx-ui-scroll/#adapter#init)|boolean|Indicates whether the Scroller is initialized ot not. |
182183
|[init$](https://dhilt.github.io/ngx-ui-scroll/#adapter#init)|Subject&lt;boolean&gt;|An Observable version of "init" property. |
183184
|[isLoading](https://dhilt.github.io/ngx-ui-scroll/#adapter#is-loading)|boolean|Indicates whether the Scroller is working ot not. |
@@ -224,6 +225,17 @@ console.log('Two-phase replacement done');
224225

225226
For more information, see [Adapter demo page](https://dhilt.github.io/ngx-ui-scroll/#adapter).
226227

228+
229+
<a name="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+
227239
### Development
228240

229241
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
261273

262274
|Name|Value|Description|
263275
|:--|:----|:----------|
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.|
265277
|TEST_BROWSER|default&nbsp;&#124; chrome&nbsp;&#124; firefox|Platform for running tests. By default a headless chrome is used; "chrome" or "firefox" are for running tests in real (chrome/ff) browser |
266278
|TEST_SERVER_PORT|9876|Port that will be used by non-default testing browser |
267279

268280
Any support and participation are welcome, so feel free to <a href="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).
269281

270282
__________
271283

272-
2021 &copy; dhilt, [Hill30 Inc](http://www.hill30.com/)
284+
2022 &copy; dhilt, [Hill30 Inc](http://www.hill30.com/)

0 commit comments

Comments
 (0)