@progress/kendo-vue-treeview 3.2.2-dev.202204181420

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 (87) hide show
  1. package/LICENSE.md +11 -0
  2. package/NOTICE.txt +86 -0
  3. package/README.md +53 -0
  4. package/dist/cdn/js/kendo-vue-treeview.js +1 -0
  5. package/dist/es/ItemRenderProps.d.ts +13 -0
  6. package/dist/es/ItemRenderProps.js +1 -0
  7. package/dist/es/TreeView.d.ts +45 -0
  8. package/dist/es/TreeView.js +359 -0
  9. package/dist/es/TreeViewDragAnalyzer.d.ts +135 -0
  10. package/dist/es/TreeViewDragAnalyzer.js +184 -0
  11. package/dist/es/TreeViewDragClue.d.ts +135 -0
  12. package/dist/es/TreeViewDragClue.js +78 -0
  13. package/dist/es/TreeViewItem.d.ts +69 -0
  14. package/dist/es/TreeViewItem.js +359 -0
  15. package/dist/es/TreeViewOperationDescriptors.d.ts +76 -0
  16. package/dist/es/TreeViewOperationDescriptors.js +1 -0
  17. package/dist/es/TreeViewProps.d.ts +122 -0
  18. package/dist/es/TreeViewProps.js +0 -0
  19. package/dist/es/additionalTypes.ts +9 -0
  20. package/dist/es/events.d.ts +135 -0
  21. package/dist/es/events.js +0 -0
  22. package/dist/es/handleTreeViewCheckChange.d.ts +67 -0
  23. package/dist/es/handleTreeViewCheckChange.js +195 -0
  24. package/dist/es/main.d.ts +12 -0
  25. package/dist/es/main.js +8 -0
  26. package/dist/es/moveTreeViewItem.d.ts +109 -0
  27. package/dist/es/moveTreeViewItem.js +156 -0
  28. package/dist/es/package-metadata.d.ts +5 -0
  29. package/dist/es/package-metadata.js +11 -0
  30. package/dist/es/processTreeViewItems.d.ts +51 -0
  31. package/dist/es/processTreeViewItems.js +166 -0
  32. package/dist/es/utils/FieldsService.d.ts +26 -0
  33. package/dist/es/utils/FieldsService.js +50 -0
  34. package/dist/es/utils/SortedPublicItemIds.d.ts +8 -0
  35. package/dist/es/utils/SortedPublicItemIds.js +26 -0
  36. package/dist/es/utils/consts.d.ts +40 -0
  37. package/dist/es/utils/consts.js +40 -0
  38. package/dist/es/utils/getItemIdUponKeyboardNavigation.d.ts +5 -0
  39. package/dist/es/utils/getItemIdUponKeyboardNavigation.js +77 -0
  40. package/dist/es/utils/itemIdUtils.d.ts +60 -0
  41. package/dist/es/utils/itemIdUtils.js +117 -0
  42. package/dist/es/utils/itemUtils.d.ts +45 -0
  43. package/dist/es/utils/itemUtils.js +191 -0
  44. package/dist/es/utils/misc.d.ts +9 -0
  45. package/dist/es/utils/misc.js +17 -0
  46. package/dist/npm/ItemRenderProps.d.ts +13 -0
  47. package/dist/npm/ItemRenderProps.js +3 -0
  48. package/dist/npm/TreeView.d.ts +45 -0
  49. package/dist/npm/TreeView.js +376 -0
  50. package/dist/npm/TreeViewDragAnalyzer.d.ts +135 -0
  51. package/dist/npm/TreeViewDragAnalyzer.js +186 -0
  52. package/dist/npm/TreeViewDragClue.d.ts +135 -0
  53. package/dist/npm/TreeViewDragClue.js +88 -0
  54. package/dist/npm/TreeViewItem.d.ts +69 -0
  55. package/dist/npm/TreeViewItem.js +373 -0
  56. package/dist/npm/TreeViewOperationDescriptors.d.ts +76 -0
  57. package/dist/npm/TreeViewOperationDescriptors.js +3 -0
  58. package/dist/npm/TreeViewProps.d.ts +122 -0
  59. package/dist/npm/TreeViewProps.js +2 -0
  60. package/dist/npm/additionalTypes.ts +9 -0
  61. package/dist/npm/events.d.ts +135 -0
  62. package/dist/npm/events.js +2 -0
  63. package/dist/npm/handleTreeViewCheckChange.d.ts +67 -0
  64. package/dist/npm/handleTreeViewCheckChange.js +199 -0
  65. package/dist/npm/main.d.ts +12 -0
  66. package/dist/npm/main.js +17 -0
  67. package/dist/npm/moveTreeViewItem.d.ts +109 -0
  68. package/dist/npm/moveTreeViewItem.js +159 -0
  69. package/dist/npm/package-metadata.d.ts +5 -0
  70. package/dist/npm/package-metadata.js +14 -0
  71. package/dist/npm/processTreeViewItems.d.ts +51 -0
  72. package/dist/npm/processTreeViewItems.js +169 -0
  73. package/dist/npm/utils/FieldsService.d.ts +26 -0
  74. package/dist/npm/utils/FieldsService.js +52 -0
  75. package/dist/npm/utils/SortedPublicItemIds.d.ts +8 -0
  76. package/dist/npm/utils/SortedPublicItemIds.js +28 -0
  77. package/dist/npm/utils/consts.d.ts +40 -0
  78. package/dist/npm/utils/consts.js +43 -0
  79. package/dist/npm/utils/getItemIdUponKeyboardNavigation.d.ts +5 -0
  80. package/dist/npm/utils/getItemIdUponKeyboardNavigation.js +80 -0
  81. package/dist/npm/utils/itemIdUtils.d.ts +60 -0
  82. package/dist/npm/utils/itemIdUtils.js +132 -0
  83. package/dist/npm/utils/itemUtils.d.ts +45 -0
  84. package/dist/npm/utils/itemUtils.js +205 -0
  85. package/dist/npm/utils/misc.d.ts +9 -0
  86. package/dist/npm/utils/misc.js +22 -0
  87. package/package.json +56 -0
