@progress/kendo-react-dropdowns 5.13.0-dev.202304200559 → 5.13.0-dev.202304201241

package/dist/npm/ComboBox/ComboBox.js

@@ -37,6 +37,7 @@ var SearchBar_1 = require("../common/SearchBar");
 var ListContainer_1 = require("../common/ListContainer");
 var List_1 = require("../common/List");
 var ListFilter_1 = require("../common/ListFilter");
+var GroupStickyHeader_1 = require("../common/GroupStickyHeader");
 var kendo_react_common_2 = require("@progress/kendo-react-common");
 var package_metadata_1 = require("../package-metadata");
 var ClearButton_1 = require("../common/ClearButton");
@@ -123,7 +124,8 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
         _this.onScroll = function (event) {
             var _a = _this.base, vs = _a.vs, list = _a.list;
             vs.scrollHandler(event);
-            var _b = _this.props, _c = _b.data, data = _c === void 0 ? [] : _c, groupField = _b.groupField;
+            var groupField = _this.props.groupField;
+            var _b = _this.props.data, data = _b === void 0 ? [] : _b;
             if (!groupField || !data.length) {
                 return;
             }
@@ -131,6 +133,9 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
                 _this.itemHeight || (vs.enabled ? vs.itemHeight : (list ? list.children[0].offsetHeight : 0));
             var target = event.target;
             var scrollTop = target.scrollTop - (vs.skip * itemHeight);
+            if (_this.props.groupMode === 'modern') {
+                data = _this.base.getGroupedDataModernMode(data, groupField);
+            }
             var group = data[0][groupField];
             for (var i = 1; i < data.length; i++) {
                 if (itemHeight * i > scrollTop) {
@@ -381,7 +386,9 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
     });
     /** @hidden */
     ComboBoxWithoutContext.prototype.componentDidUpdate = function (prevProps, prevState) {
-        var _a = this.props, _b = _a.data, data = _b === void 0 ? [] : _b, dataItemKey = _a.dataItemKey, virtual = _a.virtual;
+        var _a;
+        var _b = this.props, dataItemKey = _b.dataItemKey, virtual = _b.virtual, _c = _b.groupField, groupField = _c === void 0 ? '' : _c;
+        var _d = this.props.data, data = _d === void 0 ? [] : _d;
         var prevTotal = prevProps.virtual ? prevProps.virtual.total : 0;
         var opened = this.props.opened !== undefined ? this.props.opened : this.state.opened;
         var prevOpened = prevProps.opened !== undefined ? prevProps.opened : prevState.opened;
@@ -395,6 +402,10 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
         else {
             var prevSelectedItem = prevProps.value !== undefined ? prevProps.value : prevState.value;
             var selectedItemIndex = data.findIndex(function (i) { return (0, utils_1.areSame)(i, selectedItem, dataItemKey); });
+            // Needed to calculate the proper item index when in 'modern' grouping mode
+            if (this.props.groupMode === 'modern') {
+                selectedItemIndex = (_a = this.base.getGroupedDataModernMode(data, groupField)) === null || _a === void 0 ? void 0 : _a.indexOf(selectedItem);
+            }
             var selectedItemChanged = !(0, utils_1.areSame)(prevSelectedItem, selectedItem, dataItemKey);
             if (opening && virtual) {
                 this.base.scrollToVirtualItem(virtual, selectedItemIndex);
@@ -585,7 +596,7 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
         var _a;
         var _this = this;
         var _b = this.state.windowWidth, windowWidth = _b === void 0 ? 0 : _b;
-        var _c = this.props, header = _c.header, footer = _c.footer, size = _c.size, _d = _c.data, data = _d === void 0 ? [] : _d, groupField = _c.groupField, list = _c.list, virtual = _c.virtual, adaptiveTitle = _c.adaptiveTitle;
+        var _c = this.props, header = _c.header, footer = _c.footer, size = _c.size, _d = _c.data, data = _d === void 0 ? [] : _d, groupField = _c.groupField, groupMode = _c.groupMode, list = _c.list, virtual = _c.virtual, adaptiveTitle = _c.adaptiveTitle, groupStickyHeaderItemRender = _c.groupStickyHeaderItemRender;
         var opened = this.props.opened !== undefined ? this.props.opened : this.state.opened;
         var group = this.state.group;
         if (group === undefined && groupField !== undefined) {
@@ -621,14 +632,14 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
                                 _a["k-table-".concat(sizeMap[size] || size)] = list && size,
                                 _a)) },
                             header && React.createElement("div", { className: "k-table-header" }, header),
-                            !list && group && React.createElement("div", { className: "k-list-group-sticky-header" }, group),
+                            !list && group && React.createElement(GroupStickyHeader_1.default, { group: group, groupMode: groupMode, render: groupStickyHeaderItemRender }),
                             this.renderList(),
                             footer && React.createElement("div", { className: "k-list-footer" }, footer)))))));
     };
     ComboBoxWithoutContext.prototype.renderListContainer = function () {
         var _a;
         var base = this.base;
-        var _b = this.props, dir = _b.dir, header = _b.header, footer = _b.footer, _c = _b.data, data = _c === void 0 ? [] : _c, groupField = _b.groupField, size = _b.size, list = _b.list, virtual = _b.virtual;
+        var _b = this.props, dir = _b.dir, header = _b.header, footer = _b.footer, _c = _b.data, data = _c === void 0 ? [] : _c, groupField = _b.groupField, groupMode = _b.groupMode, size = _b.size, list = _b.list, virtual = _b.virtual, groupStickyHeaderItemRender = _b.groupStickyHeaderItemRender;
         var opened = this.props.opened !== undefined ? this.props.opened : this.state.opened;
         var popupSettings = base.getPopupSettings();
         var popupWidth = popupSettings.width !== undefined ? popupSettings.width : base.popupWidth;
@@ -652,7 +663,7 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
                     _a["k-table-".concat(sizeMap[size] || size)] = list && size,
                     _a)) },
                 header && React.createElement("div", { className: "k-table-header" }, header),
