@progress/kendo-angular-treelist 19.1.2-develop.4 → 19.1.2-develop.6

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 (244) hide show
  1. package/binding-directives/base-binding.directive.d.ts +6 -3
  2. package/binding-directives/flat-binding.directive.d.ts +7 -8
  3. package/binding-directives/hierarchy-binding.directive.d.ts +13 -6
  4. package/column-menu/column-chooser.component.d.ts +5 -8
  5. package/column-menu/column-locked-change-event.d.ts +4 -2
  6. package/column-menu/column-menu-autosize-all.component.d.ts +3 -5
  7. package/column-menu/column-menu-autosize.component.d.ts +5 -7
  8. package/column-menu/column-menu-chooser.component.d.ts +15 -6
  9. package/column-menu/column-menu-expandable-item.interface.d.ts +4 -3
  10. package/column-menu/column-menu-filter.component.d.ts +14 -4
  11. package/column-menu/column-menu-item-base.d.ts +1 -1
  12. package/column-menu/column-menu-item-content-template.directive.d.ts +3 -5
  13. package/column-menu/column-menu-item.component.d.ts +7 -10
  14. package/column-menu/column-menu-item.directive.d.ts +23 -1
  15. package/column-menu/column-menu-lock.component.d.ts +14 -4
  16. package/column-menu/column-menu-settings.interface.d.ts +5 -5
  17. package/column-menu/column-menu-sort.component.d.ts +12 -2
  18. package/column-menu/column-menu-template.directive.d.ts +3 -5
  19. package/column-menu/column-menu.component.d.ts +14 -2
  20. package/column-menu/column-menu.service.d.ts +1 -2
  21. package/column-menu/column-visibility-change-event.d.ts +2 -2
  22. package/column-resizing/column-resize.interface.d.ts +3 -2
  23. package/columns/checkbox-column.component.d.ts +16 -4
  24. package/columns/column-base.d.ts +15 -28
  25. package/columns/column-group.component.d.ts +1 -2
  26. package/columns/column.component.d.ts +22 -18
  27. package/columns/command-column.component.d.ts +3 -4
  28. package/columns/rowreorder-column.component.d.ts +9 -1
  29. package/columns/sort-settings.d.ts +5 -23
  30. package/columns/span-column.component.d.ts +11 -16
  31. package/common/cell-click-event-args.interface.d.ts +4 -3
  32. package/common/create-form-group.d.ts +2 -1
  33. package/common/pager-settings.d.ts +7 -8
  34. package/common/remove-confirmation.d.ts +1 -1
  35. package/common/single-popup.service.d.ts +7 -6
  36. package/data/change-event-args.interface.d.ts +6 -7
  37. package/data/data-item.interface.d.ts +5 -5
  38. package/data/data.collection.d.ts +4 -3
  39. package/data/treelist-item.interface.d.ts +2 -2
  40. package/directives.d.ts +10 -9
  41. package/dragdrop/column-reorder-config.d.ts +3 -2
  42. package/dragdrop/column-reorder-event.d.ts +4 -6
  43. package/editing/add-command-tool.directive.d.ts +9 -12
  44. package/editing/add-command.directive.d.ts +5 -9
  45. package/editing/add-event-args.interface.d.ts +3 -2
  46. package/editing/cancel-command.directive.d.ts +5 -8
  47. package/editing/cancel-event-args.interface.d.ts +1 -1
  48. package/editing/cell-close-event.d.ts +5 -5
  49. package/editing/edit-command.directive.d.ts +5 -9
  50. package/editing/edit-event-args.interface.d.ts +4 -3
  51. package/editing/edit-template.directive.d.ts +2 -4
  52. package/editing/remove-command.directive.d.ts +5 -8
  53. package/editing/remove-event-args.interface.d.ts +3 -2
  54. package/editing/save-command.directive.d.ts +5 -8
  55. package/editing/save-event-args.interface.d.ts +4 -3
  56. package/editing-directives/create-form-group-args.interface.d.ts +1 -1
  57. package/editing-directives/edit-service.interface.d.ts +13 -5
  58. package/editing-directives/editing-directive-base.d.ts +3 -3
  59. package/editing-directives/in-cell-editing.directive.d.ts +12 -2
  60. package/editing-directives/reactive-editing.directive.d.ts +12 -2
  61. package/editing-directives/template-editing.directive.d.ts +13 -3
  62. package/esm2022/binding-directives/base-binding.directive.mjs +6 -3
  63. package/esm2022/binding-directives/flat-binding.directive.mjs +7 -8
  64. package/esm2022/binding-directives/hierarchy-binding.directive.mjs +13 -6
  65. package/esm2022/column-menu/column-chooser.component.mjs +5 -8
  66. package/esm2022/column-menu/column-locked-change-event.mjs +4 -2
  67. package/esm2022/column-menu/column-menu-autosize-all.component.mjs +3 -5
  68. package/esm2022/column-menu/column-menu-autosize.component.mjs +5 -7
  69. package/esm2022/column-menu/column-menu-chooser.component.mjs +15 -6
  70. package/esm2022/column-menu/column-menu-filter.component.mjs +14 -4
  71. package/esm2022/column-menu/column-menu-item-base.mjs +1 -1
  72. package/esm2022/column-menu/column-menu-item-content-template.directive.mjs +3 -5
  73. package/esm2022/column-menu/column-menu-item.component.mjs +7 -10
  74. package/esm2022/column-menu/column-menu-item.directive.mjs +23 -1
  75. package/esm2022/column-menu/column-menu-lock.component.mjs +14 -4
  76. package/esm2022/column-menu/column-menu-sort.component.mjs +12 -2
  77. package/esm2022/column-menu/column-menu-template.directive.mjs +3 -5
  78. package/esm2022/column-menu/column-menu.component.mjs +14 -2
  79. package/esm2022/column-menu/column-menu.service.mjs +1 -2
  80. package/esm2022/column-menu/column-visibility-change-event.mjs +2 -2
  81. package/esm2022/columns/checkbox-column.component.mjs +16 -4
  82. package/esm2022/columns/column-base.mjs +15 -28
  83. package/esm2022/columns/column-group.component.mjs +1 -2
  84. package/esm2022/columns/column.component.mjs +22 -18
  85. package/esm2022/columns/command-column.component.mjs +3 -4
  86. package/esm2022/columns/rowreorder-column.component.mjs +9 -1
  87. package/esm2022/columns/span-column.component.mjs +11 -16
  88. package/esm2022/common/single-popup.service.mjs +7 -6
  89. package/esm2022/directives.mjs +10 -9
  90. package/esm2022/dragdrop/column-reorder-event.mjs +4 -6
  91. package/esm2022/editing/add-command-tool.directive.mjs +9 -12
  92. package/esm2022/editing/add-command.directive.mjs +5 -9
  93. package/esm2022/editing/cancel-command.directive.mjs +5 -8
  94. package/esm2022/editing/cell-close-event.mjs +5 -5
  95. package/esm2022/editing/edit-command.directive.mjs +5 -9
  96. package/esm2022/editing/edit-template.directive.mjs +2 -4
  97. package/esm2022/editing/remove-command.directive.mjs +5 -8
  98. package/esm2022/editing/save-command.directive.mjs +5 -8
  99. package/esm2022/editing-directives/editing-directive-base.mjs +3 -3
  100. package/esm2022/editing-directives/in-cell-editing.directive.mjs +12 -2
  101. package/esm2022/editing-directives/reactive-editing.directive.mjs +12 -2
  102. package/esm2022/editing-directives/template-editing.directive.mjs +13 -3
  103. package/esm2022/excel/excel-command-tool.directive.mjs +9 -11
  104. package/esm2022/excel/excel-command.directive.mjs +3 -7
  105. package/esm2022/excel/excel.component.mjs +22 -16
  106. package/esm2022/excel/excel.module.mjs +2 -2
  107. package/esm2022/expand-state/expand-event.mjs +3 -3
  108. package/esm2022/expand-state/expandable.directive.mjs +8 -5
  109. package/esm2022/filtering/base-filter-cell.component.mjs +3 -1
  110. package/esm2022/filtering/cell/boolean-filter-cell.component.mjs +1 -0
  111. package/esm2022/filtering/cell/date-filter-cell.component.mjs +5 -3
  112. package/esm2022/filtering/cell/filter-cell-operators.component.mjs +2 -1
  113. package/esm2022/filtering/cell/filter-cell-template.directive.mjs +18 -3
  114. package/esm2022/filtering/cell/numeric-filter-cell.component.mjs +7 -5
  115. package/esm2022/filtering/cell/string-filter-cell.component.mjs +7 -7
  116. package/esm2022/filtering/date-filter.component.mjs +8 -3
  117. package/esm2022/filtering/filter.service.mjs +2 -4
  118. package/esm2022/filtering/menu/boolean-filter-menu.component.mjs +3 -3
  119. package/esm2022/filtering/menu/date-filter-menu.component.mjs +6 -3
  120. package/esm2022/filtering/menu/filter-menu-template.directive.mjs +18 -2
  121. package/esm2022/filtering/menu/numeric-filter-menu.component.mjs +9 -5
  122. package/esm2022/filtering/menu/string-filter-menu.component.mjs +6 -4
  123. package/esm2022/filtering/numeric-filter.component.mjs +3 -3
  124. package/esm2022/filtering/operators/after-eq-filter-operator.component.mjs +27 -1
  125. package/esm2022/filtering/operators/after-filter-operator.component.mjs +27 -1
  126. package/esm2022/filtering/operators/before-eq-filter-operator.component.mjs +27 -1
  127. package/esm2022/filtering/operators/before-filter-operator.component.mjs +27 -1
  128. package/esm2022/filtering/operators/contains-filter-operator.component.mjs +28 -1
  129. package/esm2022/filtering/operators/ends-with-filter-operator.component.mjs +28 -1
  130. package/esm2022/filtering/operators/eq-filter-operator.component.mjs +76 -1
  131. package/esm2022/filtering/operators/filter-operator.base.mjs +1 -1
  132. package/esm2022/filtering/operators/gt-filter-operator.component.mjs +28 -2
  133. package/esm2022/filtering/operators/gte-filter-operator.component.mjs +27 -1
  134. package/esm2022/filtering/operators/is-empty-filter-operator.component.mjs +28 -1
  135. package/esm2022/filtering/operators/is-not-empty-filter-operator.component.mjs +28 -1
  136. package/esm2022/filtering/operators/is-not-null-filter-operator.component.mjs +76 -1
  137. package/esm2022/filtering/operators/isnull-filter-operator.component.mjs +76 -1
  138. package/esm2022/filtering/operators/lt-filter-operator.component.mjs +27 -1
  139. package/esm2022/filtering/operators/lte-filter-operator.component.mjs +28 -2
  140. package/esm2022/filtering/operators/neq-filter-operator.component.mjs +76 -1
  141. package/esm2022/filtering/operators/not-contains-filter-operator.component.mjs +28 -1
  142. package/esm2022/filtering/operators/starts-with-filter-operator.component.mjs +28 -1
  143. package/esm2022/filtering/string-filter.component.mjs +1 -1
  144. package/esm2022/localization/custom-messages.component.mjs +11 -2
  145. package/esm2022/navigation/focusable.directive.mjs +4 -4
  146. package/esm2022/package-metadata.mjs +2 -2
  147. package/esm2022/pdf/pdf-command-tool.directive.mjs +11 -9
  148. package/esm2022/pdf/pdf-command.directive.mjs +2 -2
  149. package/esm2022/pdf/pdf-export-event.mjs +3 -1
  150. package/esm2022/pdf/pdf-margin.component.mjs +10 -5
  151. package/esm2022/pdf/pdf-template.directive.mjs +2 -2
  152. package/esm2022/pdf/pdf.component.mjs +12 -2
  153. package/esm2022/pdf/pdf.module.mjs +6 -6
  154. package/esm2022/rendering/cell-template.directive.mjs +8 -9
  155. package/esm2022/rendering/common/spacer.component.mjs +16 -5
  156. package/esm2022/rendering/footer-template.directive.mjs +10 -12
  157. package/esm2022/rendering/header/header-template.directive.mjs +4 -4
  158. package/esm2022/rendering/no-records-template.directive.mjs +2 -2
  159. package/esm2022/rendering/toolbar/toolbar-focusable.directive.mjs +13 -2
  160. package/esm2022/rendering/toolbar/toolbar-template.directive.mjs +4 -6
  161. package/esm2022/selection/selectable.directive.mjs +12 -0
  162. package/esm2022/selection/selection-change-event.mjs +1 -1
  163. package/esm2022/treelist.component.mjs +145 -109
  164. package/esm2022/treelist.module.mjs +6 -8
  165. package/esm2022/utils.mjs +1 -1
  166. package/excel/excel-command-tool.directive.d.ts +9 -11
  167. package/excel/excel-command.directive.d.ts +3 -7
  168. package/excel/excel-export-data.interface.d.ts +4 -4
  169. package/excel/excel.component.d.ts +22 -16
  170. package/excel/excel.module.d.ts +2 -2
  171. package/expand-state/expand-event.d.ts +3 -3
  172. package/expand-state/expandable-tree-component.d.ts +4 -6
  173. package/expand-state/expandable.directive.d.ts +8 -5
  174. package/fesm2022/progress-kendo-angular-treelist.mjs +1470 -574
  175. package/filtering/base-filter-cell.component.d.ts +3 -1
  176. package/filtering/cell/boolean-filter-cell.component.d.ts +1 -0
  177. package/filtering/cell/date-filter-cell.component.d.ts +5 -3
  178. package/filtering/cell/filter-cell-operators.component.d.ts +2 -1
  179. package/filtering/cell/filter-cell-template.directive.d.ts +18 -3
  180. package/filtering/cell/numeric-filter-cell.component.d.ts +7 -5
  181. package/filtering/cell/string-filter-cell.component.d.ts +7 -7
  182. package/filtering/date-filter.component.d.ts +8 -3
  183. package/filtering/filter.service.d.ts +2 -4
  184. package/filtering/filterable.d.ts +3 -2
  185. package/filtering/menu/boolean-filter-menu.component.d.ts +3 -3
  186. package/filtering/menu/date-filter-menu.component.d.ts +6 -3
  187. package/filtering/menu/filter-menu-template.directive.d.ts +18 -2
  188. package/filtering/menu/numeric-filter-menu.component.d.ts +9 -5
  189. package/filtering/menu/string-filter-menu.component.d.ts +6 -4
  190. package/filtering/numeric-filter.component.d.ts +3 -3
  191. package/filtering/operators/after-eq-filter-operator.component.d.ts +27 -1
  192. package/filtering/operators/after-filter-operator.component.d.ts +27 -1
  193. package/filtering/operators/before-eq-filter-operator.component.d.ts +27 -1
  194. package/filtering/operators/before-filter-operator.component.d.ts +27 -1
  195. package/filtering/operators/contains-filter-operator.component.d.ts +28 -1
  196. package/filtering/operators/ends-with-filter-operator.component.d.ts +28 -1
  197. package/filtering/operators/eq-filter-operator.component.d.ts +76 -1
  198. package/filtering/operators/filter-operator.base.d.ts +1 -1
  199. package/filtering/operators/gt-filter-operator.component.d.ts +30 -0
  200. package/filtering/operators/gte-filter-operator.component.d.ts +27 -1
  201. package/filtering/operators/is-empty-filter-operator.component.d.ts +28 -1
  202. package/filtering/operators/is-not-empty-filter-operator.component.d.ts +28 -1
  203. package/filtering/operators/is-not-null-filter-operator.component.d.ts +76 -1
  204. package/filtering/operators/isnull-filter-operator.component.d.ts +76 -1
  205. package/filtering/operators/lt-filter-operator.component.d.ts +27 -1
  206. package/filtering/operators/lte-filter-operator.component.d.ts +30 -0
  207. package/filtering/operators/neq-filter-operator.component.d.ts +76 -1
  208. package/filtering/operators/not-contains-filter-operator.component.d.ts +28 -1
  209. package/filtering/operators/starts-with-filter-operator.component.d.ts +28 -1
  210. package/filtering/string-filter.component.d.ts +1 -1
  211. package/localization/custom-messages.component.d.ts +11 -2
  212. package/navigation/focusable-element.interface.d.ts +7 -11
  213. package/navigation/focusable.directive.d.ts +4 -4
  214. package/navigation/navigation-cell.interface.d.ts +5 -5
  215. package/navigation/navigation-row.interface.d.ts +4 -5
  216. package/package.json +18 -18
  217. package/pdf/pdf-command-tool.directive.d.ts +11 -9
  218. package/pdf/pdf-command.directive.d.ts +2 -2
  219. package/pdf/pdf-export-event.d.ts +3 -1
  220. package/pdf/pdf-margin.component.d.ts +10 -5
  221. package/pdf/pdf-margin.interface.d.ts +1 -1
  222. package/pdf/pdf-template.directive.d.ts +2 -2
  223. package/pdf/pdf.component.d.ts +12 -2
  224. package/pdf/pdf.module.d.ts +6 -6
  225. package/rendering/cell-template.directive.d.ts +8 -9
  226. package/rendering/common/row-class.d.ts +4 -7
  227. package/rendering/common/spacer.component.d.ts +16 -5
  228. package/rendering/footer-template.directive.d.ts +10 -12
  229. package/rendering/header/header-template.directive.d.ts +4 -4
  230. package/rendering/no-records-template.directive.d.ts +2 -2
  231. package/rendering/toolbar/toolbar-focusable.directive.d.ts +13 -2
  232. package/rendering/toolbar/toolbar-template.directive.d.ts +4 -6
  233. package/row-reordering/types.d.ts +4 -1
  234. package/schematics/ngAdd/index.js +3 -3
  235. package/scrolling/content-scroll-event.d.ts +2 -0
  236. package/scrolling/scroll-bottom-event.d.ts +2 -0
  237. package/scrolling/scroll-request.service.d.ts +3 -3
  238. package/scrolling/scrollmode.d.ts +3 -3
  239. package/selection/is-selected.d.ts +5 -4
  240. package/selection/selectable-settings.d.ts +6 -6
  241. package/selection/selectable.directive.d.ts +12 -0
  242. package/selection/selection-change-event.d.ts +2 -2
  243. package/treelist.component.d.ts +143 -107
  244. package/treelist.module.d.ts +6 -8
