primevue-mirror/components/dock/Dock.d.ts

136 lines
3.2 KiB
TypeScript

import { VNode } from 'vue';
import { MenuItem } from '../menuitem';
import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
type DockPositionType = 'bottom' | 'top' | 'left' | 'right' | undefined;
type DockTooltipEventType = 'hover' | 'focus' | undefined;
export interface DockTooltipOptions {
/**
* Event to show the tooltip, valid values are hover and focus.
* @see DockTooltipEventType
*/
event: string;
/**
* Position of element.
* @see DockPositionType
* Default value is 'bottom'.
*/
position: string;
/**
* Optional options.
*/
[key: string]: string;
}
export interface DockProps {
/**
* MenuModel instance to define the action items.
*/
model?: MenuItem[] | undefined;
/**
* Position of element.
* @see DockPositionType
* Default value is 'bottom'.
*/
position?: DockPositionType;
/**
* Style class of the element.
*/
class?: any;
/**
* Inline style of the element.
*/
style?: any;
/**
* Whether to apply 'router-link-active-exact' class if route exactly matches the item path.
* Default value is true.
*/
exact?: boolean | undefined;
/**
* Whether to display the tooltip on items. The modifiers of Tooltip can be used like an object in it. Valid keys are 'event' and 'position'.
* @see DockTooltipOptions
*/
tooltipOptions?: DockTooltipOptions;
/**
* Unique identifier of the menu.
*/
menuId?: string | undefined;
/**
* Index of the element in tabbing order.
*/
tabindex?: number | string | undefined;
/**
* Establishes relationships between the component and label(s) where its value should be one or more element IDs.
*/
'aria-labelledby'?: string | undefined;
/**
* Establishes a string value that labels the component.
*/
'aria-label'?: string | undefined;
}
export interface DockSlots {
/**
* Custom item content.
* @param {Object} scope - item slot's params.
*/
item: (scope: {
/**
* Custom content for item.
*/
item: MenuItem;
/**
* Index of the menuitem
*/
index: number;
}) => VNode[];
/**
* Custom icon content.
* @param {Object} scope - icon slot's params.
*/
icon: (scope: {
/**
* Custom content for icon.
*/
item: MenuItem;
}) => VNode[];
}
export declare type DockEmits = {
/**
* Callback to invoke when the component receives focus.
* @param {Event} event - Browser event.
*/
focus: (event: Event) => void;
/**
* Callback to invoke when the component loses focus.
* @param {Event} event - Browser event.
*/
blur: (event: Event) => void;
};
declare class Dock extends ClassComponent<DockProps, DockSlots, DockEmits> {}
declare module '@vue/runtime-core' {
interface GlobalComponents {
Dock: GlobalComponentConstructor<Dock>;
}
}
/**
*
* Dock is a navigation component consisting of menuitems.
*
* Helper API:
*
* - [MenuItem](https://www.primefaces.org/primevue/menumodel)
*
* Demos:
*
* - [Dock](https://www.primefaces.org/primevue/dock)
*
*/
export default Dock;