@syncfusion/ej2-ribbon 23.2.7 → 24.1.41

package/dist/global/index.d.ts

@@ -1,6 +1,6 @@
 /*!
 *  filename: index.d.ts
-*  version : 23.2.7
+*  version : 24.1.41
 *  Copyright Syncfusion Inc. 2001 - 2023. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/package.json

@@ -1,8 +1,8 @@
 {
   "_from": "@syncfusion/ej2-ribbon@*",
-  "_id": "@syncfusion/ej2-ribbon@23.2.5",
+  "_id": "@syncfusion/ej2-ribbon@21.27.0",
   "_inBundle": false,
-  "_integrity": "sha512-yaxRdEtxHw8Ko6CIOCA3KeaoQuBu8pNB/hDtISHgRg+VlFVdvfxy450RiOQFaN8ivXOiwi7jyGT4NvHA4E+qlA==",
+  "_integrity": "sha512-Yp291W26tAmLS4Vev1bAKc12r3ExMoy1eV3QNuoxM4mysAxjyUBRN0MjP4w8xpLrGgBZqosG3G7Ewc/IphDVww==",
   "_location": "/@syncfusion/ej2-ribbon",
   "_phantomChildren": {},
   "_requested": {
@@ -23,10 +23,10 @@
     "/@syncfusion/ej2-react-ribbon",
     "/@syncfusion/ej2-vue-ribbon"
   ],
-  "_resolved": "https://nexus.syncfusion.com/repository/ej2-hotfix-new/@syncfusion/ej2-ribbon/-/ej2-ribbon-23.2.5.tgz",
-  "_shasum": "249585a25ef9d78e2207bdcecd2ee38fd2d74c05",
+  "_resolved": "https://nexus.syncfusion.com/repository/ej2-release/@syncfusion/ej2-ribbon/-/ej2-ribbon-21.27.0.tgz",
+  "_shasum": "93461696848f6b7ca64be65ee903922584f6b52c",
   "_spec": "@syncfusion/ej2-ribbon@*",
-  "_where": "/jenkins/workspace/elease-automation_release_23.1.1/packages/included",
+  "_where": "/jenkins/workspace/elease-automation_release_24.1.1/packages/included",
   "author": {
     "name": "Syncfusion Inc."
   },
@@ -35,13 +35,13 @@
   },
   "bundleDependencies": false,
   "dependencies": {
-    "@syncfusion/ej2-base": "~23.2.6",
-    "@syncfusion/ej2-buttons": "~23.2.7",
-    "@syncfusion/ej2-dropdowns": "~23.2.7",
-    "@syncfusion/ej2-lists": "~23.2.4",
-    "@syncfusion/ej2-navigations": "~23.2.7",
-    "@syncfusion/ej2-popups": "~23.2.4",
-    "@syncfusion/ej2-splitbuttons": "~23.2.4"
+    "@syncfusion/ej2-base": "~24.1.41",
+    "@syncfusion/ej2-buttons": "~24.1.41",
+    "@syncfusion/ej2-dropdowns": "~24.1.41",
+    "@syncfusion/ej2-lists": "~24.1.41",
+    "@syncfusion/ej2-navigations": "~24.1.41",
+    "@syncfusion/ej2-popups": "~24.1.41",
+    "@syncfusion/ej2-splitbuttons": "~24.1.41"
   },
   "deprecated": false,
   "description": "Essential JS 2 Component",
@@ -62,6 +62,6 @@
     "url": "git+https://github.com/syncfusion/ej2-ribbon-component.git"
   },
   "typings": "index.d.ts",
-  "version": "23.2.7",
+  "version": "24.1.41",
   "sideEffects": false
 }

package/src/ribbon/base/ribbon.d.ts

@@ -383,6 +383,7 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
      * @returns {void}
      */
     removeGroup(groupId: string): void;
