# kol-input-email ## Properties | Property | Attribute | Description | Type | Default | | --------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | | `_accessKey` | `_access-key` | Defines the key combination that can be used to trigger or focus the component's interactive element. | `string \| undefined` | `undefined` | | `_autoComplete` | `_auto-complete` | Defines whether the input can be auto-completed. | `string \| undefined` | `'off'` | | `_disabled` | `_disabled` | Makes the element not focusable and ignore all events. | `boolean \| undefined` | `false` | | `_hasCounter` | `_has-counter` | Shows a character counter for the input element. | `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 \| { right?: IconOrIconClass \| undefined; left?: IconOrIconClass \| 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` | | `_maxLength` | `_max-length` | Defines the maximum number of input characters. | `number \| undefined` | `undefined` | | `_maxLengthBehavior` | `_max-length-behavior` | Defines the behavior when maxLength is set. 'hard' sets the maxlength attribute, 'soft' shows a character counter without preventing input. | `"hard" \| "soft" \| undefined` | `'hard'` | | `_msg` | `_msg` | Defines the properties for a message rendered as Alert component. | `Omit & { _description: string; } \| string \| undefined` | `undefined` | | `_multiple` | `_multiple` | Makes the input accept multiple inputs. | `boolean \| undefined` | `false` | | `_name` | `_name` | Defines the technical name of an input field. | `string \| undefined` | `undefined` | | `_on` | -- | Gibt die EventCallback-Funktionen für das Input-Event an. | `InputTypeOnBlur & InputTypeOnClick & InputTypeOnChange & InputTypeOnFocus & InputTypeOnInput & InputTypeOnKeyDown \| undefined` | `undefined` | | `_pattern` | `_pattern` | Defines a validation pattern for the input field. | `string \| undefined` | `undefined` | | `_placeholder` | `_placeholder` | Defines the placeholder for input field. To be shown when there's no value. | `string \| undefined` | `undefined` | | `_readOnly` | `_read-only` | Makes the input element read only. | `boolean \| undefined` | `false` | | `_required` | `_required` | Makes the input element required. | `boolean \| undefined` | `false` | | `_shortKey` | `_short-key` | Adds a visual shortcut hint after the label and instructs the screen reader to read the shortcut aloud. | `string \| undefined` | `undefined` | | `_smartButton` | `_smart-button` | Allows to add a button with an arbitrary action within the element (_hide-label only). | `string \| undefined \| { _label: string; } & { _on?: ButtonCallbacksPropType \| undefined; _type?: "button" \| "reset" \| "submit" \| undefined; _ariaExpanded?: boolean \| undefined; _tabIndex?: number \| undefined; _value?: StencilUnknown; _accessKey?: string \| undefined; _role?: "tab" \| "treeitem" \| undefined; _ariaControls?: string \| undefined; _ariaDescription?: string \| undefined; _ariaSelected?: boolean \| undefined; _customClass?: string \| undefined; _disabled?: boolean \| undefined; _hideLabel?: boolean \| undefined; _icons?: IconsPropType \| undefined; _id?: string \| undefined; _inline?: boolean \| undefined; _name?: string \| undefined; _shortKey?: string \| undefined; _syncValueBySelector?: string \| undefined; _tooltipAlign?: AlignPropType \| undefined; _variant?: string \| undefined; }` | `undefined` | | `_suggestions` | `_suggestions` | Suggestions to provide for the input. | `W3CInputValue[] \| 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 element. | `string \| undefined` | `undefined` | ## Methods ### `focus() => Promise` Sets focus on the internal element. #### Returns Type: `Promise` ### `getValue() => Promise` Returns the current value. #### Returns Type: `Promise` ## Slots | Slot | Description | | ---- | ----------------------------------- | | | Die Beschriftung des Eingabefeldes. | ----------------------------------------------