@progress/kendo-angular-listview 19.1.2-develop.2 → 19.1.2-develop.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/data-binding/data-binding.directive.d.ts +19 -2
  2. package/editing/commands/add-command.directive.d.ts +5 -4
  3. package/editing/commands/cancel-command.directive.d.ts +6 -5
  4. package/editing/commands/edit-command.directive.d.ts +5 -5
  5. package/editing/commands/remove-command.directive.d.ts +6 -5
  6. package/editing/commands/save-command.directive.d.ts +6 -5
  7. package/editing/edit-template.directive.d.ts +23 -5
  8. package/editing/events/add-event-args.interface.d.ts +2 -1
  9. package/editing/events/cancel-event-args.interface.d.ts +2 -1
  10. package/editing/events/edit-event-args.interface.d.ts +6 -5
  11. package/editing/events/remove-event-args.interface.d.ts +2 -1
  12. package/editing/events/save-event-args.interface.d.ts +3 -2
  13. package/esm2022/data-binding/data-binding.directive.mjs +19 -2
  14. package/esm2022/editing/commands/add-command.directive.mjs +5 -4
  15. package/esm2022/editing/commands/cancel-command.directive.mjs +6 -5
  16. package/esm2022/editing/commands/edit-command.directive.mjs +5 -5
  17. package/esm2022/editing/commands/remove-command.directive.mjs +6 -5
  18. package/esm2022/editing/commands/save-command.directive.mjs +6 -5
  19. package/esm2022/editing/edit-template.directive.mjs +23 -5
  20. package/esm2022/listview.component.mjs +74 -41
  21. package/esm2022/models/page-size-change-event.mjs +2 -2
  22. package/esm2022/package-metadata.mjs +2 -2
  23. package/esm2022/templates/footer-template.directive.mjs +18 -2
  24. package/esm2022/templates/header-template.directive.mjs +19 -2
  25. package/esm2022/templates/item-template.directive.mjs +23 -6
  26. package/esm2022/templates/loader-template.directive.mjs +18 -1
  27. package/fesm2022/progress-kendo-angular-listview.mjs +226 -87
  28. package/listview.component.d.ts +74 -41
  29. package/models/listview-data-result.d.ts +3 -3
  30. package/models/page-change-event.d.ts +3 -2
  31. package/models/page-size-change-event.d.ts +2 -2
  32. package/models/page-size-item.d.ts +2 -2
  33. package/models/pager-position.d.ts +4 -2
  34. package/models/pager-settings.d.ts +4 -9
  35. package/models/pager-type.d.ts +2 -5
  36. package/models/scroll-bottom-event.d.ts +2 -2
  37. package/package.json +8 -8
  38. package/schematics/ngAdd/index.js +6 -6
  39. package/templates/footer-template.directive.d.ts +18 -2
  40. package/templates/header-template.directive.d.ts +19 -2
  41. package/templates/item-template.directive.d.ts +23 -6
  42. package/templates/loader-template.directive.d.ts +18 -1
@@ -24,6 +24,34 @@ import { AddEvent } from "./editing/events/add-event-args.interface";
24
24
  import * as i0 from "@angular/core";
25
25
  /**
26
26
  * Represents the Kendo UI ListView component for Angular.
27
+ * Displays a list of data items and supports paging, editing, and custom templates
28
+ * ([see overview]({% slug overview_listview %})).
29
+ *
30
+ * @example
31
+ * ```typescript
32
+ * @Component({
33
+ * selector: 'my-app',
34
+ * template: `
35
+ * <kendo-listview
36
+ * [data]="items"
37
+ * [pageable]="true"
38
+ * [pageSize]="5">
39
+ * <ng-template kendoListViewItemTemplate let-dataItem>
40
+ * <div class="item">
41
+ * <h3>{{ dataItem.name }}</h3>
42
+ * <p>{{ dataItem.description }}</p>
43
+ * </div>
44
+ * </ng-template>
45
+ * </kendo-listview>
46
+ * `
47
+ * })
48
+ * export class AppComponent {
49
+ * items = [
50
+ * { name: 'Item 1', description: 'First item' },
51
+ * { name: 'Item 2', description: 'Second item' }
52
+ * ];
53
+ * }
54
+ * ```
27
55
  */
