@progress/kendo-angular-dropdowns 19.1.1 → 19.1.2-develop.2

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 (62) hide show
  1. package/autocomplete/autocomplete.component.d.ts +62 -53
  2. package/autocomplete/autocomplete.module.d.ts +9 -1
  3. package/comboboxes/combobox-column/column-cell-template.directive.d.ts +6 -6
  4. package/comboboxes/combobox-column/column-header-template.directive.d.ts +5 -4
  5. package/comboboxes/combobox-column/combobox-column.component.d.ts +21 -17
  6. package/comboboxes/combobox-column/util.d.ts +7 -4
  7. package/comboboxes/combobox.component.d.ts +28 -45
  8. package/comboboxes/combobox.module.d.ts +11 -2
  9. package/comboboxes/multicolumncombobox.component.d.ts +12 -2
  10. package/dropdownlist/dropdownlist.component.d.ts +53 -75
  11. package/dropdownlist/dropdownlist.module.d.ts +29 -11
  12. package/dropdowns.module.d.ts +8 -20
  13. package/dropdowntrees/checked-state/base-check.directive.d.ts +4 -7
  14. package/dropdowntrees/checked-state/check-all.directive.d.ts +4 -7
  15. package/dropdowntrees/checked-state/check.directive.d.ts +6 -10
  16. package/dropdowntrees/checked-state/checkable-settings.d.ts +2 -4
  17. package/dropdowntrees/checked-state/checked-item.d.ts +2 -2
  18. package/dropdowntrees/data-binding/dropdowntree/flat-binding.directive.d.ts +3 -3
  19. package/dropdowntrees/data-binding/dropdowntree/hierarchy-binding.directive.d.ts +2 -2
  20. package/dropdowntrees/data-binding/multiselecttree/flat-binding.directive.d.ts +3 -3
  21. package/dropdowntrees/data-binding/multiselecttree/hierarchy-binding.directive.d.ts +2 -2
  22. package/dropdowntrees/dropdowntree.component.d.ts +3 -3
  23. package/dropdowntrees/dropdowntrees.module.d.ts +1 -0
  24. package/dropdowntrees/expanded-state/expand.directive.d.ts +1 -1
  25. package/dropdowntrees/multiselecttree.component.d.ts +139 -120
  26. package/dropdowntrees/summary-tag/summary-tag.directive.d.ts +8 -6
  27. package/dropdowntrees/templates/node-template.directive.d.ts +4 -3
  28. package/esm2022/autocomplete/autocomplete.component.mjs +62 -53
  29. package/esm2022/autocomplete/autocomplete.module.mjs +9 -1
  30. package/esm2022/comboboxes/combobox-column/column-cell-template.directive.mjs +6 -6
  31. package/esm2022/comboboxes/combobox-column/column-header-template.directive.mjs +5 -4
  32. package/esm2022/comboboxes/combobox-column/combobox-column.component.mjs +21 -17
  33. package/esm2022/comboboxes/combobox-column/util.mjs +10 -5
  34. package/esm2022/comboboxes/combobox.component.mjs +28 -45
  35. package/esm2022/comboboxes/combobox.module.mjs +11 -2
  36. package/esm2022/comboboxes/multicolumncombobox.component.mjs +12 -2
  37. package/esm2022/dropdownlist/dropdownlist.component.mjs +53 -75
  38. package/esm2022/dropdownlist/dropdownlist.module.mjs +29 -11
  39. package/esm2022/dropdowns.module.mjs +8 -20
  40. package/esm2022/dropdowntrees/checked-state/base-check.directive.mjs +1 -1
  41. package/esm2022/dropdowntrees/checked-state/check-all.directive.mjs +4 -7
  42. package/esm2022/dropdowntrees/checked-state/check.directive.mjs +6 -10
  43. package/esm2022/dropdowntrees/data-binding/dropdowntree/flat-binding.directive.mjs +3 -3
  44. package/esm2022/dropdowntrees/data-binding/dropdowntree/hierarchy-binding.directive.mjs +2 -2
  45. package/esm2022/dropdowntrees/data-binding/multiselecttree/flat-binding.directive.mjs +3 -3
  46. package/esm2022/dropdowntrees/data-binding/multiselecttree/hierarchy-binding.directive.mjs +2 -2
  47. package/esm2022/dropdowntrees/dropdowntree.component.mjs +3 -3
  48. package/esm2022/dropdowntrees/dropdowntrees.module.mjs +1 -0
  49. package/esm2022/dropdowntrees/expanded-state/expand.directive.mjs +1 -1
  50. package/esm2022/dropdowntrees/multiselecttree.component.mjs +139 -120
  51. package/esm2022/dropdowntrees/summary-tag/summary-tag.directive.mjs +8 -6
  52. package/esm2022/dropdowntrees/templates/node-template.directive.mjs +4 -3
  53. package/esm2022/multiselect/multiselect.component.mjs +119 -163
  54. package/esm2022/multiselect/multiselect.module.mjs +13 -5
  55. package/esm2022/multiselect/summary-tag.directive.mjs +6 -4
  56. package/esm2022/package-metadata.mjs +2 -2
  57. package/fesm2022/progress-kendo-angular-dropdowns.mjs +571 -576
  58. package/multiselect/multiselect.component.d.ts +119 -163
  59. package/multiselect/multiselect.module.d.ts +13 -5
  60. package/multiselect/summary-tag.directive.d.ts +6 -4
  61. package/package.json +10 -10
  62. package/schematics/ngAdd/index.js +2 -2
