primevue-mirror/components/lib/inputswitch/InputSwitch.d.ts

168 lines
4.3 KiB
TypeScript
Raw Normal View History

2023-03-01 12:40:56 +00:00
/**
*
2023-03-01 12:59:47 +00:00
* InputSwitch is used to select a boolean value.
2023-03-01 12:40:56 +00:00
*
* [Live Demo](https://www.primevue.org/inputswitch/)
*
* @module inputswitch
*
*/
2022-09-06 12:03:37 +00:00
import { InputHTMLAttributes } from 'vue';
import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
2023-05-05 13:10:07 +00:00
export declare type InputSwitchPassThroughOptionType = InputSwitchPassThroughAttributes | ((options: InputSwitchPassThroughMethodOptions) => InputSwitchPassThroughAttributes) | null | undefined;
/**
* Custom passthrough(pt) option method.
*/
export interface InputSwitchPassThroughMethodOptions {
props: InputSwitchProps;
state: InputSwitchState;
}
/**
* Custom passthrough(pt) options.
* @see {@link InputSwitchProps.pt}
*/
export interface InputSwitchPassThroughOptions {
/**
* Uses to pass attributes to the root's DOM element.
*/
root?: InputSwitchPassThroughOptionType;
/**
* Uses to pass attributes to the slider's DOM element.
*/
slider?: InputSwitchPassThroughOptionType;
/**
2023-05-10 08:18:51 +00:00
* Uses to pass attributes to the hidden input wrapper's DOM element.
2023-05-05 13:10:07 +00:00
*/
2023-05-10 08:18:51 +00:00
hiddenInputWrapper?: InputSwitchPassThroughOptionType;
2023-05-05 13:10:07 +00:00
/**
2023-05-10 08:18:51 +00:00
* Uses to pass attributes to the hidden input's DOM element.
2023-05-05 13:10:07 +00:00
*/
2023-05-10 08:18:51 +00:00
hiddenInput?: InputSwitchPassThroughOptionType;
2023-05-05 13:10:07 +00:00
}
/**
* Custom passthrough attributes for each DOM elements
*/
export interface InputSwitchPassThroughAttributes {
[key: string]: any;
}
/**
* Defines current inline state in InputSwitch component.
*/
export interface InputSwitchState {
/**
* Current focus state as a boolean.
* @defaultValue false
*/
focused: boolean;
}
2023-03-01 12:40:56 +00:00
/**
* Defines valid properties in InputSwitch component.
*/
2022-09-06 12:03:37 +00:00
export interface InputSwitchProps {
/**
* Specifies whether a inputswitch should be checked or not.
2023-03-10 14:00:58 +00:00
* @defaultValue false
2022-09-06 12:03:37 +00:00
*/
modelValue?: boolean | string | undefined;
/**
* Value in checked state.
2023-03-01 12:40:56 +00:00
* @defaultValue true
2022-09-06 12:03:37 +00:00
*/
trueValue?: any;
/**
* Value in unchecked state.
2023-03-01 12:40:56 +00:00
* @defaultValue false
2022-09-06 12:03:37 +00:00
*/
falseValue?: any;
/**
* Identifier of the underlying input element.
*/
inputId?: string | undefined;
/**
* Style class of the input field.
*/
inputClass?: string | object | undefined;
2022-09-06 12:03:37 +00:00
/**
* Inline style of the input field.
*/
inputStyle?: object | undefined;
2022-09-06 12:03:37 +00:00
/**
* Uses to pass all properties of the HTMLInputElement to the focusable input element inside the component.
*/
inputProps?: InputHTMLAttributes | 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;
2023-05-24 11:15:28 +00:00
/**
* Uses to pass attributes to DOM elements inside the component.
* @type {InputSwitchPassThroughMethodOptions}
*/
pt?: InputSwitchPassThroughMethodOptions;
/**
* When enabled, it removes component related styles in the core.
* @defaultValue false
*/
unstyled?: boolean;
2022-09-06 12:03:37 +00:00
}
2022-09-14 11:26:01 +00:00
export interface InputSwitchSlots {}
2022-09-06 12:03:37 +00:00
2023-03-01 12:40:56 +00:00
/**
* Defines valid emits in InputSwitch component.
*/
export interface InputSwitchEmits {
2022-09-06 12:03:37 +00:00
/**
* Emitted when the value changes.
* @param {boolean} value - New value.
*/
2023-03-01 12:40:56 +00:00
'update:modelValue'(value: boolean): void;
2022-09-06 12:03:37 +00:00
/**
* Callback to invoke on click.
* @param {Event} event - Browser event.
*/
2023-03-01 12:40:56 +00:00
click(event: Event): void;
2022-09-06 12:03:37 +00:00
/**
* Callback to invoke on value change.
* @param {Event} event - Browser event.
*/
2023-03-01 12:40:56 +00:00
change(event: Event): void;
2022-09-06 12:03:37 +00:00
/**
* Callback to invoke on value change.
* @param {boolean} value - New value.
*/
2023-03-01 12:40:56 +00:00
input(value: boolean): void;
}
2022-09-06 12:03:37 +00:00
2023-03-01 12:40:56 +00:00
/**
* **PrimeVue - InputSwitch**
*
2023-03-01 12:59:47 +00:00
* _InputSwitch is used to select a boolean value._
2023-03-01 12:40:56 +00:00
*
* [Live Demo](https://www.primevue.org/inputswitch/)
* --- ---
2023-03-03 10:55:20 +00:00
* ![PrimeVue](https://primefaces.org/cdn/primevue/images/logo-100.png)
2023-03-01 12:40:56 +00:00
*
* @group Component
*
*/
2022-09-14 11:26:01 +00:00
declare class InputSwitch extends ClassComponent<InputSwitchProps, InputSwitchSlots, InputSwitchEmits> {}
2022-09-06 12:03:37 +00:00
declare module '@vue/runtime-core' {
interface GlobalComponents {
2022-09-14 11:26:01 +00:00
InputSwitch: GlobalComponentConstructor<InputSwitch>;
2022-09-06 12:03:37 +00:00
}
}
export default InputSwitch;