primevue-mirror/components/knob/Knob.d.ts

135 lines
3.1 KiB
TypeScript
Raw Normal View History

2023-02-28 08:29:30 +00:00
/**
*
* Knob is a form component to define number inputs with a dial.
*
* [Live Demo](https://www.primevue.org/knob/)
*
* @module knob
*
*/
2022-09-06 12:03:37 +00:00
import { ClassComponent, GlobalComponentConstructor } from '../ts-helpers';
2023-02-28 08:29:30 +00:00
/**
2023-03-01 08:45:08 +00:00
* Defines valid properties in Knob component.
2023-02-28 08:29:30 +00:00
*/
2022-09-06 12:03:37 +00:00
export interface KnobProps {
/**
* Value of the component.
*/
modelValue?: number | undefined;
/**
* Size of the component in pixels.
2023-02-28 08:29:30 +00:00
* @defaultValue 100
2022-09-06 12:03:37 +00:00
*/
size?: number | undefined;
/**
* When present, it specifies that the component should be disabled.
2023-03-01 08:45:08 +00:00
* @defaultValue false
2022-09-06 12:03:37 +00:00
*/
disabled?: boolean | undefined;
/**
* When present, it specifies that the component value cannot be edited.
2023-03-01 08:45:08 +00:00
* @defaultValue false
2022-09-06 12:03:37 +00:00
*/
readonly?: boolean | undefined;
/**
* Step factor to increment/decrement the value.
2023-03-01 08:45:08 +00:00
* @defaultValue 1
2022-09-06 12:03:37 +00:00
*/
step?: number | undefined;
/**
* Mininum boundary value.
2023-02-28 08:29:30 +00:00
* @defaultValue 0
2022-09-06 12:03:37 +00:00
*/
min?: number | undefined;
/**
* Maximum boundary value.
2023-02-28 08:29:30 +00:00
* @defaultValue 100
2022-09-06 12:03:37 +00:00
*/
max?: number | undefined;
/**
* Background of the value.
2023-03-01 08:45:08 +00:00
* @defaultValue var(--primary-color, Black)
2022-09-06 12:03:37 +00:00
*/
valueColor?: string | undefined;
/**
* Background color of the range.
2023-03-01 08:45:08 +00:00
* @defaultValue var(--surface-border, LightGray)
2022-09-06 12:03:37 +00:00
*/
rangeColor?: string | undefined;
/**
* Color of the value text.
2023-03-01 08:45:08 +00:00
* @defaultValue var(--text-color-secondary, Black)
2022-09-06 12:03:37 +00:00
*/
textColor?: string | undefined;
/**
* Width of the knob stroke.
2023-03-01 08:45:08 +00:00
* @defaultValue 14
2022-09-06 12:03:37 +00:00
*/
strokeWidth?: number | undefined;
/**
* Whether the show the value inside the knob.
2023-03-01 08:45:08 +00:00
* @defaultValue true
2022-09-06 12:03:37 +00:00
*/
showValue?: boolean | undefined;
/**
* Template string of the value.
2023-03-01 10:18:51 +00:00
* @defaultValue \{value}
2022-09-06 12:03:37 +00:00
*/
valueTemplate?: string | undefined;
/**
* Index of the element in tabbing order.
2023-03-01 08:45:08 +00:00
* @defaultValue 0
2022-09-06 12:03:37 +00:00
*/
tabindex?: number | undefined;
/**
2022-09-14 11:26:01 +00:00
* Establishes relationships between the component and label(s) where its value should be one or more element IDs.
*/
2022-09-06 12:03:37 +00:00
'aria-labelledby'?: string | undefined;
/**
2022-09-14 11:26:01 +00:00
* Used to define a string that labels the element.
*/
2022-09-06 12:03:37 +00:00
'aria-label'?: string | undefined;
}
2023-02-28 08:29:30 +00:00
/**
* Defines valid slots in Knob component.
*/
2022-09-14 11:26:01 +00:00
export interface KnobSlots {}
2022-09-06 12:03:37 +00:00
2023-02-28 08:29:30 +00:00
/**
* Defines valid emits in Knob component.
*/
export interface KnobEmits {
2022-09-06 12:03:37 +00:00
/**
* Emitted when the value changes.
2023-02-28 08:29:30 +00:00
* @param {number} event - New value.
2022-09-06 12:03:37 +00:00
*/
2023-02-28 08:29:30 +00:00
'update:modelValue'(value: number): void;
2022-09-06 12:03:37 +00:00
/**
* Callback to invoke when the value changes.
2023-02-28 08:29:30 +00:00
* @param {number} event - New value
2022-09-06 12:03:37 +00:00
*/
2023-02-28 08:29:30 +00:00
change(value: number): void;
}
2022-09-06 12:03:37 +00:00
2023-02-28 08:29:30 +00:00
/**
* **PrimeVue - Knob**
*
* _Knob groups a collection of contents in tabs._
*
* [Live Demo](https://www.primevue.org/knob/)
* --- ---
* ![PrimeVue](https://primefaces.org/cdn/primevue/images/logo.svg)
*
*/
2023-03-01 14:48:23 +00:00
declare class Knob extends ClassComponent<KnobProps, KnobSlots, KnobEmits> {}
2022-09-06 12:03:37 +00:00
declare module '@vue/runtime-core' {
interface GlobalComponents {
2022-09-14 11:26:01 +00:00
Knob: GlobalComponentConstructor<Knob>;
2022-09-06 12:03:37 +00:00
}
}
export default Knob;