@progress/kendo-react-dropdowns 5.13.0-dev.202304180747 → 5.13.0-dev.202304200917

package/dist/es/DropDownTree/DropDownTree.js

@@ -18,9 +18,10 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
+var _this = this;
 import * as React from 'react';
 import * as PropTypes from 'prop-types';
-import { classNames, noop, useRtl, getTabIndex, Keys, mapTree, extendDataItem, guid, createPropsContext, kendoThemeMaps, usePropsContext, IconWrap } from '@progress/kendo-react-common';
+import { classNames, noop, useRtl, getTabIndex, Keys, mapTree, extendDataItem, guid, createPropsContext, kendoThemeMaps, usePropsContext, IconWrap, canUseDOM } from '@progress/kendo-react-common';
 import { Popup } from '@progress/kendo-react-popup';
 import { useLocalization } from '@progress/kendo-react-intl';
 import { TreeView } from '@progress/kendo-react-treeview';
@@ -34,6 +35,9 @@ import { FloatingLabel } from '@progress/kendo-react-labels';
 import ListFilter from '../common/ListFilter';
 import { Button } from '@progress/kendo-react-buttons';
 import { xIcon, caretAltDownIcon } from '@progress/kendo-svg-icons';
+import { AdaptiveMode } from '../common/AdaptiveMode';
+import { ActionSheetContent } from '@progress/kendo-react-layout';
+import { MOBILE_MEDIUM_DEVISE } from '../common/constants';
 var sizeMap = kendoThemeMaps.sizeMap, roundedMap = kendoThemeMaps.roundedMap;
 var VALIDATION_MESSAGE = 'Please select a value from the list!';
 var ValueHolder = function (props) {
@@ -88,6 +92,7 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
     var target = React.useRef(null);
     var elementRef = React.useRef(null);
     var inputRef = React.useRef(null);
+    var adaptiveInputRef = React.useRef(null);
     var selectRef = React.useRef(null);
     var treeViewRef = React.useRef(null);
     var skipFocusRef = React.useRef(false);
@@ -113,6 +118,8 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
     var isOpen = opened !== undefined ? opened : open;
     var _l = React.useState(false), focused = _l[0], setFocused = _l[1];
     var _m = React.useState(''), filter = _m[0], setFilter = _m[1];
+    var _o = React.useState(), windowWidth = _o[0], setWindowWidth = _o[1];
+    var isAdaptive = !!(windowWidth && windowWidth <= MOBILE_MEDIUM_DEVISE && props.adaptive);
     var setValidity = React.useCallback(function () {
         if (selectRef.current && selectRef.current.setCustomValidity) {
             selectRef.current.setCustomValidity(validity.valid
@@ -121,6 +128,17 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
         }
     }, [validationMessage, validity]);
     React.useEffect(setValidity);
+    React.useEffect(function () {
+        var observerResize = canUseDOM && window.ResizeObserver && new window.ResizeObserver(calculateMedia.bind(_this));
+        if ((document === null || document === void 0 ? void 0 : document.body) && observerResize) {
+            observerResize.observe(document.body);
+        }
+        return function () {
+            if ((document === null || document === void 0 ? void 0 : document.body) && observerResize) {
+                observerResize.disconnect();
+            }
+        };
+    }, []);
     var openPopup = React.useCallback(function (event) {
         if (!isOpen) {
             if (onOpen) {
@@ -140,9 +158,14 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
             }
             if (opened === undefined) {
                 setOpen(false);
+                if (isAdaptive) {
+                    setTimeout(function () {
+                        focusElement(adaptiveInputRef.current);
+                    }, 300);
+                }
             }
         }
-    }, [isOpen, opened, onClose]);
+    }, [isOpen, opened, onClose, isAdaptive]);
     var onWrapperClick = React.useCallback(function (event) {
         if (!event.isDefaultPrevented() && target.current) {
             setFocused(true);
@@ -258,7 +281,9 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
                 var focusEvent = __assign({}, ev);
                 props.onBlur.call(undefined, focusEvent);
             }
-            closePopup(ev);
+            if (!isAdaptive) {
+                closePopup(ev);
+            }
         }
     }, [focused, props.onBlur, isOpen, opened, onClose]);
     var onWrapperMouseDown = React.useCallback(function () {
@@ -266,7 +291,12 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
             // moving focus from treeview to dropdown triggers Focus and Blur events.
             switchFocus(noop);
         }
-    }, [focused]);
+        if (isAdaptive) {
+            setTimeout(function () {
+                focusElement(adaptiveInputRef.current);
+            }, 300);
+        }
+    }, [focused, isAdaptive]);
     var changeValue = React.useCallback(function (event, newValue, hierarchicalIndex) {
         if (props.onChange) {
             var changeEvent = __assign({ value: newValue, level: hierarchicalIndex ? toLevel(hierarchicalIndex) : [] }, event);
@@ -331,6 +361,27 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
             }
         }
     }, [props.onFilterChange, props.filter, props.textField]);
