UNPKG

@public-ui/components

Version:

Contains all web components that belong to KoliBri - The accessible HTML-Standard.

65 lines (39 loc) 13.7 kB
# kol-input-checkbox <!-- Auto Generated Below --> ## Properties | Property | Attribute | Description | Type | Default | | --------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | `_accessKey` | `_access-key` | Defines which key combination can be used to trigger or focus the interactive element of the component. | `string \| undefined` | `undefined` | | `_checked` | `_checked` | Defines whether the checkbox is checked or not. Can be read and written. | `boolean \| undefined` | `false` | | `_disabled` | `_disabled` | Makes the element not focusable and ignore all events. | `boolean \| undefined` | `false` | | `_hideLabel` | `_hide-label` | Hides the caption by default and displays the caption text with a tooltip when the interactive element is focused or the mouse is over it. | `boolean \| undefined` | `false` | | `_hideMsg` | `_hide-msg` | Hides the error message but leaves it in the DOM for the input's aria-describedby. | `boolean \| undefined` | `false` | | `_hint` | `_hint` | Defines the hint text. | `string \| undefined` | `''` | | `_icons` | `_icons` | Defines the icon classnames (e.g. `_icons="fa-solid fa-user"`). | `string \| undefined \| { checked: string; indeterminate?: string \| undefined; unchecked?: string \| undefined; } \| { checked?: string \| undefined; indeterminate: string; unchecked?: string \| undefined; } \| { checked?: string \| undefined; indeterminate?: string \| undefined; unchecked: string; }` | `undefined` | | `_id` | `_id` | Defines the internal ID of the primary component element. | `string \| undefined` | `undefined` | | `_indeterminate` | `_indeterminate` | Puts the checkbox in the indeterminate state, does not change the value of _checked. | `boolean \| undefined` | `undefined` | | `_label` _(required)_ | `_label` | Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). Set to `false` to enable the expert slot. | `string` | `undefined` | | `_labelAlign` | `_label-align` | Defines which alignment should be used for presentation. | `"left" \| "right" \| undefined` | `'right'` | | `_msg` | `_msg` | Defines the properties for a message rendered as Alert component. | `string \| undefined \| {} & { _level?: 0 \| 2 \| 1 \| 4 \| 3 \| 5 \| 6 \| undefined; _on?: KoliBriAlertEventCallbacks \| undefined; _label?: string \| undefined; _alert?: boolean \| undefined; _hasCloser?: boolean \| undefined; _type?: "default" \| "info" \| "success" \| "warning" \| "error" \| undefined; _variant?: "card" \| "msg" \| undefined; } & { _description: string; }` | `undefined` | | `_name` | `_name` | Defines the technical name of an input field. | `string \| undefined` | `undefined` | | `_on` | `_on` | Gibt die EventCallback-Funktionen für das Input-Event an. | `InputTypeOnBlur & InputTypeOnClick & InputTypeOnChange & InputTypeOnFocus & InputTypeOnInput \| undefined` | `undefined` | | `_required` | `_required` | Makes the input element required. | `boolean \| undefined` | `false` | | `_shortKey` | `_short-key` | Adds a visual short key hint to the component. | `string \| undefined` | `undefined` | | `_tooltipAlign` | `_tooltip-align` | Defines where to show the Tooltip preferably: top, right, bottom or left. | `"bottom" \| "left" \| "right" \| "top" \| undefined` | `'top'` | | `_touched` | `_touched` | Shows if the input was touched by a user. | `boolean \| undefined` | `false` | | `_value` | `_value` | Defines the value of the input. | `boolean \| null \| number \| object \| string \| undefined` | `true` | | `_variant` | `_variant` | Defines which variant should be used for presentation. | `"button" \| "default" \| "switch" \| undefined` | `'default'` | ## Methods ### `getValue() => Promise<StencilUnknown>` Returns the current value. #### Returns Type: `Promise<StencilUnknown>` ### `kolFocus() => Promise<void>` Sets focus on the internal element. #### Returns Type: `Promise<void>` ## Slots | Slot | Description | | ---------- | --------------------- | | `"expert"` | Checkbox description. | ----------------------------------------------