540 lines
14 KiB
TypeScript
Executable File
540 lines
14 KiB
TypeScript
Executable File
/**
|
|
*
|
|
* Galleria is an advanced content gallery component.
|
|
*
|
|
* [Live Demo](https://www.primevue.org/galleria/)
|
|
*
|
|
* @module galleria
|
|
*
|
|
*/
|
|
import { ButtonHTMLAttributes, HTMLAttributes, TransitionProps, VNode } from 'vue';
|
|
import { ComponentHooks } from '../basecomponent';
|
|
import { PassThroughOptions } from '../passthrough';
|
|
import { ClassComponent, DesignToken, GlobalComponentConstructor, PassThrough } from '../ts-helpers';
|
|
|
|
export declare type GalleriaPassThroughOptionType = GalleriaPassThroughAttributes | ((options: GalleriaPassThroughMethodOptions) => GalleriaPassThroughAttributes | string) | string | null | undefined;
|
|
|
|
export declare type GalleriaPassThroughTransitionType = TransitionProps | ((options: GalleriaPassThroughMethodOptions) => TransitionProps) | undefined;
|
|
|
|
/**
|
|
* Custom passthrough(pt) option method.
|
|
*/
|
|
export interface GalleriaPassThroughMethodOptions {
|
|
/**
|
|
* Defines instance.
|
|
*/
|
|
instance: any;
|
|
/**
|
|
* Defines valid properties.
|
|
*/
|
|
props: GalleriaProps;
|
|
/**
|
|
* Defines current inline state.
|
|
*/
|
|
state: GalleriaState;
|
|
/**
|
|
* Defines current options.
|
|
*/
|
|
context: GalleriaContext;
|
|
/**
|
|
* Defines valid attributes.
|
|
*/
|
|
attrs: any;
|
|
/**
|
|
* Defines parent options.
|
|
*/
|
|
parent: any;
|
|
/**
|
|
* Defines passthrough(pt) options in global config.
|
|
*/
|
|
global: object | undefined;
|
|
}
|
|
|
|
export interface GalleriaResponsiveOptions {
|
|
/**
|
|
* Breakpoint for responsive mode. Exp; @media screen and (max-width: ${breakpoint}) {...}
|
|
*/
|
|
breakpoint: string;
|
|
/**
|
|
* The number of visible items on breakpoint.
|
|
*/
|
|
numVisible: number;
|
|
}
|
|
|
|
/**
|
|
* Custom passthrough(pt) options.
|
|
* @see {@link GalleriaProps.pt}
|
|
*/
|
|
export interface GalleriaPassThroughOptions {
|
|
/**
|
|
* Used to pass attributes to the root's DOM element.
|
|
*/
|
|
root?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the close button's DOM element.
|
|
*/
|
|
closeButton?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the close icon's DOM element.
|
|
*/
|
|
closeIcon?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the header's DOM element.
|
|
*/
|
|
header?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the content's DOM element.
|
|
*/
|
|
content?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the footer's DOM element.
|
|
*/
|
|
footer?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the item container's DOM element.
|
|
*/
|
|
itemsContainer?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the items' DOM element.
|
|
*/
|
|
items?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the previous item button's DOM element.
|
|
*/
|
|
previousItemButton?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the previous item icon's DOM element.
|
|
*/
|
|
previousItemIcon?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the item's DOM element.
|
|
*/
|
|
item?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the next item button's DOM element.
|
|
*/
|
|
nextItemButton?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the next item icon's DOM element.
|
|
*/
|
|
nextItemIcon?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the caption's DOM element.
|
|
*/
|
|
caption?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the indicator list's DOM element.
|
|
*/
|
|
indicatorList?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the indicator's DOM element.
|
|
*/
|
|
indicator?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the indicator button's DOM element.
|
|
*/
|
|
indicatorButton?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the thumbnails' DOM element.
|
|
*/
|
|
thumbnails?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the thumbnail content's DOM element.
|
|
*/
|
|
thumbnailContent?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the previous thumbnail button's DOM element.
|
|
*/
|
|
previousThumbnailButton?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the previous thumbnail icon's DOM element.
|
|
*/
|
|
previousThumbnailIcon?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the thumbnail items container's DOM element.
|
|
*/
|
|
thumbnailItemsContainer?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the thumbnail items' DOM element.
|
|
*/
|
|
thumbnailItems?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the thumbnail item's DOM element.
|
|
*/
|
|
thumbnailItem?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the thumbnail's DOM element.
|
|
*/
|
|
thumbnail?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the next thumbnail button's DOM element.
|
|
*/
|
|
nextThumbnailButton?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the next thumbnail icon's DOM element.
|
|
*/
|
|
nextThumbnailIcon?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to pass attributes to the mask's DOM element.
|
|
*/
|
|
mask?: GalleriaPassThroughOptionType;
|
|
/**
|
|
* Used to manage all lifecycle hooks.
|
|
* @see {@link BaseComponent.ComponentHooks}
|
|
*/
|
|
hooks?: ComponentHooks;
|
|
/**
|
|
* Used to control Vue Transition API.
|
|
*/
|
|
transition?: GalleriaPassThroughTransitionType;
|
|
}
|
|
|
|
/**
|
|
* Custom passthrough attributes for each DOM elements
|
|
*/
|
|
export interface GalleriaPassThroughAttributes {
|
|
[key: string]: any;
|
|
}
|
|
|
|
/**
|
|
* Defines current inline state in Galleria component.
|
|
*/
|
|
export interface GalleriaState {
|
|
/**
|
|
* Current container visible state as a boolean.
|
|
* @defaultValue false
|
|
*/
|
|
containerVisible: boolean;
|
|
/**
|
|
* Style id of the component.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* Index of the first item as a number.
|
|
* @defaultValue 0
|
|
*/
|
|
activeIndex: number;
|
|
/**
|
|
* Number of items per page as a number.
|
|
* @defaultValue 3
|
|
*/
|
|
numVisible: number;
|
|
/**
|
|
* Current slide active state as a boolean.
|
|
* @defaultValue false
|
|
*/
|
|
slideShowActive: boolean;
|
|
/**
|
|
* Number of items per page as a number.
|
|
* @defaultValue 3
|
|
*/
|
|
d_numVisible: number;
|
|
/**
|
|
* Old number of items per page as a number.
|
|
* @defaultValue 3
|
|
*/
|
|
d_oldNumVisible: number;
|
|
/**
|
|
* Current active item index as a number.
|
|
* @defaultValue 0
|
|
*/
|
|
d_activeIndex: number;
|
|
/**
|
|
* The previous active item index as a number.
|
|
* @defaultValue 0
|
|
*/
|
|
d_oldActiveItemIndex: number;
|
|
/**
|
|
* Index of the first item.
|
|
* @defaultValue 0
|
|
*/
|
|
page: number;
|
|
/**
|
|
* Total shifted items' count as a number.
|
|
* @defaultValue 0
|
|
*/
|
|
totalShiftedItems: number;
|
|
}
|
|
|
|
/**
|
|
* Defines current inline options in Galleria component.
|
|
*/
|
|
export interface GalleriaContext {
|
|
/**
|
|
* Current highlighted state of the indicator as a boolean.
|
|
* @defaultValue false
|
|
*/
|
|
highlighted: boolean;
|
|
}
|
|
|
|
/**
|
|
* Defines valid properties in Galleria component.
|
|
*/
|
|
export interface GalleriaProps {
|
|
/**
|
|
* Unique identifier of the element.
|
|
*/
|
|
id?: string | undefined;
|
|
/**
|
|
* An array of objects to display.
|
|
*/
|
|
value?: any[];
|
|
/**
|
|
* Index of the first item.
|
|
* @defaultValue 0
|
|
*/
|
|
activeIndex?: number | undefined;
|
|
/**
|
|
* Whether to display the component on fullscreen.
|
|
* @defaultValue false
|
|
*/
|
|
fullScreen?: boolean | undefined;
|
|
/**
|
|
* Specifies the visibility of the mask on fullscreen mode.
|
|
* @defaultValue false
|
|
*/
|
|
visible?: boolean | undefined;
|
|
/**
|
|
* Number of items per page.
|
|
* @defaultValue 3
|
|
*/
|
|
numVisible?: number | undefined;
|
|
/**
|
|
* An array of options for responsive design.
|
|
* @see GalleriaResponsiveOptions
|
|
*/
|
|
responsiveOptions?: GalleriaResponsiveOptions[];
|
|
/**
|
|
* Whether to display navigation buttons in item section.
|
|
* @defaultValue false
|
|
*/
|
|
showItemNavigators?: boolean | undefined;
|
|
/**
|
|
* Whether to display navigation buttons in thumbnail container.
|
|
* @defaultValue true
|
|
*/
|
|
showThumbnailNavigators?: boolean | undefined;
|
|
/**
|
|
* Whether to display navigation buttons on item hover.
|
|
* @defaultValue false
|
|
*/
|
|
showItemNavigatorsOnHover?: boolean | undefined;
|
|
/**
|
|
* When enabled, item is changed on indicator hover.
|
|
* @defaultValue false
|
|
*/
|
|
changeItemOnIndicatorHover?: boolean | undefined;
|
|
/**
|
|
* Defines if scrolling would be infinite.
|
|
* @defaultValue false
|
|
*/
|
|
circular?: boolean | undefined;
|
|
/**
|
|
* Items are displayed with a slideshow in autoPlay mode.
|
|
* @defaultValue false
|
|
*/
|
|
autoPlay?: boolean | undefined;
|
|
/**
|
|
* Time in milliseconds to scroll items.
|
|
* @defaultValue 4000
|
|
*/
|
|
transitionInterval?: number | undefined;
|
|
/**
|
|
* Whether to display thumbnail container.
|
|
* @defaultValue true
|
|
*/
|
|
showThumbnails?: boolean | undefined;
|
|
/**
|
|
* Position of thumbnails.
|
|
* @defaultValue bottom
|
|
*/
|
|
thumbnailsPosition?: 'bottom' | 'top' | 'left' | 'right' | undefined;
|
|
/**
|
|
* Height of the viewport in vertical thumbnail.
|
|
* @defaultValue 300px
|
|
*/
|
|
verticalThumbnailViewPortHeight?: string | undefined;
|
|
/**
|
|
* Whether to display indicator container.
|
|
* @defaultValue false
|
|
*/
|
|
showIndicators?: boolean | undefined;
|
|
/**
|
|
* When enabled, indicator container is displayed on item container.
|
|
* @defaultValue false
|
|
*/
|
|
showIndicatorsOnItem?: boolean | undefined;
|
|
/**
|
|
* Position of indicators.
|
|
* @defaultValue bottom
|
|
*/
|
|
indicatorsPosition?: 'bottom' | 'top' | 'left' | 'right' | undefined;
|
|
/**
|
|
* Base zIndex value to use in layering.
|
|
* @defaultValue 0
|
|
*/
|
|
baseZIndex?: number | undefined;
|
|
/**
|
|
* Style class of the mask on fullscreen mode.
|
|
*/
|
|
maskClass?: string | undefined;
|
|
/**
|
|
* Inline style of the component on fullscreen mode. Otherwise, the 'style' property can be used.
|
|
*/
|
|
containerStyle?: any | undefined;
|
|
/**
|
|
* Style class of the component on fullscreen mode. Otherwise, the 'class' property can be used.
|
|
*/
|
|
containerClass?: any | undefined;
|
|
/**
|
|
* Used to pass all properties of the HTMLDivElement to the container element on fullscreen mode.
|
|
*/
|
|
containerProps?: HTMLAttributes | undefined;
|
|
/**
|
|
* Used to pass all properties of the HTMLButtonElement to the previous navigation button.
|
|
*/
|
|
prevButtonProps?: ButtonHTMLAttributes | undefined;
|
|
/**
|
|
* Used to pass all properties of the HTMLButtonElement to the next navigation button.
|
|
*/
|
|
nextButtonProps?: ButtonHTMLAttributes | undefined;
|
|
/**
|
|
* Defines a string value that labels an interactive element.
|
|
*/
|
|
ariaLabel?: string | undefined;
|
|
/**
|
|
* Defines a string value that description for the role of the component.
|
|
*/
|
|
ariaRoledescription?: string | undefined;
|
|
/**
|
|
* It generates scoped CSS variables using design tokens for the component.
|
|
*/
|
|
dt?: DesignToken<any>;
|
|
/**
|
|
* Used to pass attributes to DOM elements inside the component.
|
|
* @type {GalleriaPassThroughOptions}
|
|
*/
|
|
pt?: PassThrough<GalleriaPassThroughOptions>;
|
|
/**
|
|
* Used to configure passthrough(pt) options of the component.
|
|
* @type {PassThroughOptions}
|
|
*/
|
|
ptOptions?: PassThroughOptions;
|
|
/**
|
|
* When enabled, it removes component related styles in the core.
|
|
* @defaultValue false
|
|
*/
|
|
unstyled?: boolean;
|
|
}
|
|
/**
|
|
* Defines valid slots in Galleria slots.
|
|
*/
|
|
export interface GalleriaSlots {
|
|
/**
|
|
* Custom header template.
|
|
*/
|
|
header(): VNode[];
|
|
/**
|
|
* Custom footer template.
|
|
*/
|
|
footer(): VNode[];
|
|
/**
|
|
* Custom item template.
|
|
* @param {Object} scope - item slot's params.
|
|
*/
|
|
item(scope: {
|
|
/**
|
|
* Item instance
|
|
*/
|
|
item: any;
|
|
}): VNode[];
|
|
/**
|
|
* Custom caption template.
|
|
* @param {Object} scope - caption slot's params.
|
|
*/
|
|
caption(scope: {
|
|
/**
|
|
* Item instance
|
|
*/
|
|
item: any;
|
|
}): VNode[];
|
|
/**
|
|
* Custom indicator template.
|
|
* @param {Object} scope - indicator slot's params.
|
|
*/
|
|
indicator(scope: {
|
|
/**
|
|
* Index of the indicator item
|
|
*/
|
|
index: number;
|
|
}): VNode[];
|
|
/**
|
|
* Custom thumbnail template.
|
|
* @param {Object} scope - thumbnail slot's params.
|
|
*/
|
|
thumbnail(scope: {
|
|
/**
|
|
* Item instance
|
|
*/
|
|
item: any;
|
|
}): VNode[];
|
|
/**
|
|
* Custom close icon template.
|
|
*/
|
|
closeicon(): VNode[];
|
|
/**
|
|
* Custom navigator previous item icon template.
|
|
*/
|
|
previousitemicon(): VNode[];
|
|
/**
|
|
* Custom navigator next item icon template.
|
|
*/
|
|
nextitemicon(): VNode[];
|
|
/**
|
|
* Custom thumbnail previous icon template.
|
|
*/
|
|
previousthumbnailicon(): VNode[];
|
|
/**
|
|
* Custom thumbnail next item template.
|
|
*/
|
|
nextthumbnailicon(): VNode[];
|
|
}
|
|
|
|
/**
|
|
* Defines valid emits in Galleria component.
|
|
*/
|
|
export interface GalleriaEmits {
|
|
/**
|
|
* Emitted when the active index changes.
|
|
* @param {number} value - Index of new active item.
|
|
*/
|
|
'update:activeIndex'(value: number): void;
|
|
/**
|
|
* Emitted when the visible changes.
|
|
* @param {boolean} value - New value.
|
|
*/
|
|
'update:visible'(value: boolean): void;
|
|
}
|
|
|
|
/**
|
|
* **PrimeVue - Galleria**
|
|
*
|
|
* _Galleria is an advanced content gallery component._
|
|
*
|
|
* [Live Demo](https://www.primevue.org/galleria/)
|
|
* --- ---
|
|
* 
|
|
*
|
|
* @group Component
|
|
*
|
|
*/
|
|
declare class Galleria extends ClassComponent<GalleriaProps, GalleriaSlots, GalleriaEmits> {}
|
|
|
|
declare module 'vue' {
|
|
export interface GlobalComponents {
|
|
Galleria: GlobalComponentConstructor<Galleria>;
|
|
}
|
|
}
|
|
|
|
export default Galleria;
|