-                !list && group && React.createElement("div", { className: "k-list-group-sticky-header" }, group),
+                !list && group && React.createElement(GroupStickyHeader_1.default, { group: group, groupMode: groupMode, render: groupStickyHeaderItemRender }),
                 this.renderList(),
                 footer && React.createElement("div", { className: "k-list-footer" }, footer))));
     };
@@ -660,7 +671,7 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
         var _a;
         var _this = this;
         var base = this.base;
-        var _b = this.props, textField = _b.textField, dataItemKey = _b.dataItemKey, listNoDataRender = _b.listNoDataRender, itemRender = _b.itemRender, _c = _b.data, data = _c === void 0 ? [] : _c, _d = _b.virtual, virtual = _d === void 0 ? { skip: 0 } : _d;
+        var _b = this.props, textField = _b.textField, dataItemKey = _b.dataItemKey, listNoDataRender = _b.listNoDataRender, itemRender = _b.itemRender, groupHeaderItemRender = _b.groupHeaderItemRender, _c = _b.data, data = _c === void 0 ? [] : _c, _d = _b.virtual, virtual = _d === void 0 ? { skip: 0 } : _d;
         var popupSettings = base.getPopupSettings();
         var vs = base.vs;
         var skip = virtual.skip;
@@ -671,11 +682,11 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
         var selectedItemText = (0, utils_1.getItemValue)(this.value, textField);
         var value = (0, utils_1.isPresent)(text) && text !== selectedItemText ? null : this.value;
         var ListComponent = this.props.list || List_1.default;