@@ -15,18 +15,17 @@ import * as i1 from "./data-bound-tree-component";
15
15
  import * as i2 from "../row-reordering/row-reorder.service";
16
16
  const ROOT_ID = null;
17
17
  /**
18
- * A directive which binds the TreeList to an array of objects by using
19
- * an `idField` and `parentIDField` field to define the hierarchy.
18
+ * Represents the Kendo for Angular UI TreeList flat binding directive.
19
+ * Use this directive to bind the TreeList to a flat array of objects using `idField` and `parentIdField` to define the hierarchy.
20
+ * Handles in-memory data operations [sorting]({% slug sorting_treelist %}), [aggregation]({% slug treelist_with_aggregates %})
21
+ * and [filtering]({% slug filtering_treelist %}). [More information and examples]({% slug databinding_treelist %}).
20
22
  *
21
- * The directive encapsulates the in-memory handling of data operations such as
22
- * [sorting]({% slug sorting_treelist %}), [aggregation]({% slug treelist_with_aggregates %})
23
- * and [filtering]({% slug filtering_treelist %}) ([more information and examples]({% slug databinding_treelist %})).
24
23
  */
25
24
  export class FlatBindingDirective extends BaseBindingDirective {
26
25
  component;
27
26
  rowReorderService;
28
27
  /**
29
- * The name of the field which contains the identifier of the parent node.
28
+ * Sets the name of the field that contains the identifier of the parent node.
30
29
  */
31
30
  set parentIdField(value) {
32
31
  this.parentIdGetter = getter(value);
@@ -37,7 +36,7 @@ export class FlatBindingDirective extends BaseBindingDirective {
37
36
  return this._parentIdField;
38
37
  }
39
38
  /**
40
- * The name of the field which contains the unique identifier of the node.
39
+ * Sets the name of the field that contains the unique identifier of the node.
41
40
  */
42
41
  set idField(value) {
43
42
  this.idGetter = getter(value);
@@ -48,7 +47,7 @@ export class FlatBindingDirective extends BaseBindingDirective {
48
47
  return this._idField;
49
48
  }
50
49
  /**
51
- * The array of data which will be used to populate the TreeList.
50
+ * Sets the array of data that populates the TreeList.
52
51
  */
53
52
  data;
54
53
  idGetter = getter('id');
@@ -13,17 +13,24 @@ import * as i0 from "@angular/core";
13
13
  import * as i1 from "./data-bound-tree-component";
14
14
  import * as i2 from "../row-reordering/row-reorder.service";
15
15
  /**
16
- * A directive which binds the TreeList to a tree of objects.
16
+ * Represents the Kendo UI for Angular TreeList hierarchy binding directive.
17
+ * Use this directive to bind the TreeList to a tree of objects using a field that holds child data items.
18
+ * Handles in-memory data operations [sorting]({% slug sorting_treelist %}), [aggregation]({% slug treelist_with_aggregates %})
19
+ * and [filtering]({% slug filtering_treelist %}). [More information and examples.](slug:local_databinding_treelist#toc-binding-to-hierarchical-data-1)
17
20
  *
18
- * The directive encapsulates the in-memory handling of data operations such as
19
- * [sorting]({% slug sorting_treelist %}), [aggregation]({% slug treelist_with_aggregates %})
20
- * and [filtering]({% slug filtering_treelist %}) ([more information and examples](slug:local_databinding_treelist#toc-binding-to-hierarchical-data-1)).
21
+ * @example
22
+ * ```html
23
+ * <kendo-treelist [kendoTreeListHierarchyBinding]="data" [children]="childrenField"></kendo-treelist>
24
+ * ```
25
+ *
26
+ * @remarks
27
+ * Applied to: {@link TreeListComponent}.
21
28
  */
22
29
  export class HierarchyBindingDirective extends BaseBindingDirective {
23
30
  component;
24
31
  rowReorderService;
25
32
  /**
26
- * The name of the field which holds the child data items of the node.
33
+ * Sets the name of the field that holds the child data items of the node.
27
34
  */
28
35
  set childrenField(value) {
29
36
  this.childrenGetter = getter(value);
@@ -34,7 +41,7 @@ export class HierarchyBindingDirective extends BaseBindingDirective {
34
41
  return this._childrenField;
35
42
  }
36
43
  /**
37
- * The array of data which will be used to populate the TreeList.
44
+ * Sets the array of data that populates the TreeList.
38
45
  */
39
46
  data;
40
47
  childrenGetter = getter('items');
@@ -16,15 +16,14 @@ import * as i1 from "@progress/kendo-angular-l10n";
16
16
  import * as i2 from "../common/column-info.service";
17
17
  import * as i3 from "@progress/kendo-angular-popup";
18
18
  /**
19
- * Represents the component for selecting columns in the TreeList.
20
- * To show and hide the columns without including the column chooser item in the [Column Menu](slug:columnmenu_treelist),
21
- * add the component inside the [`ToolbarTemplate`]({% slug api_treelist_toolbartemplatedirective %}) directive.
19
+ * Represents the Kendo UI for Angular TreeList column chooser component.
20
+ * Use this component to let users show or hide columns in the TreeList. To display the column chooser outside the Column Menu, add it inside the [`ToolbarTemplate`]({% slug api_treelist_toolbartemplatedirective %}) directive.
22
21
  *
23
22
  * @example
24
23
  * ```html
25
24
  * <kendo-treelist ...>
26
- * <ng-template kendoTreeListToolbarTemplate>
27
- * <kendo-treelist-column-chooser> </kendo-treelist-column-chooser>
25
+ * <ng-template kendoTreeListColumnMenuTemplate>
26
+ * <kendo-treelist-column-chooser></kendo-treelist-column-chooser>
28
27
  * </ng-template>
29
28
  * </kendo-treelist>
30
29
  * ```
@@ -37,14 +36,12 @@ export class ColumnChooserComponent {
37
36
  renderer;
38
37
  changeDetector;
39
38
  /**
40
- * Specifies if the changes in the visibility of the column will be immediately applied.
41
- *
39
+ * Specifies if changes in column visibility are applied immediately.
42
40
  * @default false
43
41
  */
44
42
  autoSync = false;
45
43
  /**
46
44
  * Specifies if all columns can be hidden.
47
- *
48
45
  * @default true
49
46
  */
50
47
  allowHideAll = true;
@@ -3,11 +3,13 @@
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  /**
6
- * Arguments for the `columnLockedChange` event.
6
+ * Represents the event arguments for the `columnLockedChange` event in the Kendo UI for Angular TreeList.
7
+ * Use this event to access the columns whose locked state has changed.
8
+ *
7
9
  */
8
10
  export class ColumnLockedChangeEvent {
9
11
  /**
10
- * The columns whose locked state is changed.
12
+ * The array of columns whose locked state has changed.
11
13
  */
12
14
  columns;
13
15
  /**
@@ -13,12 +13,10 @@ import { NgIf } from '@angular/common';
13
13
  import * as i0 from "@angular/core";
14
14
  import * as i1 from "../common/provider.service";
15
15
  /**
16
- * Represents the column-menu item for resizing all columns to the minimum possible width so that they fit the widest header or cell content without wrapping.
17
- * [See example](slug:columnmenu_treelist#toc-autosize-all-columns-item).
16
+ * Represents the Kendo UI TreeList column-menu item for resizing all columns to fit the widest header or cell content without wrapping. [See example](slug:columnmenu_treelist#toc-autosize-all-columns-item).
18
17
  *
19
- * The component can be placed inside a [ColumnMenuTemplate]({% slug api_treelist_columnmenutemplatedirective %}) directive.
20
- * To register the component as a known column menu item, set the [ColumnMenuService]({% slug api_treelist_columnmenuservice %}) that is passed by
21
- * the template to the `service` input of the `kendo-treelist-columnmenu-autosize-all-columns` component. [See example](slug:columnmenu_treelist#toc-customizing-the-content).
18
+ * Place this component inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive to enable the feature.
19
+ * Register the component as a known column menu item by setting the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %}) to the `service` input. [See example](slug:columnmenu_treelist#toc-customizing-the-content).
22
20
  *
23
21
  * @example
24
22
  * ```html
@@ -13,12 +13,10 @@ import { ColumnMenuErrorMessages } from '../common/error-messages';
13
13
  import * as i0 from "@angular/core";
14
14
  import * as i1 from "../common/provider.service";
15
15
  /**
16
- * Represents the column-menu item for resizing the specified column to the minimum possible width so that it fits the header or cell content without wrapping.
17
- * The component can be placed inside a [ColumnMenuTemplate]({% slug api_treelist_columnmenutemplatedirective %}) directive.
18
- * [See example](slug:columnmenu_treelist#toc-customizing-the-content).
16
+ * Represents the Kendo UI for Angular TreeList column-menu item for resizing a specified column to fit the header or cell content without wrapping. [See example](slug:columnmenu_treelist#toc-customizing-the-content).
19
17
  *
20
- * You have to set the [ColumnMenuService]({% slug api_treelist_columnmenuservice %}) and `column` that are passed by
21
- * the template to the `service` and `column` input of the `kendo-treelist-columnmenu-autosize-column` component.
18
+ * Place this component inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive to enable the feature.
19
+ * Set the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %}) and `column` inputs using the values passed by the template.
22
20
  *
23
21
  * @example
24
22
  * ```html
@@ -33,7 +31,7 @@ import * as i1 from "../common/provider.service";
33
31
  export class ColumnMenuAutoSizeColumnComponent extends ColumnMenuItemBase {
34
32
  ctx;
35
33
  /**
36
- * The TreeList column instance which will be resized through the auto size column option.
34
+ * The TreeList column instance to resize with the auto size column option.
37
35
  */
38
36
  column;
39
37
  maxWidthIcon = maxWidthIcon;
@@ -48,7 +46,7 @@ export class ColumnMenuAutoSizeColumnComponent extends ColumnMenuItemBase {
48
46
  }
49
47
  }
50
48
  /**
51
- * Resizes a specified column to the minimum possible width so that it fits the widest header or cell content without wrapping.
49
+ * Resizes the specified column to the minimum possible width so that it fits the widest header or cell content without wrapping.
52
50
  */
53
51
  autoSizeColumn() {
54
52
  autoSizeColumn(this.ctx.treelist, this.service, this.column);
@@ -14,12 +14,21 @@ import * as i0 from "@angular/core";
14
14
  import * as i1 from "@progress/kendo-angular-l10n";
15
15
  import * as i2 from "../common/column-info.service";
16
16
  /**
17
- * Represents the column-menu item for selecting columns in the TreeList. [See example](slug:columnmenu_treelist#toc-column-chooser-item).
18
17
  *
19
- * The component can be placed inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
18
+ * Represents the Kendo UI for Angular TreeList column-menu item for chaging the visibility of the columns. [See example](slug:columnmenu_treelist#toc-column-chooser-item).
20
19
  *
21
- * To register the component as a known column menu item, set the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %})
22
- * that is passed by the template to the service input of the `kendo-treelist-columnmenu-chooser` component.
20
+ * Place this component inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive to enable the feature.
21
+ * Set the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %}) and `column` inputs using the values passed by the template.
22
+ *
23
+ * @example
24
+ * ```html
25
+ * <kendo-treelist [columnMenu]="true" ...>
26
+ * <ng-template kendoTreeListColumnMenuTemplate let-service="service" let-column="column">
27
+ * <kendo-treelist-columnmenu-chooser [column]="column" [service]="service">
28
+ * </kendo-treelist-columnmenu-chooser>
29
+ * </ng-template>
30
+ * </kendo-treelist>
31
+ * ```
23
32
  */
24
33
  export class ColumnMenuChooserComponent extends ColumnMenuItemBase {
25
34
  localization;
@@ -27,11 +36,11 @@ export class ColumnMenuChooserComponent extends ColumnMenuItemBase {
27
36
  changeDetector;
28
37
  hostElement;
29
38
  /**
30
- * Fires when the content is expanded.
39
+ * Fires when the content expands.
31
40
  */
32
41
  expand = new EventEmitter();
33
42
  /**
34
- * Fires when the content is collapsed.
43
+ * Fires when the content collapses.
35
44
  */
36
45
  collapse = new EventEmitter();
37
46
  /**
@@ -14,21 +14,31 @@ import * as i1 from "@progress/kendo-angular-l10n";
14
14
  /**
15
15
  * Represents the column-menu item for editing column filters in the TreeList.
16
16
  *
17
- * The component can be placed inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
17
+ * Render this component inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
18
18
  *
19
19
  * To register the component as a known column menu item, set the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %})
20
- * that is passed by the template to the service input of the `kendo-treelist-columnmenu-filter` component.
20
+ * that the template passes to the `service` input of the `kendo-treelist-columnmenu-filter` component.
21
21
  *
22
+ * @example
23
+ * ```html
24
+ * <kendo-treelist ...>
25
+ * <kendo-treelist-column field="ProductName">
26
+ * <ng-template kendoTreeListColumnMenuTemplate>
27
+ * <kendo-treelist-columnmenu-filter></kendo-treelist-columnmenu-filter>
28
+ * </ng-template>
29
+ * </kendo-treelist-column>
30
+ * </kendo-treelist>
31
+ * ```
22
32
  */
23
33
  export class ColumnMenuFilterComponent extends ColumnMenuItemBase {
24
34
  localization;
25
35
  hostElement;
26
36
  /**
27
- * Fires when the content is expanded.
37
+ * Fires when the content expands.
28
38
  */
29
39
  expand = new EventEmitter();
30
40
  /**
31
- * Fires when the content is collapsed.
41
+ * Fires when the content collapses.
32
42
  */
33
43
  collapse = new EventEmitter();
34
44
  /**
@@ -11,7 +11,7 @@ import * as i0 from "@angular/core";
11
11
  */
12
12
  export class ColumnMenuItemBase {
13
13
  /**
14
- * Represents the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %}) class.
14
+ * Represents the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %}) instance.
15
15
  * Requires a mandatory input.
16
16
  */
17
17
  service;
@@ -5,11 +5,9 @@
5
5
  import { Directive, Optional, TemplateRef } from '@angular/core';
6
6
  import * as i0 from "@angular/core";
7
7
  /**
8
- * Represents the content template of the
9
- * [`kendo-treelist-columnmenu-item`]({% slug api_treelist_columnmenuitemcomponent %}) component.
10
- * Provides an option for specifying the content of a column item.
11
- * To define the content template, nest an `<ng-template>` tag with the
12
- * `kendoTreeListColumnMenuItemContentTemplate` directive inside a `<kendo-treelist-columnmenu-item>`.
8
+ * Represents the content template for the [`kendo-treelist-columnmenu-item`]({% slug api_treelist_columnmenuitemcomponent %}) component.
9
+ * Use this directive to specify the content of a column menu item.
10
+ * To define the content template, nest an `<ng-template>` tag with the `kendoTreeListColumnMenuItemContentTemplate` directive inside a `<kendo-treelist-columnmenu-item>`.
13
11
  *
14
12
  * @example
15
13
  * ```html
@@ -12,8 +12,7 @@ import { ColumnMenuService } from './column-menu.service';
12
12
  import { guid } from '@progress/kendo-angular-common';
13
13
  import * as i0 from "@angular/core";
14
14
  /**
15
- * Represents an item that can be placed inside a
16
- * [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
15
+ * Represents an item you can place inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
17
16
  *
18
17
  * @example
19
18
  * ```html
@@ -30,25 +29,23 @@ export class ColumnMenuItemComponent {
30
29
  */
31
30
  itemClick = new EventEmitter();
32
31
  /**
33
- * Fires when the content is expanded.
32
+ * Fires when the content expands.
34
33
  */
35
34
  expand = new EventEmitter();
36
35
  /**
37
- * Fires when the content is collapsed.
36
+ * Fires when the content collapses.
38
37
  */
39
38
  collapse = new EventEmitter();
40
39
  /**
41
- * Specifies the name of the [font icon](slug:icons#icons-list)
42
- * that will be rendered for the item.
40
+ * Sets the name of the [font icon](slug:icons#icons-list) rendered for the item.
43
41
  */
44
42
  icon;
45
43
  /**
46
- * Specifies the name of the [SVG icon]({% slug svgicon_list %})
47
- * that will be rendered for the item.
44
+ * Sets the name of the [SVG icon]({% slug svgicon_list %}) rendered for the item.
48
45
  */
49
46
  svgIcon;
50
47
  /**
51
- * Specifies the item text.
48
+ * Sets the item text.
52
49
  */
53
50
  text;
54
51
  /**
@@ -64,7 +61,7 @@ export class ColumnMenuItemComponent {
64
61
  */
65
62
  expanded;
66
63
  /**
67
- * Represents the [ColumnMenuService]({% slug api_treelist_columnmenuservice %}) class.
64
+ * Provides the [ColumnMenuService]({% slug api_treelist_columnmenuservice %}) instance.
68
65
  * Required to include the item in the column menu keyboard navigation sequence.
69
66
  */
70
67
  service;
@@ -8,12 +8,34 @@ import { Keys } from '@progress/kendo-angular-common';
8
8
  import { ColumnMenuChooserComponent } from './column-menu-chooser.component';
9
9
  import { ColumnMenuFilterComponent } from './column-menu-filter.component';
10
10
  import * as i0 from "@angular/core";
11
+ /**
12
+ * Provides keyboard navigation support for TreeList column menu items.
13
+ * Use this directive to manage focus and tab order for custom column menu items. [See example](slug:columnmenu_treelist#customizing-the-content).
14
+ *
15
+ * @example
16
+ * ```html
17
+ * <ng-template kendoTreelistColumnMenuTemplate let-service="service" let-column="column">
18
+ * <kendo-treelist-columnmenu-sort #sortItem [kendoTreeListColumnMenuItem]="sortItem" [service]="service">
19
+ * </kendo-treelist-columnmenu-sort>
20
+ * </ng-template>
21
+ * ```
22
+ * @remarks
23
+ * Applied to:
24
+ * {@link ColumnMenuChooserComponent},
25
+ * {@link ColumnMenuFilterComponent},
26
+ * {@link ColumnMenuSortComponent},
27
+ * {@link ColumnMenuLockComponent},
28
+ * {@link ColumnMenuComponent},
29
+ * {@link ColumnMenuItemComponent},
30
+ * {@link ColumnMenuAutoSizeAllColumnsComponent},
31
+ * {@link ColumnMenuAutoSizeColumnComponent}.
32
+ */
11
33
  export class ColumnMenuItemDirective {
12
34
  hostElement;
13
35
  renderer;
14
36
  ngZone;
15
37
  /**
16
- * The reference to the TreeList column menu item. Required to include the item in the built-in keyboard navigation.
38
+ * Provides a reference to the TreeList column menu item. Required for built-in keyboard navigation.
17
39
  */
18
40
  menuItemComponent;
19
41
  firstFocusableElement;
@@ -12,13 +12,23 @@ import * as i0 from "@angular/core";
12
12
  import * as i1 from "@progress/kendo-angular-l10n";
13
13
  import * as i2 from "../common/column-info.service";
14
14
  /**
15
- * Represents the column-menu item that allows the user to lock or unlock columns.
15
+ * Represents the column-menu item that lets you lock or unlock columns.
16
16
  *
17
- * The componnt can be placed inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
17
+ * Render this component inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
18
18
  *
19
- * To register the component as a known column menu item, set the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %})
20
- * that is passed by the template to the service input of the `kendo-treelist-columnmenu-lock` component.
19
+ * To register the component as a known column menu item, set the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %})
20
+ * that the template passes to the `service` input of the `kendo-treelist-columnmenu-lock` component.
21
21
  *
22
+ * @example
23
+ * ```html
24
+ * <kendo-treelist ...>
25
+ * <kendo-treelist-column field="ProductName">
26
+ * <ng-template kendoTreeListColumnMenuTemplate>
27
+ * <kendo-treelist-columnmenu-lock></kendo-treelist-columnmenu-lock>
28
+ * </ng-template>
29
+ * </kendo-treelist-column>
30
+ * </kendo-treelist>
31
+ * ```
22
32
  */
23
33
  export class ColumnMenuLockComponent extends ColumnMenuItemBase {
24
34
  localization;
@@ -15,11 +15,21 @@ import * as i2 from "../common/sort.service";
15
15
  /**
16
16
  * Represents the column-menu item for sorting TreeList columns.
17
17
  *
18
- * The component can be placed inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
18
+ * Render this component inside a [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
19
19
  *
20
20
  * To register the component as a known column menu item, set the [`ColumnMenuService`]({% slug api_treelist_columnmenuservice %})
21
- * that is passed by the template to the service input of the `kendo-treelist-columnmenu-sort` component.
21
+ * that the template passes to the `service` input of the `kendo-treelist-columnmenu-sort` component.
22
22
  *
23
+ * @example
24
+ * ```html
25
+ * <kendo-treelist ...>
26
+ * <kendo-treelist-column field="ProductName">
27
+ * <ng-template kendoTreeListColumnMenuTemplate>
28
+ * <kendo-treelist-columnmenu-sort></kendo-treelist-columnmenu-sort>
29
+ * </ng-template>
30
+ * </kendo-treelist-column>
31
+ * </kendo-treelist>
32
+ * ```
23
33
  */
24
34
  export class ColumnMenuSortComponent extends ColumnMenuItemBase {
25
35
  localization;
@@ -5,12 +5,10 @@
5
5
  import { Directive, Optional, TemplateRef } from '@angular/core';
6
6
  import * as i0 from "@angular/core";
7
7
  /**
8
- * Represents the template for the column menu in the TreeList. Provides an option for
9
- * customizing the content of the column menu for all or for specific columns.
10
- * To define the content template, nest an `<ng-template>` tag with the
11
- * `kendoTreeListColumnMenuTemplate` directive inside the `kendo-treelist` or the `<kendo-treelist-column>` component.
8
+ * Represents the template for the column menu in the TreeList. Use this directive to customize the content of the column menu for all or specific columns.
9
+ * To define the content template, nest an `<ng-template>` tag with the `kendoTreeListColumnMenuTemplate` directive inside the `kendo-treelist` or the `<kendo-treelist-column>` component.
12
10
  *
13
- * The template context is passes through the following fields:
11
+ * The template context is passed through the following fields:
14
12
  * - `service`&mdash;Represents the [ColumnMenuService]({% slug api_treelist_columnmenuservice %}).
15
13
  * - `column`&mdash;Represents the TreeList column.
16
14
  *
@@ -36,6 +36,18 @@ let id = 0;
36
36
  const getId = (gridId) => `${gridId}-column-menu-${id++}`;
37
37
  /**
38
38
  * Represents the [column menu]({% slug columnmenu_treelist %}) component of the TreeList.
39
+ * Use this component to display and manage column menu options for a TreeList column.
40
+ *
41
+ * @example
42
+ * ```html
43
+ * <kendo-treelist ...>
44
+ * <kendo-treelist-column field="ProductName">
45
+ * <ng-template kendoTreeListColumnMenuTemplate let-service="service" let-column="column">
46
+ * <kendo-treelist-column-menu [column]="column"></kendo-treelist-column-menu>
47
+ * </ng-template>
48
+ * </kendo-treelist-column>
49
+ * </kendo-treelist>
50
+ * ```
39
51
  */
40
52
  export class ColumnMenuComponent {
41
53
  navigationService;
@@ -61,12 +73,12 @@ export class ColumnMenuComponent {
61
73
  */
62
74
  settings = {};
63
75
  /**
64
- * The descriptors by which the data will be sorted.
76
+ * The descriptors by which the data is sorted.
65
77
  * Typically bound to the same value as [TreeListComponent.sort]({% slug api_treelist_treelistcomponent %}#toc-sort).
66
78
  */
67
79
  sort;
68
80
  /**
69
- * The descriptor by which the data will be filtered.
81
+ * The descriptor by which the data is filtered.
70
82
  * Typically bound to the same value as [TreeListComponent.filter]({% slug api_treelist_treelistcomponent %}#toc-filter).
71
83
  */
72
84
  filter;
@@ -7,8 +7,7 @@ import { MenuTabbingService } from '../filtering/menu/menu-tabbing.service';
7
7
  import * as i0 from "@angular/core";
8
8
  import * as i1 from "../filtering/menu/menu-tabbing.service";
9
9
  /**
10
- * Represents the service that is passed to the
11
- * [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
10
+ * Represents the service passed to the [`ColumnMenuTemplate`]({% slug api_treelist_columnmenutemplatedirective %}) directive.
12
11
  *
13
12
  * @example
14
13
  * ```html
@@ -3,11 +3,11 @@
3
3
  * Licensed under commercial license. See LICENSE.md in the project root for more information
4
4
  *-------------------------------------------------------------------------------------------*/
5
5
  /**
6
- * Arguments for the `columnVisibilityChange` event.
6
+ * Represents the arguments for the `columnVisibilityChange` event.
7
7
  */
8
8
  export class ColumnVisibilityChangeEvent {
9
9
  /**
10
- * The columns whose visibility is changed.
10
+ * Contains the columns whose visibility changes.
11
11
  */
12
12
  columns;
13
13
  /**
@@ -8,20 +8,32 @@ import { CellTemplateDirective } from '../rendering/cell-template.directive';
8
8
  import * as i0 from "@angular/core";
9
9
  import * as i1 from "./column-base";
10
10
  /**
11
- * Represents the checkbox for selecting rows in the TreeList. [See example](slug:treelist_row_selection#toc-select-all-checkbox).
11
+ * Represents the checkbox column for selecting rows in the TreeList. [See example](slug:treelist_row_selection#toc-select-all-checkbox).
12
+ *
13
+ * @example
14
+ * ```html
15
+ * <kendo-treelist ...>
16
+ * <kendo-treelist-checkbox-column
17
+ * [showSelectAll]="true"
18
+ * [checkChildren]="true"
19
+ * [expandable]="true">
20
+ * </kendo-treelist-checkbox-column>
21
+ * <kendo-treelist-column field="ProductName" title="Product Name"></kendo-treelist-column>
22
+ * </kendo-treelist>
23
+ * ```
12
24
  */
13
25
  export class CheckboxColumnComponent extends ColumnBase {
14
26
  parent;
15
27
  /**
16
- * Determines whether a select-all checkbox will be displayed in the header.
28
+ * Specifies if a select-all checkbox appears in the header.
17
29
  */
18
30
  showSelectAll;
19
31
  /**
20
- * Determines whether checkbox click should select / unselect all children
32
+ * Specifies if clicking the checkbox selects or deselects all children.
21
33
  */
22
34
  checkChildren;
23
35
  /**
24
- * Defines whether the expanded indicator should be rendered in the column.
36
+ * Specifies if the expanded indicator appears in the column.
25
37
  * @default false
26
38
  */
27
39
  expandable;