@@ -0,0 +1,359 @@
1
+ // @ts-ignore
2
+ import * as Vue from 'vue';
3
+ var allVue = Vue;
4
+ var gh = allVue.h;
5
+ import { Keys, validatePackage, guid, kendoThemeMaps, classNames } from '@progress/kendo-vue-common';
6
+ import nav from './utils/getItemIdUponKeyboardNavigation';
7
+ import { resolveItemId, isEnabledAndAllParentsEnabled, hasChildren } from './utils/itemUtils';
8
+ import { TreeViewItem } from './TreeViewItem';
9
+ import { ZERO_LEVEL_ZERO_NODE_ID, getItemById as _getItemById } from './utils/itemIdUtils';
10
+ import FieldsService from './utils/FieldsService';
11
+ import { packageMetadata } from './package-metadata';
12
+ import { CHECK_FIELD, CHECK_INDETERMINATE_FIELD, CHILDREN_FIELD, DISABLED_FIELD, EXPAND_FIELD, HAS_CHILDREN_FIELD, SELECT_FIELD, TEXT_FIELD } from './utils/consts';
13
+ var sizeMap = kendoThemeMaps.sizeMap; // tslint:enable:max-line-length
14
+
15
+ var TreeViewVue2 = {
16
+ name: 'KendoTreeView',
17
+ props: {
18
+ dataItems: Array,
19
+ animate: {
20
+ type: Boolean,
21
+ default: true
22
+ },
23
+ tabIndex: Number,
24
+ focusIdField: String,
25
+ getFocusHierarchicalIndex: Function,
26
+ expandField: {
27
+ type: String,
28
+ default: EXPAND_FIELD
29
+ },
30
+ selectField: {
31
+ type: String,
32
+ default: SELECT_FIELD
33
+ },
34
+ childrenField: {
35
+ type: String,
36
+ default: CHILDREN_FIELD
37
+ },
38
+ hasChildrenField: {
39
+ type: String,
40
+ default: HAS_CHILDREN_FIELD
41
+ },
42
+ expandIcons: Boolean,
43
+ checkboxes: Boolean,
44
+ textField: {
45
+ type: String,
46
+ default: TEXT_FIELD
47
+ },
48
+ disableField: {
49
+ type: String,
50
+ default: DISABLED_FIELD
51
+ },
52
+ checkField: {
53
+ type: String,
54
+ default: CHECK_FIELD
55
+ },
56
+ checkIndeterminateField: {
57
+ type: String,
58
+ default: CHECK_INDETERMINATE_FIELD
59
+ },
60
+ item: [Object, String, Function],
61
+ ariaMultiSelectable: [String, Boolean],
62
+ ariaLabel: String,
63
+ ariaLabelledby: String,
64
+ size: {
65
+ type: String,
66
+ default: 'medium',
67
+ validator: function validator(value) {
68
+ return [null, 'small', 'medium', 'large'].includes(value);
69
+ }
70
+ }
71
+ },
72
+ data: function data() {
73
+ return {
74
+ focusedItemId: undefined,
75
+ focusedItemPublicId: undefined,
76
+ tabbableItemId: ZERO_LEVEL_ZERO_NODE_ID
77
+ };
78
+ },
79
+ created: function created() {
80
+ validatePackage(packageMetadata);
81
+ this.allowExplicitFocus = false;
82
+ this.treeGuid = guid();
83
+ },
84
+ updated: function updated() {
85
+ this.allowExplicitFocus = false;
86
+ this.refocusDueToFocusIdField();
87
+ },
88
+ // @ts-ignore
89
+ setup: !gh ? undefined : function () {
90
+ var v3 = !!gh;
91
+ return {
92
+ v3: v3
93
+ };
94
+ },
95
+ // @ts-ignore
96
+ render: function render(createElement) {
97
+ var _a;
98
+
99
+ var h = gh || createElement;
100
+ this.fieldsSvc = new FieldsService(this.$props);
101
+ var size = this.$props.size;
102
+ return h("div", {
103
+ "class": classNames('k-treeview', (_a = {}, _a["k-treeview-" + (sizeMap[size] || size)] = size, _a)),
104
+ onKeydown: this.onKeyDown,
105
+ on: this.v3 ? undefined : {
106
+ "keydown": this.onKeyDown,
107
+ "focusin": this.onFocus,
108
+ "focusout": this.onBlur
109
+ },
110
+ onFocusin: this.onFocus,
111
+ onFocusout: this.onBlur,
112
+ role: "tree",
113
+ attrs: this.v3 ? undefined : {
114
+ role: "tree",
115
+ "aria-multiselectable": this.ariaMultiSelectable ? true : undefined,
116
+ "aria-label": this.$props['aria-label'],
117
+ "aria-labelledby": this.$props['aria-labelledby'],
118
+ tabIndex: this.$props.tabIndex
119
+ },
120
+ "aria-multiselectable": this.ariaMultiSelectable ? true : undefined,
121
+ "aria-label": this.$props['aria-label'],
122
+ "aria-labelledby": this.$props['aria-labelledby'],
123
+ tabIndex: this.$props.tabIndex
124
+ }, [h("ul", {
125
+ "class": "k-treeview-lines k-treeview-group",
126
+ role: "group",
127
+ attrs: this.v3 ? undefined : {
128
+ role: "group"
129
+ }
130
+ }, [this.dataItems.map(function (item, index) {
131
+ return h(TreeViewItem, {
132
+ item: item,
133
+ attrs: this.v3 ? undefined : {
134
+ item: item,
135
+ itemId: index.toString(),
136
+ treeGuid: this.treeGuid,
137
+ animate: this.$props.animate,
138
+ focusedItemId: this.focusedItemId,
139
+ tabbableItemId: this.tabbableItemId,
140
+ fieldsService: this.fieldsSvc,
141
+ itemUI: this.$props.item,
142
+ checkboxes: this.$props.checkboxes,
143
+ ariaMultiSelectable: this.ariaMultiSelectable,
144
+ draggable: this.$props.draggable,
145
+ expandIcons: this.$props.expandIcons,
146
+ size: size
147
+ },
148
+ itemId: index.toString(),
149
+ treeGuid: this.treeGuid,
150
+ animate: this.$props.animate,
151
+ focusedItemId: this.focusedItemId,
152
+ tabbableItemId: this.tabbableItemId,
153
+ fieldsService: this.fieldsSvc,
154
+ itemUI: this.$props.item,
155
+ checkboxes: this.$props.checkboxes,
156
+ ariaMultiSelectable: this.ariaMultiSelectable,
157
+ onItemclick: this.onItemClick,
158
+ on: this.v3 ? undefined : {
159
+ "itemclick": this.onItemClick,
160
+ "focusdomelneeded": this.onFocusDomElNeeded,
161
+ "press": this.onPress,
162
+ "drag": this.onDrag,
163
+ "release": this.onRelease,
164
+ "expandchange": this.onExpandChange,
165
+ "checkchange": this.onCheckChange
166
+ },
167
+ onFocusdomelneeded: this.onFocusDomElNeeded,
168
+ draggable: this.$props.draggable,
169
+ onPress: this.onPress,
170
+ onDrag: this.onDrag,
171
+ onRelease: this.onRelease,
172
+ expandIcons: this.$props.expandIcons,
173
+ onExpandchange: this.onExpandChange,
174
+ onCheckchange: this.onCheckChange,
175
+ key: index,
176
+ size: size
177
+ });
178
+ }, this)])]);
179
+ },
180
+ methods: {
181
+ onFocusDomElNeeded: function onFocusDomElNeeded(domItem) {
182
+ if (this.allowExplicitFocus) {
183
+ this.focusDomItem(domItem);
184
+ }
185
+ },
186
+ onCheckChange: function onCheckChange(event, item, itemId) {
187
+ this.setFocus(itemId);
188
+ this.dispatchCheckChange(event, item, itemId);
189
+ },
190
+ onExpandChange: function onExpandChange(event, item, itemId) {
191
+ this.setFocus(itemId);
192
+ this.dispatchExpandChange(event, item, itemId);
193
+ },
194
+ onPress: function onPress(_event, item, itemId) {
195
+ if (this.$props.onItemDragStart) {
196
+ this.$props.onItemDragStart.call(undefined, {
197
+ target: this,
198
+ item: item,
199
+ itemHierarchicalIndex: itemId
200
+ });
201
+ }
202
+ },
203
+ onDrag: function onDrag(event, item, itemId) {
204
+ var pageX = event.pageX,
205
+ pageY = event.pageY,
206
+ clientX = event.clientX,
207
+ clientY = event.clientY;
208
+
209
+ if (this.$props.onItemDragOver) {
210
+ this.$props.onItemDragOver.call(undefined, {
211
+ target: this,
212
+ item: item,
213
+ itemHierarchicalIndex: itemId,
214
+ pageX: pageX,
215
+ pageY: pageY,
216
+ clientX: clientX,
217
+ clientY: clientY
218
+ });
219
+ }
220
+ },
221
+ onRelease: function onRelease(event, item, itemId) {
222
+ var pageX = event.pageX,
223
+ pageY = event.pageY,
224
+ clientX = event.clientX,
225
+ clientY = event.clientY;
226
+
227
+ if (this.$props.onItemDragEnd) {
228
+ this.$props.onItemDragEnd.call(undefined, {
229
+ target: this,
230
+ item: item,
231
+ itemHierarchicalIndex: itemId,
232
+ pageX: pageX,
233
+ pageY: pageY,
234
+ clientX: clientX,
235
+ clientY: clientY
236
+ });
237
+ }
238
+ },
239
+ onItemClick: function onItemClick(event, item, itemId) {
240
+ this.setFocus(itemId);
241
+ this.dispatchItemClick(event, item, itemId);
242
+ },
243
+ onFocus: function onFocus() {
244
+ clearTimeout(this.blurRequest);
245
+
246
+ if (this.focusedItemId === undefined && this.dataItems.length) {
247
+ this.setFocus(this.tabbableItemId);
248
+ }
249
+ },
250
+ onBlur: function onBlur() {
251
+ var _this = this;
252
+
253
+ clearTimeout(this.blurRequest);
254
+ this.blurRequest = window.setTimeout(function () {
255
+ return _this.setFocus(undefined);
256
+ }, 0);
257
+ },
258
+ onKeyDown: function onKeyDown(event) {
259
+ var focusedItem = this.getFocusedItem();
260
+
261
+ if (focusedItem) {
262
+ var newItemId = nav(focusedItem, this.focusedItemId, this.dataItems, event.keyCode, this.fieldsSvc);
263
+
264
+ if (newItemId !== this.focusedItemId) {
265
+ // This disables the auto-scroll. The scroll is achieved via item focusing.
266
+ event.preventDefault();
267
+ this.allowExplicitFocus = true;
268
+ this.setFocus(newItemId);
269
+ }
270
+
271
+ this.dispatchEventsOnKeyDown(event, focusedItem);
272
+ }
273
+ },
274
+ dispatchEventsOnKeyDown: function dispatchEventsOnKeyDown(event, focusedItem) {
275
+ var _this = this; // isEnabled is the most expensive op and that is why is left last.
276
+
277
+
278
+ var isEnabled = function isEnabled() {
279
+ return isEnabledAndAllParentsEnabled(_this.focusedItemId, _this.dataItems, _this.fieldsSvc);
280
+ };
281
+
282
+ if (event.keyCode === Keys.left && this.fieldsSvc.expanded(focusedItem) && isEnabled()) {
283
+ this.dispatchExpandChange(event, focusedItem, this.focusedItemId);
284
+ } else if (event.keyCode === Keys.right && !this.fieldsSvc.expanded(focusedItem) && (this.fieldsSvc.hasChildren(focusedItem) || hasChildren(focusedItem, this.$props.childrenField)) && isEnabled()) {
285
+ this.dispatchExpandChange(event, focusedItem, this.focusedItemId);
286
+ } else if (event.keyCode === Keys.enter && isEnabled()) {
287
+ this.dispatchItemClick(event, focusedItem, this.focusedItemId);
288
+ } else if (event.keyCode === Keys.space && isEnabled()) {
289
+ // W/o preventDefault() long TreeViews gets incorrectly scrolled.
290
+ event.preventDefault();
291
+ this.dispatchCheckChange(event, focusedItem, this.focusedItemId);
292
+ }
293
+ },
294
+ setFocus: function setFocus(focusedItemId) {
295
+ if (focusedItemId) {
296
+ if (this.fieldsSvc.focusIdField) {
297
+ var item = this.getItemById(focusedItemId);
298
+ this.focusedItemId = focusedItemId;
299
+ this.focusedItemPublicId = this.fieldsSvc.focusId(item);
300
+ } else {
301
+ this.focusedItemId = focusedItemId;
302
+ }
303
+ } else {
304
+ this.focusedItemId = undefined;
305
+ this.focusedItemPublicId = undefined;
306
+ this.tabbableItemId = this.focusedItemId;
307
+ }
308
+ },
309
+ getFocusedItem: function getFocusedItem() {
310
+ return this.focusedItemId ? this.getItemById(this.focusedItemId) : undefined;
311
+ },
312
+ getItemById: function getItemById(itemId) {
313
+ return _getItemById(itemId, this.dataItems, this.$props.childrenField || CHILDREN_FIELD);
314
+ },
315
+ dispatchCheckChange: function dispatchCheckChange(_dispatchedEvent, item, itemId) {
316
+ this.$emit('checkchange', {
317
+ item: item,
318
+ itemHierarchicalIndex: itemId
319
+ });
320
+ },
321
+ dispatchExpandChange: function dispatchExpandChange(_dispatchedEvent, item, itemId) {
322
+ this.$emit('expandchange', {
323
+ item: item,
324
+ itemHierarchicalIndex: itemId
325
+ });
326
+ },
327
+ dispatchItemClick: function dispatchItemClick(_dispatchedEvent, item, itemId) {
328
+ this.$emit('itemclick', {
329
+ item: item,
330
+ itemHierarchicalIndex: itemId
331
+ });
332
+ },
333
+ refocusDueToFocusIdField: function refocusDueToFocusIdField() {
334
+ if (this.fieldsSvc.focusIdField) {
335
+ var focusedItemPublicId = this.focusedItemPublicId;
336
+
337
+ if (focusedItemPublicId) {
338
+ var focusedItemId = this.$props.getFocusHierarchicalIndex ? this.$props.getFocusHierarchicalIndex(focusedItemPublicId) : resolveItemId(focusedItemPublicId, this.fieldsSvc.focusIdField, this.dataItems, this.$props.childrenField);
339
+
340
+ if (focusedItemId !== this.focusedItemId) {
341
+ this.allowExplicitFocus = true;
342
+ this.focusedItemId = focusedItemId;
343
+ }
344
+ }
345
+ }
346
+ },
347
+ // private get ariaMultiSelectable() {
348
+ // return this.$props['aria-multiselectable'] === true || this.$props['aria-multiselectable'] === 'true';
349
+ // }
350
+ focusDomItem: function focusDomItem(domItem) {
351
+ domItem.focus();
352
+ },
353
+ guid: function guid() {
354
+ return this.treeGuid;
355
+ }
356
+ }
357
+ };
358
+ var TreeView = TreeViewVue2;
359
+ export { TreeView, TreeViewVue2 };
@@ -0,0 +1,135 @@
1
+ import { TreeViewItemDragOverEvent, TreeViewItemDragEndEvent } from './events';
2
+ /**
3
+ * A class which provides an API for analyzing the `drag` events
4
+ * of the TreeView.
5
+ *
6
+ * @example
7
+ * ```jsx
8
+ * class App extends React.Component {
9
+ * dragClue;
10
+ * state = { tree };
11
+ *
12
+ * render() {
13
+ * return (
14
+ * <div>
15
+ * <TreeView data={this.state.tree} draggable={true}
16
+ * onItemDragOver={this.onItemDragOver} onItemDragEnd={this.onItemDragEnd} />
17
+ * <TreeViewDragClue ref={dragClue => this.dragClue = dragClue} />
18
+ * </div>
19
+ * );
20
+ * }
21
+ *
22
+ * onItemDragOver = (event) => {
23
+ * this.dragClue.show(event.pageY + 10, event.pageX, event.item.text, this.getClueClassName(event));
24
+ * }
25
+ * onItemDragEnd = (event) => {
26
+ * this.dragClue.hide();
27
+ * const eventAnalyzer = new TreeViewDragAnalyzer(event).init();
28
+ *
29
+ * if (eventAnalyzer.isDropAllowed) {
30
+ * const updatedTree = moveTreeViewItem(
31
+ * event.itemHierarchicalIndex,
32
+ * this.state.tree,
33
+ * eventAnalyzer.getDropOperation(),
34
+ * eventAnalyzer.destinationMeta.itemHierarchicalIndex,
35
+ * );
36
+ *
37
+ * this.setState({ tree: updatedTree });
38
+ * }
39
+ * }
40
+ * getClueClassName(event) {
41
+ * const eventAnalyzer = new TreeViewDragAnalyzer(event).init();
42
+ * const itemIndex = eventAnalyzer.destinationMeta.itemHierarchicalIndex;
43
+ *
44
+ * if (eventAnalyzer.isDropAllowed) {
45
+ * switch (eventAnalyzer.getDropOperation()) {
46
+ * case 'child':
47
+ * return 'k-i-plus';
48
+ * case 'before':
49
+ * return itemIndex === '0' || itemIndex.endsWith(`${SEPARATOR}0`) ?
50
+ * 'k-i-insert-up' : 'k-i-insert-middle';
51
+ * case 'after':
52
+ * const siblings = getSiblings(itemIndex, this.state.tree);
53
+ * const lastIndex = Number(itemIndex.split(SEPARATOR).pop());
54
+ *
55
+ * return lastIndex < siblings.length - 1 ? 'k-i-insert-middle' : 'k-i-insert-down';
56
+ * default:
57
+ * break;
58
+ * }
59
+ * }
60
+ *
61
+ * return 'k-i-cancel';
62
+ * }
63
+ * }
64
+ *
65
+ * function getSiblings(itemIndex, data) {
66
+ * let result = data;
67
+ *
68
+ * const indices = itemIndex.split(SEPARATOR).map(index => Number(index));
69
+ * for (let i = 0; i < indices.length - 1; i++) {
70
+ * result = result[indices[i]].items;
71
+ * }
72
+ *
73
+ * return result;
74
+ * }
75
+ *
76
+ * const SEPARATOR = '_';
77
+ * const tree = [{
78
+ * text: 'Furniture', expanded: true, items: [
79
+ * { text: 'Tables & Chairs', expanded: true },
80
+ * { text: 'Sofas', expanded: true },
81
+ * { text: 'Occasional Furniture', expanded: true }]
82
+ * }, {
83
+ * text: 'Decor', expanded: true, items: [
84
+ * { text: 'Bed Linen', expanded: true },
85
+ * { text: 'Curtains & Blinds', expanded: true },
86
+ * { text: 'Carpets', expanded: true }]
87
+ * }];
88
+ *
89
+ * ReactDOM.render(<App />, document.querySelector('my-app'));
90
+ * ```
91
+ */
92
+ export default class TreeViewDragAnalyzer {
93
+ private event;
94
+ private itemId;
95
+ private treeViewGuid;
96
+ private initialized;
97
+ private destDomNodeWithMeta;
98
+ private destItemId;
99
+ private destTreeViewGuid;
100
+ /**
101
+ * @param event - The event that will be analyzed.
102
+ */
103
+ constructor(event: TreeViewItemDragOverEvent | TreeViewItemDragEndEvent);
104
+ /**
105
+ * The method which initializes the analyzer.
106
+ * Invoke the method before you call any other methods.
107
+ *
108
+ * @returns - The analyzer object of the `drag` event.
109
+ */
110
+ init(): this;
111
+ /**
112
+ * Returns `true` if dropping is allowed. Otherwise, returns `false`.
113
+ */
114
+ get isDropAllowed(): boolean;
115
+ /**
116
+ * Returns an object which contains:
117
+ * * The `itemHierarchicalIndex` of the destination item (the item below the dragged item) and
118
+ * * The `guid` of the destination TreeView (the TreeView which renders the destination item).
119
+ */
120
+ get destinationMeta(): {
121
+ itemHierarchicalIndex: string;
122
+ treeViewGuid: string;
123
+ };
124
+ /**
125
+ * Returns the specific drop operation.
126
+ *
127
+ * @returns - The following values are returned:
128
+ * * `before`&mdash;Indicates that the dragged item is positioned at the beginning of the destination item.
129
+ * * `after`&mdash;Indicates that the dragged item is positioned at the end of the destination item.
130
+ * * `child`&mdash;Indicates that the dragged item is positioned in the middle of the destination item.
131
+ * * `undefined`&mdash;Indicates that dropping is not allowed.
132
+ */
133
+ getDropOperation(): "before" | "after" | "child";
134
+ private setDestimationMeta;
135
+ }
@@ -0,0 +1,184 @@
1
+ import { DOM_KENDO_ITEM_ID_FIELD, DOM_KENDO_TREEVIEW_GUID_FIELD } from './utils/consts';
2
+ var DROPZONE_BOUNDARY_DELTA = 6;
3
+ /**
4
+ * A class which provides an API for analyzing the `drag` events
5
+ * of the TreeView.
6
+ *
7
+ * @example
8
+ * ```jsx
9
+ * class App extends React.Component {
10
+ * dragClue;
11
+ * state = { tree };
12
+ *
13
+ * render() {
14
+ * return (
15
+ * <div>
16
+ * <TreeView data={this.state.tree} draggable={true}
17
+ * onItemDragOver={this.onItemDragOver} onItemDragEnd={this.onItemDragEnd} />
18
+ * <TreeViewDragClue ref={dragClue => this.dragClue = dragClue} />
19
+ * </div>
20
+ * );
21
+ * }
22
+ *
23
+ * onItemDragOver = (event) => {
24
+ * this.dragClue.show(event.pageY + 10, event.pageX, event.item.text, this.getClueClassName(event));
25
+ * }
26
+ * onItemDragEnd = (event) => {
27
+ * this.dragClue.hide();
28
+ * const eventAnalyzer = new TreeViewDragAnalyzer(event).init();
29
+ *
30
+ * if (eventAnalyzer.isDropAllowed) {
31
+ * const updatedTree = moveTreeViewItem(
32
+ * event.itemHierarchicalIndex,
33
+ * this.state.tree,
34
+ * eventAnalyzer.getDropOperation(),
35
+ * eventAnalyzer.destinationMeta.itemHierarchicalIndex,
36
+ * );
37
+ *
38
+ * this.setState({ tree: updatedTree });
39
+ * }
40
+ * }
41
+ * getClueClassName(event) {
42
+ * const eventAnalyzer = new TreeViewDragAnalyzer(event).init();
43
+ * const itemIndex = eventAnalyzer.destinationMeta.itemHierarchicalIndex;
44
+ *
45
+ * if (eventAnalyzer.isDropAllowed) {
46
+ * switch (eventAnalyzer.getDropOperation()) {
47
+ * case 'child':
48
+ * return 'k-i-plus';
49
+ * case 'before':
50
+ * return itemIndex === '0' || itemIndex.endsWith(`${SEPARATOR}0`) ?
51
+ * 'k-i-insert-up' : 'k-i-insert-middle';
52
+ * case 'after':
53
+ * const siblings = getSiblings(itemIndex, this.state.tree);
54
+ * const lastIndex = Number(itemIndex.split(SEPARATOR).pop());
55
+ *
56
+ * return lastIndex < siblings.length - 1 ? 'k-i-insert-middle' : 'k-i-insert-down';
57
+ * default:
58
+ * break;
59
+ * }
60
+ * }
61
+ *
62
+ * return 'k-i-cancel';
63
+ * }
64
+ * }
65
+ *
66
+ * function getSiblings(itemIndex, data) {
67
+ * let result = data;
68
+ *
69
+ * const indices = itemIndex.split(SEPARATOR).map(index => Number(index));
70
+ * for (let i = 0; i < indices.length - 1; i++) {
71
+ * result = result[indices[i]].items;
72
+ * }
73
+ *
74
+ * return result;
75
+ * }
76
+ *
77
+ * const SEPARATOR = '_';
78
+ * const tree = [{
79
+ * text: 'Furniture', expanded: true, items: [
80
+ * { text: 'Tables & Chairs', expanded: true },
81
+ * { text: 'Sofas', expanded: true },
82
+ * { text: 'Occasional Furniture', expanded: true }]
83
+ * }, {
84
+ * text: 'Decor', expanded: true, items: [
85
+ * { text: 'Bed Linen', expanded: true },
86
+ * { text: 'Curtains & Blinds', expanded: true },
87
+ * { text: 'Carpets', expanded: true }]
88
+ * }];
89
+ *
90
+ * ReactDOM.render(<App />, document.querySelector('my-app'));
91
+ * ```
92
+ */
93
+ var TreeViewDragAnalyzer = /** @class */ (function () {
94
+ /**
95
+ * @param event - The event that will be analyzed.
96
+ */
97
+ function TreeViewDragAnalyzer(event) {
98
+ this.event = event;
99
+ this.initialized = false;
100
+ this.itemId = event.itemHierarchicalIndex;
101
+ this.treeViewGuid = event.target.guid;
102
+ }
103
+ /**
104
+ * The method which initializes the analyzer.
105
+ * Invoke the method before you call any other methods.
106
+ *
107
+ * @returns - The analyzer object of the `drag` event.
108
+ */
109
+ TreeViewDragAnalyzer.prototype.init = function () {
110
+ if (!this.initialized) {
111
+ this.setDestimationMeta(document.elementFromPoint(this.event.clientX, this.event.clientY));
112
+ this.initialized = true;
113
+ }
114
+ return this;
115
+ };
116
+ Object.defineProperty(TreeViewDragAnalyzer.prototype, "isDropAllowed", {
117
+ /**
118
+ * Returns `true` if dropping is allowed. Otherwise, returns `false`.
119
+ */
120
+ get: function () {
121
+ if (this.initialized && this.destItemId && this.destTreeViewGuid) {
122
+ // Disallow circular references.
123
+ return !((this.destTreeViewGuid + "_" + this.destItemId + "_").
124
+ startsWith(this.treeViewGuid + "_" + this.itemId + "_"));
125
+ }
126
+ else {
127
+ return false;
128
+ }
129
+ },
130
+ enumerable: false,
131
+ configurable: true
132
+ });
133
+ Object.defineProperty(TreeViewDragAnalyzer.prototype, "destinationMeta", {
134
+ /**
135
+ * Returns an object which contains:
136
+ * * The `itemHierarchicalIndex` of the destination item (the item below the dragged item) and
137
+ * * The `guid` of the destination TreeView (the TreeView which renders the destination item).
138
+ */
139
+ get: function () {
140
+ return { itemHierarchicalIndex: this.destItemId, treeViewGuid: this.destTreeViewGuid };
141
+ },
142
+ enumerable: false,
143
+ configurable: true
144
+ });
145
+ /**
146
+ * Returns the specific drop operation.
147
+ *
148
+ * @returns - The following values are returned:
149
+ * * `before`&mdash;Indicates that the dragged item is positioned at the beginning of the destination item.
150
+ * * `after`&mdash;Indicates that the dragged item is positioned at the end of the destination item.
151
+ * * `child`&mdash;Indicates that the dragged item is positioned in the middle of the destination item.
152
+ * * `undefined`&mdash;Indicates that dropping is not allowed.
153
+ */
154
+ TreeViewDragAnalyzer.prototype.getDropOperation = function () {
155
+ if (this.initialized && this.isDropAllowed) {
156
+ var _a = this.destDomNodeWithMeta.getBoundingClientRect(), top_1 = _a.top, height = _a.height;
157
+ if (top_1 + height - this.event.clientY < DROPZONE_BOUNDARY_DELTA) {
158
+ return 'after';
159
+ }
160
+ else if (this.event.clientY - top_1 < DROPZONE_BOUNDARY_DELTA) {
161
+ return 'before';
162
+ }
163
+ else {
164
+ return 'child';
165
+ }
166
+ }
167
+ else {
168
+ return undefined;
169
+ }
170
+ };
171
+ TreeViewDragAnalyzer.prototype.setDestimationMeta = function (element) {
172
+ var node = element;
173
+ while (node && !node[DOM_KENDO_ITEM_ID_FIELD]) {
174
+ node = node.parentNode;
175
+ }
176
+ if (node && node[DOM_KENDO_ITEM_ID_FIELD]) {
177
+ this.destDomNodeWithMeta = node;
178
+ this.destItemId = node[DOM_KENDO_ITEM_ID_FIELD];
179
+ this.destTreeViewGuid = node[DOM_KENDO_TREEVIEW_GUID_FIELD];
180
+ }
181
+ };
182
+ return TreeViewDragAnalyzer;
183
+ }());
184
+ export default TreeViewDragAnalyzer;