@progress/kendo-angular-treelist 12.0.1-develop.3 → 12.0.1-develop.4

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 (53) hide show
  1. package/binding-directives/flat-binding.directive.d.ts +1 -1
  2. package/binding-directives/hierarchy-binding.directive.d.ts +1 -1
  3. package/column-menu/column-menu-item-content-template.directive.d.ts +14 -6
  4. package/column-menu/column-menu-template.directive.d.ts +15 -6
  5. package/editing/add-command.directive.d.ts +4 -13
  6. package/editing/cancel-command.directive.d.ts +4 -17
  7. package/editing/edit-command.directive.d.ts +5 -5
  8. package/editing/edit-template.directive.d.ts +1 -2
  9. package/editing/remove-command.directive.d.ts +3 -3
  10. package/editing/save-command.directive.d.ts +3 -16
  11. package/editing-directives/in-cell-editing.directive.d.ts +1 -1
  12. package/editing-directives/template-editing.directive.d.ts +1 -1
  13. package/esm2020/binding-directives/flat-binding.directive.mjs +1 -1
  14. package/esm2020/binding-directives/hierarchy-binding.directive.mjs +1 -1
  15. package/esm2020/column-menu/column-menu-item-content-template.directive.mjs +14 -6
  16. package/esm2020/column-menu/column-menu-template.directive.mjs +15 -6
  17. package/esm2020/editing/add-command.directive.mjs +4 -13
  18. package/esm2020/editing/cancel-command.directive.mjs +4 -17
  19. package/esm2020/editing/edit-command.directive.mjs +5 -5
  20. package/esm2020/editing/edit-template.directive.mjs +1 -2
  21. package/esm2020/editing/remove-command.directive.mjs +3 -3
  22. package/esm2020/editing/save-command.directive.mjs +3 -16
  23. package/esm2020/editing-directives/in-cell-editing.directive.mjs +1 -1
  24. package/esm2020/editing-directives/template-editing.directive.mjs +1 -1
  25. package/esm2020/excel/excel-command.directive.mjs +6 -7
  26. package/esm2020/expand-state/expandable.directive.mjs +9 -1
  27. package/esm2020/navigation/focusable.directive.mjs +2 -2
  28. package/esm2020/package-metadata.mjs +2 -2
  29. package/esm2020/pager/pager-template.directive.mjs +15 -7
  30. package/esm2020/pdf/pdf-command.directive.mjs +6 -7
  31. package/esm2020/pdf/pdf-template.directive.mjs +13 -6
  32. package/esm2020/rendering/cell-template.directive.mjs +10 -6
  33. package/esm2020/rendering/footer-template.directive.mjs +9 -8
  34. package/esm2020/rendering/header/header-template.directive.mjs +10 -6
  35. package/esm2020/rendering/no-records-template.directive.mjs +10 -7
  36. package/esm2020/rendering/toolbar/toolbar-template.directive.mjs +12 -13
  37. package/esm2020/selection/selectable.directive.mjs +1 -1
  38. package/excel/excel-command.directive.d.ts +6 -7
  39. package/expand-state/expandable.directive.d.ts +9 -1
  40. package/fesm2015/progress-kendo-angular-treelist.mjs +158 -145
  41. package/fesm2020/progress-kendo-angular-treelist.mjs +158 -145
  42. package/navigation/focusable.directive.d.ts +2 -2
  43. package/package.json +15 -15
  44. package/pager/pager-template.directive.d.ts +15 -7
  45. package/pdf/pdf-command.directive.d.ts +6 -7
  46. package/pdf/pdf-template.directive.d.ts +13 -6
  47. package/rendering/cell-template.directive.d.ts +10 -6
  48. package/rendering/footer-template.directive.d.ts +9 -8
  49. package/rendering/header/header-template.directive.d.ts +10 -6
  50. package/rendering/no-records-template.directive.d.ts +10 -7
  51. package/rendering/toolbar/toolbar-template.directive.d.ts +12 -13
  52. package/schematics/ngAdd/index.js +3 -3
  53. package/selection/selectable.directive.d.ts +1 -1