28
56
  export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDestroy {
29
57
  ngZone: NgZone;
@@ -71,40 +99,42 @@ export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDe
71
99
  */
72
100
  bordered: boolean;
73
101
  /**
74
- * The data collection that will be used to populate the ListView
102
+ * Specifies the data collection that populates the ListView
75
103
  * ([see data binding examples]({% slug paging_listview %})).
76
104
  */
77
105
  set data(value: any[] | ListViewDataResult | undefined);
78
106
  get data(): any[] | ListViewDataResult | undefined;
79
107
  /**
80
- * Specifies if the loading indicator of the ListView will be displayed
108
+ * Specifies whether the loading indicator of the ListView displays
81
109
  * ([see example]({% slug paging_listview %}#toc-remote-binding)).
110
+ *
111
+ * @default false
82
112
  */
83
113
  loading: boolean;
84
114
  /**
85
- * The CSS styles that will be rendered on the content container element of the ListView.
86
- * Supports the type of values that are supported by [`ngStyle`](link:site.data.urls.angular['ngstyleapi']).
115
+ * Specifies the CSS styles that render on the content container element of the ListView.
116
+ * Supports the type of values that [`ngStyle`](link:site.data.urls.angular['ngstyleapi']) supports.
87
117
  */
88
118
  containerStyle?: {
89
119
  [key: string]: string;
90
120
  };
91
121
  /**
92
- * The CSS styles that will be rendered on each item element wrapper of the ListView.
93
- * Supports the type of values that are supported by [`ngStyle`](link:site.data.urls.angular['ngstyleapi']).
122
+ * Specifies the CSS styles that render on each item element wrapper of the ListView.
123
+ * Supports the type of values that [`ngStyle`](link:site.data.urls.angular['ngstyleapi']) supports.
94
124
  */
95
125
  itemStyle?: {
96
126
  [key: string]: string;
97
127
  };
98
128
  /**
99
- * The CSS class that will be rendered on the content container element of the ListView.
100
- * Supports the type of values that are supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
129
+ * Specifies the CSS class that renders on the content container element of the ListView.
130
+ * Supports the type of values that [`ngClass`](link:site.data.urls.angular['ngclassapi']) supports.
101
131
  */
102
132
  containerClass?: string | string[] | Set<string> | {
103
133
  [key: string]: boolean;
104
134
  };
105
135
  /**
106
- * The CSS class that will be rendered on each item element wrapper of the ListView.
107
- * Supports the type of values that are supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
136
+ * Specifies the CSS class that renders on each item element wrapper of the ListView.
137
+ * Supports the type of values that [`ngClass`](link:site.data.urls.angular['ngclassapi']) supports.
108
138
  */
109
139
  itemClass?: string | string[] | Set<string> | {
110
140
  [key: string]: boolean;
@@ -117,24 +147,27 @@ export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDe
117
147
  /**
118
148
  * Specifies the content container `role` attribute
119
149
  * ([more details]({% slug accessibility_listview %}#toc-wai-aria-support)).
120
- * By default, the container `role` is set to `list`.
150
+ *
151
+ * @default 'list'
121
152
  */
122
153
  containerRole: string;
123
154
  /**
124
155
  * Specifies the list item `role` attribute
125
156
  * ([more details]({% slug accessibility_listview %}#toc-wai-aria-support)).
126
- * By default, the list item `role` is set to `listitem`.
157
+ *
158
+ * @default 'listitem'
127
159
  */
128
160
  listItemRole: string;
129
161
  /**
130
- * Specifies whether the keyboard navigation is enabled
162
+ * Specifies whether keyboard navigation is enabled
131
163
  * ([see example]({% slug keyboard_navigation_listview %})).
132
- * By default, the navigation is enabled.
164
+ *
165
+ * @default true
133
166
  */
134
167
  set navigable(navigable: boolean);
135
168
  get navigable(): boolean;
136
169
  /**
137
- * Defines the page size used by the ListView pager
170
+ * Specifies the page size used by the ListView pager
138
171
  * ([more details]({% slug paging_listview %})).
139
172
  */
140
173
  pageSize?: number;
@@ -145,57 +178,58 @@ export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDe
145
178
  set skip(skip: number);
146
179
  get skip(): number;
147
180
  /**
148
- * Configures whether the ListView will render a pager
181
+ * Configures whether the ListView renders a pager
149
182
  * ([more details]({% slug paging_listview %})).
150
- * Providing a boolean value will render a pager with the default settings.
183
+ * When you provide a boolean value, it renders a pager with the default settings.
151
184
  */
152
185
  set pageable(pageable: boolean | PagerSettings);
153
186
  get pageable(): boolean | PagerSettings;
154
187
  /**
155
- * Defines the height (in pixels) of the ListView component.
156
- * If the content height exceeds the component height, a vertical scrollbar will be rendered.
188
+ * Specifies the height (in pixels) of the ListView component.
189
+ * When the content height exceeds the component height, a vertical scrollbar renders.
190
+ *
157
191
  * To set the height of the ListView, you can also use `style.height`. The `style.height`
158
192
  * option supports units such as `px`, `%`, `em`, `rem`, and others.
159
193
  */
160
194
  height?: number;
161
195
  /**
162
- * Fires when the user scrolls to the last record on the page
196
+ * Fires when you scroll to the last record on the page
163
197
  * ([see endless scrolling example]({% slug scrollmodes_listview %}#toc-endless-scrolling)).
164
198
  */
165
199
  scrollBottom: EventEmitter<ScrollBottomEvent>;
166
200
  /**
167
- * Fires when the page or the page size of the ListView is changed
201
+ * Fires when you change the page or the page size of the ListView
168
202
  * ([see example]({% slug paging_listview %}#toc-remote-binding)).
169
203
  * You have to handle the event yourself and page the data.
170
204
  */
171
205
  pageChange: EventEmitter<PageChangeEvent>;
172
206
  /**
173
- * Fires when the page size of the ListView is changed. This event can be prevented (`$event.preventDefault()`).
174
- * If not prevented, the `pageChange` event will be fired subsequently.
207
+ * Fires when you change the page size of the ListView. You can prevent this event (`$event.preventDefault()`).
208
+ * When not prevented, the `pageChange` event fires subsequently.
175
209
  */
176
210
  pageSizeChange: EventEmitter<PageSizeChangeEvent>;
177
211
  /**
178
- * Fires when the user clicks the **Edit** command button to edit an item
212
+ * Fires when you click the **Edit** command button to edit an item
179
213
  * ([see example]({% slug editing_template_forms_listview %}#toc-editing-records)).
180
214
  */
181
215
  edit: EventEmitter<EditEvent>;
182
216
  /**
183
- * Fires when the user clicks the **Cancel** command button to close an item
217
+ * Fires when you click the **Cancel** command button to close an item
184
218
  * ([see example]({% slug editing_template_forms_listview %}#toc-cancelling-editing)).
185
219
  */
186
220
  cancel: EventEmitter<CancelEvent>;
187
221
  /**
188
- * Fires when the user clicks the **Save** command button to save changes in an item
222
+ * Fires when you click the **Save** command button to save changes in an item
189
223
  * ([see example]({% slug editing_template_forms_listview %}#toc-saving-records)).
190
224
  */
191
225
  save: EventEmitter<SaveEvent>;
192
226
  /**
193
- * Fires when the user clicks the **Remove** command button to remove an item
227
+ * Fires when you click the **Remove** command button to remove an item
194
228
  * ([see example]({% slug editing_template_forms_listview %}#toc-removing-records)).
195
229
  */
196
230
  remove: EventEmitter<RemoveEvent>;
197
231
  /**
198
- * Fires when the user clicks the **Add** command button to add a new item
232
+ * Fires when you click the **Add** command button to add a new item
199
233
  * ([see example]({% slug editing_template_forms_listview %}#toc-adding-records)).
200
234
  */
201
235
  add: EventEmitter<AddEvent>;
@@ -207,14 +241,14 @@ export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDe
207
241
  * @hidden
208
242
  *
209
243
  * Gets the data items passed to the ListView.
210
- * If a ListViewDataResult is passed, the data value is used. If an array is passed - it's directly used.
244
+ * If a `ListViewDataResult` is passed, the data value is used. If an array is passed - it's directly used.
211
245
  */
212
246
  get items(): any[];
213
247
  /**
214
248
  * @hidden
215
249
  *
216
250
  * Gets the total number of records passed to the ListView.
217
- * If a ListViewDataResult is passed, the total value is used. If an array is passed - its length is used.
251
+ * If a `ListViewDataResult` is passed, the total value is used. If an array is passed - its length is used.
218
252
  */
219
253
  get total(): number;
220
254
  /**
@@ -224,7 +258,7 @@ export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDe
224
258
  /**
225
259
  * Gets the current active item index
226
260
  * ([see example]({% slug keyboard_navigation_listview %}#toc-controlling-the-focus)).
227
- * Returns `null` when the keyboard navigation is disabled.
261
+ * Returns `null` when keyboard navigation is disabled.
228
262
  */
229
263
  get activeIndex(): number;
230
264
  private removeNavigationListeners;
@@ -248,26 +282,26 @@ export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDe
248
282
  editTemplateContext(index: number): any;
249
283
  /**
250
284
  * Focuses the item at the specified index ([see example]({% slug keyboard_navigation_listview %}#toc-controlling-the-focus)):
251
- * - If no index is specified, the current active index will be focused.
252
- * - If the passed value is below `0`, the first item receives focus.
253
- * - If the passed value is above the last available index, the last item receives focus.
285
+ * - When you specify no index, the current active index receives focus.
286
+ * - When the passed value is below `0`, the first item receives focus.
287
+ * - When the passed value is above the last available index, the last item receives focus.
254
288
  *
255
- * > The index param is based on the logical structure of the ListView and does not correspond to the data item index -
256
- * > i.e. the index `0` corresponds to the first rendered list item. Paging is not taken into account.
257
- * > Also, for the focusing to work, the `navigable` prop must first be set to `true`.
289
+ * > The `index` parameter is based on the logical structure of the ListView and does not correspond to the data item index&mdash
290
+ * > the index `0` corresponds to the first rendered list item. Paging is not taken into account.
291
+ * > Also, the `navigable` property must first be set to `true` for the method to work as expected.
258
292
  */
259
293
  focus(index?: number): void;
260
294
  /**
261
295
  * Creates a new item editor ([see example]({% slug editing_template_forms_listview %}#toc-adding-records)).
262
296
  *
263
297
  * @param {FormGroup} group - The [`FormGroup`](link:site.data.urls.angular['formgroupapi']) that describes
264
- * the edit form. If called with a data item, it will build the `FormGroup` from the data item fields.
298
+ * the edit form. When called with a data item, it builds the `FormGroup` from the data item fields.
265
299
  */
266
300
  addItem(group: any): void;
267
301
  /**
268
302
  * Switches the specified item to edit mode ([see example]({% slug editing_template_forms_listview %}#toc-editing-records)).
269
303
  *
270
- * @param index - The item index that will be switched to edit mode.
304
+ * @param index - The item index that switches to edit mode.
271
305
  * @param group - The [`FormGroup`](link:site.data.urls.angular['formgroupapi'])
272
306
  * that describes the edit form.
273
307
  */
@@ -275,8 +309,7 @@ export declare class ListViewComponent implements AfterViewInit, OnChanges, OnDe
275
309
  /**
276
310
  * Closes the editor for a given item ([see example]({% slug editing_template_forms_listview %}#toc-cancelling-editing)).
277
311
  *
278
- * @param {number} index - The item index that will be switched out of the edit mode. If no index is provided, it is assumed
279
- * that the new item editor will be closed.
312
+ * @param {number} index - The item index that switches out of the edit mode. When you provide no index, the editor of the new item will close.
280
313
  */
281
314
  closeItem(index?: number): void;
282
315
  /**
@@ -3,16 +3,16 @@
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  /**
6
- * The data type that is expected by the ListView
6
+ * Defines the data type that the ListView expects
7
7
  * ([see data binding examples]({% slug paging_listview %})).
8
8
  */
9
9
  export interface ListViewDataResult {
10
10
  /**
11
- * The data that will be rendered by the ListView.
11
+ * Specifies the data that the ListView renders.
12
12
  */
13
13
  data: any[];
14
14
  /**
15
- * The total number of available records.
15
+ * Specifies the total number of available records.
16
16
  */
17
17
  total: number;
18
18
  }
@@ -4,7 +4,8 @@
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  import { PageChangeEvent as PagerPageChangeEvent } from '@progress/kendo-angular-pager';
6
6
  /**
7
- * The arguments of the [`pageChange`]({% slug api_listview_listviewcomponent %}#toc-pagechange) event of the ListView
8
- * ([more details]({% slug paging_listview %}).
7
+ * Defines the arguments of the [`pageChange`]({% slug api_listview_listviewcomponent %}#toc-pagechange) event of the ListView
8
+ * ([more details]({% slug paging_listview %})).
9
+ *
9
10
  */
10
11
  export type PageChangeEvent = PagerPageChangeEvent;
@@ -4,8 +4,8 @@
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  import { PageSizeChangeEvent as PagerPageSizeChangeEvent } from "@progress/kendo-angular-pager";
6
6
  /**
7
- * The arguments of the [`pageSizeChange`]({% slug api_listview_listviewcomponent %}#toc-pagesizechange) event of the ListView
8
- * ([more details]({% slug paging_listview %}).
7
+ * Defines the arguments of the [`pageSizeChange`]({% slug api_listview_listviewcomponent %}#toc-pagesizechange) event of the ListView
8
+ * ([more details]({% slug paging_listview %})).
9
9
  */
10
10
  export declare class PageSizeChangeEvent extends PagerPageSizeChangeEvent {
11
11
  }
@@ -4,8 +4,8 @@
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  import { PageSizeItem as PagerPageSizeItem } from '@progress/kendo-angular-pager';
6
6
  /**
7
- * The type accepted by the pager [`pageSizeValues`]({% slug api_listview_pagersettings %}#toc-pagesizevalues) property,
8
- * that defines the text and value of each page size item
7
+ * Defines the type that the pager [`pageSizeValues`]({% slug api_listview_pagersettings %}#toc-pagesizevalues) property accepts.
8
+ * Specifies the text and value of each page size item
9
9
  * ([see example]({% slug paging_listview %}#toc-pager-options)).
10
10
  */
11
11
  export interface PageSizeItem extends PagerPageSizeItem {
@@ -3,8 +3,10 @@
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  /**
6
- * The type accepted by the pager [`position`]({% slug api_listview_pagersettings %}#toc-position) property,
7
- * that specifies whether the pager is going to be positioned above the content container, beneath it, or in both places
6
+ * Defines the type that the pager [`position`]({% slug api_listview_pagersettings %}#toc-position) property accepts.
7
+ * Specifies whether the pager appears above the content container, beneath it, or in both places
8
8
  * ([see example]({% slug paging_listview %}#toc-pager-options)).
9
+ *
10
+ * @default 'bottom'
9
11
  */
10
12
  export type PagerPosition = 'bottom' | 'top' | 'both';
@@ -6,21 +6,16 @@ import { PagerType } from './pager-type';
6
6
  import { PageSizeItem } from './page-size-item';
7
7
  import { PagerPosition } from './pager-position';
8
8
  /**
9
- * The pager settings of the ListView
9
+ * Defines the pager settings of the ListView
10
10
  * ([see example]({% slug paging_listview %}#toc-pager-options)).
11
11
  */
12
12
  export interface PagerSettings {
13
13
  /**
14
14
  * Specifies the position of the pager.
15
- *
16
- * The possible values are:
17
- * - `bottom` (Default) &mdash; Positions the pager below the ListView.
18
- * - `top` &mdash; Positions the pager above the ListView.
19
- * - `both` &mdash; Displays two pager instances. Positions the first one above the ListView and the second one below it.
20
15
  */
21
16
  position?: PagerPosition;
22
17
  /**
23
- * Sets the maximum numeric buttons count before the buttons are collapsed.
18
+ * Specifies the maximum count of numeric buttons before the buttons collapse.
24
19
  */
25
20
  buttonCount?: number;
26
21
  /**
@@ -32,11 +27,11 @@ export interface PagerSettings {
32
27
  */
33
28
  previousNext?: boolean;
34
29
  /**
35
- * Defines the type of the pager.
30
+ * Specifies the type of the pager.
36
31
  */
37
32
  type?: PagerType;
38
33
  /**
39
- * Shows a dropdown for selecting the page size. When set to true, the dropdown will contain the default list of options - 5, 10, 20.
34
+ * Shows a dropdown for selecting the page size. When you set this to `true`, the dropdown contains the default list of options: 5, 10, 20.
40
35
  * To customize the list of options, set `pageSizeValues` to an array of the desired values.
41
36
  * The array can contain numbers and `PageSizeItem` objects.
42
37
  */
@@ -4,12 +4,9 @@
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  import { PagerType as PagerTypeSource } from '@progress/kendo-angular-pager';
6
6
  /**
7
- * The type accepted by the pager [`type`]({% slug api_listview_pagersettings %}#toc-type) property,
8
- * that specifies whether the pager will render a set of buttons for page control or a single HTML `input` element
7
+ * Defines the type that the pager [`type`]({% slug api_listview_pagersettings %}#toc-type) property accepts.
8
+ * Specifies whether the pager renders a set of buttons for page control or a single HTML `input` element
9
9
  * ([see example]({% slug paging_listview %}#toc-pager-options)).
10
10
  *
11
- * The available values are:
12
- * * `numeric`&mdash;Buttons with numbers.
13
- * * `input`&mdash;Input for typing the page number.
14
11
  */
15
12
  export declare type PagerType = Partial<PagerTypeSource>;
@@ -4,11 +4,11 @@
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  import { ListViewComponent } from "../listview.component";
6
6
  /**
7
- * The arguments of the [`scrollBottom`]({% slug api_listview_listviewcomponent %}#toc-scrollbottom) event of the ListView.
7
+ * Defines the arguments of the [`scrollBottom`]({% slug api_listview_listviewcomponent %}#toc-scrollbottom) event of the ListView.
8
8
  */
9
9
  export interface ScrollBottomEvent {
10
10
  /**
11
- * The instance of the ListViewComponent.
11
+ * Specifies the instance of the `ListViewComponent`.
12
12
  */
13
13
  sender: ListViewComponent;
14
14
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@progress/kendo-angular-listview",
3
- "version": "19.1.2-develop.2",
3
+ "version": "19.1.2-develop.3",
4
4
  "description": "Kendo UI Angular listview component",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "author": "Progress",
@@ -19,7 +19,7 @@
19
19
  "package": {
20
20
  "productName": "Kendo UI for Angular",
21
21
  "productCode": "KENDOUIANGULAR",
22
- "publishDate": 1749820766,
22
+ "publishDate": 1750152834,
23
23
  "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
24
24
  }
25
25
  },
@@ -30,16 +30,16 @@
30
30
  "@angular/forms": "16 - 20",
31
31
  "@angular/platform-browser": "16 - 20",
32
32
  "@progress/kendo-licensing": "^1.5.0",
33
- "@progress/kendo-angular-buttons": "19.1.2-develop.2",
34
- "@progress/kendo-angular-common": "19.1.2-develop.2",
35
- "@progress/kendo-angular-icons": "19.1.2-develop.2",
36
- "@progress/kendo-angular-l10n": "19.1.2-develop.2",
37
- "@progress/kendo-angular-pager": "19.1.2-develop.2",
33
+ "@progress/kendo-angular-buttons": "19.1.2-develop.3",
34
+ "@progress/kendo-angular-common": "19.1.2-develop.3",
35
+ "@progress/kendo-angular-icons": "19.1.2-develop.3",
36
+ "@progress/kendo-angular-l10n": "19.1.2-develop.3",
37
+ "@progress/kendo-angular-pager": "19.1.2-develop.3",
38
38
  "rxjs": "^6.5.3 || ^7.0.0"
39
39
  },
40
40
  "dependencies": {
41
41
  "tslib": "^2.3.1",
42
- "@progress/kendo-angular-schematics": "19.1.2-develop.2"
42
+ "@progress/kendo-angular-schematics": "19.1.2-develop.3"
43
43
  },
44
44
  "schematics": "./schematics/collection.json",
45
45
  "module": "fesm2022/progress-kendo-angular-listview.mjs",
@@ -4,12 +4,12 @@ const schematics_1 = require("@angular-devkit/schematics");
4
4
  function default_1(options) {
5
5
  const finalOptions = Object.assign(Object.assign({}, options), { mainNgModule: 'ListViewModule', package: 'listview', peerDependencies: {
6
6
  // Peers of pager
7
- '@progress/kendo-angular-dropdowns': '19.1.2-develop.2',
8
- '@progress/kendo-angular-treeview': '19.1.2-develop.2',
9
- '@progress/kendo-angular-inputs': '19.1.2-develop.2',
10
- '@progress/kendo-angular-intl': '19.1.2-develop.2',
11
- '@progress/kendo-angular-l10n': '19.1.2-develop.2',
12
- '@progress/kendo-angular-popup': '19.1.2-develop.2',
7
+ '@progress/kendo-angular-dropdowns': '19.1.2-develop.3',
8
+ '@progress/kendo-angular-treeview': '19.1.2-develop.3',
9
+ '@progress/kendo-angular-inputs': '19.1.2-develop.3',
10
+ '@progress/kendo-angular-intl': '19.1.2-develop.3',
11
+ '@progress/kendo-angular-l10n': '19.1.2-develop.3',
12
+ '@progress/kendo-angular-popup': '19.1.2-develop.3',
13
13
  '@progress/kendo-drawing': '^1.17.2',
14
14
  // Peer of icons
15
15
  '@progress/kendo-svg-icons': '^4.0.0'
@@ -5,9 +5,25 @@
5
5
  import { TemplateRef } from '@angular/core';
6
6
  import * as i0 from "@angular/core";
7
7
  /**
8
- * Renders the footer content of the ListView. To define a footer template, nest an `<ng-template>` tag
8
+ * Allows customizing the footer content of the ListView. To define a footer template, nest an `<ng-template>` tag
9
9
  * with the `kendoListViewFooterTemplate` directive inside the `<kendo-listview>` tag
10
- * [see example]({% slug templates_listview %}#toc-footer-template).
10
+ * ([see example]({% slug templates_listview %}#toc-footer-template)).
11
+ *
12
+ * @example
13
+ * ```typescript
14
+ * @Component({
15
+ * template: `
16
+ * <kendo-listview [data]="items">
17
+ * <ng-template kendoListViewFooterTemplate>
18
+ * <div class="footer-content">
19
+ * <p>Total items: {{ items.length }}</p>
20
+ * </div>
21
+ * </ng-template>
22
+ * </kendo-listview>
23
+ * `
24
+ * })
25
+ * export class AppComponent { }
26
+ * ```
11
27
  */
12
28
  export declare class FooterTemplateDirective {
13
29
  templateRef: TemplateRef<any>;
@@ -5,9 +5,26 @@
5
5
  import { TemplateRef } from '@angular/core';
6
6
  import * as i0 from "@angular/core";
7
7
  /**
8
- * Renders the header content of the ListView. To define a header template, nest an `<ng-template>` tag
8
+ * Allows customizing the header content of the ListView. To define a header template, nest an `<ng-template>` tag
9
9
  * with the `kendoListViewHeaderTemplate` directive inside the `<kendo-listview>` tag
10
- * [see example]({% slug templates_listview %}#toc-header-template).
10
+ * ([see example]({% slug templates_listview %}#toc-header-template)).
11
+ *
12
+ * @example
13
+ * ```typescript
14
+ * @Component({
15
+ * template: `
16
+ * <kendo-listview [data]="items">
17
+ * <ng-template kendoListViewHeaderTemplate>
18
+ * <div class="header-content">
19
+ * <h3>Product List</h3>
20
+ * <button kendoListViewAddCommand>Add New Item</button>
21
+ * </div>
22
+ * </ng-template>
23
+ * </kendo-listview>
24
+ * `
25
+ * })
26
+ * export class AppComponent { }
27
+ * ```
11
28
  */
12
29
  export declare class HeaderTemplateDirective {
13
30
  templateRef: TemplateRef<any>;
@@ -5,15 +5,32 @@
5
5
  import { TemplateRef } from '@angular/core';
6
6
  import * as i0 from "@angular/core";
7
7
  /**
8
- * Renders the list item content. To define an item template, nest an `<ng-template>` tag
8
+ * Allows customizing the list item content. To define an item template, nest an `<ng-template>` tag
9
9
  * with the `kendoListViewItemTemplate` directive inside the `<kendo-listview>` tag
10
- * [see example]({% slug templates_listview %}#toc-item-template).
10
+ * ([see example]({% slug templates_listview %}#toc-item-template)).
11
11
  *
12
12
  * The following values are available as context variables:
13
- * - `let-dataItem="dataItem"` (`any`) - The current data item. Also available as implicit context variable.
14
- * - `let-index="index"` (`number`) - The current item index.
15
- * - `let-isFirst="isFirst"` (`boolean`) - Indicates whether the current data item will be rendered as the first item on the list.
16
- * - `let-isLast="isLast"` (`boolean`)- Indicates whether the current data item will be rendered as the last item on the list.
13
+ * - `let-dataItem="dataItem"` (`any`)&mdashThe current data item. Also available as implicit context variable.
14
+ * - `let-index="index"` (`number`)&mdashThe current item index.
15
+ * - `let-isFirst="isFirst"` (`boolean`)&mdashIndicates whether the current data item renders as the first item on the list.
16
+ * - `let-isLast="isLast"` (`boolean`)&mdashIndicates whether the current data item renders as the last item on the list.
17
+ *
18
+ * @example
19
+ * ```typescript
20
+ * @Component({
21
+ * template: `
22
+ * <kendo-listview [data]="items">
23
+ * <ng-template kendoListViewItemTemplate let-dataItem let-index="index">
24
+ * <div class="item-wrapper">
25
+ * <h4>{{ dataItem.name }}</h4>
26
+ * <p>Item #{{ index + 1 }}: {{ dataItem.description }}</p>
27
+ * </div>
28
+ * </ng-template>
29
+ * </kendo-listview>
30
+ * `
31
+ * })
32
+ * export class AppComponent { }
33
+ * ```
17
34
  */
18
35
  export declare class ItemTemplateDirective {
19
36
  templateRef: TemplateRef<any>;
@@ -7,7 +7,24 @@ import * as i0 from "@angular/core";
7
7
  /**
8
8
  * Overrides the default loader content of the ListView. To define a loader template, nest an `<ng-template>` tag
9
9
  * with the `kendoListViewLoaderTemplate` directive inside the `<kendo-listview>` tag
10
- * [see example]({% slug templates_listview %}#toc-loader-template).
10
+ * ([see example]({% slug templates_listview %}#toc-loader-template)).
11
+ *
12
+ * @example
13
+ * ```typescript
14
+ * @Component({
15
+ * template: `
16
+ * <kendo-listview [data]="items" [loading]="isLoading">
17
+ * <ng-template kendoListViewLoaderTemplate>
18
+ * <div class="custom-loader">
19
+ * <kendo-loader></kendo-loader>
20
+ * <p>Loading data, please wait...</p>
21
+ * </div>
22
+ * </ng-template>
23
+ * </kendo-listview>
24
+ * `
25
+ * })
26
+ * export class AppComponent { }
27
+ * ```
11
28
  */
12
29
  export declare class LoaderTemplateDirective {
13
30
  templateRef: TemplateRef<any>;