+    var renderAdaptiveListContainer = function () {
+        var mobileFilter = props.filterable ? (React.createElement(ListFilter, { value: props.filter === undefined ? filter : props.filter, inputRef: adaptiveInputRef, onChange: onFilterChange, onKeyDown: onInputKeyDown, size: size, rounded: rounded, fillMode: fillMode })) : null;
+        var actionSheetProps = {
+            adaptiveTitle: props.adaptiveTitle,
+            expand: isOpen,
+            onClose: function (event) { return closePopup(event); },
+            windowWidth: windowWidth,
+            mobileFilter: mobileFilter
+        };
+        return (React.createElement(AdaptiveMode, __assign({}, actionSheetProps),
+            React.createElement(ActionSheetContent, { className: '!k-overflow-hidden' },
+                React.createElement("div", { className: 'k-list-container' },
+                    React.createElement("div", { className: 'k-list k-list-lg' }, data.length > 0 ? (React.createElement(TreeView, { ref: treeViewRef, tabIndex: tabIndex, data: treeViewData, focusIdField: dataItemKey, textField: props.textField, selectField: selectField, expandField: props.expandField, childrenField: subItemsField, expandIcons: true, onItemClick: onChange, onExpandChange: onExpand, size: size, item: props.item })) : (React.createElement(NoData, null, localization.toLanguageString(nodata, messages[nodata]))))))));
+    };
+    var calculateMedia = React.useCallback(function (entries) {
+        for (var _i = 0, entries_1 = entries; _i < entries_1.length; _i++) {
+            var entry = entries_1[_i];
+            setWindowWidth(entry.target.clientWidth);
+        }
+        ;
+    }, []);
     var treeViewData = React.useMemo(function () {
         return (controlled || !hasValue) ? data :
             mapTree(data, subItemsField, function (item) {
@@ -343,27 +394,29 @@ export var DropDownTree = React.forwardRef(function (directProps, ref) {
     var localization = useLocalization();
     var isValid = !validityStyles || validity.valid;
     var size = props.size, rounded = props.rounded, fillMode = props.fillMode;
-    var dropdowntree = (React.createElement("span", { className: classNames('k-dropdowntree k-picker', props.className, (_a = {},
-            _a["k-picker-".concat(sizeMap[size] || size)] = size,
-            _a["k-rounded-".concat(roundedMap[rounded] || rounded)] = rounded,
-            _a["k-picker-".concat(fillMode)] = fillMode,
-            _a['k-focus'] = focused,
-            _a['k-invalid'] = !isValid,
-            _a['k-loading'] = props.loading,
-            _a['k-required'] = required,
-            _a['k-disabled'] = props.disabled,
-            _a)), tabIndex: tabIndex, accessKey: props.accessKey, id: id, style: label ? __assign(__assign({}, style), { width: undefined }) : style, dir: dir, ref: elementRef, onKeyDown: disabled ? undefined : onWrapperKeyDown, onMouseDown: onWrapperMouseDown, onClick: disabled ? undefined : onWrapperClick, onFocus: onFocus, onBlur: onBlur, role: "combobox", "aria-haspopup": "tree", "aria-expanded": isOpen, "aria-disabled": disabled, "aria-label": label, "aria-labelledby": props.ariaLabelledBy, "aria-describedby": props.ariaDescribedBy, "aria-required": required },
-        React.createElement("span", { className: "k-input-inner" },
-            React.createElement(ValueComponent, { item: value }, currentValueText || placeholder)),
-        props.loading && React.createElement(IconWrap, { className: "k-input-loading-icon", name: 'loading' }),
-        hasValue && !disabled && (React.createElement("span", { onClick: onClear, className: "k-clear-value", title: localization.toLanguageString(clear, messages[clear]), role: "button", tabIndex: -1, onMouseDown: function (e) { return e.preventDefault(); } },
-            React.createElement(IconWrap, { name: 'x', icon: xIcon }))),
-        React.createElement(Button, { tabIndex: -1, type: "button", "aria-label": "select", className: "k-input-button", size: size, fillMode: fillMode, themeColor: "base", rounded: null, icon: "caret-alt-down", svgIcon: caretAltDownIcon }),
-        React.createElement("select", { name: name, ref: selectRef, tabIndex: -1, "aria-hidden": true, title: label, style: { opacity: 0, width: 1, border: 0, zIndex: -1, position: 'absolute', left: '50%' } },
-            React.createElement("option", { value: props.valueMap ? props.valueMap.call(undefined, value) : value })),
-        React.createElement(Popup, { className: classNames(popupSettings.className, { 'k-rtl': dir === 'rtl' }), popupClass: classNames(popupSettings.popupClass, 'k-list-container', 'k-dropdowntree-popup'), style: popupStyles, animate: popupSettings.animate, anchor: elementRef.current, show: isOpen, onOpen: onPopupOpened, onClose: onPopupClosed, appendTo: popupSettings.appendTo },
-            props.filterable && (React.createElement(ListFilter, { value: props.filter === undefined ? filter : props.filter, inputRef: inputRef, onChange: onFilterChange, onKeyDown: onInputKeyDown, size: size, rounded: rounded, fillMode: fillMode })),
-            data.length > 0 ? (React.createElement(TreeView, { ref: treeViewRef, tabIndex: tabIndex, data: treeViewData, focusIdField: dataItemKey, textField: props.textField, selectField: selectField, expandField: props.expandField, childrenField: subItemsField, expandIcons: true, onItemClick: onChange, onExpandChange: onExpand, size: size, item: props.item })) : (React.createElement(NoData, null, localization.toLanguageString(nodata, messages[nodata]))))));
+    var dropdowntree = (React.createElement(React.Fragment, null,
+        React.createElement("span", { className: classNames('k-dropdowntree k-picker', props.className, (_a = {},
+                _a["k-picker-".concat(sizeMap[size] || size)] = size,
+                _a["k-rounded-".concat(roundedMap[rounded] || rounded)] = rounded,
+                _a["k-picker-".concat(fillMode)] = fillMode,
+                _a['k-focus'] = focused,
+                _a['k-invalid'] = !isValid,
+                _a['k-loading'] = props.loading,
+                _a['k-required'] = required,
+                _a['k-disabled'] = props.disabled,
+                _a)), tabIndex: tabIndex, accessKey: props.accessKey, id: id, style: label ? __assign(__assign({}, style), { width: undefined }) : style, dir: dir, ref: elementRef, onKeyDown: disabled ? undefined : onWrapperKeyDown, onMouseDown: onWrapperMouseDown, onClick: disabled ? undefined : onWrapperClick, onFocus: onFocus, onBlur: onBlur, role: "combobox", "aria-haspopup": "tree", "aria-expanded": isOpen, "aria-disabled": disabled, "aria-label": label, "aria-labelledby": props.ariaLabelledBy, "aria-describedby": props.ariaDescribedBy, "aria-required": required },
+            React.createElement("span", { className: "k-input-inner" },
+                React.createElement(ValueComponent, { item: value }, currentValueText || placeholder)),
+            props.loading && React.createElement(IconWrap, { className: "k-input-loading-icon", name: 'loading' }),
+            hasValue && !disabled && (React.createElement("span", { onClick: onClear, className: "k-clear-value", title: localization.toLanguageString(clear, messages[clear]), role: "button", tabIndex: -1, onMouseDown: function (e) { return e.preventDefault(); } },
+                React.createElement(IconWrap, { name: 'x', icon: xIcon }))),
+            React.createElement(Button, { tabIndex: -1, type: "button", "aria-label": "select", className: "k-input-button", size: size, fillMode: fillMode, themeColor: "base", rounded: null, icon: "caret-alt-down", svgIcon: caretAltDownIcon }),
+            React.createElement("select", { name: name, ref: selectRef, tabIndex: -1, "aria-hidden": true, title: label, style: { opacity: 0, width: 1, border: 0, zIndex: -1, position: 'absolute', left: '50%' } },
+                React.createElement("option", { value: props.valueMap ? props.valueMap.call(undefined, value) : value })),
+            !isAdaptive && React.createElement(Popup, { className: classNames(popupSettings.className, { 'k-rtl': dir === 'rtl' }), popupClass: classNames(popupSettings.popupClass, 'k-list-container', 'k-dropdowntree-popup'), style: popupStyles, animate: popupSettings.animate, anchor: elementRef.current, show: isOpen, onOpen: onPopupOpened, onClose: onPopupClosed, appendTo: popupSettings.appendTo },
+                props.filterable && (React.createElement(ListFilter, { value: props.filter === undefined ? filter : props.filter, inputRef: inputRef, onChange: onFilterChange, onKeyDown: onInputKeyDown, size: size, rounded: rounded, fillMode: fillMode })),
+                data.length > 0 ? (React.createElement(TreeView, { ref: treeViewRef, tabIndex: tabIndex, data: treeViewData, focusIdField: dataItemKey, textField: props.textField, selectField: selectField, expandField: props.expandField, childrenField: subItemsField, expandIcons: true, onItemClick: onChange, onExpandChange: onExpand, size: size, item: props.item })) : (React.createElement(NoData, null, localization.toLanguageString(nodata, messages[nodata]))))),
+        isAdaptive && renderAdaptiveListContainer()));
     return label ? (React.createElement(FloatingLabel, { label: label, editorValue: currentValueText, editorPlaceholder: placeholder, editorValid: isValid, editorDisabled: disabled, editorId: id, style: { width: style ? style.width : undefined }, children: dropdowntree, dir: dir })) : dropdowntree;
 });
 var propTypes = {
@@ -415,7 +468,9 @@ var propTypes = {
     onExpandChange: PropTypes.func,
     item: PropTypes.func,
     valueHolder: PropTypes.func,
-    listNoData: PropTypes.func
+    listNoData: PropTypes.func,
+    adaptiveTitle: PropTypes.string,
+    adaptive: PropTypes.bool
 };
 DropDownTree.displayName = 'KendoReactDropDownTree';
 DropDownTree.defaultProps = defaultProps;

package/dist/es/DropDownTree/DropDownTreeProps.d.ts

@@ -283,4 +283,12 @@ export interface DropDownTreeProps extends FormComponentProps {
      * @default `solid`
      */
     fillMode?: null | 'solid' | 'flat' | 'outline';
+    /**
+     * Providing different rendering of the popup element based on the screen dimensions.
+     */
+    adaptive?: boolean;
+    /**
+     * Specifies the text that is rendered as title in the adaptive popup.
+     */
+    adaptiveTitle?: string;
 }

package/dist/es/MultiColumnComboBox/MultiColumnComboBox.js

@@ -73,6 +73,9 @@ export var 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" },
@@ -84,8 +87,7 @@ export var 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)
@@ -93,7 +95,7 @@ export var 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 ? 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 ? getter(column.field)(liProps.dataItem) : '')); });
         var group = undefined;
         var curGroup, prevGroup, groupGetter, data = props.data || [];
         var index = liProps.index - skip;