-        return (React.createElement(ListComponent, { id: base.listBoxId, virtual: Boolean(virtual), show: opened, data: data, focusedIndex: focusedIndex, value: value, textField: textField, valueField: dataItemKey, groupField: this.props.groupField, optionsGuid: base.guid, listRef: function (list) { vs.list = _this.base.list = list; _this.itemHeight = 0; }, wrapperStyle: (this.state.windowWidth && this.state.windowWidth > constants_1.MOBILE_MEDIUM_DEVISE)
+        return (React.createElement(ListComponent, { id: base.listBoxId, virtual: Boolean(virtual), show: opened, data: data, focusedIndex: focusedIndex, value: value, textField: textField, valueField: dataItemKey, groupField: this.props.groupField, groupMode: this.props.groupMode, isMultiColumn: this.props.isMultiColumn, optionsGuid: base.guid, listRef: function (list) { vs.list = _this.base.list = list; _this.itemHeight = 0; }, wrapperStyle: (this.state.windowWidth && this.state.windowWidth > constants_1.MOBILE_MEDIUM_DEVISE)
                 ? { maxHeight: popupSettings.height }
                 : {}, wrapperCssClass: (0, kendo_react_common_1.classNames)('k-list-content', (_a = {},
                 _a['k-list-scroller'] = !virtual,
-                _a)), listStyle: vs.enabled ? { transform: translate } : undefined, key: "listkey", skip: skip, onClick: this.handleItemClick, itemRender: itemRender, noDataRender: listNoDataRender, onMouseDown: function (e) { return e.preventDefault(); }, onScroll: this.onScroll, wrapperRef: vs.scrollerRef, scroller: this.base.renderScrollElement() }));
+                _a)), listStyle: vs.enabled ? { transform: translate } : undefined, key: "listkey", skip: skip, onClick: this.handleItemClick, itemRender: itemRender, groupHeaderItemRender: groupHeaderItemRender, noDataRender: listNoDataRender, onMouseDown: function (e) { return e.preventDefault(); }, onScroll: this.onScroll, wrapperRef: vs.scrollerRef, scroller: this.base.renderScrollElement() }));
     };
     ComboBoxWithoutContext.prototype.renderSearchBar = function (text, id, placeholder) {
         var _this = this;
@@ -731,9 +742,9 @@ var ComboBoxWithoutContext = /** @class */ (function (_super) {
     ;
     ComboBoxWithoutContext.displayName = 'ComboBox';
     /** @hidden */
-    ComboBoxWithoutContext.propTypes = __assign(__assign({}, DropDownBase_1.default.propTypes), { size: PropTypes.oneOf([null, 'small', 'medium', 'large']), rounded: PropTypes.oneOf([null, 'small', 'medium', 'large', 'full']), fillMode: PropTypes.oneOf([null, 'solid', 'flat', 'outline']), dataItemKey: PropTypes.string, groupField: PropTypes.string, suggest: PropTypes.bool, placeholder: PropTypes.string, allowCustom: PropTypes.bool, clearButton: PropTypes.bool, iconClassName: PropTypes.string, svgIcon: kendo_react_common_1.svgIconPropType, validationMessage: PropTypes.string, required: PropTypes.bool, id: PropTypes.string, ariaLabelledBy: PropTypes.string, ariaDescribedBy: PropTypes.string, list: PropTypes.any, valueRender: PropTypes.func });
+    ComboBoxWithoutContext.propTypes = __assign(__assign({}, DropDownBase_1.default.propTypes), { size: PropTypes.oneOf([null, 'small', 'medium', 'large']), rounded: PropTypes.oneOf([null, 'small', 'medium', 'large', 'full']), fillMode: PropTypes.oneOf([null, 'solid', 'flat', 'outline']), dataItemKey: PropTypes.string, groupField: PropTypes.string, groupMode: PropTypes.oneOf([undefined, 'classic', 'modern']), isMultiColumn: PropTypes.bool, suggest: PropTypes.bool, placeholder: PropTypes.string, allowCustom: PropTypes.bool, clearButton: PropTypes.bool, iconClassName: PropTypes.string, svgIcon: kendo_react_common_1.svgIconPropType, validationMessage: PropTypes.string, required: PropTypes.bool, id: PropTypes.string, ariaLabelledBy: PropTypes.string, ariaDescribedBy: PropTypes.string, list: PropTypes.any, valueRender: PropTypes.func });
     /** @hidden */
-    ComboBoxWithoutContext.defaultProps = __assign(__assign({}, DropDownBase_1.default.defaultProps), { size: 'medium', rounded: 'medium', fillMode: 'solid', allowCustom: false, clearButton: true, required: false });
+    ComboBoxWithoutContext.defaultProps = __assign(__assign({}, DropDownBase_1.default.defaultProps), { size: 'medium', rounded: 'medium', fillMode: 'solid', allowCustom: false, clearButton: true, required: false, groupMode: 'classic', isMultiColumn: false });
     return ComboBoxWithoutContext;
 }(React.Component));
 exports.ComboBoxWithoutContext = ComboBoxWithoutContext;

package/dist/npm/ComboBox/ComboBoxProps.d.ts

@@ -4,6 +4,8 @@ import { FilterChangeEvent, ChangeEvent, OpenEvent, CloseEvent, FocusEvent, Blur
 import { FormComponentProps, SVGIcon } from '@progress/kendo-react-common';
 import { VirtualizationSettings, DropDownsPopupSettings } from '../common/settings';
 import { ListItemProps } from '../common/ListItem';
+import { ListGroupItemProps } from '../common/ListGroupItem';
+import { GroupStickyHeaderProps } from '../common/GroupStickyHeader';
 /**
  * Represents the object of the `FilterChange` ComboBox event.
  */
@@ -131,6 +133,14 @@ export interface ComboBoxProps extends FormComponentProps {
      * Sets the data item field that represents the start of a group. Applicable to objects data.
      */
     groupField?: string;
+    /**
+     * Defines the `classic` or `modern` type of the grouping's visualization. Defaults to `classic`.
+     */
+    groupMode?: string;
+    /**
+     * @hidden Used to indicate if the ComboBox is with multiple columns
+     */
+    isMultiColumn?: boolean;
     /**
      * Sets the key for comparing the data items of the ComboBox. If `dataItemKey` is not set, the ComboBox compares the items by reference ([see example]({% slug binding_combobox %}#toc-datasets-of-objects)).
      */
@@ -213,6 +223,14 @@ export interface ComboBoxProps extends FormComponentProps {
      * Fires when a ComboBox list item is about to be rendered ([see example]({% slug customrendering_combobox %}#toc-items)). Used to override the default appearance of the list items.
      */
     itemRender?: (li: React.ReactElement<HTMLLIElement>, itemProps: ListItemProps) => React.ReactNode;
+    /**
+     * Fires when a ComboBox group header item is about to be rendered. Used to override the default appearance of the group's headers when the component is configured in `modern` group mode.
+     */
+    groupHeaderItemRender?: (li: React.ReactElement<HTMLLIElement>, itemProps: ListGroupItemProps) => React.ReactNode;
+    /**
+     * Fires when a ComboBox sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    groupStickyHeaderItemRender?: (div: React.ReactElement<HTMLDivElement>, stickyHeaderProps: GroupStickyHeaderProps) => React.ReactNode;
     /**
      * Fires when the element which indicates no data in the popup is about to be rendered. Used to override the default appearance of the element.
      */

package/dist/npm/DropDownList/DropDownList.d.ts

@@ -80,6 +80,8 @@ export declare class DropDownListWithoutContext extends React.Component<DropDown
         ariaLabel: PropTypes.Requireable<string>;
         leftRightKeysNavigation: PropTypes.Requireable<boolean>;
         title: PropTypes.Requireable<string>;
+        groupField: PropTypes.Requireable<string>;
+        list: PropTypes.Requireable<any>;
     };
     /**
      * @hidden
@@ -89,6 +91,7 @@ export declare class DropDownListWithoutContext extends React.Component<DropDown
         size: "small" | "medium" | "large" | null | undefined;
         rounded: "small" | "medium" | "full" | "large" | null | undefined;
         fillMode: "flat" | "outline" | "solid" | null | undefined;
+        groupMode: string | undefined;
         popupSettings: {
             height: string;
         };
@@ -111,6 +114,7 @@ export declare class DropDownListWithoutContext extends React.Component<DropDown
     private _valueDuringOnChange;
     private _navigated;
     private _inputId;
+    private itemHeight;
     private observerResize?;
     private get document();
     constructor(props: DropDownListProps);
@@ -170,6 +174,7 @@ export declare class DropDownListWithoutContext extends React.Component<DropDown
     private renderAdaptiveListContainer;
     private renderListContainer;
     private renderList;
+    private onScroll;
     private renderListFilter;
     private renderDefaultItem;
     private search;

package/dist/npm/DropDownList/DropDownList.js

@@ -34,6 +34,7 @@ var kendo_react_labels_1 = require("@progress/kendo-react-labels");
 var kendo_svg_icons_1 = require("@progress/kendo-svg-icons");
 var ListContainer_1 = require("../common/ListContainer");
 var ListFilter_1 = require("../common/ListFilter");
+var GroupStickyHeader_1 = require("../common/GroupStickyHeader");
 var ListDefaultItem_1 = require("../common/ListDefaultItem");
 var List_1 = require("../common/List");
 var DropDownBase_1 = require("../common/DropDownBase");
@@ -66,6 +67,7 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
         _this._filterInput = null;
         _this._navigated = false;
         _this._inputId = (0, kendo_react_common_1.guid)();
+        _this.itemHeight = 0;
         /**
          * @hidden
          */
@@ -99,7 +101,7 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
         };
         _this.renderListContainer = function () {
             var _a;
-            var _b = _this.props, header = _b.header, footer = _b.footer, dir = _b.dir, _c = _b.data, data = _c === void 0 ? [] : _c, size = _b.size;
+            var _b = _this.props, header = _b.header, footer = _b.footer, dir = _b.dir, _c = _b.data, data = _c === void 0 ? [] : _c, size = _b.size, groupField = _b.groupField, groupStickyHeaderItemRender = _b.groupStickyHeaderItemRender, list = _b.list;
             var base = _this.base;
             var popupSettings = base.getPopupSettings();
             var opened = _this.props.opened !== undefined ? _this.props.opened : _this.state.opened;
@@ -119,24 +121,57 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
                 },
                 itemsCount: [data.length]
             };
+            var group = _this.state.group;
+            if (group === undefined && groupField !== undefined) {
+                group = (0, utils_1.getItemValue)(data[0], groupField);
+            }
             return (React.createElement(ListContainer_1.default, __assign({}, listContainerProps),
                 _this.renderListFilter(),
                 header && React.createElement("div", { className: "k-list-header" }, header),
                 React.createElement("div", { className: (0, kendo_react_common_1.classNames)('k-list', (_a = {}, _a["k-list-".concat(sizeMap[size] || size)] = size, _a['k-virtual-list'] = _this.base.vs.enabled, _a)) },
                     _this.renderDefaultItem(),
+                    !list && group && React.createElement(GroupStickyHeader_1.default, { group: group, groupMode: 'modern', render: groupStickyHeaderItemRender }),
                     _this.renderList()),
                 footer && React.createElement("div", { className: "k-list-footer" }, footer)));
         };
         _this.renderList = function () {
-            var _a = _this.props, _b = _a.data, data = _b === void 0 ? [] : _b, textField = _a.textField, dataItemKey = _a.dataItemKey, _c = _a.virtual, virtual = _c === void 0 ? { skip: 0 } : _c, listNoDataRender = _a.listNoDataRender, itemRender = _a.itemRender;
+            var _a = _this.props, _b = _a.data, data = _b === void 0 ? [] : _b, textField = _a.textField, dataItemKey = _a.dataItemKey, _c = _a.virtual, virtual = _c === void 0 ? { skip: 0 } : _c, groupHeaderItemRender = _a.groupHeaderItemRender, listNoDataRender = _a.listNoDataRender, itemRender = _a.itemRender;
             var vs = _this.base.vs;
             var skip = virtual.skip;
             var opened = _this.props.opened !== undefined ? _this.props.opened : _this.state.opened;
             var popupSettings = _this.base.getPopupSettings();
             var translate = "translateY(".concat(vs.translate, "px)");
-            return (React.createElement(List_1.default, { id: _this.base.listBoxId, show: opened, data: data.slice(), focusedIndex: _this.focusedIndex(), value: _this.value, textField: textField, valueField: dataItemKey, optionsGuid: _this.base.guid, listRef: function (list) { return vs.list = _this.base.list = list; }, wrapperStyle: { maxHeight: popupSettings.height }, wrapperCssClass: "k-list-content", listStyle: vs.enabled ? { transform: translate } : undefined, key: "listkey", skip: skip, onClick: _this.handleItemClick, itemRender: itemRender, noDataRender: listNoDataRender, onScroll: function (e) {
-                    vs.scrollHandler(e);
-                }, wrapperRef: vs.scrollerRef, scroller: _this.base.renderScrollElement() }));
+            return (React.createElement(List_1.default, { id: _this.base.listBoxId, show: opened, data: data.slice(), focusedIndex: _this.focusedIndex(), value: _this.value, textField: textField, valueField: dataItemKey, optionsGuid: _this.base.guid, groupField: _this.props.groupField, groupMode: 'modern', listRef: function (list) { return vs.list = _this.base.list = list; }, wrapperStyle: { maxHeight: popupSettings.height }, wrapperCssClass: "k-list-content", listStyle: vs.enabled ? { transform: translate } : undefined, key: "listkey", skip: skip, onClick: _this.handleItemClick, itemRender: itemRender, groupHeaderItemRender: groupHeaderItemRender, noDataRender: listNoDataRender, onScroll: _this.onScroll, wrapperRef: vs.scrollerRef, scroller: _this.base.renderScrollElement() }));
+        };
+        _this.onScroll = function (event) {
+            var _a = _this.base, vs = _a.vs, list = _a.list;
+            vs.scrollHandler(event);
+            var groupField = _this.props.groupField;
+            var _b = _this.props.data, data = _b === void 0 ? [] : _b;
+            if (!groupField || !data.length) {
+                return;
+            }
+            if (groupField) {
+                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);
+                data = _this.base.getGroupedDataModernMode(data, groupField);
+                var group = data[0][groupField];
+                for (var i = 1; i < data.length; i++) {
+                    if (itemHeight * i > scrollTop) {
+                        break;
+                    }
+                    if (data[i] && data[i][groupField]) {
+                        group = data[i][groupField];
+                    }
+                }
+                if (group !== _this.state.group) {
+                    _this.setState({
+                        group: group
+                    });
+                }
+            }
         };
         _this.renderListFilter = function () {
             var filterText = _this.props.filter !== undefined ? _this.props.filter : _this.state.text;
@@ -457,7 +492,9 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
      * @hidden
      */
     DropDownListWithoutContext.prototype.componentDidUpdate = function (prevProps, prevState) {
-        var _a = this.props, _b = _a.data, data = _b === void 0 ? [] : _b, dataItemKey = _a.dataItemKey, virtual = _a.virtual;
+        var _a;
+        var _b = this.props, dataItemKey = _b.dataItemKey, virtual = _b.virtual, _c = _b.groupField, groupField = _c === void 0 ? '' : _c;
+        var _d = this.props.data, data = _d === void 0 ? [] : _d;
         var prevTotal = prevProps.virtual ? prevProps.virtual.total : 0;
         var opened = this.props.opened !== undefined ? this.props.opened : this.state.opened;
         var prevOpened = prevProps.opened !== undefined ? prevProps.opened : prevState.opened;
@@ -479,6 +516,9 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
             var selectedItem_1 = this.value;
             var prevSelectedItem = prevProps.value !== undefined ? prevProps.value : prevState.value;
             var selectedItemIndex = data.findIndex(function (i) { return (0, utils_1.areSame)(i, selectedItem_1, dataItemKey); });
+            if (groupField !== '') {
+                selectedItemIndex = (_a = this.base.getGroupedDataModernMode(data, groupField)) === null || _a === void 0 ? void 0 : _a.indexOf(selectedItem_1);
+            }
             var selectedItemChanged = !(0, utils_1.areSame)(prevSelectedItem, selectedItem_1, dataItemKey);
             if (opening && virtual) {
                 this.base.scrollToVirtualItem(virtual, selectedItemIndex);
@@ -599,7 +639,7 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
         var _a;
         var _this = this;
         var _b = this.state.windowWidth, windowWidth = _b === void 0 ? 0 : _b;
-        var _c = this.props, header = _c.header, footer = _c.footer, size = _c.size, adaptiveTitle = _c.adaptiveTitle;
+        var _c = this.props, header = _c.header, footer = _c.footer, size = _c.size, adaptiveTitle = _c.adaptiveTitle, groupField = _c.groupField, groupStickyHeaderItemRender = _c.groupStickyHeaderItemRender, list = _c.list, _d = _c.data, data = _d === void 0 ? [] : _d;
         var opened = this.props.opened !== undefined ? this.props.opened : this.state.opened;
         var actionSheetProps = {
             navigatable: false,
@@ -612,6 +652,10 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
                 ? 'k-adaptive-actionsheet k-actionsheet-fullscreen'
                 : 'k-adaptive-actionsheet k-actionsheet-bottom'
         };
+        var group = this.state.group;
+        if (group === undefined && groupField !== undefined) {
+            group = (0, utils_1.getItemValue)(data[0], groupField);
+        }
         return (React.createElement(React.Fragment, null,
             React.createElement(kendo_react_layout_1.ActionSheet, __assign({}, actionSheetProps),
                 React.createElement(kendo_react_layout_1.ActionSheetHeader, { className: 'k-text-center' },
@@ -625,6 +669,7 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
                     header && React.createElement("div", { className: "k-list-header" }, header),
                     React.createElement("div", { className: (0, kendo_react_common_1.classNames)('k-list', (_a = {}, _a["k-list-".concat(sizeMap[size] || size)] = size, _a['k-virtual-list'] = this.base.vs.enabled, _a)) },
                         this.renderDefaultItem(),
+                        !list && group && React.createElement(GroupStickyHeader_1.default, { group: group, groupMode: 'modern', render: groupStickyHeaderItemRender }),
                         this.renderList()),
                     footer && React.createElement("div", { className: "k-list-footer" }, footer)))));
     };
@@ -674,11 +719,11 @@ var DropDownListWithoutContext = /** @class */ (function (_super) {
     /**
      * @hidden
      */
-    DropDownListWithoutContext.propTypes = __assign({ delay: PropTypes.number, ignoreCase: PropTypes.bool, iconClassName: PropTypes.string, svgIcon: kendo_react_common_1.svgIconPropType, defaultItem: PropTypes.any, valueRender: PropTypes.func, valueMap: PropTypes.func, validationMessage: PropTypes.string, required: PropTypes.bool, id: PropTypes.string, ariaLabelledBy: PropTypes.string, ariaDescribedBy: PropTypes.string, ariaLabel: PropTypes.string, leftRightKeysNavigation: PropTypes.bool, title: PropTypes.string }, DropDownBase_1.default.propTypes);
+    DropDownListWithoutContext.propTypes = __assign({ delay: PropTypes.number, ignoreCase: PropTypes.bool, iconClassName: PropTypes.string, svgIcon: kendo_react_common_1.svgIconPropType, defaultItem: PropTypes.any, valueRender: PropTypes.func, valueMap: PropTypes.func, validationMessage: PropTypes.string, required: PropTypes.bool, id: PropTypes.string, ariaLabelledBy: PropTypes.string, ariaDescribedBy: PropTypes.string, ariaLabel: PropTypes.string, leftRightKeysNavigation: PropTypes.bool, title: PropTypes.string, groupField: PropTypes.string, list: PropTypes.any }, DropDownBase_1.default.propTypes);
     /**
      * @hidden
      */
-    DropDownListWithoutContext.defaultProps = __assign(__assign({ delay: 500, tabIndex: 0, ignoreCase: true }, DropDownBase_1.default.defaultProps), { required: false, size: 'medium', rounded: 'medium', fillMode: 'solid' });
+    DropDownListWithoutContext.defaultProps = __assign(__assign({ delay: 500, tabIndex: 0, ignoreCase: true }, DropDownBase_1.default.defaultProps), { required: false, size: 'medium', rounded: 'medium', fillMode: 'solid', groupMode: 'modern' });
     return DropDownListWithoutContext;
 }(React.Component));
 exports.DropDownListWithoutContext = DropDownListWithoutContext;

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

@@ -2,6 +2,8 @@
 import { DropDownList } from './DropDownList';
 import { FilterChangeEvent, ChangeEvent, OpenEvent, CloseEvent, FocusEvent, BlurEvent, PageChangeEvent } from './../common/events';
 import { VirtualizationSettings, DropDownsPopupSettings } from '../common/settings';
+import { ListGroupItemProps } from '../common/ListGroupItem';
+import { GroupStickyHeaderProps } from '../common/GroupStickyHeader';
 import { ListItemProps } from '../common/ListItem';
 import { FormComponentProps, SVGIcon } from '@progress/kendo-react-common';
 /**
@@ -297,4 +299,24 @@ export interface DropDownListProps extends FormComponentProps {
      * Specifies the text that is rendered as title in the adaptive popup.
      */
     adaptiveTitle?: string;
+    /**
+     * Sets the data item field that represents the start of a group. Applicable to objects data.
+     */
+    groupField?: string;
+    /**
+     * Fires when a DropDownList's group header item is about to be rendered. Used to override the default appearance of the group's headers.
+     */
+    groupHeaderItemRender?: (li: React.ReactElement<HTMLLIElement>, itemProps: ListGroupItemProps) => React.ReactNode;
+    /**
+     * Fires when a DropDownList's sticky group header item is about to be rendered. Used to override the default appearance of the sticky group header of the component.
+     */
+    groupStickyHeaderItemRender?: (div: React.ReactElement<HTMLDivElement>, stickyHeaderProps: GroupStickyHeaderProps) => React.ReactNode;
+    /**
+     * @hidden
+     */
+    list?: any;
+    /**
+     * @hidden
+     */
+    groupMode?: string;
 }

package/dist/npm/MultiColumnComboBox/MultiColumnComboBox.js

@@ -76,6 +76,9 @@ exports.MultiColumnComboBox = React.forwardRef(function (directProps, ref) {
     }, [props.data, props.groupField]);
     var _c = React.useState(initialGroupHeader), groupHeader = _c[0], setGroupHeader = _c[1];
     var header = React.useMemo(function () {
+        var renderer = (React.createElement("th", { className: 'k-table-th', colSpan: columns.length },
+            groupHeader,
+            "    "));
         return (React.createElement(React.Fragment, null,
             props.header,
             React.createElement("div", { className: "k-table-header-wrap" },
@@ -87,8 +90,7 @@ exports.MultiColumnComboBox = React.forwardRef(function (directProps, ref) {
                         React.createElement("tr", { className: 'k-table-row' }, columns.map(function (column, i) {
                             return (React.createElement("th", { className: "k-table-th", key: column.uniqueKey ? column.uniqueKey : i }, column.header || '\u00A0'));
                         })),
-                        groupHeader && React.createElement("tr", { className: 'k-table-group-row' },
-                            React.createElement("th", { className: 'k-table-th', colSpan: columns.length }, groupHeader)))))));
+                        groupHeader && React.createElement("tr", { className: 'k-table-group-row' }, props.groupStickyHeaderItemRender ? props.groupStickyHeaderItemRender.call(undefined, renderer, {}) : renderer))))));
     }, [props.header, columns, groupHeader]);
     var popupWidth = React.useMemo(function () {
         // These additional 4px are coming from the child elements side borders (fixes horizontal scrollbar)
@@ -96,7 +98,7 @@ exports.MultiColumnComboBox = React.forwardRef(function (directProps, ref) {
     }, [columns, scrollbarWidth]);
     var skip = props.virtual ? props.virtual.skip : 0;
     var itemRender = React.useCallback(function (li, liProps) {
-        var children = columns.map(function (column, i) { return (React.createElement("span", { className: "k-table-td", style: { width: column.width ? column.width : defaultProps.width }, key: column.uniqueKey ? column.uniqueKey : i }, column.field ? (0, kendo_react_common_1.getter)(column.field)(liProps.dataItem) : '')); });
+        var children = columns.map(function (column, i) { return (React.createElement("span", { className: !props.itemRender ? 'k-table-td' : undefined, style: !props.itemRender ? { width: column.width ? column.width : defaultProps.width } : undefined, key: column.uniqueKey ? column.uniqueKey : i }, column.field ? (0, kendo_react_common_1.getter)(column.field)(liProps.dataItem) : '')); });
         var group = undefined;
         var curGroup, prevGroup, groupGetter, data = props.data || [];
         var index = liProps.index - skip;
@@ -108,7 +110,7 @@ exports.MultiColumnComboBox = React.forwardRef(function (directProps, ref) {
                 group = curGroup;
             }
         }
-        if (group) {
+        if (group && props.groupMode === 'classic') {
             children.push(React.createElement("div", { key: "group", className: "k-table-td k-table-group-td" },
                 React.createElement("span", null, group)));
         }
@@ -137,7 +139,7 @@ exports.MultiColumnComboBox = React.forwardRef(function (directProps, ref) {
     }, []);
     React.useEffect(function () { (0, kendo_react_common_1.setScrollbarWidth)(); });
     var List = React.useCallback(function (listProps) { return React.createElement(MultiColumnList_1.MultiColumnList, __assign({}, listProps)); }, []);
-    return (React.createElement(ComboBox_1.ComboBox, __assign({}, other, { list: List, popupSettings: __assign(__assign({ width: popupWidth }, popupSettings), { popupClass: 'k-dropdowngrid-popup k-reset', className: popupSettings.className }), ref: comboBoxRef, header: header, itemRender: itemRender, size: props.size, rounded: props.rounded, fillMode: props.fillMode, onOpen: onOpenHandler, onClose: onCloseHandler, onFocus: onFocusHandler, onBlur: onBlurHandler, onChange: onChangeHandler, onFilterChange: onFilterChangeHandler, onPageChange: onPageChangeHandler, onGroupScroll: onGroupScroll, className: (0, kendo_react_common_1.classNames)('k-dropdowngrid', className), required: props.required })));
+    return (React.createElement(ComboBox_1.ComboBox, __assign({}, other, { list: List, popupSettings: __assign(__assign({ width: popupWidth }, popupSettings), { popupClass: 'k-dropdowngrid-popup k-reset', className: popupSettings.className }), ref: comboBoxRef, header: header, itemRender: itemRender, groupHeaderItemRender: props.groupHeaderItemRender, size: props.size, rounded: props.rounded, fillMode: props.fillMode, groupMode: props.groupMode, groupField: props.groupField, isMultiColumn: true, onOpen: onOpenHandler, onClose: onCloseHandler, onFocus: onFocusHandler, onBlur: onBlurHandler, onChange: onChangeHandler, onFilterChange: onFilterChangeHandler, onPageChange: onPageChangeHandler, onGroupScroll: onGroupScroll, className: (0, kendo_react_common_1.classNames)('k-dropdowngrid', className), required: props.required })));
 });
 var propTypes = __assign(__assign({}, ComboBox_1.ComboBoxWithoutContext.propTypes), { columns: PropTypes.any.isRequired });
 var defaultProps = {

package/dist/npm/MultiSelect/MultiSelect.d.ts

@@ -5,28 +5,24 @@ import { TagData } from './TagList';
 import DropDownBase from '../common/DropDownBase';
 import { MultiSelectProps } from './MultiSelectProps';
 import { DropDownStateBase, InternalState, ActiveDescendant } from './../common/settings';
-/**
- * @hidden
- */
+/** @hidden */
 export interface MultiSelectState extends DropDownStateBase {
     selectedItems?: Array<any>;
     focusedIndex?: number;
     focusedTag?: TagData;
     activedescendant?: ActiveDescendant;
     value?: Array<any>;
+    currentTreeValue?: Array<any>;
+    windowWidth?: number;
 }
-/**
- * @hidden
- */
+/** @hidden */
 export interface MultiSelectInternalState extends InternalState {
     data: MultiSelectState;
 }
 /** @hidden */
 export declare class MultiSelectWithoutContext extends React.Component<MultiSelectProps, MultiSelectState> implements FormComponent {
     static displayName: string;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     static propTypes: {
         autoClose: PropTypes.Requireable<boolean>;
         value: PropTypes.Requireable<any[]>;
@@ -41,6 +37,11 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
         id: PropTypes.Requireable<string>;
         ariaLabelledBy: PropTypes.Requireable<string>;
         ariaDescribedBy: PropTypes.Requireable<string>;
+        groupField: PropTypes.Requireable<string>;
+        list: PropTypes.Requireable<any>;
+        adaptive: PropTypes.Requireable<boolean>;
+        adaptiveTitle: PropTypes.Requireable<string>;
+        onCancel: PropTypes.Requireable<(...args: any[]) => any>;
         filterable: PropTypes.Requireable<boolean>;
         filter: PropTypes.Requireable<string>;
         virtual: PropTypes.Requireable<PropTypes.InferProps<{
@@ -82,23 +83,20 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
         header: PropTypes.Requireable<PropTypes.ReactNodeLike>;
         footer: PropTypes.Requireable<PropTypes.ReactNodeLike>;
     };
-    /**
-     * @hidden
-     */
+    /** @hidden */
     static defaultProps: {
         autoClose: boolean;
         required: boolean;
         size: "small" | "medium" | "large" | null | undefined;
         rounded: "small" | "medium" | "full" | "large" | null | undefined;
         fillMode: "flat" | "outline" | "solid" | null | undefined;
+        groupMode: string | undefined;
         popupSettings: {
             height: string;
         };
         validityStyles: boolean;
     };
-    /**
-     * @hidden
-     */
+    /** @hidden */
     readonly state: MultiSelectState;
     private _element;
     private _valueItemsDuringOnChange;
@@ -106,17 +104,26 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
     protected readonly base: DropDownBase;
     private readonly _tags;
     private _input;
+    private _adaptiveInput;
     private _skipFocusEvent;
+    private itemHeight;
     protected scrollToFocused: boolean;
+    private localization;
+    private observerResize?;
+    private get document();
     constructor(props: MultiSelectProps);
-    /**
-     * @hidden
-     */
+    /** @hidden */
     focus: () => void;
+    /** @hidden */
+    get element(): HTMLSpanElement | null;
+    /** @hidden */
+    get opened(): boolean;
+    /** @hidden */
+    get tagsToRender(): Array<TagData>;
     /**
-     * @hidden
+     * The mobile mode of the ComboBox.
      */
-    get element(): HTMLSpanElement | null;
+    get mobileMode(): boolean;
     /**
      * Represents the value of the MultiSelect.
      */
@@ -129,41 +136,27 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
      * Represents the validity state into which the MultiSelect is set.
      */
     get validity(): FormComponentValidity;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     protected get required(): boolean;
     protected get validityStyles(): boolean;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     componentDidUpdate(prevProps: MultiSelectProps, prevState: MultiSelectState): void;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     componentDidMount(): void;
-    /**
-     * @hidden
-     */
+    /** @hidden */
+    componentWillUnmount(): void;
+    /** @hidden */
     handleItemSelect: (index: number, state: MultiSelectInternalState) => void;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     onTagDelete: (itemsToRemove: Array<any>, event: React.MouseEvent<HTMLSpanElement>) => void;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     onNavigate(state: MultiSelectInternalState, keyCode: number): void;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     itemFocus: (index: number, state: MultiSelectInternalState) => void;
-    /**
-     * @hidden
-     */
+    /** @hidden */
     render(): JSX.Element;
     private componentRef;
-    private renderSearchbar;
+    private renderSearchBar;
     private searchbarRef;
     private onChangeHandler;
     private clearButtonClick;
@@ -173,8 +166,13 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
     private selectFocusedItem;
     private setItems;
     private getFocusedState;
+    private listContainerContent;
     private renderListContainer;
+    private renderAdaptiveListContainer;
+    private closePopup;
+    private onCancel;
     private renderList;
+    private onScroll;
     private customItemSelect;
     private handleWrapperClick;
     private handleItemClick;
@@ -185,6 +183,7 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
     private focusElement;
     private applyState;
     private setValidity;
+    private calculateMedia;
 }
 /**
  * Represents the PropsContext of the `MultiSelect` component.