primevue-mirror/components/splitter/Splitter.d.ts

120 lines
2.7 KiB
TypeScript
Raw Normal View History

2023-02-28 21:23:26 +00:00
/**
*
* Splitter is utilized to separate and resize panels.
*
* [Live Demo](https://www.primevue.org/splitter/)
*
* @module splitter
*
*/
2022-09-06 12:03:37 +00:00
import { VNode } from 'vue';
import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
2023-02-28 21:23:26 +00:00
/**
* Custom resize start event.
2023-03-06 20:35:39 +00:00
* @see {@link SplitterEmits.resizestar}
2023-02-28 21:23:26 +00:00
*/
2022-12-08 11:04:25 +00:00
export interface SplitterResizeStartEvent {
/**
* Browser event
*/
originalEvent: Event;
/**
* Sizes of the panels
*/
sizes: number[];
}
2023-02-28 21:23:26 +00:00
/**
* Custom resize end event.
2023-03-06 20:35:39 +00:00
* @see {@link PickListEmits.resizeend}
2023-02-28 21:23:26 +00:00
*/
2022-09-06 12:03:37 +00:00
export interface SplitterResizeEndEvent {
/**
* Browser event
*/
originalEvent: Event;
/**
* Sizes of the panels
*/
sizes: number[];
}
2023-02-28 21:23:26 +00:00
/**
* Defines valid properties in Splitter component.
*/
2022-09-06 12:03:37 +00:00
export interface SplitterProps {
/**
* Orientation of the panels.
2023-02-28 21:23:26 +00:00
* @defaultValue horizontal
2022-09-06 12:03:37 +00:00
*/
2023-02-28 21:23:26 +00:00
layout?: 'horizontal' | 'vertical' | undefined;
2022-09-06 12:03:37 +00:00
/**
* Size of the divider in pixels.
2023-02-28 21:23:26 +00:00
* @defaultValue 4
2022-09-06 12:03:37 +00:00
*/
gutterSize?: number | undefined;
/**
* Storage identifier of a stateful Splitter.
*/
stateKey?: string | undefined;
/**
* Defines where a stateful splitter keeps its state, valid values are 'session' for sessionStorage and 'local' for localStorage.
2023-03-03 08:18:55 +00:00
* @defaultValue 'session'
2022-09-06 12:03:37 +00:00
*/
2023-02-28 21:23:26 +00:00
stateStorage?: 'local' | 'session' | undefined;
2022-09-14 11:26:01 +00:00
/**
* Step factor to increment/decrement the size of the panels while pressing the arrow keys.
2023-02-28 21:23:26 +00:00
* @defaultValue 1
2022-09-14 11:26:01 +00:00
*/
step?: number | undefined;
2022-09-06 12:03:37 +00:00
}
2023-02-28 21:23:26 +00:00
/**
* Defines valid slots in Splitter slots.
*/
2022-09-06 12:03:37 +00:00
export interface SplitterSlots {
/**
* Default slot to detect SplitterPanel components.
*/
2023-02-28 21:23:26 +00:00
default(): VNode[];
2022-09-06 12:03:37 +00:00
}
2023-02-28 21:23:26 +00:00
/**
* Defines valid emits in Splitter component.
*/
export interface SplitterEmits {
2022-12-08 11:04:25 +00:00
/**
* Callback to invoke when resize starts.
* @param {SplitterResizeStartEvent} event - Custom resize start event.
*/
2023-02-28 21:23:26 +00:00
resizestar(event: SplitterResizeStartEvent): void;
2022-09-06 12:03:37 +00:00
/**
* Callback to invoke when resize ends.
* @param {SplitterResizeEndEvent} event - Custom resize end event.
*/
2023-02-28 21:23:26 +00:00
resizeend(event: SplitterResizeEndEvent): void;
}
2022-09-06 12:03:37 +00:00
2023-02-28 21:23:26 +00:00
/**
* **PrimeVue - Splitter**
*
* _Splitter is utilized to separate and resize panels._
*
* [Live Demo](https://www.primevue.org/splitter/)
* --- ---
2023-03-03 10:55:20 +00:00
* ![PrimeVue](https://primefaces.org/cdn/primevue/images/logo-100.png)
2023-02-28 21:23:26 +00:00
*
* @group Component
*
*/
2023-03-01 12:30:54 +00:00
declare class Splitter extends ClassComponent<SplitterProps, SplitterSlots, SplitterEmits> {}
2022-09-06 12:03:37 +00:00
declare module '@vue/runtime-core' {
interface GlobalComponents {
2022-09-14 11:26:01 +00:00
Splitter: GlobalComponentConstructor<Splitter>;
2022-09-06 12:03:37 +00:00
}
}
export default Splitter;