@progress/kendo-angular-layout 6.5.2 → 6.6.0-dev.202204071221

package/dist/npm/panelbar/panelbar.component.js

@@ -16,6 +16,7 @@ var panelbar_service_1 = require("./panelbar.service");
 var panelbar_item_template_directive_1 = require("./panelbar-item-template.directive");
 var util_1 = require("../common/util");
 var dom_queries_1 = require("./../common/dom-queries");
+var events_1 = require("./events");
 /**
  * Represents the [Kendo UI PanelBar component for Angular]({% slug overview_panelbar %}).
  */
@@ -46,17 +47,35 @@ var PanelBarComponent = /** @class */ (function () {
          * Sets the height of the component when the `"full"` expand mode is used.
          * This option is ignored in the `"multiple"` and `"single"` expand modes.
          */
-        this.height = "400px";
+        this.height = '400px';
         /**
          * Fires each time the user interacts with a PanelBar item
          * ([see example]({% slug routing_panelbar %}#toc-getting-the-selected-item)).
          * The event data contains all items that are modified.
          */
         this.stateChange = new core_1.EventEmitter();
+        /**
+         * Fires when an item is about to be selected.
+         * ([see example]({% slug events_panelbar %}))
+         * This event is preventable. If you cancel it, the item will not be selected.
+         */
+        this.select = new core_1.EventEmitter();
+        /**
+         * Fires when an item is about to be expanded.
+         * ([see example]({% slug events_panelbar %}))
+         * This event is preventable. If you cancel it, the item will remain collapsed.
+         */
+        this.expand = new core_1.EventEmitter();
+        /**
+         * Fires when an item is about to be collapsed.
+         * ([see example]({% slug events_panelbar %}))
+         * This event is preventable. If you cancel it, the item will remain expanded.
+         */
+        this.collapse = new core_1.EventEmitter();
         this.tabIndex = 0;
-        this.role = "tree";
+        this.role = 'tree';
         this.hostClass = true;
-        this.activeDescendant = "";
+        this.activeDescendant = '';
         this.isViewInit = true;
         this.focused = false;
         this._keepItemContent = false;
@@ -68,7 +87,7 @@ var PanelBarComponent = /** @class */ (function () {
                 childrenHeight += item.headerHeight();
             });
             _this.childrenItems.forEach(function (item) {
-                item.contentHeight = panelbar_expand_mode_1.PanelBarExpandMode.Full === _this.expandMode ? (panelbarHeight - childrenHeight) + "px" : 'auto';
+                item.contentHeight = panelbar_expand_mode_1.PanelBarExpandMode.Full === _this.expandMode ? (panelbarHeight - childrenHeight) + 'px' : 'auto';
                 item.contentOverflow = contentOverflow;
             });
         };
@@ -120,7 +139,7 @@ var PanelBarComponent = /** @class */ (function () {
     });
     Object.defineProperty(PanelBarComponent.prototype, "overflow", {
         get: function () {
-            return this.expandMode === panelbar_expand_mode_1.PanelBarExpandMode.Full ? "hidden" : "visible";
+            return this.expandMode === panelbar_expand_mode_1.PanelBarExpandMode.Full ? 'hidden' : 'visible';
         },
         enumerable: true,
         configurable: true
@@ -187,7 +206,7 @@ var PanelBarComponent = /** @class */ (function () {
         this.validateConfiguration();
     };
     PanelBarComponent.prototype.ngOnChanges = function (changes) {
-        if (changes['height'] || changes['expandMode'] || changes["items"]) { // tslint:disable-line
+        if (changes['height'] || changes['expandMode'] || changes['items']) { // tslint:disable-line
             if (this.childrenItems) {
                 setTimeout(this.updateChildrenHeight);
             }
@@ -238,7 +257,7 @@ var PanelBarComponent = /** @class */ (function () {
     PanelBarComponent.prototype.onComponentBlur = function () {
         this.eventService.onBlur();
         this.focused = false;
-        this.activeDescendant = "";
+        this.activeDescendant = '';
     };
     /**
      * @hidden
@@ -257,6 +276,26 @@ var PanelBarComponent = /** @class */ (function () {
             }
         }
     };
+    /**
+     * @hidden
+     */
+    PanelBarComponent.prototype.emitEvent = function (event, item) {
+        var eventArgs;
+        switch (event) {
+            case 'select':
+                eventArgs = new events_1.PanelBarSelectEvent();
+                break;
+            case 'collapse':
+                eventArgs = new events_1.PanelBarCollapseEvent();
+                break;
+            default:
+                eventArgs = new events_1.PanelBarExpandEvent();
+                break;
+        }
+        eventArgs.item = item.serialize();
+        this[event].emit(eventArgs);
+        return eventArgs;
+    };
     Object.defineProperty(PanelBarComponent.prototype, "viewItems", {
         get: function () {
             var treeItems = [];
@@ -272,7 +311,7 @@ var PanelBarComponent = /** @class */ (function () {
     PanelBarComponent.prototype.validateConfiguration = function () {
         if (core_1.isDevMode()) {
             if (this.items && (this.contentItems && this.contentItems.length > 0)) {
-                throw new Error("Invalid configuration: mixed template components and items property.");
+                throw new Error('Invalid configuration: mixed template components and items property.');
             }
         }
     };
@@ -288,30 +327,69 @@ var PanelBarComponent = /** @class */ (function () {
             var focusedState = selectedState;
             selectedState = _this.selectable ? selectedState : currentItem.selected;
             if (currentItem.selected !== selectedState || currentItem.focused !== focusedState) {
-                currentItem.selected = selectedState;
-                currentItem.focused = focusedState;
-                _this.activeDescendant = focusedState ? currentItem.itemId : "";
-                modifiedItems.push(currentItem);
+                var isSelectPrevented = selectedState ? _this.emitEvent('select', currentItem).isDefaultPrevented() : false;
+                if (!isSelectPrevented) {
+                    currentItem.selected = selectedState;
+                    currentItem.focused = focusedState;
+                    _this.activeDescendant = focusedState ? currentItem.itemId : '';
+                    modifiedItems.push(currentItem);
+                }
             }
         });
         if (this.expandMode === panelbar_expand_mode_1.PanelBarExpandMode.Multiple) {
-            if (item.hasChildItems || item.hasContent) {
-                item.expanded = !item.expanded;
-            }
-            if (modifiedItems.indexOf(item) < 0) {
-                modifiedItems.push(item);
+            if ((item.hasChildItems || item.hasContent) && item.selected) {
+                var isEventPrevented = item.expanded ?
+                    this.emitEvent('collapse', item).isDefaultPrevented() :
+                    this.emitEvent('expand', item).isDefaultPrevented();
+                if (!isEventPrevented) {
+                    item.expanded = !item.expanded;
+                    if (modifiedItems.indexOf(item) < 0) {
+                        modifiedItems.push(item);
+                    }
+                }
             }
         }
         else {
             var siblings = item.parent ? item.parent.childrenItems : this.childrenItems;
-            if (item.hasChildItems || item.hasContent) {
+            var preventedCollapseItem_1;
+            var expandedItems_1 = [];
+            if ((item.hasChildItems || item.hasContent) && item.selected) {
                 siblings
                     .forEach(function (currentItem) {
                     var expandedState = currentItem === item;
                     if (currentItem.expanded !== expandedState) {
-                        currentItem.expanded = expandedState;
-                        if (modifiedItems.indexOf(currentItem) < 0) {
-                            modifiedItems.push(currentItem);
+                        var isEventPrevented = currentItem.expanded ?
+                            _this.emitEvent('collapse', currentItem).isDefaultPrevented() :
+                            _this.emitEvent('expand', currentItem).isDefaultPrevented();
+                        if (!isEventPrevented) {
+                            currentItem.expanded = expandedState;
+                            if (currentItem.expanded) {
+                                expandedItems_1.push(currentItem);
+                            }
+                            if (modifiedItems.indexOf(currentItem) < 0) {
+                                modifiedItems.push(currentItem);
+                            }
+                        }
+                        else if (isEventPrevented && currentItem.expanded) {
+                            preventedCollapseItem_1 = currentItem;
+                        }
+                    }
+                    else if (currentItem.expanded === expandedState && expandedState) {
+                        var isCollapsePrevented = _this.emitEvent('collapse', currentItem).isDefaultPrevented();
+                        if (!isCollapsePrevented) {
+                            currentItem.expanded = !currentItem.expanded;
+                            if (modifiedItems.indexOf(currentItem) < 0) {
+                                modifiedItems.push(currentItem);
+                            }
+                        }
+                    }
+                });
+                expandedItems_1.forEach(function (item) {
+                    if (preventedCollapseItem_1 && item.id !== preventedCollapseItem_1.id) {
+                        item.expanded = false;
+                        if (core_1.isDevMode()) {
+                            var expandMode = panelbar_expand_mode_1.PanelBarExpandMode[_this.expandMode].toLowerCase();
+                            console.warn("\n                            The " + expandMode + " expandMode allows the expansion of only one item at a time.\n                            See https://www.telerik.com/kendo-angular-ui-develop/components/layout/panelbar/expand-modes/");
                         }
                     }
                 });
@@ -344,16 +422,16 @@ var PanelBarComponent = /** @class */ (function () {
             currentIndex = visibleItems.findIndex(function (item) { return item === currentItem; });
         }
         switch (action) {
-            case "lastItem":
+            case 'lastItem':
                 nextItem = visibleItems[visibleItems.length - 1];
                 break;
-            case "firstItem":
+            case 'firstItem':
                 nextItem = visibleItems[0];
                 break;
-            case "nextItem":
+            case 'nextItem':
                 nextItem = visibleItems[currentIndex < visibleItems.length - 1 ? currentIndex + 1 : 0];
                 break;
-            case "previousItem":
+            case 'previousItem':
                 nextItem = visibleItems[currentIndex > 0 ? currentIndex - 1 : visibleItems.length - 1];
                 break;
             default:
@@ -370,16 +448,16 @@ var PanelBarComponent = /** @class */ (function () {
         this.stateChange.emit(modifiedItems);
     };
     PanelBarComponent.prototype.focusLastItem = function () {
-        this.focusItem("lastItem");
+        this.focusItem('lastItem');
     };
     PanelBarComponent.prototype.focusFirstItem = function () {
-        this.focusItem("firstItem");
+        this.focusItem('firstItem');
     };
     PanelBarComponent.prototype.focusNextItem = function () {
-        this.focusItem("nextItem");
+        this.focusItem('nextItem');
     };
     PanelBarComponent.prototype.focusPreviousItem = function () {
-        this.focusItem("previousItem");
+        this.focusItem('previousItem');
     };
     PanelBarComponent.prototype.expandItem = function () {
         var currentItem = this.allItems.filter(function (item) { return item.focused; })[0];
@@ -463,6 +541,18 @@ var PanelBarComponent = /** @class */ (function () {
         core_1.Output(),
         tslib_1.__metadata("design:type", core_1.EventEmitter)
     ], PanelBarComponent.prototype, "stateChange", void 0);
+    tslib_1.__decorate([
+        core_1.Output(),
+        tslib_1.__metadata("design:type", core_1.EventEmitter)
+    ], PanelBarComponent.prototype, "select", void 0);
+    tslib_1.__decorate([
+        core_1.Output(),
+        tslib_1.__metadata("design:type", core_1.EventEmitter)
+    ], PanelBarComponent.prototype, "expand", void 0);
+    tslib_1.__decorate([
+        core_1.Output(),
+        tslib_1.__metadata("design:type", core_1.EventEmitter)
+    ], PanelBarComponent.prototype, "collapse", void 0);
     tslib_1.__decorate([
         core_1.HostBinding('attr.tabIndex'),
         tslib_1.__metadata("design:type", Number)
@@ -546,7 +636,7 @@ var PanelBarComponent = /** @class */ (function () {
                 }
             ],
             selector: 'kendo-panelbar',
-            template: "\n        <ng-content *ngIf=\"contentChildItems && !items\" select=\"kendo-panelbar-item\"></ng-content>\n        <ng-template [ngIf]=\"items?.length\">\n            <ng-container *ngFor=\"let item of items\">\n                <kendo-panelbar-item *ngIf=\"!item.hidden\"\n                     [title]=\"item.title\"\n                     [id]=\"item.id\"\n                     [icon]=\"item.icon\"\n                     [iconClass]=\"item.iconClass\"\n                     [imageUrl]=\"item.imageUrl\"\n                     [selected]=\"!!item.selected\"\n                     [expanded]=\"!!item.expanded\"\n                     [disabled]=\"!!item.disabled\"\n                     [template]=\"templateRef\"\n                     [items]=\"item.children\"\n                     [content]=\"item.content\"\n                >\n                </kendo-panelbar-item>\n            </ng-container>\n        </ng-template>\n    "
+            template: "\n        <ng-content *ngIf=\"contentChildItems && !items\" select=\"kendo-panelbar-item\"></ng-content>\n        <ng-template [ngIf]=\"items?.length\">\n            <ng-container *ngFor=\"let item of items\">\n                <kendo-panelbar-item *ngIf=\"!item.hidden\"\n                    [title]=\"item.title\"\n                    [id]=\"item.id\"\n                    [icon]=\"item.icon\"\n                    [iconClass]=\"item.iconClass\"\n                    [imageUrl]=\"item.imageUrl\"\n                    [selected]=\"!!item.selected\"\n                    [expanded]=\"!!item.expanded\"\n                    [disabled]=\"!!item.disabled\"\n                    [template]=\"templateRef\"\n                    [items]=\"item.children\"\n                    [content]=\"item.content\"\n                >\n                </kendo-panelbar-item>\n            </ng-container>\n        </ng-template>\n    "
         })
         // TODO: add styles as input prop
         ,