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

package/dist/fesm2015/index.js

@@ -21,7 +21,7 @@ const packageMetadata = {
     name: '@progress/kendo-angular-layout',
     productName: 'Kendo UI for Angular',
     productCodes: ['KENDOUIANGULAR', 'KENDOUICOMPLETE'],
-    publishDate: 1647343533,
+    publishDate: 1649334013,
     version: '',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/?utm_medium=product&utm_source=kendoangular&utm_campaign=kendo-ui-angular-purchase-license-keys-warning'
 };
@@ -660,7 +660,22 @@ PanelBarItemComponent = PanelBarItemComponent_1 = __decorate([
                     [src]="imageUrl"
                     alt="">
                 <ng-container *ngIf="!titleTemplate"><span class="k-panelbar-item-text">{{title}}</span></ng-container>
-                <ng-template *ngIf="titleTemplate" [ngTemplateOutlet]="titleTemplate"></ng-template>
+                <ng-template *ngIf="titleTemplate"
+                [ngTemplateOutlet]="titleTemplate"
+                [ngTemplateOutletContext]="{
+                    item: {
+                        title: title,
+                        id: id,
+                        icon: icon,
+                        iconClass: iconClass,
+                        imageUrl: imageUrl,
+                        selected: selected,
+                        expanded: expanded,
+                        disabled: disabled,
+                        focused: focused,
+                        content: content
+                    }
+                }"></ng-template>
                 <span *ngIf="hasChildItems || hasContent"
                     class="k-icon k-panelbar-toggle"
                     [ngClass]="{'k-i-arrow-chevron-up k-panelbar-collapse': expanded, 'k-i-arrow-chevron-down k-panelbar-expand': !expanded}">
@@ -762,6 +777,55 @@ PanelBarItemTemplateDirective = __decorate([
     __metadata("design:paramtypes", [TemplateRef])
 ], PanelBarItemTemplateDirective);
 
+/**
+ * @hidden
+ */
+class PreventableEvent$1 {
+    /**
+     * @hidden
+     */
+    constructor(args) {
+        this.prevented = false;
+        Object.assign(this, args);
+    }
+    /**
+     * Prevents the default action for a specified event.
+     * In this way, the source component suppresses
+     * the built-in behavior that follows the event.
+     */
+    preventDefault() {
+        this.prevented = true;
+    }
+    /**
+     * Returns `true` if the event was prevented
+     * by any of its subscribers.
+     *
+     * @returns `true` if the default action was prevented.
+     * Otherwise, returns `false`.
+     */
+    isDefaultPrevented() {
+        return this.prevented;
+    }
+}
+
+/**
+ * Arguments for the `collapse` event of the PanelBar.
+ */
+class PanelBarCollapseEvent extends PreventableEvent$1 {
+}
+
+/**
+ * Arguments for the `expand` event of the PanelBar.
+ */
+class PanelBarExpandEvent extends PreventableEvent$1 {
+}
+
+/**
+ * Arguments for the `select` event of the PanelBar.
+ */
+class PanelBarSelectEvent extends PreventableEvent$1 {
+}
+
 /**
  * Represents the [Kendo UI PanelBar component for Angular]({% slug overview_panelbar %}).
  */
@@ -793,17 +857,35 @@ class PanelBarComponent {
          * 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 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 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 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 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;
@@ -815,7 +897,7 @@ class PanelBarComponent {
                 childrenHeight += item.headerHeight();
             });
             this.childrenItems.forEach(item => {
-                item.contentHeight = PanelBarExpandMode.Full === this.expandMode ? (panelbarHeight - childrenHeight) + "px" : 'auto';
+                item.contentHeight = PanelBarExpandMode.Full === this.expandMode ? (panelbarHeight - childrenHeight) + 'px' : 'auto';
                 item.contentOverflow = contentOverflow;
             });
         };
