Zum Hauptinhalt springen

InputEmail

Der Input-Typ E-Mail erzeugt ein Eingabefeld für E-Mails.

Konstruktion

Code

<kol-input-email _id="meine_email" _name="meine_email" _icon="codicon codicon-mail"> E-Mail-Adresse </kol-input-email>

Beispiel

E-Mail-Adresse

Verwendung

Setzen Sie die InputEmail-Komponente auf Formularen ein, wenn dort die Eingabe einer oder mehrerer E-Mail-Adressen erforderlich ist.

Standardmäßig ist die Komponente für die Erfassung einer einzelnen E-Mail-Adresse vorgesehen. Setzen Sie das Attribut _multiple, um mehrere E-Mail-Adressen zu erfassen. Trennen Sie die einzelnen E-Mail-Adressen mit einem Komma (,) voneinander.

Best practices

  • Achten sie darauf id und name korrekt zu setzen, damit die Daten beim Formular Absenden mitgesendet werden.

Barrierefreiheit

Eine Validierung der erfassten E-Mail-Adressen innerhalb der Komponente erfolgt nicht. Um eine fehlgeschlagene Validierung anzuzeigen, setzen Sie das Attrbut _error mit der entsprechenden Fehlermeldung, diese wird dann via kol-alert unterhalb angezeigt.

Tastatursteuerung

TasteFunktion
TabFokussiert das Eingabefeld.

Properties

PropertyAttributeDescriptionTypeDefault
_accessKey_access-keyGibt an, mit welcher Tastenkombination man das Input auslösen oder fokussieren kann.string | undefinedundefined
_alert_alertGibt an, ob die Fehlermeldung vorgelesen werden soll, wenn es eine gibt.boolean | undefinedtrue
_autoComplete_auto-completeGibt an, ob das Eingabefeld autovervollständigt werden kann."off" | "on" | undefinedundefined
_disabled_disabledSetzt das Feld in einen inaktiven Zustand, in dem es keine Interaktion erlaubt.boolean | undefinedundefined
_error_errorGibt den Text für eine Fehlermeldung an.string | undefinedundefined
_hideLabel_hide-labelVersteckt das sichtbare Label des Elements.boolean | undefinedundefined
_hint_hintGibt den Hinweistext an.string | undefined''
_icon_iconErmöglicht das Anzeigen von Icons links und/oder rechts am Rand des Eingabefeldes.string | undefined | { right?: IconOrIconClass | undefined; left?: IconOrIconClass | undefined; }undefined
_id_idGibt die technische ID des Eingabefeldes an.string | undefinedundefined
_list_listGibt die Liste der Vorschlagswörter an.string | string[] | undefinedundefined
_maxLength_max-lengthGibt an, wie viele Zeichen man maximal eingeben kann.number | undefinedundefined
_multiple_multipleGibt an, ob mehrere Werte eingegeben werden können.boolean | undefinedundefined
_name_nameGibt den technischen Namen des Eingabefeldes an.string | undefinedundefined
_on--Gibt die EventCallback-Funktionen für das Input-Event an.InputTypeOnBlur & InputTypeOnClick & InputTypeOnChange & InputTypeOnFocus | undefinedundefined
_pattern_patternGibt ein Prüfpattern für das Eingabefeld an.string | undefinedundefined
_placeholder_placeholderGibt den Platzhalter des Eingabefeldes an, wenn es leer ist.string | undefinedundefined
_readOnly_read-onlySetzt das Eingabefeld in den schreibgeschützten Modus.boolean | undefinedundefined
_required_requiredMacht das Eingabeelement zu einem Pflichtfeld.boolean | undefinedundefined
_size_sizeSetzt die Breite des Eingabefeldes in Buchstabenbreiten.number | undefinedundefined
_smartButton--Ermöglicht eine Schaltfläche ins das Eingabefeld mit einer beliebigen Aktion zu einzufügen (ohne label).undefined | { _label: string; } & { _ariaControls?: string | undefined; _ariaLabel?: string | undefined; _icon?: Stringified<KoliBriIconProp> | undefined; _iconAlign?: Alignment | undefined; _iconOnly?: boolean | undefined; _role?: AlternativButtonLinkRole | undefined; _tabIndex?: number | undefined; _tooltipAlign?: Alignment | undefined; _ariaCurrent?: AriaCurrent | undefined; _ariaExpanded?: boolean | undefined; _ariaSelected?: boolean | undefined; _disabled?: boolean | undefined; _accessKey?: string | undefined; _id?: string | undefined; _on?: KoliBriButtonCallbacks<unknown> | undefined; _type?: KoliBriButtonType | undefined; _value?: unknown; _variant?: KoliBriButtonVariant | undefined; _customClass?: string | undefined; }undefined
_tabIndex_tab-indexGibt an, welchen Tab-Index dieses Input hat.number | undefinedundefined
_touched_touchedGibt an, ob dieses Eingabefeld von Nutzer:innen einmal besucht/berührt wurde.boolean | undefinedfalse
_value_valueGibt den Wert des Eingabefeldes an.string | undefinedundefined

Slots

SlotDescription
Die Beschriftung des Eingabefeldes.

Dependencies

Depends on

  • kol-input

Graph


Live-Editor

Beispiele