@@ -20,6 +20,7 @@ import * as i14 from "./summary-tag/summary-tag.directive";
20
20
  import * as i15 from "../common/templates/group-tag-template.directive";
21
21
  import * as i16 from "../common/templates/tag-template.directive";
22
22
  /**
23
+ * Required for adding all DropDownTree features in NgModule-based Angular applications.
23
24
  * - `MultiSelectTreeComponent`—The MultiSelectTree component class.
24
25
  * - `DropDownTreeComponent`—The DropDownTree component class.
25
26
  * - `MultiSelectTreeFlatBindingDirective`—The MultiSelectTree flat binding directive.
@@ -5,7 +5,7 @@
5
5
  import { ExpandableComponent, ExpandDirective } from '@progress/kendo-angular-treeview';
6
6
  import * as i0 from "@angular/core";
7
7
  /**
8
- * A directive which manages the expanded state of the popup TreeView.
8
+ * Manages the expanded state of the popup TreeView.
9
9
  */
10
10
  export declare class DropDownTreesExpandDirective extends ExpandDirective {
11
11
  private dropDownTree;
@@ -33,7 +33,34 @@ import { TextBoxComponent } from '@progress/kendo-angular-inputs';
33
33
  import { AdaptiveRendererComponent } from '../common/adaptive-renderer.component';
34
34
  import * as i0 from "@angular/core";
35
35
  /**
36
- * Represents the [Kendo UI MultiSelectTree component for Angular]({% slug overview_multiselecttree %}).
36
+ * Represents the Kendo UI for Angular [MultiSelectTree]({% slug overview_multiselecttree %}) component.
37
+ *
38
+ * The `MultiSelectTree` lets you select multiple items from hierarchical data in a tree structure.
39
+ * It provides built-in filtering, checkboxes, and adaptive rendering for mobile devices.
40
+ *
41
+ * @example
42
+ * ```typescript
43
+ * @Component({
44
+ * selector: 'my-app',
45
+ * template: `
46
+ * <kendo-multiselecttree
47
+ * [data]="data"
48
+ * textField="text"
49
+ * valueField="value"
50
+ * [(value)]="selectedValues">
51
+ * </kendo-multiselecttree>
52
+ * `
53
+ * })
54
+ * export class AppComponent {
55
+ * public data = [
56
+ * { text: 'Root', value: 1, items: [
57
+ * { text: 'Child 1', value: 2 },
58
+ * { text: 'Child 2', value: 3 }
59
+ * ]}
60
+ * ];
61
+ * public selectedValues = [2, 3];
62
+ * }
63
+ * ```
37
64
  */
38
65
  export declare class MultiSelectTreeComponent implements OnInit, OnDestroy, OnChanges, AfterContentChecked, DataBoundComponent, ExpandableComponent, ControlValueAccessor {
39
66
  private injector;
@@ -86,18 +113,23 @@ export declare class MultiSelectTreeComponent implements OnInit, OnDestroy, OnCh
86
113
  */
87
114
  onFilterChange(text: any): void;
88
115
  /**
89
- * Enables or disables the adaptive mode. By default the adaptive rendering is disabled.
116
+ * Controls the adaptive mode behavior of the component.
117
+ * Set to `auto` to enable automatic adaptive rendering on small screens.
118
+ *
119
+ * @default 'none'
90
120
  */
91
121
  adaptiveMode: AdaptiveMode;
92
122
  /**
93
- * Sets the title of the ActionSheet that is rendered instead of the Popup when using small screen devices.
94
- * By default the ActionSheet title uses the text provided for the label of the MultiSelectTree.
123
+ * Sets the title text for the ActionSheet in adaptive mode on small screens.
124
+ * Uses the component label by default if not set.
125
+ *
126
+ * @default ''
95
127
  */
96
128
  adaptiveTitle: string;
97
129
  /**
98
- * Sets the subtitle of the ActionSheet that is rendered instead of the Popup when using small screen devices.
99
- * By default the ActionSheet does not render a subtitle.
100
- */
130
+ * Sets the subtitle text for the ActionSheet in adaptive mode on small screens.
131
+ * No subtitle appears by default.
132
+ */
101
133
  adaptiveSubtitle: string;
102
134
  /**
103
135
  * @hidden
@@ -144,250 +176,238 @@ export declare class MultiSelectTreeComponent implements OnInit, OnDestroy, OnCh
144
176
  private filterInput;
145
177
  private checkAllInput;
146
178
  /**
147
- * Specifies the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
179
+ * Sets the tab index for keyboard navigation.
180
+ * Use `-1` to remove the component from the tab sequence.
181
+ *
182
+ * @default 0
148
183
  */
149
184
  set tabindex(value: number);
150
185
  get tabindex(): number;
151
186
  /**
152
- * Sets the size of the component.
153
- *
154
- * The possible values are:
155
- * * `small`
156
- * * `medium` (default)
157
- * * `large`
158
- * * `none`
187
+ * Sets the visual size of the component.
159
188
  *
189
+ * @default 'medium'
160
190
  */
161
191
  set size(size: DropDownSize);
162
192
  get size(): DropDownSize;
163
193
  /**
164
- * Sets the border radius of the component.
165
- *
166
- * The possible values are:
167
- * * `small`
168
- * * `medium` (default)
169
- * * `large`
170
- * * `full`
171
- * * `none`
194
+ * Sets the border radius style of the component.
172
195
  *
196
+ * @default 'medium'
173
197
  */
174
198
  set rounded(rounded: DropDownRounded);
175
199
  get rounded(): DropDownRounded;
176
200
  /**
177
- * Sets the fillMode of the component.
178
- *
179
- * The possible values are:
180
- * * `flat`
181
- * * `solid` (default)
182
- * * `outline`
183
- * * `none`
201
+ * Sets the fill style for the component background and borders.
184
202
  *
203
+ * @default 'solid'
185
204
  */
186
205
  set fillMode(fillMode: DropDownFillMode);
187
206
  get fillMode(): DropDownFillMode;
188
207
  /**
189
- * Configures the popup of the MultiSelectTree.
190
- *
191
- * The available options are:
192
- * - `animate: Boolean`&mdash;Controls the popup animation. By default, the open and close animations are enabled.
193
- * - `width: Number | String`&mdash;Sets the width of the popup container. By default, the width of the host element is used. If set to `auto`, the component automatically adjusts the width of the popup and no item labels are wrapped.
194
- * - `height: Number`&mdash;Sets the height of the popup container.
195
- * - `popupClass: String`&mdash;Specifies a list of CSS classes that are used to style the popup.
196
- * - `appendTo: "root" | "component" | ViewContainerRef`&mdash;Specifies the component to which the popup will be appended.
208
+ * Configures the popup container settings: animation, dimensions, styling and positioning.
197
209
  */
198
210
  set popupSettings(settings: PopupSettings);
199
211
  get popupSettings(): PopupSettings;
200
212
  /**
201
- * Defines the checkable settings of the MultiSelecTree nodes.
202
- * If no value is provided, the default [`CheckableSettings`]({% slug api_dropdowns_multiselecttreecheckablesettings %}) are applied.
213
+ * Configures the checkbox behavior for the MultiSelecTree nodes.
214
+ * Use `checkableSettings` to control parent-child selection relationships and click interactions.
215
+ *
216
+ * @default '{ checkChildren: true, checkOnClick: true }'
203
217
  */
204
218
  set checkableSettings(settings: MultiSelectTreeCheckableSettings);
205
219
  get checkableSettings(): MultiSelectTreeCheckableSettings;
206
220
  /**
207
- * Sets the data of the MultiSelectTree.
208
- *
209
- * > The data has to be provided in an array-like list with objects.
221
+ * Sets the hierarchical data source for the tree structure.
222
+ * Provide an array of objects that contain the tree data and structure.
210
223
  */
211
224
  set data(data: Object[]);
212
225
  get data(): Object[];
213
226
  /**
214
- * Sets the value of the MultiSelectTree.
215
- * It can either be of the primitive (string, numbers) or of the complex (objects) type.
216
- * To define the type, use the `valuePrimitive` option.
217
- *
227
+ * Sets the selected values in the component.
228
+ * Accepts primitive values if `valuePrimitive` is `true`, or objects if `false`.
218
229
  */
219
230
  set value(value: any[]);
220
231
  get value(): any[];
221
232
  /**
222
- * Keeps the current `dataItems` object in order to resolve selection.
223
- * Needs to be provided when when programmatically setting a `value` and `valuePrimitive` is set to `true`.
233
+ * Sets the data items that correspond to the selected values.
234
+ * Required when using primitive values to resolve the full data objects.
224
235
  */
225
236
  set dataItems(items: any[]);
226
237
  get dataItems(): any[];
227
238
  /**
228
- * The fields of the data item that provide the text content of the nodes inside the
229
- * MultiSelectTree ([see example]({% slug databinding_multiselecttree %})). If the `textField`
230
- * input is set to an array, each hierarchical level uses the field that corresponds
231
- * to the same index in the array, or the last item in the array.
232
- *
239
+ * Specifies which data field provides the display text for tree nodes.
233
240
  * > The `textField` property can be set to point to a nested property value - e.g. `category.name`.
234
241
  */
235
242
  textField: string | string[];
236
243
  /**
237
- * The fields of the data item that provide the value of the nodes inside the
238
- * MultiSelectTree ([see example]({% slug databinding_multiselecttree %})). If the `valueField`
239
- * input is set to an array, each hierarchical level uses the field that corresponds
240
- * to the same index in the array, or the last item in the array.
241
- *
244
+ * Specifies which data field provides the unique values for tree nodes.
242
245
  * > The `valueField` property can be set to point to a nested property value - e.g. `category.id`.
243
246
  */
244
247
  valueField: string | string[];
245
248
  /**
246
249
  * Sets the levels in the data set where the values can be found when `valueField` is an Array.
247
250
  * The field serves to correctly allocate a data item used when the MultiSelectTree is initialized with a value.
251
+ *
252
+ * @default []
248
253
  */
249
254
  valueDepth: number[];
250
255
  /**
251
- * Sets and gets the loading state of the MultiSelectTree.
256
+ * Controls the loading state visual indicator.
257
+ * Shows a loading spinner when set to `true`.
258
+ *
259
+ * @default false
252
260
  */
253
261
  loading: boolean;
254
262
  /**
255
- * The hint which is displayed when the component is empty.
263
+ * Sets the placeholder text shown when no items are selected.
264
+ * Helps guide users on what action to take.
265
+ *
266
+ * @default ''
256
267
  */
257
268
  placeholder: string;
258
269
  /**
259
- * Sets the height of the options list in the popup. By default, `listHeight` is 200px.
270
+ * Sets the maximum height of the options list in the popup.
271
+ * Controls vertical scrolling when content exceeds this height.
260
272
  *
261
- * > The `listHeight` property affects only the list of options and not the whole popup container.
262
- * > To set the height of the popup container, use `popupSettings.height`.
263
- *
264
- * > When using `adaptiveMode` and the screen size is `small` or `medium` the `listHeight` property is set to null.
273
+ * @default 200
265
274
  */
266
275
  set listHeight(_listHeight: number);
267
276
  get listHeight(): number;
268
277
  private _listHeight;
269
278
  /**
270
- * Sets the disabled state of the component. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_multiselecttree#toc-managing-the-multiselecttree-disabled-state-in-reactive-forms).
279
+ * Controls whether the component accepts user input.
280
+ * Prevents all user interactions when set to `true`.
281
+ *
282
+ * @default false
271
283
  */
272
284
  disabled: boolean;
273
285
  /**
274
- * Sets the read-only state of the component.
286
+ * Sets the component to read-only mode.
287
+ * Displays current selections but prevents changes.
275
288
  *
276
289
  * @default false
277
290
  */
278
291
  readonly: boolean;
279
292
  /**
280
- * Specifies the type of the selected value
281
- * ([more information and example]({% slug valuebinding_multiselecttree %}#toc-primitive-values)).
282
- * If set to `true`, the selected value has to be a primitive one.
293
+ * Determines the data type of selected values.
294
+ * Set to `true` for primitive values, false for complex objects.
295
+ *
296
+ * @default false
283
297
  */
284
298
  valuePrimitive: boolean;
285
299
  /**
286
- * Indicates whether the child nodes will be fetched on node expand or will be initially prefetched.
300
+ * Controls when child nodes load from the data source.
301
+ * Set to `true` to load children only when parent nodes expand.
302
+ *
287
303
  * @default false
288
304
  */
289
305
  loadOnDemand: boolean;
290
306
  /**
291
- * @hidden
292
- *
293
- * Used by the kendo-label and kendo-floatinglabel to access and associate the focusable element with the provided label via aria-labelledby.
307
+ * Sets the unique identifier for the focusable element.
308
+ * Used internally for accessibility and label association.
294
309
  */
295
310
  focusableId: string;
296
311
  /**
297
- * If set to `true`, renders a button on hovering over the component.
298
- * Clicking this button resets the value of the component to `undefined` and triggers the `change` event.
312
+ * Shows a clear button to reset all selections.
313
+ * Appears on hover when selections exist and the component is not disabled.
314
+ *
299
315
  * @default true
300
316
  */
301
317
  clearButton: boolean;
302
318
  /**
303
- * Renders the built-in input element for filtering the MultiSelectTree.
304
- * If set to `true`, the component emits the `filterChange` event, which can be used to [filter the MultiSelectTree manually]({% slug filtering_multiselecttree %}#toc-manual-filtering).
305
- * A built-in filtering implementation is available to use with the [`kendoMultiSelectTreeHierarchyBinding`]({% slug api_dropdowns_multiselecttreehierarchybindingdirective %}) and [`kendoMultiSelectTreeFlatBinding`]({% slug api_dropdowns_multiselecttreeflatbindingdirective %}) directives.
319
+ * Enables the built-in filter input for searching tree nodes.
320
+ * Shows a search box above the tree when enabled.
321
+ *
306
322
  * @default false
307
323
  */
308
324
  filterable: boolean;
309
325
  /**
310
- * If `checkАll` is set to `true` and the checkboxes are enabled, a tri-state checkbox appears above the embedded treeview.
311
- * Clicking the checkbox checks or unchecks all enabled items of the treeview that are loaded.
326
+ * Shows a checkbox to select or deselect all visible tree nodes.
327
+ * Appears above the tree when checkboxes are enabled.
328
+ *
312
329
  * @default false
313
330
  */
314
331
  checkAll: boolean;
315
332
  /**
316
- * A function which determines if a specific node has child nodes.
333
+ * Determines if a tree node contains child nodes.
334
+ * Return `true` if the node has children, false otherwise.
317
335
  */
318
336
  hasChildren: (node: object) => boolean;
319
337
  /**
320
- * A function which provides the child nodes for a given parent node.
338
+ * Function that provides child nodes for a parent node.
339
+ * Return an Observable of child objects for the given parent.
321
340
  */
322
341
  fetchChildren: (node: object) => Observable<object[]>;
323
342
  /**
324
- * A function that is executed for each data item and determines if a specific node is expanded.
343
+ * Determines if a specific node is expanded. The function is executed for each data item.
325
344
  */
326
345
  isNodeExpanded: (item: object, index: string) => boolean;
327
346
  /**
328
- * A callback which determines whether a tree node should be rendered as hidden. The utility .k-hidden class is used to hide the nodes.
329
- * Useful for custom filtering implementations.
347
+ * Determines if a tree node should be hidden.
330
348
  */
331
349
  isNodeVisible: (item: object, index: string) => boolean;
332
350
  /**
333
- * A function that is executed for each data item and determines if a specific item is disabled.
351
+ * Determines if a tree node is disabled. The function is executed for each data item.
334
352
  */
335
353
  itemDisabled: (item: object, index: string) => boolean;
336
354
  /**
337
- * A user-defined callback function which receives an array of selected data items and maps them to an array of tags.
338
- *
339
355
  * @param { Any[] } dataItems - The selected data items from the list.
340
356
  * @returns { Any[] } - The tags that will be rendered by the component.
357
+ * Transforms the provided array of data items into an array of tags.
341
358
  */
342
359
  tagMapper: (tags: any) => any;
343
360
  /**
344
- * Fires each time the user focuses the MultiSelectTree.
361
+ * Fires when the component receives focus.
345
362
  */
346
363
  onFocus: EventEmitter<any>;
347
364
  /**
348
- * Fires each time the MultiSelectTree gets blurred.
365
+ * Fires when the component gets blurred.
349
366
  */
350
367
  onBlur: EventEmitter<any>;
351
368
  /**
352
- * Fires each time the popup is about to open
353
- * ([see example]({% slug openstate_multiselecttree %})).
354
- * This event is preventable. If you cancel it, the popup will remain closed.
369
+ * Fires when the popup is about to open. ([See example]({% slug openstate_multiselecttree %})).
370
+ * This event is preventable. When cancelled, the popup remains closed.
355
371
  */
356
372
  open: EventEmitter<PreventableEvent>;
357
373
  /**
358
- * Fires after the popup has been opened.
374
+ * Fires after the popup opens completely.
375
+ * Use this event to perform actions when the popup becomes visible.
359
376
  */
360
377
  opened: EventEmitter<any>;
361
378
  /**
362
- * Fires each time the popup is about to close
363
- * ([see example]({% slug openstate_multiselecttree %})).
364
- * This event is preventable. If you cancel it, the popup will remain open.
379
+ * Fires before the popup closes.
380
+ * Cancel this event to prevent the popup from closing.
365
381
  */
366
382
  close: EventEmitter<PreventableEvent>;
367
383
  /**
368
- * Fires after the popup has been closed.
384
+ * Fires after the popup closes completely.
385
+ * Use this event to perform cleanup actions when the popup becomes hidden.
369
386
  */
370
387
  closed: EventEmitter<any>;
371
388
  /**
372
- * Fires when the user expands a node in the popup TreeView.
389
+ * Fires when a tree node is expanded.
390
+ * Use this event to respond to node expansion actions.
373
391
  */
374
392
  nodeExpand: EventEmitter<TreeItem>;
375
393
  /**
376
- * Fires when the user collapses a node in the popup TreeView.
394
+ * Fires when a user collapses a tree node.
395
+ * Use this event to respond to node collapse actions.
377
396
  */
378
397
  nodeCollapse: EventEmitter<TreeItem>;
379
398
  /**
380
- * Fires each time the value is changed
381
- * ([see example](slug:events_multiselecttree)).
399
+ * Fires when the selected value changes.
400
+ * Use this event to respond to selection changes.
382
401
  */
383
402
  valueChange: EventEmitter<any>;
384
403
  /**
385
- * Fires each time a tag is about to be removed([see examples]({% slug summarytagmode_multiselect %}#toc-notifying-on-removing-group-tags)).
386
- * This event is preventable. If you cancel it, the tag will not be removed.
404
+ * Fires before a tag is removed.
405
+ * Cancel this event to prevent tag removal.
387
406
  */
388
407
  removeTag: EventEmitter<RemoveTagEvent>;
389
408
  /**
390
- * Fires when the value of the built-in filter input element changes.
409
+ * Fires when the filter input value changes.
410
+ * Use this event to implement custom filtering logic.
391
411
  */
392
412
  filterChange: EventEmitter<string>;
393
413
  /**
@@ -539,31 +559,30 @@ export declare class MultiSelectTreeComponent implements OnInit, OnDestroy, OnCh
539
559
  */
540
560
  isEmpty(): boolean;
541
561
  /**
542
- * Focuses the MultiSelectTree.
562
+ * Sets focus to the component.
563
+ * Call this method to programmatically focus the MultiSelectTree.
543
564
  */
544
565
  focus(): void;
545
566
  /**
546
- * Blurs the MultiSelectTree.
567
+ * Removes focus from the component.
568
+ * Call this method to programmatically blur the MultiSelectTree.
547
569
  */
548
570
  blur(): void;
549
571
  /**
550
- * Focuses a specific item of the MultiSelectTree based on a provided index in the format of `1_1`.
551
- * The targeted item should be expanded in order for it to be focused.
552
- * If null or invalid index is provided the focus will be set on the first item.
572
+ * Sets focus to a specific tree item by index.
573
+ * Provide the item index in format like '1_1' to focus that item.
574
+ * The item must be expanded and enabled to receive focus.
553
575
  */
554
576
  focusItemAt(index: string): void;
555
577
  /**
556
- * Resets the value of the MultiSelectTree.
557
- * If you use the `reset` method to clear the value of the component,
558
- * the model will not update automatically and the `valueChange` event will not be fired.
578
+ * Clears all selected values from the component.
579
+ * This method does not trigger the valueChange event.
559
580
  */
560
581
  reset(): void;
561
582
  /**
562
- * Toggles the visibility of the popup or actionSheet
563
- * ([see example]({% slug openstate_multiselecttree %})).
564
- * If you use the `toggle` method to open or close the popup, the `open` and `close` events will not be fired.
565
- *
566
- * @param open - The state of the popup.
583
+ * Opens or closes the popup programmatically.
584
+ * Pass `true` to open, false to close, or omit the parameter to toggle.
585
+ * This method does not trigger open or close events.
567
586
  */
568
587
  toggle(open?: boolean): void;
569
588
  /**
@@ -6,24 +6,26 @@ import { OnChanges } from '@angular/core';
6
6
  import { MultiSelectTreeComponent } from '../multiselecttree.component';
7
7
  import * as i0 from "@angular/core";
8
8
  /**
9
- * A directive which configures the MultiSelectTree to show one single summary tag for all selected data items.
10
- * When a number is provided, the summary tag is displayed after the given amount of data items are selected
11
- * ([more information and examples]({% slug api_dropdowns_multiselecttreesummarytagdirective %})).
9
+ * Configures the MultiSelectTree to show one single summary tag for all selected data items.
10
+ * When a number is set, the summary tag is shown after the corresponding number of data items are selected (see examples).
11
+ * See [more information and examples]({% slug api_dropdowns_multiselecttreesummarytagdirective %}).
12
12
  *
13
13
  * @example
14
- * ```ts-no-run
14
+ * ```ts
15
15
  * <kendo-multiselecttree kendoMultiSelectTreeSummaryTag [data]="data"></kendo-multiselecttree>
16
16
  * ```
17
17
  *
18
18
  * @example
19
- * ```ts-no-run
19
+ * ```ts
20
20
  * <kendo-multiselecttree [kendoMultiSelectTreeSummaryTag]="2" [data]="data"></kendo-multiselecttree>
21
21
  * ```
22
22
  */
23
23
  export declare class MultiSelectTreeSummaryTagDirective implements OnChanges {
24
24
  private multiSelectTreeComponent;
25
25
  /**
26
- * A numeric value that indicates the number of selected data items after which the summary tag will appear.
26
+ * Sets the number of data items that need to be selected before the summary tag appears.
27
+ *
28
+ * @default 0
27
29
  */
28
30
  showAfter: number | string;
29
31
  constructor(multiSelectTreeComponent: MultiSelectTreeComponent);
@@ -7,11 +7,12 @@ import * as i0 from "@angular/core";
7
7
  /**
8
8
  * Renders the content of each node in the DropDownTree. To define a node template, nest an `<ng-template>` tag
9
9
  * with the `kendoDropDownTreeNodeTemplate` directive inside the `<kendo-dropdowntree>` tag.
10
+ * To define a node template, nest an `<ng-template>` tag with the `kendoDropDownTreeNodeTemplate` directive inside the `<kendo-dropdowntree>` tag.
10
11
  *
11
- * The current data item and hierarchical index are available as context variables:
12
+ * You can use these context variables in the template:
12
13
  *
13
- * - `let-dataItem` (`any`) - The current data item. Available as implicit context variable.
14
- * - `let-index="index"` (`string`) - The current item hierarchical index.
14
+ * - `let-dataItem` (`any`) - The current data item. This is the implicit context variable.
15
+ * - `let-index="index"` (`string`) - The current item's hierarchical index.
15
16
  */
16
17
  export declare class NodeTemplateDirective {
17
18
  templateRef: TemplateRef<any>;