@@ -854,7 +936,7 @@ class PanelBarComponent {
         return this.expandMode === PanelBarExpandMode.Full ? this.height : 'auto';
     }
     get overflow() {
-        return this.expandMode === PanelBarExpandMode.Full ? "hidden" : "visible";
+        return this.expandMode === PanelBarExpandMode.Full ? 'hidden' : 'visible';
     }
     get dir() {
         return this.localization.rtl ? 'rtl' : 'ltr';
@@ -904,7 +986,7 @@ class PanelBarComponent {
         this.validateConfiguration();
     }
     ngOnChanges(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);
             }
@@ -951,7 +1033,7 @@ class PanelBarComponent {
     onComponentBlur() {
         this.eventService.onBlur();
         this.focused = false;
-        this.activeDescendant = "";
+        this.activeDescendant = '';
     }
     /**
      * @hidden
@@ -970,6 +1052,26 @@ class PanelBarComponent {
             }
         }
     }
+    /**
+     * @hidden
+     */
+    emitEvent(event, item) {
+        let eventArgs;
+        switch (event) {
+            case 'select':
+                eventArgs = new PanelBarSelectEvent();
+                break;
+            case 'collapse':
+                eventArgs = new PanelBarCollapseEvent();
+                break;
+            default:
+                eventArgs = new PanelBarExpandEvent();
+                break;
+        }
+        eventArgs.item = item.serialize();
+        this[event].emit(eventArgs);
+        return eventArgs;
+    }
     get viewItems() {
         let treeItems = [];
         this.viewChildItems.toArray().forEach(item => {
@@ -981,7 +1083,7 @@ class PanelBarComponent {
     validateConfiguration() {
         if (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.');
             }
         }
     }
@@ -996,30 +1098,71 @@ class PanelBarComponent {
             let 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);
+                const 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 === 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) {
+                const 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 {
             let siblings = item.parent ? item.parent.childrenItems : this.childrenItems;
-            if (item.hasChildItems || item.hasContent) {
+            let preventedCollapseItem;
+            let expandedItems = [];
+            if ((item.hasChildItems || item.hasContent) && item.selected) {
                 siblings
                     .forEach((currentItem) => {
                     let expandedState = currentItem === item;
                     if (currentItem.expanded !== expandedState) {
-                        currentItem.expanded = expandedState;
-                        if (modifiedItems.indexOf(currentItem) < 0) {
-                            modifiedItems.push(currentItem);
+                        const isEventPrevented = currentItem.expanded ?
+                            this.emitEvent('collapse', currentItem).isDefaultPrevented() :
+                            this.emitEvent('expand', currentItem).isDefaultPrevented();
+                        if (!isEventPrevented) {
+                            currentItem.expanded = expandedState;
+                            if (currentItem.expanded) {
+                                expandedItems.push(currentItem);
+                            }
+                            if (modifiedItems.indexOf(currentItem) < 0) {
+                                modifiedItems.push(currentItem);
+                            }
+                        }
+                        else if (isEventPrevented && currentItem.expanded) {
+                            preventedCollapseItem = currentItem;
+                        }
+                    }
+                    else if (currentItem.expanded === expandedState && expandedState) {
+                        const isCollapsePrevented = this.emitEvent('collapse', currentItem).isDefaultPrevented();
+                        if (!isCollapsePrevented) {
+                            currentItem.expanded = !currentItem.expanded;
+                            if (modifiedItems.indexOf(currentItem) < 0) {
+                                modifiedItems.push(currentItem);
+                            }
+                        }
+                    }
+                });
+                expandedItems.forEach(item => {
+                    if (preventedCollapseItem && item.id !== preventedCollapseItem.id) {
+                        item.expanded = false;
+                        if (isDevMode()) {
+                            const expandMode = PanelBarExpandMode[this.expandMode].toLowerCase();
+                            console.warn(`
+                            The ${expandMode} expandMode allows the expansion of only one item at a time.
+                            See https://www.telerik.com/kendo-angular-ui-develop/components/layout/panelbar/expand-modes/`);
                         }
                     }
                 });
@@ -1052,16 +1195,16 @@ class PanelBarComponent {
             currentIndex = visibleItems.findIndex(item => 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:
@@ -1078,16 +1221,16 @@ class PanelBarComponent {
         this.stateChange.emit(modifiedItems);
     }
     focusLastItem() {
-        this.focusItem("lastItem");
+        this.focusItem('lastItem');
     }
     focusFirstItem() {
-        this.focusItem("firstItem");
+        this.focusItem('firstItem');
     }
     focusNextItem() {
-        this.focusItem("nextItem");
+        this.focusItem('nextItem');
     }
     focusPreviousItem() {
-        this.focusItem("previousItem");
+        this.focusItem('previousItem');
     }
     expandItem() {
         let currentItem = this.allItems.filter(item => item.focused)[0];
@@ -1169,6 +1312,18 @@ __decorate([
     Output(),
     __metadata("design:type", EventEmitter)
 ], PanelBarComponent.prototype, "stateChange", void 0);
+__decorate([
+    Output(),
+    __metadata("design:type", EventEmitter)
+], PanelBarComponent.prototype, "select", void 0);
+__decorate([
+    Output(),
+    __metadata("design:type", EventEmitter)
+], PanelBarComponent.prototype, "expand", void 0);
+__decorate([
+    Output(),
+    __metadata("design:type", EventEmitter)
+], PanelBarComponent.prototype, "collapse", void 0);
 __decorate([
     HostBinding('attr.tabIndex'),
     __metadata("design:type", Number)
@@ -1257,17 +1412,17 @@ PanelBarComponent = __decorate([
         <ng-template [ngIf]="items?.length">
             <ng-container *ngFor="let item of items">
                 <kendo-panelbar-item *ngIf="!item.hidden"
-                     [title]="item.title"
-                     [id]="item.id"
-                     [icon]="item.icon"
-                     [iconClass]="item.iconClass"
-                     [imageUrl]="item.imageUrl"
-                     [selected]="!!item.selected"
-                     [expanded]="!!item.expanded"
-                     [disabled]="!!item.disabled"
-                     [template]="templateRef"
-                     [items]="item.children"
-                     [content]="item.content"
+                    [title]="item.title"
+                    [id]="item.id"
+                    [icon]="item.icon"
+                    [iconClass]="item.iconClass"
+                    [imageUrl]="item.imageUrl"
+                    [selected]="!!item.selected"
+                    [expanded]="!!item.expanded"
+                    [disabled]="!!item.disabled"
+                    [template]="templateRef"
+                    [items]="item.children"
+                    [content]="item.content"
                 >
                 </kendo-panelbar-item>
             </ng-container>
@@ -2572,37 +2727,6 @@ const DIRECTION_CLASSES = {
  */
 const DEFAULT_SCROLL_BEHAVIOR = 'smooth';
 
-/**
- * @hidden
- */
-class PreventableEvent$1 {
-    /**
-     * @hidden
-     */
-    constructor(args) {
-        this.prevented = false;
-        Object.assign(this, args);
-    }
-    /**
-     * Prevents the default action for a specified event.
-     * In this way, the source component suppresses
-     * the built-in behavior that follows the event.
-     */
-    preventDefault() {
-        this.prevented = true;
-    }
-    /**
-     * Returns `true` if the event was prevented
-     * by any of its subscribers.
-     *
-     * @returns `true` if the default action was prevented.
-     * Otherwise, returns `false`.
-     */
-    isDefaultPrevented() {
-        return this.prevented;
-    }
-}
-
 /**
  * Arguments for the `tabScroll` event of the TabStrip.
  * The `tabScroll` event fires when the tabs are being scrolled.
@@ -8786,4 +8910,4 @@ LayoutModule = __decorate([
  * Generated bundle index. Do not edit.
  */
 
-export { PreventableEvent$1 as PreventableEvent, DrawerService, DrawerItemComponent, DrawerListComponent, DRAWER_ITEM_INDEX, PanelBarService, SplitterBarComponent, SplitterService, StepperListComponent, StepperMessages, STEPPER_STEP_INDEX, StepperStepComponent, StepperService, TabStripMessages, TabComponent, TabStripScrollableButtonComponent, ScrollService, TabStripService, TileLayoutDraggingService, PreventableEvent$2 as PreventableEvent$1, TileLayoutResizeHandleDirective, PanelBarComponent, PanelBarItemComponent, PanelBarContentDirective, PanelBarItemTemplateDirective, PanelBarItemTitleDirective, PanelBarExpandMode, SplitterComponent, SplitterPaneComponent, TabStripComponent, TabStripTabComponent, TabContentDirective, TabTitleDirective, LocalizedTabStripMessagesDirective, TabStripCustomMessagesComponent, DrawerComponent, DrawerContainerComponent, DrawerContentComponent, DrawerSelectEvent, StepperComponent, StepperActivateEvent, StepperCustomMessagesComponent, LocalizedStepperMessagesDirective, AvatarComponent, CardComponent, CardHeaderComponent, CardBodyComponent, CardFooterComponent, CardActionsComponent, CardSeparatorDirective, CardTitleDirective, CardSubtitleDirective, CardMediaDirective, CardAction, ExpansionPanelComponent, ExpansionPanelTitleDirective, ExpansionPanelActionEvent, TileLayoutComponent, TileLayoutItemComponent, TileLayoutItemBodyComponent, TileLayoutItemHeaderComponent, TileLayoutReorderEvent, TileLayoutResizeEvent, AvatarModule, CardModule, DrawerModule, LayoutModule, PanelBarModule, SplitterModule, StepperModule, TabStripModule, ExpansionPanelModule, TileLayoutModule, StackLayoutModule, GridLayoutModule, StackLayoutComponent, GridLayoutComponent, GridLayoutItemComponent, TabCloseEvent, SelectEvent, DrawerTemplateDirective, DrawerItemTemplateDirective, DrawerHeaderTemplateDirective, DrawerFooterTemplateDirective, StepperIndicatorTemplateDirective, StepperLabelTemplateDirective, StepperStepTemplateDirective };
+export { PreventableEvent$1 as PreventableEvent, DrawerService, DrawerItemComponent, DrawerListComponent, DRAWER_ITEM_INDEX, PanelBarService, SplitterBarComponent, SplitterService, StepperListComponent, StepperMessages, STEPPER_STEP_INDEX, StepperStepComponent, StepperService, TabStripMessages, TabComponent, TabStripScrollableButtonComponent, ScrollService, TabStripService, TileLayoutDraggingService, PreventableEvent$2 as PreventableEvent$1, TileLayoutResizeHandleDirective, PanelBarComponent, PanelBarItemComponent, PanelBarContentDirective, PanelBarItemTemplateDirective, PanelBarItemTitleDirective, PanelBarExpandMode, SplitterComponent, SplitterPaneComponent, TabStripComponent, TabStripTabComponent, TabContentDirective, TabTitleDirective, LocalizedTabStripMessagesDirective, TabStripCustomMessagesComponent, DrawerComponent, DrawerContainerComponent, DrawerContentComponent, DrawerSelectEvent, StepperComponent, StepperActivateEvent, StepperCustomMessagesComponent, LocalizedStepperMessagesDirective, AvatarComponent, CardComponent, CardHeaderComponent, CardBodyComponent, CardFooterComponent, CardActionsComponent, CardSeparatorDirective, CardTitleDirective, CardSubtitleDirective, CardMediaDirective, CardAction, ExpansionPanelComponent, ExpansionPanelTitleDirective, ExpansionPanelActionEvent, TileLayoutComponent, TileLayoutItemComponent, TileLayoutItemBodyComponent, TileLayoutItemHeaderComponent, TileLayoutReorderEvent, TileLayoutResizeEvent, AvatarModule, CardModule, DrawerModule, LayoutModule, PanelBarModule, SplitterModule, StepperModule, TabStripModule, ExpansionPanelModule, TileLayoutModule, StackLayoutModule, GridLayoutModule, StackLayoutComponent, GridLayoutComponent, GridLayoutItemComponent, PanelBarCollapseEvent, PanelBarExpandEvent, PanelBarSelectEvent, TabCloseEvent, SelectEvent, DrawerTemplateDirective, DrawerItemTemplateDirective, DrawerHeaderTemplateDirective, DrawerFooterTemplateDirective, StepperIndicatorTemplateDirective, StepperLabelTemplateDirective, StepperStepTemplateDirective };