@progress/kendo-vue-dropdowns 3.11.0-dev.202305230623 → 3.11.0-dev.202305230751

package/dist/es/DropDownList/DropDownList.js

@@ -25,6 +25,7 @@ import { ListFilter } from '../common/ListFilter';
 import { ListDefaultItem } from '../common/ListDefaultItem';
 import { List } from '../common/List';
 import DropDownBase from '../common/DropDownBase';
+import { GroupStickyHeader } from '../common/GroupStickyHeader';
 import { selectButton, messages } from '../messages/main';
 import { provideLocalizationService } from '@progress/kendo-vue-intl';
 import { isPresent, getItemValue, sameCharsOnly, shuffleData, matchText, areSame, preventDefaultNonInputs, getFocusedItem } from '../common/utils';
@@ -127,6 +128,8 @@ var DropDownListVue2 = {
       }
     },
     itemRender: [String, Function, Object],
+    groupHeaderItemRender: [String, Function, Object],
+    groupStickyHeaderItemRender: [String, Function, Object],
     listNoDataRender: [String, Function, Object],
     focusedItemIndex: Function,
     header: [String, Function, Object],
@@ -163,6 +166,9 @@ var DropDownListVue2 = {
       validator: function validator(value) {
         return ['small', 'medium', 'large'].includes(value);
       }
+    },
+    groupField: {
+      type: String
     }
   },
   inject: {
@@ -183,7 +189,10 @@ var DropDownListVue2 = {
       },
       _skipFocusEvent: false,
       valueDuringOnChange: {},
-      _navigated: false
+      _navigated: false,
+      group: undefined,
+      isScrolling: false,
+      itemHeight: 0
     };
   },
   watch: {
@@ -234,11 +243,14 @@ var DropDownListVue2 = {
     this.setValidity();
   },
   updated: function updated() {
-    var _a = this.$props,
-      _b = _a.dataItems,
-      dataItems = _b === void 0 ? [] : _b,
-      dataItemKey = _a.dataItemKey,
-      virtual = _a.virtual;
+    var _a;
+    var _b = this.$props,
+      _c = _b.dataItems,
+      dataItems = _c === void 0 ? [] : _c,
+      dataItemKey = _b.dataItemKey,
+      virtual = _b.virtual,
+      groupField = _b.groupField,
+      textField = _b.textField;
     var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
     var prevOpened = this.prevOpened !== undefined ? this.prevOpened : this.prevCurrentOpened;
     var opening = !prevOpened && opened;
@@ -282,11 +294,19 @@ var DropDownListVue2 = {
       var selectedItemIndex = dataItems.findIndex(function (i) {
         return areSame(i, selectedItem_1, dataItemKey);
       });
+      // Needed to calculate the proper item index when in grouping mode
+      if (groupField) {
+        selectedItemIndex = (_a = this.base.getGroupedDataModernMode(dataItems, groupField)) === null || _a === void 0 ? void 0 : _a.indexOf(selectedItem_1);
+      }
       var selectedItemChanged = !areSame(prevSelectedItem, selectedItem_1, dataItemKey);
       if (opening && virtual) {
         this.base.scrollToVirtualItem(virtual, selectedItemIndex);
         this.prevCurrentOpened = true;
       } else if (opening && !virtual) {
+        // Resets the sticky header group value for scenarios with open/close of component's popup
+        if (dataItems && dataItems.length !== 0) {
+          this.base.resetGroupStickyHeader(dataItems[0][groupField], this);
+        }
         this.base.scrollToItem(selectedItemIndex);
         this.prevCurrentOpened = true;
       } else if (opened && prevOpened && selectedItem_1 && selectedItemChanged && !this._navigated) {
@@ -487,6 +507,9 @@ var DropDownListVue2 = {
       }
     },
     handleKeyDown: function handleKeyDown(event) {
+      if (this.isScrolling) {
+        this.isScrolling = false;
+      }
       var _a = this.$props,
         _b = _a.dataItems,
         dataItems = _b === void 0 ? [] : _b,
@@ -611,6 +634,8 @@ var DropDownListVue2 = {
         state.data.currentText = event.target.value;
       }
       this.base.filterChanged(event.target.value, state);
+      // Used to reset the value of the StickyHeader when filtering the data
+      state.data.group = undefined;
       this.applyState(state);
     },
     onPopupOpened: function onPopupOpened() {
@@ -682,6 +707,39 @@ var DropDownListVue2 = {
     },
     repositionPopup: function repositionPopup() {
       this.base.repositionPopup();
+    },
+    onScroll: function onScroll(event) {
+      this.isScrolling = true;
+      var _a = this.base,
+        vs = _a.vs,
+        list = _a.list;
+      vs.scrollHandler(event);
+      var state = this.base.initState();
+      var groupField = this.$props.groupField;
+      var _b = this.$props.dataItems,
+        dataItems = _b === void 0 ? [] : _b;
+      if (!groupField || !dataItems.length) {
+        return;
+      }
+      var itemHeight = this.itemHeight = this.itemHeight || (vs.enabled ? vs.itemHeight : list ? list.children[0].offsetHeight : 0);
+      var target = event.target;
+      var scrollTop = target.scrollTop - vs.skip * itemHeight;
+      if (groupField) {
+        dataItems = this.base.getGroupedDataModernMode(dataItems, groupField);
+      }
+      var group = dataItems[0][groupField];
+      for (var i = 1; i < dataItems.length; i++) {
+        if (itemHeight * i > scrollTop) {
+          break;
+        }
+        if (dataItems[i] && dataItems[i][groupField]) {
+          group = dataItems[i][groupField];
+        }
+      }
+      if (group !== this.group) {
+        state.data.group = group;
+        this.applyState(state);
+      }
     }
   },
   render: function render(createElement) {
@@ -799,11 +857,18 @@ var DropDownListVue2 = {
     };
     var renderList = function renderList() {
       var _this2 = this;
-      var textField = this.$props.textField;
+      var _a = this.$props,
+        textField = _a.textField,
+        groupField = _a.groupField;
+      var dataItemsToRender = this.$props.dataItems || [];
       var itemRender = templateRendering.call(this, this.$props.itemRender, getListeners.call(this));
+      var groupHeaderItemRender = templateRendering.call(this, this.$props.groupHeaderItemRender, getListeners.call(this));
       var listNoDataRender = templateRendering.call(this, this.$props.listNoDataRender, getListeners.call(this));
       var skip = virtual.skip;
       var translate = "translateY(".concat(vs.translate, "px)");
+      if (groupField) {
+        dataItemsToRender = this.base.getGroupedDataModernMode(dataItemsToRender, groupField);
+      }
       return (
         // @ts-ignore  function children
         h(List, {
@@ -811,7 +876,7 @@ var DropDownListVue2 = {
           attrs: this.v3 ? undefined : {
             id: this.base.listBoxId,
             show: opened,
-            dataItems: dataItems.slice(),
+            dataItems: dataItemsToRender.slice(),
             focusedIndex: this.focusedIndex(),
             value: this.computedValue(),
             textField: textField,
@@ -826,10 +891,12 @@ var DropDownListVue2 = {
             } : undefined,
             skip: skip,
             itemRender: itemRender,
-            noDataRender: listNoDataRender
+            groupHeaderItemRender: groupHeaderItemRender,
+            noDataRender: listNoDataRender,
+            groupField: groupField
           },
           show: opened,
-          dataItems: dataItems.slice(),
+          dataItems: dataItemsToRender.slice(),
           focusedIndex: this.focusedIndex(),
           value: this.computedValue(),
           textField: textField,
@@ -848,11 +915,13 @@ var DropDownListVue2 = {
           onListclick: this.handleItemClick,
           on: this.v3 ? undefined : {
             "listclick": this.handleItemClick,
-            "scroll": vs.scrollHandler
+            "scroll": this.onScroll
           },
           itemRender: itemRender,
+          groupHeaderItemRender: groupHeaderItemRender,
           noDataRender: listNoDataRender,
-          onScroll: vs.scrollHandler
+          groupField: groupField,
+          onScroll: this.onScroll
         }, this.v3 ? function () {
           return [renderScrollElement.call(_this2)];
         } : [renderScrollElement.call(_this2)])
@@ -893,6 +962,7 @@ var DropDownListVue2 = {
       var _a;
       var headerTemplate = templateRendering.call(this, this.$props.header, getListeners.call(this));
       var footerTemplate = templateRendering.call(this, this.$props.footer, getListeners.call(this));
+      var groupStickyHeaderTemplate = templateRendering.call(this, this.$props.groupStickyHeaderItemRender, getListeners.call(this));
       var header = getTemplate.call(this, {
         h: h,
         template: headerTemplate
@@ -902,6 +972,9 @@ var DropDownListVue2 = {
         template: footerTemplate
       });
       var popupWidth = popupSettings.width !== undefined ? popupSettings.width : base.popupWidth;
+      if (this.group === undefined && this.$props.groupField !== undefined) {
+        this.group = getItemValue(dataItems[0], this.$props.groupField);
+      }
       return (
         // @ts-ignore  function children
         h(ListContainer, {
@@ -937,12 +1010,26 @@ var DropDownListVue2 = {
           onClose: this.onPopupClosed,
           onBlur: this.handleBlur
         }, this.v3 ? function () {
-          return [renderListFilter.call(_this3), renderDefaultItem.call(_this3), header && h("div", {
+          return [renderListFilter.call(_this3), renderDefaultItem.call(_this3), _this3.group && dataItems.length !== 0 && h(GroupStickyHeader, {
+            group: _this3.group,
+            attrs: _this3.v3 ? undefined : {
+              group: _this3.group,
+              render: groupStickyHeaderTemplate
+            },
+            render: groupStickyHeaderTemplate
+          }), header && h("div", {
             "class": "k-list-header"
           }, [header]), renderList.call(_this3), footer && h("div", {
             "class": "k-list-footer"
           }, [footer])];
-        } : [renderListFilter.call(_this3), renderDefaultItem.call(_this3), header && h("div", {
+        } : [renderListFilter.call(_this3), renderDefaultItem.call(_this3), _this3.group && dataItems.length !== 0 && h(GroupStickyHeader, {
+          group: _this3.group,
+          attrs: _this3.v3 ? undefined : {
+            group: _this3.group,
+            render: groupStickyHeaderTemplate
+          },
+          render: groupStickyHeaderTemplate
+        }), header && h("div", {
           "class": "k-list-header"
         }, [header]), renderList.call(_this3), footer && h("div", {
           "class": "k-list-footer"

package/dist/es/DropDownList/DropDownListProps.d.ts

@@ -284,4 +284,16 @@ export interface DropDownListProps extends FormComponentProps {
      * @default `solid`
      */
     fillMode?: null | 'solid' | 'outline' | 'flat' | string;
+    /**
+     * Sets the data item field that represents the start of a group. Applicable to objects data.
+     */
+    groupField?: string;
+    /**
+     * Fires when a DropDownList group header item is about to be rendered. Used to override the default appearance of the group's headers.
+     */
+    groupHeaderItemRender?: any;
+    /**
+     * Fires when a DropDownList sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    groupStickyHeaderItemRender?: any;
 }

package/dist/es/MultiSelect/MultiSelect.js

@@ -33,6 +33,7 @@ import { List } from '../common/List';
 import { TagList } from './TagList';
 import { SearchBar } from '../common/SearchBar';
 import DropDownBase from '../common/DropDownBase';
+import { GroupStickyHeader } from '../common/GroupStickyHeader';
 import { ClearButton } from '../common/ClearButton';
 import { ActiveDescendant } from './../common/settings';
 import { itemIndexStartsWith, getItemValue, areSame, matchDataCollections, removeDataItems, isPresent, preventDefaultNonInputs } from '../common/utils';
@@ -139,6 +140,8 @@ var MultiSelectVue2 = {
       }
     },
     itemRender: [String, Function, Object],
+    groupHeaderItemRender: [String, Function, Object],
+    groupStickyHeaderItemRender: [String, Function, Object],
     listNoDataRender: [String, Function, Object],
     focusedItemIndex: Function,
     virtual: {
@@ -181,6 +184,9 @@ var MultiSelectVue2 = {
       validator: function validator(value) {
         return ['small', 'medium', 'large'].includes(value);
       }
+    },
+    groupField: {
+      type: String
     }
   },
   // @ts-ignore
@@ -232,7 +238,10 @@ var MultiSelectVue2 = {
         last: ''
       },
       suggested: '',
-      activedescendant: ActiveDescendant.PopupList
+      activedescendant: ActiveDescendant.PopupList,
+      group: undefined,
+      isScrolling: false,
+      itemHeight: 0
     };
   },
   watch: {
@@ -249,7 +258,13 @@ var MultiSelectVue2 = {
     }
   },
   updated: function updated() {
-    var virtual = this.$props.virtual;
+    var _a;
+    var _b = this.$props,
+      virtual = _b.virtual,
+      _c = _b.groupField,
+      groupField = _c === void 0 ? '' : _c,
+      _d = _b.dataItems,
+      dataItems = _d === void 0 ? [] : _d;
     var skip = virtual ? virtual.skip : 0;
     var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
     var prevOpened = this.prevOpened !== undefined ? this.prevOpened : this.prevCurrentOpened;
@@ -270,29 +285,38 @@ var MultiSelectVue2 = {
     if (scrollElement) {
       this.base.vs.scrollElement = scrollElement;
     }
-    if (list && this.dataItems.length) {
+    if (list && dataItems.length) {
       // @ts-ignore
       this.base.vs.scrollerRef(list.$el);
     }
     if (!popupSettings.animate && closing) {
       this.onPopupClosed();
     }
-    if (virtual && this.virtualTotalHasChanged) {
-      this.base.vs.calcScrollElementHeight();
-      this.base.vs.reset();
-      this.virtualTotalHasChanged = false;
-    } else {
-      var _a = this.getFocusedState(),
-        focusedItem = _a.focusedItem,
-        focusedIndex = _a.focusedIndex;
-      if (opening && virtual) {
-        this.base.scrollToVirtualItem(virtual, focusedIndex - skip);
-        this.prevCurrentOpened = true;
-      } else if (opening && !virtual) {
-        this.base.scrollToItem(focusedIndex);
-        this.prevCurrentOpened = true;
-      } else if (opened && prevOpened && focusedItem && this.scrollToFocused) {
-        this.base.scrollToItem(focusedIndex - skip);
+    if (!this.isScrolling) {
+      if (virtual && this.virtualTotalHasChanged) {
+        this.base.vs.calcScrollElementHeight();
+        this.base.vs.reset();
+        this.virtualTotalHasChanged = false;
+      } else {
+        var _e = this.getFocusedState(),
+          focusedItem = _e.focusedItem,
+          focusedIndex = _e.focusedIndex;
+        if (groupField !== '') {
+          focusedIndex = (_a = this.base.getGroupedDataModernMode(dataItems, groupField)) === null || _a === void 0 ? void 0 : _a.indexOf(focusedItem);
+        }
+        if (opening && virtual) {
+          this.base.scrollToVirtualItem(virtual, focusedIndex - skip);
+          this.prevCurrentOpened = true;
+        } else if (opening && !virtual) {
+          // Resets the sticky header group value for scenarios with open/close of component's popup
+          if (dataItems && dataItems.length !== 0) {
+            this.base.resetGroupStickyHeader(dataItems[0][groupField], this);
+          }
+          this.base.scrollToItem(focusedIndex);
+          this.prevCurrentOpened = true;
+        } else if (opened && prevOpened && focusedItem) {
+          this.base.scrollToItem(focusedIndex - skip);
+        }
       }
     }
     this.scrollToFocused = false;
@@ -478,6 +502,10 @@ var MultiSelectVue2 = {
         this.base.togglePopup(state);
       }
       this.base.filterChanged(value, state);
+      // Resets the value of the StickyHeader when filtering the data or just entering symbols in the input
+      if (this.$props.filterable) {
+        state.data.group = undefined;
+      }
       this.applyState(state);
     },
     clearButtonClick: function clearButtonClick(event) {
@@ -505,6 +533,9 @@ var MultiSelectVue2 = {
     },
     onInputKeyDown: function onInputKeyDown(event) {
       var _this = this;
+      if (this.isScrolling) {
+        this.isScrolling = false;
+      }
       var keyCode = event.keyCode;
       var text = this.$props.filter !== undefined ? this.$props.filter : this.currentText;
       var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
@@ -794,6 +825,39 @@ var MultiSelectVue2 = {
     },
     repositionPopup: function repositionPopup() {
       this.base.repositionPopup();
+    },
+    onScroll: function onScroll(event) {
+      this.isScrolling = true;
+      var _a = this.base,
+        vs = _a.vs,
+        list = _a.list;
+      vs.scrollHandler(event);
+      var state = this.base.initState();
+      var groupField = this.$props.groupField;
+      var _b = this.$props.dataItems,
+        dataItems = _b === void 0 ? [] : _b;
+      if (!groupField || !dataItems.length) {
+        return;
+      }
+      var itemHeight = this.itemHeight = this.itemHeight || (vs.enabled ? vs.itemHeight : list ? list.children[0].offsetHeight : 0);
+      var target = event.target;
+      var scrollTop = target.scrollTop - vs.skip * itemHeight;
+      if (groupField) {
+        dataItems = this.base.getGroupedDataModernMode(dataItems, groupField);
+      }
+      var group = dataItems[0][groupField];
+      for (var i = 1; i < dataItems.length; i++) {
+        if (itemHeight * i > scrollTop) {
+          break;
+        }
+        if (dataItems[i] && dataItems[i][groupField]) {
+          group = dataItems[i][groupField];
+        }
+      }
+      if (group !== this.group) {
+        state.data.group = group;
+        this.applyState(state);
+      }
     }
   },
   render: function render(createElement) {
@@ -899,14 +963,18 @@ var MultiSelectVue2 = {
     };
     var renderList = function renderList() {
       var _this2 = this;
-      var _a = this.$props.dataItems,
-        dataItems = _a === void 0 ? [] : _a;
+      var groupField = this.$props.groupField;
+      var dataItems = this.$props.dataItems || [];
       var itemRender = templateRendering.call(this, this.$props.itemRender, getListeners.call(this));
+      var groupHeaderItemRender = templateRendering.call(this, this.$props.groupHeaderItemRender, getListeners.call(this));
       var listNoDataRender = templateRendering.call(this, this.$props.listNoDataRender, getListeners.call(this));
       var skip = virtual ? virtual.skip : 0;
       var opened = this.$props.opened !== undefined ? this.$props.opened : this.currentOpened;
       var focusedIndex = this.getFocusedState().focusedIndex;
       var translate = "translateY(".concat(vs.translate, "px)");
+      if (groupField) {
+        dataItems = this.base.getGroupedDataModernMode(dataItems, groupField);
+      }
       return (
         // @ts-ignore  function children
         h(List, {
@@ -929,7 +997,9 @@ var MultiSelectVue2 = {
             } : undefined,
             skip: skip,
             itemRender: itemRender,
-            noDataRender: listNoDataRender
+            groupHeaderItemRender: groupHeaderItemRender,
+            noDataRender: listNoDataRender,
+            groupField: groupField
           },
           show: opened,
           dataItems: dataItems.slice(),
@@ -951,11 +1021,13 @@ var MultiSelectVue2 = {
           onListclick: this.handleItemClick,
           on: this.v3 ? undefined : {
             "listclick": this.handleItemClick,
-            "scroll": vs.scrollHandler
+            "scroll": this.onScroll
           },
           itemRender: itemRender,
+          groupHeaderItemRender: groupHeaderItemRender,
           noDataRender: listNoDataRender,
-          onScroll: vs.scrollHandler
+          groupField: groupField,
+          onScroll: this.onScroll
         }, this.v3 ? function () {
           return [renderScrollElement.call(_this2)];
         } : [renderScrollElement.call(_this2)])
@@ -977,6 +1049,7 @@ var MultiSelectVue2 = {
         dataItems = _c === void 0 ? [] : _c;
       var headerTemplate = templateRendering.call(this, this.$props.header, getListeners.call(this));
       var footerTemplate = templateRendering.call(this, this.$props.footer, getListeners.call(this));
+      var groupStickyHeaderTemplate = templateRendering.call(this, this.$props.groupStickyHeaderItemRender, getListeners.call(this));
       var header = getTemplate.call(this, {
         h: h,
         template: headerTemplate
@@ -1011,6 +1084,9 @@ var MultiSelectVue2 = {
           float: 'right'
         }
       })])]);
+      if (this.group === undefined && this.$props.groupField !== undefined) {
+        this.group = getItemValue(dataItems[0], this.$props.groupField);
+      }
       return (
         // @ts-ignore  function children
         h(ListContainer, {
@@ -1048,12 +1124,26 @@ var MultiSelectVue2 = {
         }, this.v3 ? function () {
           return [header && h("div", {
             "class": "k-list-header"
-          }, [header]), customItem, renderList.call(_this3), footer && h("div", {
+          }, [header]), customItem, _this3.group && dataItems.length !== 0 && h(GroupStickyHeader, {
+            group: _this3.group,
+            attrs: _this3.v3 ? undefined : {
+              group: _this3.group,
+              render: groupStickyHeaderTemplate
+            },
+            render: groupStickyHeaderTemplate
+          }), renderList.call(_this3), footer && h("div", {
             "class": "k-list-footer"
           }, [footer]), virtual && header];
         } : [header && h("div", {
           "class": "k-list-header"
-        }, [header]), customItem, renderList.call(_this3), footer && h("div", {
+        }, [header]), customItem, _this3.group && dataItems.length !== 0 && h(GroupStickyHeader, {
+          group: _this3.group,
+          attrs: _this3.v3 ? undefined : {
+            group: _this3.group,
+            render: groupStickyHeaderTemplate
+          },
+          render: groupStickyHeaderTemplate
+        }), renderList.call(_this3), footer && h("div", {
           "class": "k-list-footer"
         }, [footer]), virtual && header])
       );

package/dist/es/MultiSelect/MultiSelectProps.d.ts

@@ -263,4 +263,16 @@ export interface MultiSelectProps extends FormComponentProps {
      * @default `solid`
      */
     fillMode?: null | 'solid' | 'outline' | 'flat' | string;
+    /**
+     * Sets the data item field that represents the start of a group. Applicable to objects data.
+     */
+    groupField?: string;
+    /**
+     * Fires when a MultiSelect group header item is about to be rendered. Used to override the default appearance of the group's headers.
+     */
+    groupHeaderItemRender?: any;
+    /**
+     * Fires when a MultiSelect sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    groupStickyHeaderItemRender?: any;
 }

package/dist/es/common/DropDownBase.d.ts

@@ -82,4 +82,6 @@ export default class DropDownBase {
     triggerOnPageChange(state: InternalState, skip: number, take: number): void;
     triggerPageChangeCornerItems(item: any, state: InternalState): void;
     scrollToVirtualItem: (virtual: VirtualizationSettings, selectedItemIndex: number) => void;
+    getGroupedDataModernMode: (data: any[], groupField: string) => any[];
+    resetGroupStickyHeader: (groupName: string, that: any) => void;
 }

package/dist/es/common/DropDownBase.js

@@ -113,6 +113,26 @@ var DropDownBase = /** @class */function () {
         return vs.enabled = true;
       }, 10);
     };
+    this.getGroupedDataModernMode = function (data, groupField) {
+      var newData = [];
+      data.forEach(function (el, index) {
+        var _a;
+        if (data[index - 1] && el[groupField] !== data[index - 1][groupField]) {
+          newData.push((_a = {}, _a[groupField] = el[groupField], _a));
+          newData.push(data[index]);
+        } else {
+          newData.push(data[index]);
+        }
+      });
+      return newData;
+    };
+    this.resetGroupStickyHeader = function (groupName, that) {
+      var state = _this.initState();
+      if (groupName !== that.group && that.state) {
+        that.state.data.group = groupName;
+        _this.applyState(state);
+      }
+    };
     validatePackage(packageMetadata);
     this.listBoxId = guid();
     this.guid = guid();

package/dist/es/common/GroupStickyHeader.d.ts

@@ -0,0 +1,29 @@
+import { DefineComponent, RecordPropsDefinition, ComponentOptions, Vue2type } from '../additionalTypes';
+declare type DefaultData<V> = object | ((this: V) => {});
+declare type DefaultMethods<V> = {
+    [key: string]: (this: V, ...args: any[]) => any;
+};
+/**
+ * Represents the props of the GroupStickyHeader component.
+ */
+export interface GroupStickyHeaderProps {
+    /**
+     * The group that will be rendered.
+     */
+    group?: string;
+    /**
+     * Fires when a sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    render?: any;
+}
+export interface GroupStickyHeaderAll extends Vue2type {
+}
+/**
+ * @hidden
+ */
+declare let GroupStickyHeaderVue2: ComponentOptions<Vue2type, DefaultData<{}>, DefaultMethods<{}>, {}, RecordPropsDefinition<GroupStickyHeaderProps>>;
+/**
+ * @hidden
+ */
+declare const GroupStickyHeader: DefineComponent<GroupStickyHeaderProps, any, {}, {}, {}, {}, {}, {}, string, GroupStickyHeaderProps, GroupStickyHeaderProps, {}>;
+export { GroupStickyHeader, GroupStickyHeaderVue2 };

package/dist/es/common/GroupStickyHeader.js

@@ -0,0 +1,59 @@
+var __assign = this && this.__assign || function () {
+  __assign = Object.assign || function (t) {
+    for (var s, i = 1, n = arguments.length; i < n; i++) {
+      s = arguments[i];
+      for (var p in s) {
+        if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+      }
+    }
+    return t;
+  };
+  return __assign.apply(this, arguments);
+};
+// @ts-ignore
+import * as Vue from 'vue';
+var allVue = Vue;
+var gh = allVue.h;
+var isV3 = allVue.version && allVue.version[0] === '3';
+var ref = allVue.ref;
+import { getTemplate } from '@progress/kendo-vue-common';
+/**
+ * @hidden
+ */
+var GroupStickyHeaderVue2 = {
+  name: 'KendoGroupStickyHeader',
+  props: {
+    group: String,
+    render: Object
+  },
+  // @ts-ignore
+  setup: !isV3 ? undefined : function () {
+    var v3 = !!isV3;
+    return {
+      v3: v3
+    };
+  },
+  // @ts-ignore
+  render: function render(createElement) {
+    var h = gh || createElement;
+    var _a = this.$props,
+      group = _a.group,
+      render = _a.render;
+    var defaulGroupStickyHeader = h("div", {
+      "class": "k-list-group-sticky-header"
+    }, [h("div", {
+      "class": "k-list-header-text"
+    }, [group])]);
+    return getTemplate.call(this, {
+      h: h,
+      template: render,
+      defaultRendering: defaulGroupStickyHeader,
+      additionalProps: __assign({}, this.$props)
+    });
+  }
+};
+/**
+ * @hidden
+ */
+var GroupStickyHeader = GroupStickyHeaderVue2;
+export { GroupStickyHeader, GroupStickyHeaderVue2 };

package/dist/es/common/List.d.ts

@@ -23,8 +23,10 @@ export interface ListProps {
     highlightSelected?: boolean;
     onClick?: (index: number, event: any) => void;
     itemRender?: any;
+    groupHeaderItemRender?: any;
     noDataRender?: any;
     scroller?: boolean;
+    groupField: string;
 }
 /**
  * @hidden