@@ -46,8 +46,8 @@ const packageMetadata = {
46
46
  name: '@progress/kendo-angular-treelist',
47
47
  productName: 'Kendo UI for Angular',
48
48
  productCodes: ['KENDOUIANGULAR', 'KENDOUICOMPLETE'],
49
- publishDate: 1683100454,
50
- version: '12.0.1-develop.3',
49
+ publishDate: 1683180347,
50
+ version: '12.0.1-develop.4',
51
51
  licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
52
52
  };
53
53
 
@@ -67,12 +67,16 @@ const packageMetadata = {
67
67
  * - `loading`—Specifies if the item children are currently loading.
68
68
  * - `rowIndex`—The current row index. Use it as an alias for a template variable by utilizing the `let-rowIndex="rowIndex"` syntax.
69
69
  *
70
- * {% meta height:470 %}
71
- * {% embed_file data-binding/hierarchy/app.component.ts preview %}
72
- * {% embed_file data-binding/hierarchy/app.module.ts %}
73
- * {% embed_file shared/main.ts %}
74
- * {% embed_file shared/filesystem.ts %}
75
- * {% endmeta %}
70
+ * * @example
71
+ * ```html
72
+ * <kendo-treelist ...>
73
+ * <kendo-treelist-column field="ProductName">
74
+ * <ng-template kendoTreeListCellTemplate let-dataItem let-rowIndex="rowIndex" let-column="column">
75
+ * Data Row: {{rowIndex}}
76
+ * </ng-template>
77
+ * </kendo-treelist-column>
78
+ * </kendo-treelist>
79
+ *```
76
80
  */
77
81
  class CellTemplateDirective {
78
82
  constructor(templateRef) {
@@ -101,8 +105,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
101
105
  * - `column`&mdash;The current column instance.
102
106
  * - `dataItem`&mdash;The current data item.
103
107
  * - `cellContext`&mdash;An object used to pass context information to built-in directives.
104
- * - `formGroup`&mdash;The current [`FormGroup`](link:site.data.urls.angular['formgroupapi']).
105
- * If you use the TreeList inside [Template-Driven Forms](link:site.data.urls.angular['forms']), it will be `undefined`.
108
+ * - `formGroup`&mdash;The current [`FormGroup`](link:site.data.urls.angular['formgroupapi']). If you use the TreeList inside [Template-Driven Forms](link:site.data.urls.angular['forms']), `formGroup` will be `undefined`.
106
109
  * - `isNew`&mdash;The state of the current item.
107
110
  * - `rowIndex`&mdash;The current row index. If inside a new item row, `rowIndex` is `-1`.
108
111
  */
@@ -134,12 +137,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
134
137
  * - `service`&mdash;Represents the [ColumnMenuService]({% slug api_treelist_columnmenuservice %}).
135
138
  * - `column`&mdash;Represents the TreeList column.
136
139
  *
137
- * {% meta height:500 %}
138
- * {% embed_file column-menu/template/app.component.ts preview %}
139
- * {% embed_file column-menu/template/app.module.ts %}
140
- * {% embed_file shared/main.ts %}
141
- * {% embed_file shared/employees.ts %}
142
- * {% endmeta %}
140
+ * @example
141
+ * ```html
142
+ * <kendo-treelist ... >
143
+ * <ng-template kendoTreeListColumnMenuTemplate let-service="service">
144
+ * <kendo-treelist-columnmenu-sort [service]="service">
145
+ * </kendo-treelist-columnmenu-sort>
146
+ * </ng-template>
147
+ * <kendo-treelist-column field="name">
148
+ * <ng-template kendoTreeListColumnMenuTemplate let-service="service">
149
+ * <kendo-treelist-columnmenu-sort [service]="service">
150
+ * </kendo-treelist-columnmenu-sort>
151
+ * </ng-template>
152
+ * </kendo-treelist-column>
153
+ * </kendo-treelist>
154
+ * ```
143
155
  */
144
156
  class ColumnMenuTemplateDirective {
145
157
  constructor(templateRef) {
@@ -164,7 +176,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
164
176
  * ([more information and example]({% slug templates_columns_treelist %}#toc-footer-template)).
165
177
  * Helps to customize the table footer cell for the column.
166
178
  * To define a footer template, nest an `<ng-template>` tag with the
167
- * [`kendoTreeListFooterTemplate`]({% slug api_treelist_footertemplatedirective %}) directive inside the `<kendo-treelist-column>` tag.
179
+ * `kendoTreeListFooterTemplate` directive inside the `<kendo-treelist-column>` tag.
168
180
  *
169
181
  * The template context is set to the aggregate values and the following additional fields are passed:
170
182
  * * `aggregates`&mdash;The aggregates for the level items.
@@ -174,13 +186,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
174
186
  * * `items`&mdash;The data items on this level.
175
187
  * * `parentItem`&mdash;The parent data item; `null` for root level items.
176
188
  *
177
- *
178
- * {% meta height:500 %}
179
- * {% embed_file configuration/footer-template/app.component.ts preview %}
180
- * {% embed_file configuration/footer-template/app.module.ts %}
181
- * {% embed_file shared/main.ts %}
182
- * {% embed_file shared/employees.ts %}
183
- * {% endmeta %}
189
+ * @example
190
+ * ```html
191
+ * <kendo-treelist-column field="name">
192
+ * <ng-template kendoTreeListFooterTemplate let-aggregates="aggregates">
193
+ * {{ aggregates.name.count }}
194
+ * </ng-template>
195
+ * </kendo-treelist-column>
196
+ * ```
184
197
  */
185
198
  class FooterTemplateDirective {
186
199
  constructor(templateRef) {
@@ -211,12 +224,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
211
224
  * * `column`&mdash;Defines an instance of the [`ColumnComponent`]({% slug api_treelist_columncomponent %}) option.
212
225
  * * `columnIndex`&mdash;Defines the current column index.
213
226
  *
214
- * {% meta height:533 %}
215
- * {% embed_file configuration/header-template/app.component.ts preview %}
216
- * {% embed_file configuration/header-template/app.module.ts %}
217
- * {% embed_file shared/main.ts %}
218
- * {% embed_file shared/employees.ts %}
219
- * {% endmeta %}
227
+ * @example
228
+ * ```html
229
+ * <kendo-treelist-column field="name">
230
+ * <ng-template
231
+ * kendoTreeListHeaderTemplate
232
+ * let-column>
233
+ * {{ column.field }}
234
+ * </ng-template>
235
+ * </kendo-treelist-column>
236
+ * ```
220
237
  */
221
238
  class HeaderTemplateDirective {
222
239
  constructor(templateRef) {
@@ -2037,14 +2054,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2037
2054
  * appearance of the item that is displayed when no data is present. To define the no-records template,
2038
2055
  * nest an `<ng-template>` tag with the `kendoTreeListNoRecordsTemplate` directive inside `<kendo-treelist>`.
2039
2056
  *
2040
- * > When the locked columns of the TreeList are in use, the template is displayed in the non-locked part of the content.
2057
+ * When the locked columns of the TreeList are in use, the template is displayed in the non-locked part of the content.
2041
2058
  *
2042
- * {% meta height:533 %}
2043
- * {% embed_file configuration/no-records-template/app.component.ts preview %}
2044
- * {% embed_file configuration/no-records-template/app.module.ts %}
2045
- * {% embed_file shared/main.ts %}
2046
- * {% embed_file shared/employees.ts %}
2047
- * {% endmeta %}
2059
+ * @example
2060
+ * ```html
2061
+ * <kendo-treelist ... >
2062
+ * <kendo-treelist-column field="name" ></kendo-treelist-column>
2063
+ * <ng-template kendoTreeListNoRecordsTemplate>
2064
+ * No data loaded.
2065
+ * </ng-template>
2066
+ * </kendo-treelist>
2067
+ * ```
2048
2068
  */
2049
2069
  class NoRecordsTemplateDirective {
2050
2070
  constructor(templateRef) {
@@ -2135,7 +2155,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2135
2155
 
2136
2156
  /**
2137
2157
  * Represents the pager template which helps to customize the pager appearance in the TreeList. To define a pager
2138
- * template, nest an `<ng-template>` tag with the `kendoTreeListPagerTemplate` directive inside `<kendo-treelist>`.
2158
+ * template, nest an `<ng-template>` tag with the `kendoTreeListPagerTemplate` directive inside `<kendo-treelist>`. [See example](slug:paging_treelist#toc-pager-template).
2139
2159
  *
2140
2160
  * The template context provides the following fields:
2141
2161
  * * `currentPage`&mdash;The index of the displayed page.
@@ -2144,12 +2164,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2144
2164
  * * `total`&mdash;The total number of records.
2145
2165
  * * `totalPages`&mdash;The total number of available pages.
2146
2166
  *
2147
- * {% meta height:470 %}
2148
- * {% embed_file configuration/pager-template-all/app.component.ts preview %}
2149
- * {% embed_file configuration/pager-template-all/app.module.ts %}
2150
- * {% embed_file shared/main.ts %}
2151
- * {% embed_file shared/filesystem.ts %}
2152
- * {% endmeta %}
2167
+ * @example
2168
+ * ```
2169
+ * <kendo-treelist ...>
2170
+ * <kendo-treelist-column field="type"></kendo-treelist-column>
2171
+ * <ng-template
2172
+ * kendoTreeListPagerTemplate
2173
+ * let-totalPages="totalPages"
2174
+ * let-currentPage="currentPage">
2175
+ * <kendo-treelist-pager-prev-buttons></kendo-treelist-pager-prev-buttons>
2176
+ * <kendo-treelist-pager-next-buttons></kendo-treelist-pager-next-buttons>
2177
+ * <kendo-treelist-pager-info></kendo-treelist-pager-info>
2178
+ * </ng-template>
2179
+ * </kendo-treelist>
2180
+ * ```
2153
2181
  */
2154
2182
  class PagerTemplateDirective {
2155
2183
  constructor(templateRef) {
@@ -2422,15 +2450,18 @@ class ColumnList {
2422
2450
  * Represents the toolbar template of the TreeList.
2423
2451
  *
2424
2452
  * The template context has the following field:
2425
- * - `position`&mdash;The position at which the toolbar template is rendered. The possible values are "top" and "bottom".
2453
+ * - `position`&mdash;The position at which the toolbar template is rendered. The possible values are `top`, `bottom` and `both`.
2426
2454
  *
2427
2455
  * @example
2428
- * {% meta height:470 %}
2429
- * {% embed_file configuration/toolbar-template/basic/app.component.ts preview %}
2430
- * {% embed_file configuration/toolbar-template/basic/app.module.ts %}
2431
- * {% embed_file shared/main.ts %}
2432
- * {% embed_file shared/employees.ts %}
2433
- * {% endmeta %}
2456
+ * ```html
2457
+ * <kendo-treelist ...>
2458
+ * <ng-template kendoTreeListToolbarTemplate>
2459
+ * <button kendoTreeListExcelCommand icon="file-excel">
2460
+ * Export to Excel
2461
+ * </button>
2462
+ * </ng-template>
2463
+ * </kendo-treelist>
2464
+ * ```
2434
2465
  */
2435
2466
  class ToolbarTemplateDirective {
2436
2467
  constructor(templateRef, optionChanges) {
@@ -2440,12 +2471,8 @@ class ToolbarTemplateDirective {
2440
2471
  }
2441
2472
  /**
2442
2473
  * The position of the toolbar ([see example]({% slug toolbartemplate_treelist %})).
2443
- *
2444
- * The possible values are:
2445
- * - `top`&mdash;Positions the toolbar above the group panel or header.
2446
- * - `bottom`&mdash;Positions the toolbar below the pager.
2447
- * - `both`&mdash;Displays two toolbar instances. Positions the first one above
2448
- * the group panel or header and the second one below the pager.
2474
+ * The group panel or header and the second one below the pager.
2475
+ * @default 'top'
2449
2476
  */
2450
2477
  set position(position) {
2451
2478
  this._position = position;
@@ -4122,10 +4149,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
4122
4149
  *
4123
4150
  * The directive takes as input the `cellContext` from the cell template.
4124
4151
  *
4125
- * ```ts-no-run
4152
+ * ```html
4126
4153
  * <kendo-treelist-column>
4127
4154
  * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext">
4128
- * <input type="button" kendoButton [kendoTreeListFocusable]="cellContext" value="Focus me!" />
4155
+ * <input [kendoTreeListFocusable]="cellContext" />
4129
4156
  * </ng-template>
4130
4157
  * </kendo-treelist-column>
4131
4158
  * ```
@@ -7393,12 +7420,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
7393
7420
  * To define the content template, nest an `<ng-template>` tag with the
7394
7421
  * `kendoTreeListColumnMenuItemContentTemplate` directive inside a `<kendo-treelist-columnmenu-item>`.
7395
7422
  *
7396
- * {% meta height:500 %}
7397
- * {% embed_file column-menu/template-item-content/app.component.ts preview %}
7398
- * {% embed_file column-menu/template-item-content/app.module.ts %}
7399
- * {% embed_file shared/main.ts %}
7400
- * {% embed_file shared/employees.ts %}
7401
- * {% endmeta %}
7423
+ * @example
7424
+ * ```html
7425
+ * <kendo-treelist>
7426
+ * <kendo-treelist-column field="ProductName">
7427
+ * <ng-template kendoTreeListColumnMenuTemplate>
7428
+ * <kendo-treelist-columnmenu-item text="Item Text" [expanded]="true">
7429
+ * <ng-template kendoTreeListColumnMenuItemContentTemplate>
7430
+ * Item Content
7431
+ * </ng-template>
7432
+ * </kendo-treelist-columnmenu-item>
7433
+ * </ng-template>
7434
+ * </kendo-treelist-column>
7435
+ * </kendo-treelist>
7436
+ * ```
7402
7437
  */
7403
7438
  class ColumnMenuItemContentTemplateDirective {
7404
7439
  constructor(templateRef) {
@@ -17889,17 +17924,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
17889
17924
  * element inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
17890
17925
  * When an associated button with the directive is clicked, the
17891
17926
  * [`edit`]({% slug api_treelist_treelistcomponent %}#toc-edit) event
17892
- * is triggered ([see example]({% slug editing_treelist %})).
17927
+ * is triggered ([see example](slug:custom_editors_editing_treelist)).
17893
17928
  *
17894
- * > * When the row is in the edit mode, the button with `kendoTreeListEditCommand` is automatically hidden.
17895
- * > * The directive takes as input the `cellContext` from the cell template.
17929
+ * When the row is in the `edit` mode, the button with `kendoTreeListEditCommand` is automatically hidden.
17930
+ * The directive takes as input the `cellContext` from the cell template.
17896
17931
  *
17897
17932
  * @example
17898
- * ```html-no-run
17933
+ * ```html
17899
17934
  * <kendo-treelist>
17900
17935
  * <kendo-treelist-command-column title="command">
17901
17936
  * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext">
17902
- * <button [kendoTreeListEditCommand]="cellContext" class="k-primary">Edit</button>
17937
+ * <button [kendoTreeListEditCommand]="cellContext">Edit</button>
17903
17938
  * </ng-template>
17904
17939
  * </kendo-treelist-command-column>
17905
17940
  * </kendo-treelist>
@@ -17961,13 +17996,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
17961
17996
  * element inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
17962
17997
  * When an associated button with the directive is clicked, the
17963
17998
  * [`cancel`]({% slug api_treelist_treelistcomponent %}#toc-cancel) event
17964
- * is triggered ([see example]({% slug editing_treelist %})).
17999
+ * is triggered ([see example](slug:custom_editors_editing_treelist)).
17965
18000
  *
17966
- * > * When the row is not in the edit mode, the button with the `kendoTreeListCancelCommand` is automatically hidden.
17967
- * > * The directive takes as input the `cellContext` from the cell template.
18001
+ * When the row is not in the `edit` mode, the button with the `kendoTreeListCancelCommand` is automatically hidden.
18002
+ * The directive takes as input the `cellContext` from the cell template.
17968
18003
  *
17969
18004
  * @example
17970
- * ```html-no-run
18005
+ * ```html
17971
18006
  * <kendo-treelist>
17972
18007
  * <kendo-treelist-command-column title="command">
17973
18008
  * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext">
@@ -17976,19 +18011,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
17976
18011
  * </kendo-treelist-command-column>
17977
18012
  * </kendo-treelist>
17978
18013
  * ```
17979
- *
17980
- * You can control the content of the button based on the state of the row.
17981
- *
17982
- * @example
17983
- * ```html-no-run
17984
- * <kendo-treelist>
17985
- * <kendo-treelist-command-column title="command">
17986
- * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext" let-isNew="isNew">
17987
- * <button [kendoTreeListCancelCommand]="cellContext">{{isNew ? 'Discard' : 'Cancel changes'}}</button>
17988
- * </ng-template>
17989
- * </kendo-treelist-command-column>
17990
- * </kendo-treelist>
17991
- * ```
17992
18014
  */
17993
18015
  class CancelCommandDirective extends BaseCommandDirective {
17994
18016
  constructor(editService, element, renderer, localization, ngZone) {
@@ -18048,11 +18070,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
18048
18070
  * [`save`]({% slug api_treelist_treelistcomponent %}#toc-save) event
18049
18071
  * is triggered ([see example]({% slug editing_treelist %})).
18050
18072
  *
18051
- * > * When the row is not in the edit mode, the button with `kendoTreeListSaveCommand` is automatically hidden.
18052
- * > * The directive takes as input the `cellContext` from the cell template.
18073
+ * When the row is not in the `edit` mode, the button with `kendoTreeListSaveCommand` is automatically hidden.
18074
+ * The directive takes as input the `cellContext` from the cell template.
18053
18075
  *
18054
18076
  * @example
18055
- * ```html-no-run
18077
+ * ```html
18056
18078
  * <kendo-treelist>
18057
18079
  * <kendo-treelist-command-column title="command">
18058
18080
  * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext">
@@ -18061,19 +18083,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
18061
18083
  * </kendo-treelist-command-column>
18062
18084
  * </kendo-treelist>
18063
18085
  * ```
18064
- *
18065
- * You can control the content of the button based on the state of the row.
18066
- *
18067
- * @example
18068
- * ```html-no-run
18069
- * <kendo-treelist>
18070
- * <kendo-treelist-command-column title="command">
18071
- * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext" let-isNew="isNew">
18072
- * <button [kendoTreeListSaveCommand]="cellContext">{{isNew ? 'Add' : 'Update'}}</button>
18073
- * </ng-template>
18074
- * </kendo-treelist-command-column>
18075
- * </kendo-treelist>
18076
- * ```
18077
18086
  */
18078
18087
  class SaveCommandDirective extends BaseCommandDirective {
18079
18088
  constructor(editService, element, renderer, localization, ngZone) {
@@ -18132,11 +18141,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
18132
18141
  * [`remove` event]({% slug api_treelist_treelistcomponent %}#toc-remove)
18133
18142
  * is triggered ([see example]({% slug editing_reactive_forms_treelist %})).
18134
18143
  *
18135
- * > * When the row is in the edit mode, the button with the `kendoTreeListRemoveCommand` is automatically hidden.
18136
- * > * The directive takes as input the `cellContext` from the cell template.
18144
+ * When the row is in the `edit` mode, the button with the `kendoTreeListRemoveCommand` is automatically hidden.
18145
+ * The directive takes as input the `cellContext` from the cell template.
18137
18146
  *
18138
18147
  * @example
18139
- * ```html-no-run
18148
+ * ```html
18140
18149
  * <kendo-treelist>
18141
18150
  * <kendo-treelist-command-column title="command">
18142
18151
  * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext">
@@ -18198,28 +18207,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
18198
18207
 
18199
18208
  /**
18200
18209
  * Represents the command for adding a new item to the TreeList. You can apply this directive to any
18201
- * `button` element inside a [`ToolbarTemplate`]({% slug api_treelist_commandcolumncomponent %}) or
18210
+ * `button` element inside a [`ToolbarTemplate`](slug:toolbartemplate_treelist) or
18202
18211
  * inside a [`CommandColumnComponent`]({% slug api_treelist_commandcolumncomponent %}).
18203
18212
  *
18204
18213
  * When an associated button with the directive is clicked, the
18205
18214
  * [`add`]({% slug api_treelist_treelistcomponent %}#toc-add) event is triggered
18206
- * ([see example]({% slug editing_treelist %})).
18215
+ * ([see example](slug:custom_editors_editing_treelist)).
18207
18216
  *
18208
- * > When the row is in the edit mode, the button with `kendoTreeListAddCommand` is automatically hidden.
18209
- *
18210
- * @example
18211
- * ```html-no-run
18212
- * <kendo-treelist>
18213
- * <ng-template kendoTreeListToolbarTemplate>
18214
- * <button kendoTreeListAddCommand>Add new</button>
18215
- * </ng-template>
18216
- * </kendo-treelist>
18217
- * ```
18217
+ * When the row is in the `edit mode`, the button with `kendoTreeListAddCommand` is automatically hidden.
18218
18218
  *
18219
18219
  * When added to the command column, the directive takes as input the `cellContext` from the cell template.
18220
18220
  *
18221
18221
  * @example
18222
- * ```html-no-run
18222
+ * ```html
18223
18223
  * <kendo-treelist>
18224
18224
  * <kendo-treelist-command-column title="command">
18225
18225
  * <ng-template kendoTreeListCellTemplate let-cellContext="cellContext">
@@ -18515,7 +18515,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
18515
18515
 
18516
18516
  /**
18517
18517
  * A directive which encapsulates the editing operations of the TreeList when using
18518
- * the Template-Driven Angular Forms ([see example]({% slug editing_directives_treelist %}#toc-the-template-directive)).
18518
+ * the Template-Driven Angular Forms ([see example](slug:editing_directives_treelist#toc-template-editing-directive)).
18519
18519
  */
18520
18520
  class TemplateEditingDirective extends RowEditingDirectiveBase {
18521
18521
  constructor(treelist) {
@@ -18632,7 +18632,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
18632
18632
 
18633
18633
  /**
18634
18634
  * A directive which encapsulates the editing operations of the TreeList when using the in-cell
18635
- * editing with Reactive Forms ([see example]({% slug editing_directives_treelist %}#toc-the-incell-directive)).
18635
+ * editing with Reactive Forms ([see example](slug:editing_directives_treelist#toc-in-cell-editing-directive)).
18636
18636
  */
18637
18637
  class InCellEditingDirective extends EditingDirectiveBase {
18638
18638
  constructor(treelist) {
@@ -18897,7 +18897,7 @@ class HierarchyEditService extends LocalEditService {
18897
18897
  *
18898
18898
  * The directive encapsulates the in-memory handling of data operations such as
18899
18899
  * [sorting]({% slug sorting_treelist %}), [aggregation]({% slug treelist_with_aggregates %})
18900
- * and [filtering]({% slug filtering_treelist %}) ([more information and examples]({% slug databinding_treelist %})).
18900
+ * and [filtering]({% slug filtering_treelist %}) ([more information and examples](slug:databinding_treelist#toc-binding-to-hierarchical-data)).
18901
18901
  */
18902
18902
  class HierarchyBindingDirective extends BaseBindingDirective {
18903
18903
  constructor(component) {
@@ -18983,7 +18983,7 @@ class FlatEditService extends LocalEditService {
18983
18983
  const ROOT_ID = null;
18984
18984
  /**
18985
18985
  * A directive which binds the TreeList to an array of objects by using
18986
- * an ID and parentID field to define the hierarchy.
18986
+ * an `idField` and `parentIDField` field to define the hierarchy.
18987
18987
  *
18988
18988
  * The directive encapsulates the in-memory handling of data operations such as
18989
18989
  * [sorting]({% slug sorting_treelist %}), [aggregation]({% slug treelist_with_aggregates %})
@@ -19042,7 +19042,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
19042
19042
  }] } });
19043
19043
 
19044
19044
  /**
19045
- * A directive which controls the expanded state of the items.
19045
+ * A directive which controls the expanded state of the items. [See example](slug:treelist_expanded_state#toc-built-in-directive).
19046
+ *
19047
+ * @example
19048
+ * ```html
19049
+ * <kendo-treelist ...
19050
+ * [kendoTreeListFlatBinding]="data"
19051
+ * kendoTreeListExpandable> ...
19052
+ * </kendo-treelist>
19053
+ * ```
19046
19054
  */
19047
19055
  class ExpandableDirective {
19048
19056
  constructor(component) {
@@ -19137,7 +19145,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
19137
19145
 
19138
19146
  const defaultColumnKeyGetter = (_column, columnIndex) => columnIndex;
19139
19147
  /**
19140
- * A directive which controls the selection state
19148
+ * A directive which controls the selection state. [See example](slug:selection_treelist).
19141
19149
  */
19142
19150
  class SelectableDirective {
19143
19151
  constructor(treelist) {
@@ -19505,12 +19513,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
19505
19513
  * - `pageNumber`&mdash;Defines PDF page number.
19506
19514
  * - `totalPages`&mdash;Defines the total number of PDF pages.
19507
19515
  *
19508
- * {% meta height:550 %}
19509
- * {% embed_file pdf-export/page-template-inline/app.component.ts preview %}
19510
- * {% embed_file pdf-export/page-template-inline/app.module.ts %}
19511
- * {% embed_file shared/filesystem.ts %}
19512
- * {% embed_file shared/main.ts %}
19513
- * {% endmeta %}
19516
+ * @example
19517
+ * ```html
19518
+ * <kendo-treelist-pdf fileName="Files.pdf" ...>
19519
+ * <ng-template
19520
+ * kendoTreeListPDFTemplate
19521
+ * let-pageNum="pageNum"
19522
+ * let-totalPages="totalPages">
19523
+ * <div style="position: absolute; top: 5px; left: 5px;">
19524
+ * Page {{ pageNum }} of {{ totalPages }}
19525
+ * </div>
19526
+ * </ng-template>
19527
+ * </kendo-treelist-pdf>
19528
+ * ```
19514
19529
  */
19515
19530
  class PDFTemplateDirective extends PDFExportTemplateDirective {
19516
19531
  constructor(templateRef) {
@@ -19900,19 +19915,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
19900
19915
  /**
19901
19916
  * Represents the `export-to-PDF` command of the TreeList.
19902
19917
  * You can apply this directive to any `button` element inside a
19903
- * [`ToolbarTemplate`]({% slug api_treelist_commandcolumncomponent %}).
19918
+ * [`ToolbarTemplate`](slug:toolbartemplate_treelist).
19904
19919
  * When the user clicks a button that is associated with the directive, the
19905
19920
  * [`pdfExport`]({% slug api_treelist_treelistcomponent %}#toc-pdfexport) event
19906
19921
  * fires ([see example]({% slug pdfexport_treelist %})).
19907
19922
  *
19908
19923
  * @example
19909
- * ```html-no-run
19924
+ * ```html
19910
19925
  * <kendo-treelist>
19911
- * <ng-template kendoTreeListToolbarTemplate>
19912
- * <button kendoTreeListPDFCommand>Export to PDF</button>
19913
- * </ng-template>
19914
- * <kendo-treelist-pdf fileName="TreeList.pdf">
19915
- * </kendo-treelist-pdf>
19926
+ * <ng-template kendoTreeListToolbarTemplate>
19927
+ * <button kendoTreeListPDFCommand>Export to PDF</button>
19928
+ * </ng-template>
19929
+ * <kendo-treelist-pdf fileName="TreeList.pdf"></kendo-treelist-pdf>
19916
19930
  * </kendo-treelist>
19917
19931
  * ```
19918
19932
  */
@@ -20253,19 +20267,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
20253
20267
  /**
20254
20268
  * Represents the `export-to-Excel` command of the TreeList. You can apply this
20255
20269
  * directive to any `button` element inside a
20256
- * [`ToolbarTemplate`]({% slug api_treelist_commandcolumncomponent %}).
20270
+ * [`ToolbarTemplate`](slug:toolbartemplate_treelist).
20257
20271
  * When the user clicks a button associated with the directive, the
20258
20272
  * [`excelExport`]({% slug api_treelist_treelistcomponent %}#toc-excelexport) event
20259
20273
  * fires ([see example]({% slug excelexport_treelist %})).
20260
20274
  *
20261
20275
  * @example
20262
- * ```html-no-run
20276
+ * ```html
20263
20277
  * <kendo-treelist>
20264
- * <ng-template kendoTreeListToolbarTemplate>
20265
- * <button kendoTreeListExcelCommand>Export to PDF</button>
20266
- * </ng-template>
20267
- * <kendo-treelist-excel fileName="TreeList.xlsx">
20268
- * </kendo-treelist-excel>
20278
+ * <ng-template kendoTreeListToolbarTemplate>
20279
+ * <button kendoTreeListExcelCommand>Export to PDF</button>
20280
+ * </ng-template>
20281
+ * <kendo-treelist-excel fileName="TreeList.xlsx"> </kendo-treelist-excel>
20269
20282
  * </kendo-treelist>
20270
20283
  * ```
20271
20284
  */