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
+19-15Lines changed: 19 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ This becomes a real problem if the html representing a row has event handlers an
8
8
complexity can easily introduce 20 watchers per row. Which for a list of 100 rows gives you total of 2000 watchers and a sluggish app.
9
9
10
10
uiScroll directive
11
-
-------------------
11
+
-------------------
12
12
13
13
[](https://travis-ci.org/angular-ui/ui-scroll)[](http://badge.fury.io/js/angular-ui-scroll)[](http://badge.fury.io/bo/angular-ui-scroll)[](https://gitter.im/angular-ui/ui-scroll?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
14
14
@@ -119,8 +119,8 @@ exactly `count` elements unless it hit eof/bof
119
119
120
120
#### Description
121
121
As the scroller recieves the items requested by the `get` method, the value of minimum and maximum values of the item index are placed in the `minIndex` and `maxIndex` properties respectively. The values of the properties are cumulative - the value of the `minIndex` will never increase, and the value of the `maxIndex` will never decrease - except the values are reset in response to a call to the adapter `reload` method. The values of the properties are used to maintain the appearance of the scroller scrollBar.
122
-
123
-
Values of the properties can be assigned programmatically. If the range of the index values is known in advance, assigneing them programmatically would improve the usability of the scrollBar.
122
+
123
+
Values of the properties can be assigned programmatically. If the range of the index values is known in advance, assigneing them programmatically would improve the usability of the scrollBar.
124
124
125
125
###Adapter
126
126
The adapter object is an internal object created for every instance of the scroller. Properties and methods of the adapter can be used to manipulate and assess the scroller the adapter was created for. Adapter based API replaces old (undocumented) event based API introduced earlier for this purpose. The event based API is now deprecated and no longer supported.
@@ -149,7 +149,7 @@ Adapater object implements the following methods
149
149
#### Description
150
150
returns `true` if the last item of the dataset is already in the buffer. No further requests for tailing items will be issued, returns `false` otherwise,
151
151
152
-
* Method `reload`
152
+
* Method `reload`
153
153
154
154
reload()
155
155
or
@@ -158,10 +158,10 @@ Adapater object implements the following methods
158
158
159
159
#### Description
160
160
Calling this method reinitializes and reloads the scroller content. `startIndex` is an integer indicating what item index the scroller will use to start the load process. The value of the argument replaces the value provided with the start-index attribute. Calling `reload()` is equivalent to calling `reload` method with current value of the `start-index` attribute .
161
-
162
-
**important: `startIndex` should fall within underlying datset boundaries** The scroller will request two batches of items one starting from the `startIndex` and another one preceding the first one (starting from `startIndex - bufferSize`). If both requests come back empty, the scroller will consider the dataset to be empty and will place no further data requests.
163
-
164
-
* Method `applyUpdates`
161
+
162
+
**important: `startIndex` should fall within underlying datset boundaries** The scroller will request two batches of items one starting from the `startIndex` and another one preceding the first one (starting from `startIndex - bufferSize`). If both requests come back empty, the scroller will consider the dataset to be empty and will place no further data requests.
163
+
164
+
* Method `applyUpdates`
165
165
166
166
applyUpdates(index, newItems)
167
167
#### Description
@@ -181,18 +181,18 @@ Adapater object implements the following methods
181
181
182
182
append(newItems)
183
183
#### Description
184
-
Adds new items after the last item in the buffer.
184
+
Adds new items after the last item in the buffer.
185
185
#### Parameters
186
186
* **newItems** provides an array of items to be appended.
187
187
188
188
* Method `prepend`
189
-
189
+
190
190
prepend(newItems)
191
191
#### Description
192
192
Adds new items before the first item in the buffer.
193
193
#### Parameters
194
194
* **newItems** provides an array of items to be prepended.
195
-
195
+
196
196
####Manipulating the scroller content with adapter methods
197
197
198
198
Adapter methods `applyUpdates`, `append` and `prepend` provide a way to update the scroller content without full reload of the content from the datasource. The updates are performed by changing the items in the scroller internal buffer after they are loaded from the datasource. Items in the buffer can be deleted or replaced with one or more items.
@@ -225,7 +225,7 @@ uiScrollTh and uiScrollTd directives
225
225
-------------------
226
226
###Description
227
227
228
-
The uiScrollTh and uiScrollTd directives provide a way to build flexible dynamic grids. Handling of grid rows is done by the uiScroll directive itself. In addition to this uiScrollTh and uiScrollTd directive provide tools to programmatically change grid layout, inclduing applying styles to columns, changing column size and order, as well as saving the modifications to the layout and applying previosly saved layouts.
228
+
The uiScrollTh and uiScrollTd directives provide a way to build flexible dynamic grids. Handling of grid rows is done by the uiScroll directive itself. In addition to this uiScrollTh and uiScrollTd directive provide tools to programmatically change grid layout, inclduing applying styles to columns, changing column size and order, as well as saving the modifications to the layout and applying previosly saved layouts.
229
229
At this point the above functionality is supported only for table based scrollable grids.
230
230
231
231
###Usage
@@ -252,11 +252,11 @@ Here is the basic html template for scrollable grid using the uiScrollTh and uiS
252
252
253
253
### Dependencies
254
254
255
-
The grid directives have the same dependency requirements as the uiScroll directive itself. To use the directives make sure the `ui.scroll.grid` module is on the list of the module dependencies. Also you have to load the dist/ui-scroll-grid.js file in your page.
255
+
The grid directives have the same dependency requirements as the uiScroll directive itself. To use the directives make sure the `ui.scroll.grid` module is on the list of the module dependencies. Also you have to load the dist/ui-scroll-grid.js file in your page.
256
256
257
257
### Controlling scrollable grid with the GridAdapter
258
258
259
-
GridAdapter object (along with ColumnAdapter objects) provides methods and properties to be used to change the scrollable grid layout. A reference to this object is injected as a property named `gridAdapter`in the scroller adapter.
259
+
GridAdapter object (along with ColumnAdapter objects) provides methods and properties to be used to change the scrollable grid layout. A reference to this object is injected as a property named `gridAdapter`in the scroller adapter.
260
260
261
261
`GridAdapter` object implements the following properties:
262
262
@@ -276,7 +276,7 @@ GridAdapter object (along with ColumnAdapter objects) provides methods and prope
276
276
277
277
###Examples
278
278
279
-
Examples ([look here for sources](https://github.com/angular-ui/ui-scroll/tree/master/demo/examples)) consist of several pages (.html files) showing various ways to use the ui-scroll directive. Each page relays on its own datasource service (called `datasource`) defined in the javascript file with the same name and .js extension.
279
+
Examples ([look here for sources](https://github.com/angular-ui/ui-scroll/tree/master/demo)) consist of several pages (.html files) showing various ways to use the ui-scroll directive. Each page relays on its own datasource service (called `datasource`) defined in the javascript file with the same name and .js extension.
280
280
281
281
I intentionally broke every rule of proper html/css structure (i.e. embedded styles). This is done to keep the html as bare bones as possible and leave
282
282
it to you to do it properly - whatever properly means in your book.
@@ -285,6 +285,10 @@ To run the examples use this [link](http://rawgithub.com/angular-ui/ui-scroll/ma
285
285
286
286
###History
287
287
288
+
###v1.5.2
289
+
* Refactored assignable expressions and attributes scope bindings.
290
+
* Added new demos and tests. fixed IE compatibility.
291
+
288
292
###v1.5.1
289
293
* Refactored adjustments during elements append/prepend.
290
294
* Bof/eof information is accessible out of the scroller.
0 commit comments