primeng
Version:
PrimeNG is an open source UI library for Angular featuring a rich set of 80+ components, a theme designer, various theme alternatives such as Material, Bootstrap, Tailwind, premium templates and professional support. In addition, it integrates with PrimeB
661 lines (638 loc) • 27.3 kB
JavaScript
import * as i1 from '@angular/common';
import { CommonModule } from '@angular/common';
import * as i0 from '@angular/core';
import { Injectable, EventEmitter, inject, ContentChildren, ContentChild, ViewChild, Output, Input, ViewEncapsulation, ChangeDetectionStrategy, Component, NgModule } from '@angular/core';
import * as i2 from '@angular/router';
import { RouterModule } from '@angular/router';
import { uuid, resolve, find, findSingle } from '@primeuix/utils';
import { SharedModule, PrimeTemplate } from 'primeng/api';
import { BaseComponent } from 'primeng/basecomponent';
import { Ripple } from 'primeng/ripple';
import * as i3 from 'primeng/tooltip';
import { TooltipModule } from 'primeng/tooltip';
import { BaseStyle } from 'primeng/base';
const theme = ({ dt }) => `
.p-dock {
position: absolute;
z-index: 1;
display: flex;
justify-content: center;
align-items: center;
pointer-events: none;
}
.p-dock-list-container {
display: flex;
pointer-events: auto;
background: ${dt('dock.background')};
border: 1px solid ${dt('dock.border.color')};
padding: ${dt('dock.padding')};
border-radius: ${dt('dock.border.radius')};
}
.p-dock-list {
margin: 0;
padding: 0;
list-style: none;
display: flex;
align-items: center;
justify-content: center;
outline: 0 none;
}
.p-dock-item {
transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
will-change: transform;
padding: ${dt('dock.item.padding')};
border-radius: ${dt('dock.item.border.radius')};
}
.p-dock-item.p-focus {
box-shadow: ${dt('dock.item.focus.ring.shadow')};
outline: ${dt('dock.item.focus.ring.width')} ${dt('dock.item.focus.ring.style')} ${dt('dock.item.focus.ring.color')};
outline-offset: ${dt('dock.item.focus.ring.offset')};
}
.p-dock-item-link {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
position: relative;
overflow: hidden;
cursor: default;
width: ${dt('dock.item.size')};
height: ${dt('dock.item.size')};
}
.p-dock-top {
left: 0;
top: 0;
width: 100%;
}
.p-dock-top .p-dock-item {
transform-origin: center top;
}
.p-dock-bottom {
left: 0;
bottom: 0;
width: 100%;
}
.p-dock-bottom .p-dock-item {
transform-origin: center bottom;
}
.p-dock-right {
right: 0;
top: 0;
height: 100%;
}
.p-dock-right:dir(rtl) {
right: auto;
left: 0;
}
.p-dock-right .p-dock-item {
transform-origin: center right;
}
.p-dock-right .p-dock-list {
flex-direction: column;
}
.p-dock-left {
left: 0;
top: 0;
height: 100%;
}
.p-dock-left:dir(rtl) {
left: auto;
right: 0;
}
.p-dock-left .p-dock-item {
transform-origin: center left;
}
.p-dock-left .p-dock-list {
flex-direction: column;
}
.p-dock-mobile.p-dock-top .p-dock-list-container,
.p-dock-mobile.p-dock-bottom .p-dock-list-container {
overflow-x: auto;
width: 100%;
}
.p-dock-mobile.p-dock-top .p-dock-list-container .p-dock-list,
.p-dock-mobile.p-dock-bottom .p-dock-list-container .p-dock-list {
margin: 0 auto;
}
.p-dock-mobile.p-dock-left .p-dock-list-container,
.p-dock-mobile.p-dock-right .p-dock-list-container {
overflow-y: auto;
height: 100%;
}
.p-dock-mobile.p-dock-left .p-dock-list-container .p-dock-list,
.p-dock-mobile.p-dock-right .p-dock-list-container .p-dock-list {
margin: auto 0;
}
.p-dock-mobile .p-dock-list .p-dock-item {
transform: none;
margin: 0;
}
`;
const classes = {
root: ({ instance, props }) => [
'p-dock p-component',
`p-dock-${props.position}`,
{
'p-dock-mobile': instance.queryMatches
}
],
listContainer: 'p-dock-list-container',
list: 'p-dock-list',
item: ({ instance, processedItem, id }) => [
'p-dock-item',
{
'p-focus': instance.isItemActive(id),
'p-disabled': instance.disabled(processedItem)
}
],
itemContent: 'p-dock-item-content',
itemLink: 'p-dock-item-link',
itemIcon: 'p-dock-item-icon'
};
class DockStyle extends BaseStyle {
name = 'dock';
theme = theme;
classes = classes;
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: DockStyle, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: DockStyle });
}
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: DockStyle, decorators: [{
type: Injectable
}] });
/**
*
* Dock is a navigation component consisting of menuitems.
*
* [Live Demo](https://www.primeng.org/dock/)
*
* @module dockstyle
*
*/
var DockClasses;
(function (DockClasses) {
/**
* Class name of the root element
*/
DockClasses["root"] = "p-dock";
/**
* Class name of the list container element
*/
DockClasses["listContainer"] = "p-dock-list-container";
/**
* Class name of the list element
*/
DockClasses["list"] = "p-dock-list";
/**
* Class name of the item element
*/
DockClasses["item"] = "p-dock-item";
/**
* Class name of the item content element
*/
DockClasses["itemContent"] = "p-dock-item-content";
/**
* Class name of the item link element
*/
DockClasses["itemLink"] = "p-dock-item-link";
/**
* Class name of the item icon element
*/
DockClasses["itemIcon"] = "p-dock-item-icon";
})(DockClasses || (DockClasses = {}));
/**
* Dock is a navigation component consisting of menuitems.
* @group Components
*/
class Dock extends BaseComponent {
cd;
/**
* Current id state as a string.
* @group Props
*/
id;
/**
* Inline style of the element.
* @group Props
*/
style;
/**
* Class of the element.
* @group Props
*/
styleClass;
/**
* MenuModel instance to define the action items.
* @group Props
*/
model = null;
/**
* Position of element.
* @group Props
*/
position = 'bottom';
/**
* Defines a string that labels the input for accessibility.
* @group Props
*/
ariaLabel;
/**
* Defines a string that labels the dropdown button for accessibility.
* @group Props
*/
ariaLabelledBy;
/**
* Callback to execute when button is focused.
* @param {FocusEvent} event - Focus event.
* @group Emits
*/
onFocus = new EventEmitter();
/**
* Callback to invoke when the component loses focus.
* @param {FocusEvent} event - Focus event.
* @group Emits
*/
onBlur = new EventEmitter();
listViewChild;
currentIndex;
tabindex = 0;
focused = false;
focusedOptionIndex = -1;
_componentStyle = inject(DockStyle);
get focusedOptionId() {
return this.focusedOptionIndex !== -1 ? this.focusedOptionIndex : null;
}
constructor(cd) {
super();
this.cd = cd;
this.currentIndex = -3;
}
ngOnInit() {
super.ngOnInit();
this.id = this.id || uuid('pn_id_');
}
itemTemplate;
_itemTemplate;
getItemId(item, index) {
return item && item?.id ? item.id : `${index}`;
}
getItemProp(processedItem, name) {
return processedItem && processedItem.item ? resolve(processedItem.item[name]) : undefined;
}
disabled(item) {
return typeof item.disabled === 'function' ? item.disabled() : item.disabled;
}
isItemActive(id) {
return id === this.focusedOptionIndex;
}
onListMouseLeave() {
this.currentIndex = -3;
this.cd.markForCheck();
}
onItemMouseEnter(index) {
this.currentIndex = index;
if (index === 1) {
}
this.cd.markForCheck();
}
onItemClick(e, item) {
if (item.command) {
item.command({ originalEvent: e, item });
}
}
onListFocus(event) {
this.focused = true;
this.changeFocusedOptionIndex(0);
this.onFocus.emit(event);
}
onListBlur(event) {
this.focused = false;
this.focusedOptionIndex = -1;
this.onBlur.emit(event);
}
onListKeyDown(event) {
switch (event.code) {
case 'ArrowDown': {
if (this.position === 'left' || this.position === 'right')
this.onArrowDownKey();
event.preventDefault();
break;
}
case 'ArrowUp': {
if (this.position === 'left' || this.position === 'right')
this.onArrowUpKey();
event.preventDefault();
break;
}
case 'ArrowRight': {
if (this.position === 'top' || this.position === 'bottom')
this.onArrowDownKey();
event.preventDefault();
break;
}
case 'ArrowLeft': {
if (this.position === 'top' || this.position === 'bottom')
this.onArrowUpKey();
event.preventDefault();
break;
}
case 'Home': {
this.onHomeKey();
event.preventDefault();
break;
}
case 'End': {
this.onEndKey();
event.preventDefault();
break;
}
case 'Enter':
case 'Space': {
this.onSpaceKey();
event.preventDefault();
break;
}
default:
break;
}
}
onArrowDownKey() {
const optionIndex = this.findNextOptionIndex(this.focusedOptionIndex);
this.changeFocusedOptionIndex(optionIndex);
}
onArrowUpKey() {
const optionIndex = this.findPrevOptionIndex(this.focusedOptionIndex);
this.changeFocusedOptionIndex(optionIndex);
}
onHomeKey() {
this.changeFocusedOptionIndex(0);
}
onEndKey() {
this.changeFocusedOptionIndex(find(this.listViewChild.nativeElement, 'li[data-pc-section="menuitem"][data-p-disabled="false"]').length - 1);
}
onSpaceKey() {
const element = findSingle(this.listViewChild.nativeElement, `li[id="${`${this.focusedOptionIndex}`}"]`);
const anchorElement = element && findSingle(element, '[data-pc-section="action"]');
anchorElement ? anchorElement.click() : element && element.click();
}
findNextOptionIndex(index) {
const menuitems = find(this.listViewChild.nativeElement, 'li[data-pc-section="menuitem"][data-p-disabled="false"]');
const matchedOptionIndex = [...menuitems].findIndex((link) => link.id === index);
return matchedOptionIndex > -1 ? matchedOptionIndex + 1 : 0;
}
changeFocusedOptionIndex(index) {
const menuitems = find(this.listViewChild.nativeElement, 'li[data-pc-section="menuitem"][data-p-disabled="false"]');
let order = index >= menuitems.length ? menuitems.length - 1 : index < 0 ? 0 : index;
this.focusedOptionIndex = menuitems[order].getAttribute('id');
}
findPrevOptionIndex(index) {
const menuitems = find(this.listViewChild.nativeElement, 'li[data-pc-section="menuitem"][data-p-disabled="false"]');
const matchedOptionIndex = [...menuitems].findIndex((link) => link.id === index);
return matchedOptionIndex > -1 ? matchedOptionIndex - 1 : 0;
}
get containerClass() {
return {
['p-dock p-component ' + ` p-dock-${this.position}`]: true
};
}
isClickableRouterLink(item) {
return item.routerLink && !item.disabled;
}
itemClass(item, index) {
return {
'p-dock-item': true,
'p-focus': this.isItemActive(this.getItemId(item, index)),
'p-disabled': this.disabled(item)
};
}
templates;
ngAfterContentInit() {
this.templates?.forEach((item) => {
switch (item.getType()) {
case 'item':
this._itemTemplate = item.template;
break;
default:
this._itemTemplate = item.template;
break;
}
});
}
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: Dock, deps: [{ token: i0.ChangeDetectorRef }], target: i0.ɵɵFactoryTarget.Component });
static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.5", type: Dock, isStandalone: true, selector: "p-dock", inputs: { id: "id", style: "style", styleClass: "styleClass", model: "model", position: "position", ariaLabel: "ariaLabel", ariaLabelledBy: "ariaLabelledBy" }, outputs: { onFocus: "onFocus", onBlur: "onBlur" }, providers: [DockStyle], queries: [{ propertyName: "itemTemplate", first: true, predicate: ["item"], descendants: true }, { propertyName: "templates", predicate: PrimeTemplate }], viewQueries: [{ propertyName: "listViewChild", first: true, predicate: ["list"], descendants: true }], usesInheritance: true, ngImport: i0, template: `
<div [ngClass]="containerClass" [ngStyle]="style" [class]="styleClass" [attr.data-pc-name]="'dock'">
<div class="p-dock-list-container">
<ul
#list
[attr.id]="id"
class="p-dock-list"
role="menu"
[attr.aria-orientation]="position === 'bottom' || position === 'top' ? 'horizontal' : 'vertical'"
[attr.aria-activedescendant]="focused ? focusedOptionId : undefined"
[tabindex]="tabindex"
[attr.aria-label]="ariaLabel"
[attr.aria-labelledby]="ariaLabelledBy"
[attr.data-pc-section]="'menu'"
(focus)="onListFocus($event)"
(blur)="onListBlur($event)"
(keydown)="onListKeyDown($event)"
(mouseleave)="onListMouseLeave()"
>
(item of model; track item.label; let i = $index) {
<li
*ngIf="item.visible !== false"
[attr.id]="getItemId(item, i)"
[ngClass]="itemClass(item, i)"
role="menuitem"
[attr.aria-label]="item.label"
[attr.aria-disabled]="disabled(item)"
(click)="onItemClick($event, item)"
(mouseenter)="onItemMouseEnter(i)"
[attr.data-pc-section]="'menuitem'"
[attr.data-p-focused]="isItemActive(getItemId(item, i))"
[attr.data-p-disabled]="disabled(item) || false"
>
<div class="p-dock-item-content" [attr.data-pc-section]="'content'">
<a
*ngIf="isClickableRouterLink(item); else elseBlock"
pRipple
[routerLink]="item.routerLink"
[queryParams]="item.queryParams"
[ngClass]="{ 'p-disabled': item.disabled }"
class="p-dock-item-link"
[routerLinkActiveOptions]="item.routerLinkActiveOptions || { exact: false }"
[target]="item.target"
[attr.tabindex]="item.disabled || readonly ? null : item.tabindex ? item.tabindex : '-1'"
pTooltip
[tooltipOptions]="item.tooltipOptions"
[fragment]="item.fragment"
[queryParamsHandling]="item.queryParamsHandling"
[preserveFragment]="item.preserveFragment"
[skipLocationChange]="item.skipLocationChange"
[replaceUrl]="item.replaceUrl"
[state]="item.state"
[attr.aria-hidden]="true"
>
<span class="p-dock-item-icon" *ngIf="item.icon && !itemTemplate && !_itemTemplate" [ngClass]="item.icon" [ngStyle]="item.iconStyle"></span>
<ng-container *ngTemplateOutlet="itemTemplate || itemTemplate; context: { $implicit: item }"></ng-container>
</a>
<ng-template #elseBlock>
<a
[tooltipPosition]="item.tooltipPosition"
[attr.href]="item.url || null"
class="p-dock-item-link"
pRipple
pTooltip
[tooltipOptions]="item.tooltipOptions"
[ngClass]="{ 'p-disabled': item.disabled }"
[target]="item.target"
[attr.tabindex]="item.disabled || (i !== activeIndex && readonly) ? null : item.tabindex ? item.tabindex : '-1'"
[attr.aria-hidden]="true"
>
<span class="p-dock-item-icon" *ngIf="item.icon && !itemTemplate && !_itemTemplate" [ngClass]="item.icon" [ngStyle]="item.iconStyle"></span>
<ng-container *ngTemplateOutlet="itemTemplate || _itemTemplate; context: { $implicit: item }"></ng-container>
</a>
</ng-template>
</div>
</li>
}
</ul>
</div>
</div>
`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "directive", type: i1.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "directive", type: i1.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "directive", type: i1.NgStyle, selector: "[ngStyle]", inputs: ["ngStyle"] }, { kind: "ngmodule", type: RouterModule }, { kind: "directive", type: i2.RouterLink, selector: "[routerLink]", inputs: ["target", "queryParams", "fragment", "queryParamsHandling", "state", "info", "relativeTo", "preserveFragment", "skipLocationChange", "replaceUrl", "routerLink"] }, { kind: "directive", type: Ripple, selector: "[pRipple]" }, { kind: "ngmodule", type: TooltipModule }, { kind: "directive", type: i3.Tooltip, selector: "[pTooltip]", inputs: ["tooltipPosition", "tooltipEvent", "appendTo", "positionStyle", "tooltipStyleClass", "tooltipZIndex", "escape", "showDelay", "hideDelay", "life", "positionTop", "positionLeft", "autoHide", "fitContent", "hideOnEscape", "pTooltip", "tooltipDisabled", "tooltipOptions"] }, { kind: "ngmodule", type: SharedModule }], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.None });
}
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: Dock, decorators: [{
type: Component,
args: [{
selector: 'p-dock',
standalone: true,
imports: [CommonModule, RouterModule, Ripple, TooltipModule, SharedModule],
template: `
<div [ngClass]="containerClass" [ngStyle]="style" [class]="styleClass" [attr.data-pc-name]="'dock'">
<div class="p-dock-list-container">
<ul
#list
[attr.id]="id"
class="p-dock-list"
role="menu"
[attr.aria-orientation]="position === 'bottom' || position === 'top' ? 'horizontal' : 'vertical'"
[attr.aria-activedescendant]="focused ? focusedOptionId : undefined"
[tabindex]="tabindex"
[attr.aria-label]="ariaLabel"
[attr.aria-labelledby]="ariaLabelledBy"
[attr.data-pc-section]="'menu'"
(focus)="onListFocus($event)"
(blur)="onListBlur($event)"
(keydown)="onListKeyDown($event)"
(mouseleave)="onListMouseLeave()"
>
(item of model; track item.label; let i = $index) {
<li
*ngIf="item.visible !== false"
[attr.id]="getItemId(item, i)"
[ngClass]="itemClass(item, i)"
role="menuitem"
[attr.aria-label]="item.label"
[attr.aria-disabled]="disabled(item)"
(click)="onItemClick($event, item)"
(mouseenter)="onItemMouseEnter(i)"
[attr.data-pc-section]="'menuitem'"
[attr.data-p-focused]="isItemActive(getItemId(item, i))"
[attr.data-p-disabled]="disabled(item) || false"
>
<div class="p-dock-item-content" [attr.data-pc-section]="'content'">
<a
*ngIf="isClickableRouterLink(item); else elseBlock"
pRipple
[routerLink]="item.routerLink"
[queryParams]="item.queryParams"
[ngClass]="{ 'p-disabled': item.disabled }"
class="p-dock-item-link"
[routerLinkActiveOptions]="item.routerLinkActiveOptions || { exact: false }"
[target]="item.target"
[attr.tabindex]="item.disabled || readonly ? null : item.tabindex ? item.tabindex : '-1'"
pTooltip
[tooltipOptions]="item.tooltipOptions"
[fragment]="item.fragment"
[queryParamsHandling]="item.queryParamsHandling"
[preserveFragment]="item.preserveFragment"
[skipLocationChange]="item.skipLocationChange"
[replaceUrl]="item.replaceUrl"
[state]="item.state"
[attr.aria-hidden]="true"
>
<span class="p-dock-item-icon" *ngIf="item.icon && !itemTemplate && !_itemTemplate" [ngClass]="item.icon" [ngStyle]="item.iconStyle"></span>
<ng-container *ngTemplateOutlet="itemTemplate || itemTemplate; context: { $implicit: item }"></ng-container>
</a>
<ng-template #elseBlock>
<a
[tooltipPosition]="item.tooltipPosition"
[attr.href]="item.url || null"
class="p-dock-item-link"
pRipple
pTooltip
[tooltipOptions]="item.tooltipOptions"
[ngClass]="{ 'p-disabled': item.disabled }"
[target]="item.target"
[attr.tabindex]="item.disabled || (i !== activeIndex && readonly) ? null : item.tabindex ? item.tabindex : '-1'"
[attr.aria-hidden]="true"
>
<span class="p-dock-item-icon" *ngIf="item.icon && !itemTemplate && !_itemTemplate" [ngClass]="item.icon" [ngStyle]="item.iconStyle"></span>
<ng-container *ngTemplateOutlet="itemTemplate || _itemTemplate; context: { $implicit: item }"></ng-container>
</a>
</ng-template>
</div>
</li>
}
</ul>
</div>
</div>
`,
changeDetection: ChangeDetectionStrategy.OnPush,
encapsulation: ViewEncapsulation.None,
providers: [DockStyle]
}]
}], ctorParameters: () => [{ type: i0.ChangeDetectorRef }], propDecorators: { id: [{
type: Input
}], style: [{
type: Input
}], styleClass: [{
type: Input
}], model: [{
type: Input
}], position: [{
type: Input
}], ariaLabel: [{
type: Input
}], ariaLabelledBy: [{
type: Input
}], onFocus: [{
type: Output
}], onBlur: [{
type: Output
}], listViewChild: [{
type: ViewChild,
args: ['list', { static: false }]
}], itemTemplate: [{
type: ContentChild,
args: ['item']
}], templates: [{
type: ContentChildren,
args: [PrimeTemplate]
}] } });
class DockModule {
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: DockModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "19.2.5", ngImport: i0, type: DockModule, imports: [Dock, SharedModule], exports: [Dock, SharedModule] });
static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: DockModule, imports: [Dock, SharedModule, SharedModule] });
}
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: DockModule, decorators: [{
type: NgModule,
args: [{
imports: [Dock, SharedModule],
exports: [Dock, SharedModule]
}]
}] });
/**
* Generated bundle index. Do not edit.
*/
export { Dock, DockClasses, DockModule, DockStyle };
//# sourceMappingURL=primeng-dock.mjs.map