+    private isHeaderVisible;
     /**
      * Hides a specific group within a ribbon tab.
      *

package/src/ribbon/base/ribbon.js

@@ -132,7 +132,9 @@ var Ribbon = /** @class */ (function (_super) {
             e.preventDefault();
         }
         var activeContent = this.tabObj.element.querySelector('#' + this.tabs[this.selectedTab].id + constants.CONTENT_ID);
-        var ribbonControls = activeContent.querySelectorAll('.e-control');
+        var controlElements = Array.prototype.slice.call(activeContent.querySelectorAll('.e-control'));
+        var templateElements = Array.prototype.slice.call(activeContent.querySelectorAll('.e-ribbon-template'));
+        var ribbonControls = controlElements.concat(templateElements);
         var comboBoxElements = activeContent.querySelectorAll('.e-combobox');
         var comboBoxEle;
         if (comboBoxElements) {
@@ -161,7 +163,7 @@ var Ribbon = /** @class */ (function (_super) {
         if (e.target.classList.contains('e-control') || e.target.classList.contains('e-ribbon-launcher-icon') ||
             e.target.classList.contains('e-ribbon-collapse-btn') || e.target.classList.contains('e-ribbon-last-item') ||
             e.target.classList.contains('e-ribbon-first-item') || e.target.classList.contains('e-ribbon-group-of-btn') ||
-            e.target.classList.contains('e-ribbon-overall-of-btn')) {
+            e.target.classList.contains('e-ribbon-overall-of-btn') || e.target.classList.contains('e-ribbon-template')) {
             switch (e.action) {
                 case 'rightarrow':
                     this.handleNavigation(e, !this.enableRtl, ribbonControls);
@@ -203,7 +205,7 @@ var Ribbon = /** @class */ (function (_super) {
             }
         }
         if ((!enableRtl && (this.currentControlIndex > 0)) || (enableRtl && (this.currentControlIndex < ribbonControls.length - 1))) {
-            if (!e.target.classList.contains('e-combobox') && e.target.classList.contains('e-control') && !e.target.classList.contains('e-ribbon-last-item')) {
+            if (!e.target.classList.contains('e-combobox') && (e.target.classList.contains('e-control') || e.target.classList.contains('e-ribbon-template')) && !e.target.classList.contains('e-ribbon-last-item')) {
                 if (enableRtl) {
                     this.currentControlIndex++;
                 }
@@ -237,7 +239,10 @@ var Ribbon = /** @class */ (function (_super) {
                         }
                         if (launcherIconEle) {
                             var items = groupContainer.querySelectorAll('.e-ribbon-item');
-                            items[items.length - 1].querySelector('.e-control').classList.add('e-ribbon-last-item');
+                            var elem = items[items.length - 1].querySelector('.e-control');
+                            if (elem) {
+                                elem.classList.add('e-ribbon-last-item');
+                            }
                         }
                     }
                     else {
@@ -350,6 +355,15 @@ var Ribbon = /** @class */ (function (_super) {
             var scrollEle = this.tabObj.element.querySelector('.' + constants.HORIZONTAL_SCROLLBAR);
             this.scrollModule.scrollStep = scrollEle.offsetWidth;
         }
+        if (this.activeLayout === 'Simplified') {
+            var activePopup = document.querySelectorAll('.e-ribbon .e-dropdown-btn.e-active, .e-ribbon-group-overflow-ddb .e-dropdown-btn.e-active');
+            if (activePopup.length) {
+                for (var i = 0; i < activePopup.length; i++) {
+                    var dropDownBtn = getInstance(activePopup[parseInt(i.toString(), 10)], DropDownButton);
+                    dropDownBtn.toggle();
+                }
+            }
+        }
     };
     Ribbon.prototype.renderTabs = function () {
         this.tabsInternal = this.tabs.slice();
@@ -675,7 +689,7 @@ var Ribbon = /** @class */ (function (_super) {
             }
             if (overflowDDB) {
                 if (group.enableGroupOverflow) {
-                    if (overflowtarget.childElementCount === 0) {
+                    if (overflowtarget.childElementCount === 0 || (overflowtarget.childElementCount === 1 && this.isHeaderVisible(overflowtarget, group.id))) {
                         this.removeOverflowButton(overflowDDB);
                     }
                 }
@@ -747,6 +761,7 @@ var Ribbon = /** @class */ (function (_super) {
     };
     Ribbon.prototype.createOverflowPopup = function (item, tabIndex, isGroupOF, groupId, groupHeader, itemEle, groupContainer, isResize) {
         var overflowButton;
+        var itemProp = getGroup(this.tabs, groupId);
         var contentEle = this.tabObj.items[parseInt(tabIndex.toString(), 10)].content;
         var groupEle = contentEle.querySelector('#' + groupId);
         if (isGroupOF) {
@@ -760,6 +775,17 @@ var Ribbon = /** @class */ (function (_super) {
                 overflowButton = getInstance(overflowDDB, DropDownButton);
             }
             var overflowBtnTarget = overflowButton.target;
+            var headerEle = overflowBtnTarget.querySelector('#' + groupId + constants.GROUPOF_BUTTON_ID + constants.HEADER_ID);
+            if (!headerEle) {
+                if (itemProp.group.overflowHeader) {
+                    var groupHeader_1 = this.createElement('div', {
+                        className: constants.RIBBON_OVERFLOW_HEADER,
+                        id: groupId + constants.GROUPOF_BUTTON_ID + constants.HEADER_ID,
+                        innerHTML: itemProp.group.overflowHeader
+                    });
+                    overflowBtnTarget.append(groupHeader_1);
+                }
+            }
             if (groupEle) {
                 if (groupEle.classList.contains('e-disabled')) {
                     overflowBtnTarget.classList.add('e-disabled');
@@ -788,7 +814,7 @@ var Ribbon = /** @class */ (function (_super) {
                 if (ofTabContainer) {
                     var ofGroupContainer = overflowEle.querySelector('#' + groupId + constants.CONTAINER_ID);
                     if (!ofGroupContainer) {
-                        ofGroupContainer = this.createGroupContainer(groupId, groupHeader);
+                        ofGroupContainer = itemProp.group.overflowHeader ? this.createGroupContainer(groupId, itemProp.group.overflowHeader) : this.createGroupContainer(groupId, groupHeader);
                         if (groupEle) {
                             if (groupEle.classList.contains('e-disabled')) {
                                 ofGroupContainer.classList.add('e-disabled');
@@ -836,7 +862,7 @@ var Ribbon = /** @class */ (function (_super) {
                 break;
             case 'GroupButton':
                 if (this.activeLayout === 'Simplified') {
-                    this.ribbonGroupButtonModule.addOverFlowEvents(item, itemEle);
+                    this.ribbonGroupButtonModule.addOverFlowEvents(item, itemEle, overflowButton);
                     break;
                 }
         }
@@ -848,7 +874,8 @@ var Ribbon = /** @class */ (function (_super) {
         });
         var overflowtarget = this.overflowDDB.target;
         overflowtarget.append(ofTabContainer);
-        var ofGroupContainer = this.createGroupContainer(groupId, groupHeader);
+        var itemProp = getGroup(this.tabs, groupId);
+        var ofGroupContainer = itemProp.group.overflowHeader ? this.createGroupContainer(groupId, itemProp.group.overflowHeader) : this.createGroupContainer(groupId, groupHeader);
         ofGroupContainer.append(itemEle);
         ofTabContainer.append(ofGroupContainer);
         if (tabIndex === this.selectedTab) {
@@ -1705,9 +1732,10 @@ var Ribbon = /** @class */ (function (_super) {
             },
             beforeClose: function (args) {
                 var ele = args.event ? closest(args.event.target, '.' + constants.RIBBON_POPUP_CONTROL) : null;
+                var groupButtonEle = args.event ? closest(args.event.target, '.e-ribbon-group-button-overflow-popup') : null;
                 var eventArgs = { element: args.element, event: args.event, cancel: args.cancel };
                 _this.trigger('overflowPopupClose', eventArgs, function (ribbonArgs) {
-                    if (ele || ribbonArgs.cancel) {
+                    if (ele || ribbonArgs.cancel || groupButtonEle) {
                         args.cancel = true;
                     }
                 });
@@ -1729,8 +1757,10 @@ var Ribbon = /** @class */ (function (_super) {
             var currentList = target.querySelector('.e-ribbon-of-tab.e-ribbon-active');
             items = currentList.getElementsByClassName('e-ribbon-item');
         }
-        var comboBoxEle = items[(!this.itemIndex || this.itemIndex < 0) ? 0 : this.itemIndex].querySelector('.e-control').classList.contains('e-combobox') ? items[(!this.itemIndex || this.itemIndex < 0) ? 0 : this.itemIndex].querySelector('.e-combobox') : null;
+        var control = items[(!this.itemIndex || this.itemIndex < 0) ? 0 : this.itemIndex].querySelector('.e-control');
+        var comboBoxEle = control && control.classList.contains('e-combobox') ? items[(!this.itemIndex || this.itemIndex < 0) ? 0 : this.itemIndex].querySelector('.e-combobox') : null;
         var ribbonItem;
+        var templateEle;
         if (comboBoxEle === null || (e.key === 'Tab') || this.itemIndex < 0) {
             if (e.key === 'ArrowDown' || (!e.shiftKey && e.key === 'Tab')) {
                 if ((!this.itemIndex && this.itemIndex !== 0) || this.itemIndex < 0 || this.itemIndex === items.length - 1) {
@@ -1739,13 +1769,21 @@ var Ribbon = /** @class */ (function (_super) {
                     this.findDisabledItem(ribbonItem, items, true);
                     if (comboBoxEle && e.key === 'Tab') {
                         e.preventDefault();
-                        items[this.itemIndex].querySelector('.e-control').focus();
+                        var item = items[this.itemIndex].querySelector('.e-control');
+                        if (item) {
+                            item.focus();
+                        }
                     }
+                    templateEle = items[this.itemIndex].querySelector('.e-ribbon-template');
                 }
                 else if (this.itemIndex < items.length - 1 && this.itemIndex >= 0) {
                     this.itemIndex++;
                     ribbonItem = items[this.itemIndex].closest('.e-ribbon-item');
                     this.findDisabledItem(ribbonItem, items, true);
+                    templateEle = items[this.itemIndex].querySelector('.e-ribbon-template');
+                }
+                if (templateEle) {
+                    templateEle.focus();
                 }
             }
             else if (e.key === 'ArrowUp' || (e.shiftKey && e.key === 'Tab')) {
@@ -1756,20 +1794,32 @@ var Ribbon = /** @class */ (function (_super) {
                         this.findDisabledItem(ribbonItem, items, false);
                         if (comboBoxEle && (e.shiftKey && e.key === 'Tab')) {
                             e.preventDefault();
-                            items[this.itemIndex].querySelector('.e-control').focus();
+                            var item = items[this.itemIndex].querySelector('.e-control');
+                            if (item) {
+                                item.focus();
+                            }
                         }
+                        templateEle = items[this.itemIndex].querySelector('.e-ribbon-template');
                     }
                     else if (this.itemIndex <= items.length - 1 && this.itemIndex > 0) {
                         this.itemIndex--;
                         ribbonItem = items[this.itemIndex].closest('.e-ribbon-item');
                         this.findDisabledItem(ribbonItem, items, false);
+                        templateEle = items[this.itemIndex].querySelector('.e-ribbon-template');
+                    }
+                    if (templateEle) {
+                        templateEle.focus();
                     }
                 }
             }
             target.setAttribute('index', this.itemIndex.toString());
         }
         var currentItemIndex = parseInt(target.getAttribute('index'), 10);
-        var itemType = items[parseInt(currentItemIndex.toString(), 10)] ? items[parseInt(currentItemIndex.toString(), 10)].querySelector('.e-control').getAttribute('data-control') : null;
+        var itemType = "";
+        var controlItem = items[parseInt(currentItemIndex.toString(), 10)] ? items[parseInt(currentItemIndex.toString(), 10)].querySelector('.e-control') : null;
+        if (controlItem) {
+            itemType = controlItem.getAttribute('data-control');
+        }
         if (e.key === 'ArrowDown' || e.key === 'ArrowUp' || e.key === ' ' || e.key === 'Tab') {
             if (itemType === 'ColorPicker') {
                 if (e.key === 'Tab') {
@@ -1781,7 +1831,10 @@ var Ribbon = /** @class */ (function (_super) {
                 if (e.key === 'Tab') {
                     e.preventDefault();
                 }
-                items[parseInt(currentItemIndex.toString(), 10)].querySelector('.e-control').focus();
+                var elem = items[parseInt(currentItemIndex.toString(), 10)].querySelector('.e-control');
+                if (elem) {
+                    elem.focus();
+                }
             }
             if (e.key === ' ' && (itemType === 'CheckBox')) {
                 var checkBoxEle = items[parseInt(currentItemIndex.toString(), 10)].querySelector('.e-control');
@@ -2168,7 +2221,7 @@ var Ribbon = /** @class */ (function (_super) {
                                 this.setItemSize(ele, item);
                             }
                             if (group.enableGroupOverflow && overflowDDB) {
-                                if (overflowtarget.childElementCount === 0) {
+                                if (overflowtarget.childElementCount === 0 || (overflowtarget.childElementCount === 1 && this.isHeaderVisible(overflowtarget, group.id))) {
                                     this.removeOverflowButton(overflowDDB);
                                 }
                             }
@@ -2453,7 +2506,8 @@ var Ribbon = /** @class */ (function (_super) {
     Ribbon.prototype.createTemplateContent = function (item, itemElement) {
         var itemEle = this.createElement('div', {
             className: item.cssClass ? (constants.RIBBON_TEMPLATE + constants.SPACE + item.cssClass) : constants.RIBBON_TEMPLATE,
-            id: item.id
+            id: item.id,
+            attrs: { 'tabindex': '-1' }
         });
         if (item.disabled) {
             itemEle.classList.add(constants.DISABLED_CSS);
@@ -2929,7 +2983,7 @@ var Ribbon = /** @class */ (function (_super) {
             }
             if (this.activeLayout === RibbonLayout.Simplified) {
                 if (itemProp.group.enableGroupOverflow) {
-                    if (dropdown.target.childElementCount === 0) {
+                    if (dropdown.target.childElementCount === 0 || (dropdown.target.childElementCount === 1 && this.isHeaderVisible(dropdown.target, itemProp.group.id))) {
                         this.removeOverflowButton(dropdown);
                     }
                 }
@@ -2956,6 +3010,9 @@ var Ribbon = /** @class */ (function (_super) {
             this.refreshLayout();
         }
     };
+    Ribbon.prototype.isHeaderVisible = function (headerEle, groupID) {
+        return headerEle.querySelector('#' + groupID + constants.GROUPOF_BUTTON_ID + constants.HEADER_ID) ? true : false;
+    };
     /**
      * Hides a specific group within a ribbon tab.
      *
@@ -3515,7 +3572,7 @@ var Ribbon = /** @class */ (function (_super) {
             }
             if (this.activeLayout === RibbonLayout.Simplified) {
                 if (itemProp.group.enableGroupOverflow) {
-                    if (dropdown.target.childElementCount === 0) {
+                    if (dropdown.target.childElementCount === 0 || (dropdown.target.childElementCount === 1 && this.isHeaderVisible(dropdown.target, itemProp.group.id))) {
                         this.removeOverflowButton(dropdown);
                     }
                 }
@@ -3734,7 +3791,7 @@ var Ribbon = /** @class */ (function (_super) {
             }
             this.createRibbonItem(ribbonItem, itemContainer);
             if (this.activeLayout === 'Simplified' && itemProp.group.enableGroupOverflow) {
-                if (dropdown.target.childElementCount === 0) {
+                if (dropdown.target.childElementCount === 0 || (dropdown.target.childElementCount === 1 && this.isHeaderVisible(dropdown.target, itemProp.group.id))) {
                     this.removeOverflowButton(dropdown);
                 }
             }

package/src/ribbon/items/ribbon-colorpicker.js

@@ -88,6 +88,15 @@ var RibbonColorPicker = /** @class */ (function () {
      */
     RibbonColorPicker.prototype.addOverFlowEvents = function (item, itemEle, overflowButton) {
         var _this = this;
+        var colorPickerSettings = item.colorPickerSettings;
+        if (colorPickerSettings.label && this.parent.activeLayout === 'Simplified') {
+            var label = this.parent.createElement('div', {
+                className: 'e-ribbon-colorpicker-label',
+                id: item.id + '_label',
+                innerHTML: colorPickerSettings.label
+            });
+            itemEle.insertBefore(label, itemEle.firstChild);
+        }
         var colorPickerEle = itemEle.querySelector('#' + item.id);
         colorPickerEle.setAttribute('data-control', item.type.toString());
         var colorPickerObj = getComponent(colorPickerEle, ColorPicker);
@@ -118,6 +127,13 @@ var RibbonColorPicker = /** @class */ (function () {
      */
     RibbonColorPicker.prototype.removeOverFlowEvents = function (item, itemEle) {
         var _this = this;
+        var colorPickerSettings = item.colorPickerSettings;
+        if (colorPickerSettings.label) {
+            var label = itemEle.querySelector('#' + item.id + '_label');
+            if (label) {
+                label.remove();
+            }
+        }
         var colorPickerEle = itemEle.querySelector('#' + item.id);
         var colorPickerObj = getComponent(colorPickerEle, ColorPicker);
         var cssClass = colorPickerObj.cssClass.split(SPACE);

package/src/ribbon/items/ribbon-combobox.js

@@ -83,6 +83,15 @@ var RibbonComboBox = /** @class */ (function () {
      */
     RibbonComboBox.prototype.addOverFlowEvents = function (item, itemEle, overflowButton) {
         var _this = this;
+        var comboBoxSettings = item.comboBoxSettings;
+        if (comboBoxSettings.label && this.parent.activeLayout === 'Simplified') {
+            var label = this.parent.createElement('div', {
+                className: 'e-ribbon-combobox-label',
+                id: item.id + '_label',
+                innerHTML: comboBoxSettings.label
+            });
+            itemEle.insertBefore(label, itemEle.firstChild);
+        }
         var inputEle = itemEle.querySelector('#' + item.id);
         inputEle.setAttribute('data-control', item.type.toString());
         var comboBoxObj = getComponent(inputEle, ComboBox);
@@ -107,6 +116,13 @@ var RibbonComboBox = /** @class */ (function () {
      */
     RibbonComboBox.prototype.removeOverFlowEvents = function (item, itemEle) {
         var _this = this;
+        var comboBoxSettings = item.comboBoxSettings;
+        if (comboBoxSettings.label) {
+            var label = itemEle.querySelector('#' + item.id + '_label');
+            if (label) {
+                label.remove();
+            }
+        }
         var inputEle = itemEle.querySelector('#' + item.id);
         var comboBoxObj = getComponent(inputEle, ComboBox);
         var cssClass = comboBoxObj.cssClass.split(SPACE);

package/src/ribbon/items/ribbon-dropdown.js

@@ -164,7 +164,9 @@ var RibbonDropDown = /** @class */ (function () {
         return dropdown;
     };
     RibbonDropDown.prototype.keyActionHandler = function (e, target) {
-        var items = target.querySelectorAll('.e-control');
+        var controlElements = Array.prototype.slice.call(target.querySelectorAll('.e-control'));
+        var templateElements = Array.prototype.slice.call(target.querySelectorAll('.e-ribbon-template'));
+        var items = controlElements.concat(templateElements);
         var comboBoxElements = target.querySelectorAll('.e-combobox');
         var comboBoxEle;
         if (comboBoxElements) {
@@ -183,7 +185,7 @@ var RibbonDropDown = /** @class */ (function () {
                 }
             }
         }
-        if (e.target.classList.contains('e-control') || e.target.classList.contains('e-ribbon-launcher-icon') ||
+        if (e.target.classList.contains('e-control') || e.target.classList.contains('e-ribbon-template') || e.target.classList.contains('e-ribbon-launcher-icon') ||
             e.target.classList.contains('e-ribbon-last-item') || e.target.classList.contains('e-ribbon-first-item')) {
             if (e.key === 'ArrowRight' || (!e.shiftKey && e.key === 'Tab')) {
                 this.handleNavigation(e, !this.enableRtl, items);
@@ -206,7 +208,7 @@ var RibbonDropDown = /** @class */ (function () {
             }
             if (!e.target.classList.contains('e-combobox') && !e.target.classList.contains('e-ribbon-last-item') &&
                 !e.target.classList.contains('e-ribbon-group-container') && (e.target.classList.contains('e-ribbon-first-item')
-                || this.itemIndex !== 0) && e.target.classList.contains('e-control')) {
+                || this.itemIndex !== 0) && (e.target.classList.contains('e-control') || e.target.classList.contains('e-ribbon-template'))) {
                 this.itemIndex++;
                 this.updateItemIndex(e, items, true);
             }

package/src/ribbon/items/ribbon-groupbutton.d.ts

@@ -1,5 +1,6 @@
 import { Ribbon } from '../base/ribbon';
 import { RibbonItemModel } from '../models';
+import { DropDownButton } from '@syncfusion/ej2-splitbuttons';
 /**
  * Defines the items of Ribbon.
  */
@@ -30,6 +31,7 @@ export declare class RibbonGroupButton {
      * @hidden
      */
     switchGroupButton(item: RibbonItemModel, itemElement: HTMLElement): void;
+    private addGroupButtonHeader;
     private handleGroupButtonNavigation;
     /**
      * Adds the additional event handlers as the item moved into overflow popup.
@@ -39,7 +41,7 @@ export declare class RibbonGroupButton {
      * @returns {void}
      * @hidden
      */
-    addOverFlowEvents(item: RibbonItemModel, itemEle: HTMLElement): void;
+    addOverFlowEvents(item: RibbonItemModel, itemEle: HTMLElement, overflowButton: DropDownButton): void;
     /**
      * Removes the additional event handlers as the item moved into overflow popup.
      *

package/src/ribbon/items/ribbon-groupbutton.js

@@ -113,13 +113,17 @@ var RibbonGroupButton = /** @class */ (function () {
                 }
                 count++;
             }
-            new DropDownButton({
+            var dropdown = new DropDownButton({
                 iconCss: dropdownIcon,
                 target: btnContainerEle,
                 enableRtl: this.parent.enableRtl,
                 cssClass: 'e-ribbon-dropdown-group-button',
                 disabled: item.disabled
             }, buttonEle);
+            if (groupBtnSettings.header) {
+                var dropDownPopup = dropdown.dropDown;
+                this.addGroupButtonHeader(item.id, groupBtnSettings, dropDownPopup.element);
+            }
             buttonEle.onclick = buttonEle.onkeydown = function () {
                 if (itemElement.querySelector('#' + item.id).classList.contains('e-active')) {
                     document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + 0).focus();
@@ -136,7 +140,9 @@ var RibbonGroupButton = /** @class */ (function () {
         }
     };
     RibbonGroupButton.prototype.groupButtonClicked = function (itemIndex, item, grpBtnSettings) {
-        var previousItems = [], selectingItems = [], selectedItems = [];
+        var previousItems = [];
+        var selectingItems = [];
+        var selectedItems = [];
         var groupButtonEle;
         var dropdown;
         for (var j = 0; j < grpBtnSettings.items.length; j++) {
@@ -167,9 +173,11 @@ var RibbonGroupButton = /** @class */ (function () {
                 for (var j = 0; j < grpBtnSettings.items.length; j++) {
                     if (document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + j) && document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + j).classList.contains('e-active')) {
                         document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + j).classList.remove('e-active');
+                        grpBtnSettings.items[parseInt(j.toString(), 10)].selected = false;
                     }
                 }
                 document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + itemIndex).classList.toggle('e-active');
+                grpBtnSettings.items[parseInt(itemIndex.toString(), 10)].selected = true;
                 if (document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + itemIndex).classList.contains('e-active') && this.parent.activeLayout === 'Simplified') {
                     this.grpBtnIndex = itemIndex;
                     groupButtonEle = document.querySelector('#' + item.id);
@@ -185,6 +193,12 @@ var RibbonGroupButton = /** @class */ (function () {
                     document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID).classList.add(constants.RIBBON_MULTIPLE_BUTTON_SELECTION);
                 }
                 document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + itemIndex).classList.toggle('e-active');
+                if (document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + itemIndex).classList.contains('e-active')) {
+                    grpBtnSettings.items[parseInt(itemIndex.toString(), 10)].selected = true;
+                }
+                else {
+                    grpBtnSettings.items[parseInt(itemIndex.toString(), 10)].selected = false;
+                }
                 var activeEleCount = 0;
                 for (var n = 0; n < grpBtnSettings.items.length; n++) {
                     if (document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + n) && document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + n).classList.contains('e-active') && this.parent.activeLayout === 'Simplified' && n !== itemIndex) {
@@ -273,13 +287,17 @@ var RibbonGroupButton = /** @class */ (function () {
                 }
                 itemsCount++;
             }
-            new DropDownButton({
+            var dropdown = new DropDownButton({
                 iconCss: dropdownIcon,
                 target: containerEle,
                 enableRtl: this.parent.enableRtl,
                 cssClass: 'e-ribbon-dropdown-group-button',
                 disabled: item.disabled
             }, buttonEle);
+            if (groupBtnSettings.header) {
+                var dropDownPopup = dropdown.dropDown;
+                this.addGroupButtonHeader(item.id, groupBtnSettings, dropDownPopup.element);
+            }
             buttonEle.onclick = buttonEle.onkeydown = function () {
                 if (itemElement.querySelector('#' + item.id).classList.contains('e-active')) {
                     document.querySelector('#' + item.id + constants.RIBBON_GROUP_BUTTON_ID + 0).focus();
@@ -303,6 +321,14 @@ var RibbonGroupButton = /** @class */ (function () {
             }
         }
     };
+    RibbonGroupButton.prototype.addGroupButtonHeader = function (itemID, groupBtnSettings, popupEle) {
+        var groupButtonHeader = this.parent.createElement('div', {
+            className: 'e-ribbon-groupbutton-header',
+            id: itemID + constants.HEADER_ID,
+            innerHTML: groupBtnSettings.header
+        });
+        popupEle.insertBefore(groupButtonHeader, popupEle.firstChild);
+    };
     RibbonGroupButton.prototype.handleGroupButtonNavigation = function (e, item) {
         var groupButtonEle = document.querySelector('#' + item.id);
         var dropdown = getComponent(groupButtonEle, DropDownButton);
@@ -368,16 +394,29 @@ var RibbonGroupButton = /** @class */ (function () {
      * @returns {void}
      * @hidden
      */
-    RibbonGroupButton.prototype.addOverFlowEvents = function (item, itemEle) {
+    RibbonGroupButton.prototype.addOverFlowEvents = function (item, itemEle, overflowButton) {
         var _this = this;
+        var groupBtnSettings = item.groupButtonSettings;
+        var isIconOnly = true;
         var groupButtonEle = itemEle.querySelector('#' + item.id);
         var dropdown = getComponent(groupButtonEle, DropDownButton);
-        dropdown.setProperties({ cssClass: dropdown.cssClass + constants.SPACE + constants.RIBBON_GROUP_BUTTON_OVERFLOW_POPUP });
+        dropdown.setProperties({ cssClass: dropdown.cssClass + constants.SPACE + constants.RIBBON_GROUP_BUTTON_OVERFLOW_POPUP, content: groupBtnSettings.header ? groupBtnSettings.header : '' });
         var targetEle = dropdown.target;
+        if (targetEle.children.length) {
+            for (var i = 0; i < targetEle.children.length; i++) {
+                if (groupBtnSettings.items[parseInt(i.toString(), 10)].content) {
+                    isIconOnly = false;
+                    break;
+                }
+            }
+            if (isIconOnly) {
+                targetEle.classList.add('e-icon-btn');
+            }
+        }
         targetEle.onclick = function () {
             if (_this.parent.activeLayout === 'Simplified' && targetEle.closest('.e-ribbon-dropdown-group-button').classList.contains(constants.RIBBON_GROUP_BUTTON_OVERFLOW_POPUP)) {
-                dropdown.element.focus();
                 dropdown.toggle();
+                overflowButton.toggle();
             }
         };
     };
@@ -393,9 +432,13 @@ var RibbonGroupButton = /** @class */ (function () {
         var groupButtonEle = itemEle.querySelector('#' + item.id);
         if (groupButtonEle) {
             var dropdown = getComponent(groupButtonEle, DropDownButton);
+            var targetEle = dropdown.target;
+            if (targetEle.classList.contains('e-icon-btn')) {
+                targetEle.classList.remove('e-icon-btn');
+            }
             var cssClass = dropdown.cssClass.split(constants.SPACE);
             cssClass = cssClass.filter(function (value) { return value !== constants.RIBBON_GROUP_BUTTON_OVERFLOW_POPUP; });
-            dropdown.setProperties({ cssClass: cssClass.join(constants.SPACE) });
+            dropdown.setProperties({ cssClass: cssClass.join(constants.SPACE), content: '' });
         }
     };
     /**

package/src/ribbon/models/ribbon-colorpicker-settings-model.d.ts

@@ -19,6 +19,13 @@ export interface RibbonColorPickerSettingsModel {
      */
     cssClass?: string;
 
+    /**
+     * Specifies the label text for the overflow item.
+     *
+     * @default ''
+     */
+    label?: string;
+
     /**
      * Defines whether to enable the opacity option in the color picker.
      *
@@ -29,7 +36,7 @@ export interface RibbonColorPickerSettingsModel {
     /**
      * Defines the rendering mode of the color picker.
      *
-     * @default 'Picker'
+     * @default 'Palette'
      */
     mode?: ColorPickerMode;
 

package/src/ribbon/models/ribbon-colorpicker-settings.d.ts

@@ -16,6 +16,12 @@ export declare class RibbonColorPickerSettings extends ChildProperty<RibbonColor
      * @default ''
      */
     cssClass: string;
+    /**
+     * Specifies the label text for the overflow item.
+     *
+     * @default ''
+     */
+    label: string;
     /**
      * Defines whether to enable the opacity option in the color picker.
      *
@@ -25,7 +31,7 @@ export declare class RibbonColorPickerSettings extends ChildProperty<RibbonColor
     /**
      * Defines the rendering mode of the color picker.
      *
-     * @default 'Picker'
+     * @default 'Palette'
      */
     mode: ColorPickerMode;
     /**

package/src/ribbon/models/ribbon-colorpicker-settings.js

@@ -41,11 +41,14 @@ var RibbonColorPickerSettings = /** @class */ (function (_super) {
     __decorate([
         Property('')
     ], RibbonColorPickerSettings.prototype, "cssClass", void 0);
+    __decorate([
+        Property('')
+    ], RibbonColorPickerSettings.prototype, "label", void 0);
     __decorate([
         Property(true)
     ], RibbonColorPickerSettings.prototype, "enableOpacity", void 0);
     __decorate([
-        Property('Picker')
+        Property('Palette')
     ], RibbonColorPickerSettings.prototype, "mode", void 0);
     __decorate([
         Property(true)