@@ -105,7 +107,7 @@ export var 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)));
         }
@@ -134,7 +136,7 @@ export var MultiColumnComboBox = React.forwardRef(function (directProps, ref) {
     }, []);
     React.useEffect(function () { setScrollbarWidth(); });
     var List = React.useCallback(function (listProps) { return React.createElement(MultiColumnList, __assign({}, listProps)); }, []);
-    return (React.createElement(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: classNames('k-dropdowngrid', className), required: props.required })));
+    return (React.createElement(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: classNames('k-dropdowngrid', className), required: props.required })));
 });
 var propTypes = __assign(__assign({}, ComboBoxWithoutContext.propTypes), { columns: PropTypes.any.isRequired });
 var defaultProps = {

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

@@ -41,6 +41,8 @@ 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>;
         filterable: PropTypes.Requireable<boolean>;
         filter: PropTypes.Requireable<string>;
         virtual: PropTypes.Requireable<PropTypes.InferProps<{
@@ -91,6 +93,7 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
         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;
         };
@@ -107,6 +110,7 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
     private readonly _tags;
     private _input;
     private _skipFocusEvent;
+    private itemHeight;
     protected scrollToFocused: boolean;
     constructor(props: MultiSelectProps);
     /**
@@ -175,6 +179,7 @@ export declare class MultiSelectWithoutContext extends React.Component<MultiSele
     private getFocusedState;
     private renderListContainer;
     private renderList;
+    private onScroll;
     private customItemSelect;
     private handleWrapperClick;
     private handleItemClick;

package/dist/es/MultiSelect/MultiSelect.js

@@ -40,6 +40,7 @@ import { plusIcon } from '@progress/kendo-svg-icons';
 import { FloatingLabel } from '@progress/kendo-react-labels';
 import ListContainer from '../common/ListContainer';
 import List from '../common/List';
+import GroupStickyHeader from '../common/GroupStickyHeader';
 import TagList from './TagList';
 import SearchBar from '../common/SearchBar';
 import DropDownBase from '../common/DropDownBase';
@@ -76,6 +77,7 @@ var MultiSelectWithoutContext = /** @class */ (function (_super) {
         _this._tags = [];
         _this._input = null;
         _this._skipFocusEvent = false;
+        _this.itemHeight = 0;
         _this.scrollToFocused = false;
         /**
          * @hidden
@@ -250,7 +252,7 @@ var MultiSelectWithoutContext = /** @class */ (function (_super) {
         _this.renderListContainer = function () {
             var _a, _b;
             var base = _this.base;
-            var _c = _this.props, header = _c.header, footer = _c.footer, allowCustom = _c.allowCustom, dir = _c.dir, _d = _c.data, data = _d === void 0 ? [] : _d, size = _c.size;
+            var _c = _this.props, header = _c.header, footer = _c.footer, allowCustom = _c.allowCustom, dir = _c.dir, _d = _c.data, data = _d === void 0 ? [] : _d, size = _c.size, groupStickyHeaderItemRender = _c.groupStickyHeaderItemRender, groupField = _c.groupField, list = _c.list;
             var popupSettings = _this.base.getPopupSettings();
             var opened = _this.props.opened !== undefined ? _this.props.opened : _this.state.opened;
             var text = _this.props.filter !== undefined ? _this.props.filter : _this.state.text;
@@ -277,26 +279,60 @@ var MultiSelectWithoutContext = /** @class */ (function (_super) {
                 React.createElement("div", { className: classNames('k-list-item k-custom-item', { 'k-focus': isCustom(focusedType) }), style: { fontStyle: 'italic' } },
                     text,
                     React.createElement(IconWrap, { name: 'plus', icon: plusIcon, style: { position: 'absolute', right: '0.5em' } }))));
+            var group = _this.state.group;
+            if (group === undefined && groupField !== undefined) {
+                group = getItemValue(data[0], groupField);
+            }
             return (React.createElement(ListContainer, __assign({}, listContainerProps),
                 header && React.createElement("div", { className: "k-list-header" }, header),
                 customItem,
                 React.createElement("div", { className: classNames('k-list', (_b = {},
                         _b["k-list-".concat(sizeMap[size] || size)] = size,
                         _b['k-virtual-list'] = _this.base.vs.enabled,
-                        _b)) }, _this.renderList()),
+                        _b)) },
+                    !list && group && React.createElement(GroupStickyHeader, { 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, listNoDataRender = _a.listNoDataRender, itemRender = _a.itemRender, dataItemKey = _a.dataItemKey, virtual = _a.virtual;
+            var _a = _this.props, _b = _a.data, data = _b === void 0 ? [] : _b, textField = _a.textField, listNoDataRender = _a.listNoDataRender, itemRender = _a.itemRender, groupHeaderItemRender = _a.groupHeaderItemRender, dataItemKey = _a.dataItemKey, virtual = _a.virtual;
             var vs = _this.base.vs;
             var skip = virtual ? virtual.skip : 0;
             var opened = _this.props.opened !== undefined ? _this.props.opened : _this.state.opened;
             var focusedIndex = _this.getFocusedState().focusedIndex;
             var popupSettings = _this.base.getPopupSettings();
             var translate = "translateY(".concat(vs.translate, "px)");
-            return (React.createElement(List, { id: _this.base.listBoxId, show: opened, data: data.slice(), focusedIndex: focusedIndex - skip, value: _this.value, textField: textField, valueField: dataItemKey, optionsGuid: _this.base.guid, listRef: function (list) { 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, onMouseDown: preventDefault, onBlur: _this.handleBlur, onScroll: function (e) {
-                    vs.scrollHandler(e);
-                }, wrapperRef: vs.scrollerRef, scroller: _this.base.renderScrollElement() }));
+            return (React.createElement(List, { id: _this.base.listBoxId, show: opened, data: data.slice(), focusedIndex: focusedIndex - skip, value: _this.value, textField: textField, valueField: dataItemKey, optionsGuid: _this.base.guid, groupField: _this.props.groupField, groupMode: 'modern', listRef: function (list) { 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, onMouseDown: preventDefault, onBlur: _this.handleBlur, 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.customItemSelect = function (event) {
             var _a;
@@ -478,7 +514,9 @@ var MultiSelectWithoutContext = /** @class */ (function (_super) {
      * @hidden
      */
     MultiSelectWithoutContext.prototype.componentDidUpdate = function (prevProps, prevState) {
-        var virtual = this.props.virtual;
+        var _a;
+        var _b = this.props, virtual = _b.virtual, _c = _b.groupField, groupField = _c === void 0 ? '' : _c;
+        var _d = this.props.data, data = _d === void 0 ? [] : _d;
         var skip = virtual ? virtual.skip : 0;
         var prevTotal = prevProps.virtual ? prevProps.virtual.total : 0;
         var opened = this.props.opened !== undefined ? this.props.opened : this.state.opened;
@@ -494,7 +532,10 @@ var MultiSelectWithoutContext = /** @class */ (function (_super) {
             this.base.vs.reset();
         }
         else {
-            var _a = this.getFocusedState(), focusedItem = _a.focusedItem, focusedIndex = _a.focusedIndex;
+            var _e = this.getFocusedState(), focusedItem = _e.focusedItem, focusedIndex = _e.focusedIndex;
+            if (groupField !== '') {
+                focusedIndex = (_a = this.base.getGroupedDataModernMode(data, groupField)) === null || _a === void 0 ? void 0 : _a.indexOf(focusedItem);
+            }
             if (opening && virtual) {
                 this.base.scrollToVirtualItem(virtual, focusedIndex - skip);
             }
@@ -743,11 +784,11 @@ var MultiSelectWithoutContext = /** @class */ (function (_super) {
     MultiSelectWithoutContext.propTypes = __assign(__assign({}, DropDownBase.propTypes), { autoClose: PropTypes.bool, value: PropTypes.arrayOf(PropTypes.any), defaultValue: PropTypes.arrayOf(PropTypes.any), dataItemKey: PropTypes.string, placeholder: PropTypes.string, tags: PropTypes.arrayOf(PropTypes.shape({
             text: PropTypes.string,
             data: PropTypes.arrayOf(PropTypes.any)
-        })), tagRender: PropTypes.func, id: PropTypes.string, ariaLabelledBy: PropTypes.string, ariaDescribedBy: PropTypes.string });
+        })), tagRender: PropTypes.func, id: PropTypes.string, ariaLabelledBy: PropTypes.string, ariaDescribedBy: PropTypes.string, groupField: PropTypes.string, list: PropTypes.any });
     /**
      * @hidden
      */
-    MultiSelectWithoutContext.defaultProps = __assign(__assign({}, DropDownBase.defaultProps), { autoClose: true, required: false, size: 'medium', rounded: 'medium', fillMode: 'solid' });
+    MultiSelectWithoutContext.defaultProps = __assign(__assign({}, DropDownBase.defaultProps), { autoClose: true, required: false, size: 'medium', rounded: 'medium', fillMode: 'solid', groupMode: 'modern' });
     return MultiSelectWithoutContext;
 }(React.Component));
 export { MultiSelectWithoutContext };

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

@@ -3,6 +3,8 @@ import { MultiSelect } from './MultiSelect';
 import { FormComponentProps } from '@progress/kendo-react-common';
 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 { TagData } from './TagList';
 /**
@@ -264,4 +266,24 @@ export interface MultiSelectProps extends FormComponentProps {
      * @default `solid`
      */
     fillMode?: null | 'solid' | 'flat' | 'outline';
+    /**
+     * 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/es/common/AdaptiveMode.js

@@ -22,7 +22,7 @@ export var AdaptiveMode = function (props) {
         navigatable: navigatable || false,
         navigatableElements: navigatableElements || [],
         expand: expand,
-        animation: animation || true,
+        animation: animation === false ? false : true,
         onClose: onClose,
         animationStyles: windowWidth <= MOBILE_SMALL_DEVISE ? { top: 0, width: '100%', height: '100%' } : undefined,
         className: windowWidth <= MOBILE_SMALL_DEVISE

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

@@ -160,4 +160,5 @@ export default class DropDownBase {
     scrollToVirtualItem: (virtual: VirtualizationSettings, selectedItemIndex: number) => void;
     renderScrollElement: () => false | JSX.Element;
     getPopupSettings(): DropDownsPopupSettings;
+    getGroupedDataModernMode(data: any[], groupField: string): any[];
 }

package/dist/es/common/DropDownBase.js

@@ -209,6 +209,19 @@ var DropDownBase = /** @class */ (function () {
         return Object
             .assign({}, DropDownBase.defaultProps.popupSettings, this.component.props.popupSettings);
     };
+    DropDownBase.prototype.getGroupedDataModernMode = function (data, groupField) {
+        var newData = [];
+        data.forEach(function (el, index) {
+            if (data[index - 1] && el[groupField] !== data[index - 1][groupField]) {
+                newData.push({ position: el[groupField] });
+                newData.push(data[index]);
+            }
+            else {
+                newData.push(data[index]);
+            }
+        });
+        return newData;
+    };
     DropDownBase.basicPropTypes = {
         opened: PropTypes.bool,
         disabled: PropTypes.bool,

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

@@ -0,0 +1,24 @@
+import * as React from 'react';
+/**
+ * Represents the props of the GroupStickyHeader component.
+ */
+export interface GroupStickyHeaderProps {
+    /**
+     * The group that will be rendered.
+     */
+    group?: string;
+    /**
+     * @hidden
+     */
+    groupMode?: string;
+    /**
+     * 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.
+     */
+    render?: (div: React.ReactElement<HTMLDivElement>, itemProps: GroupStickyHeaderProps) => React.ReactNode;
+}
+/**
+ * @hidden
+ */
+export default class GroupStickyHeader extends React.Component<GroupStickyHeaderProps, {}> {
+    render(): string | number | boolean | React.ReactFragment | JSX.Element | null | undefined;
+}

package/dist/es/common/GroupStickyHeader.js

@@ -0,0 +1,34 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import * as React from 'react';
+/**
+ * @hidden
+ */
+var GroupStickyHeader = /** @class */ (function (_super) {
+    __extends(GroupStickyHeader, _super);
+    function GroupStickyHeader() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    GroupStickyHeader.prototype.render = function () {
+        var _a = this.props, group = _a.group, groupMode = _a.groupMode, renderer = _a.render;
+        var item = (React.createElement("div", { className: "k-list-group-sticky-header" }, groupMode === 'classic'
+            ? group
+            : React.createElement("div", { className: "k-list-header-text" }, group)));
+        return renderer !== undefined ? renderer.call(undefined, item, this.props) : item;
+    };
+    return GroupStickyHeader;
+}(React.Component));
+export default GroupStickyHeader;

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

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import { ListItemProps } from './ListItem';
+import { ListGroupItemProps } from './ListGroupItem';
 import { LocalizationService } from '@progress/kendo-react-intl';
 /**
  * @hidden
@@ -13,6 +14,8 @@ export interface ListProps {
     textField?: string;
     valueField?: string;
     groupField?: string;
+    groupMode?: string;
+    isMultiColumn?: boolean;
     optionsGuid?: string;
     listRef?: React.Ref<HTMLUListElement>;
     wrapperRef?: React.Ref<HTMLDivElement>;
@@ -25,6 +28,7 @@ export interface ListProps {
     highlightSelected?: boolean;
     onClick: (index: number, event: React.MouseEvent<HTMLLIElement>) => void;
     itemRender?: (li: React.ReactElement<HTMLLIElement>, itemProps: ListItemProps) => React.ReactNode;
+    groupHeaderItemRender?: (li: React.ReactElement<HTMLLIElement>, groupItemProps: ListGroupItemProps) => React.ReactNode;
     noDataRender?: (element: React.ReactElement<HTMLDivElement>) => React.ReactNode;
     onMouseDown?: (event: React.MouseEvent<HTMLDivElement>) => void;
     onBlur?: (event: React.FocusEvent<HTMLDivElement>) => void;
@@ -35,7 +39,7 @@ export interface ListProps {
  * @hidden
  */
 export default class List extends React.Component<ListProps> {
-    renderItems(): JSX.Element[];
+    renderItems(): (false | JSX.Element)[][];
     renderNoValueElement(localizationService: LocalizationService): string | number | boolean | React.ReactFragment | JSX.Element | null | undefined;
     render(): string | number | boolean | React.ReactFragment | JSX.Element | null | undefined;
 }

package/dist/es/common/List.js

@@ -15,6 +15,7 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import * as React from 'react';
 import ListItem from './ListItem';
+import ListGroupItem from './ListGroupItem';
 import { areSame, getItemValue } from './utils';
 import { registerForLocalization, provideLocalizationService } from '@progress/kendo-react-intl';
 import { messages, nodata } from '../messages';
@@ -28,10 +29,12 @@ var List = /** @class */ (function (_super) {
     }
     List.prototype.renderItems = function () {
         var _this = this;
-        var _a = this.props, textField = _a.textField, valueField = _a.valueField, groupField = _a.groupField, optionsGuid = _a.optionsGuid, _b = _a.skip, skip = _b === void 0 ? 0 : _b, virtual = _a.virtual, focusedIndex = _a.focusedIndex, _c = _a.highlightSelected, highlightSelected = _c === void 0 ? true : _c, value = _a.value, data = _a.data, itemRender = _a.itemRender;
+        var _a = this.props, textField = _a.textField, valueField = _a.valueField, groupField = _a.groupField, groupMode = _a.groupMode, isMultiColumn = _a.isMultiColumn, optionsGuid = _a.optionsGuid, _b = _a.skip, skip = _b === void 0 ? 0 : _b, virtual = _a.virtual, focusedIndex = _a.focusedIndex, _c = _a.highlightSelected, highlightSelected = _c === void 0 ? true : _c, value = _a.value, data = _a.data, itemRender = _a.itemRender, groupHeaderItemRender = _a.groupHeaderItemRender;
         var isArray = Array.isArray(value);
+        var groupCounter = 0;
         return data.map(function (item, index) {
             var realIndex = skip + index;
+            var idIndex = skip + index + groupCounter;
             var selected = highlightSelected &&
                 ((!isArray && areSame(item, value, valueField)) ||
                     (isArray && value.findIndex(function (i) { return areSame(i, item, valueField); }) !== -1));
@@ -44,7 +47,11 @@ var List = /** @class */ (function (_super) {
                     group = current;
                 }
             }
-            return (React.createElement(ListItem, { id: "option-".concat(optionsGuid, "-").concat(realIndex), virtual: virtual, dataItem: item, selected: selected, focused: focusedIndex === index, index: realIndex, key: realIndex, onClick: _this.props.onClick, textField: textField, group: group, render: itemRender }));
+            group !== undefined && groupMode === 'modern' ? groupCounter += 1 : '';
+            return [
+                group !== undefined && groupMode === 'modern' && React.createElement(ListGroupItem, { id: "option-".concat(optionsGuid, "-").concat(idIndex), virtual: virtual, key: realIndex + '-group-item', group: group, isMultiColumn: isMultiColumn, render: groupHeaderItemRender }),
+                React.createElement(ListItem, { id: "option-".concat(optionsGuid, "-").concat(group !== undefined && groupMode === 'modern' ? idIndex + 1 : idIndex), virtual: virtual, dataItem: item, groupMode: groupMode, selected: selected, focused: focusedIndex === index, index: realIndex, key: realIndex, onClick: _this.props.onClick, textField: textField, group: group, render: itemRender })
+            ];
         });
     };
     List.prototype.renderNoValueElement = function (localizationService) {