Formular: Input
-
Akkordeon -
Anker -
Audio-Player -
Bild -
Bot -
Breaking News -
Button -
Card update -
Chip -
Copyright -
Details -
Exposé -
Fetch -
Flip-Card -
Footer -
Formular: Block -
Formular: Checkbox -
Formular: Combobox -
Formular: Fehlerliste -
Formular: Filter -
Formular: Fortschrittsanzeige -
Formular: Input -
Formular: Layouts -
Formular: Radio -
Formular: Select -
Formular: Switch -
Formular: Textfeld -
Formular: Upload -
Formular: Validierung -
Galerie -
Grid -
Header -
Hervorgehobener Link -
Hervorhebung -
Icon -
In-Page Navigation -
Infobox -
Karussell -
Kontakt -
Links -
Liste update -
Logo -
Map -
Meldung -
Menü -
Modal -
Newsletter -
One Time Password (OTP) – Eingabe von Einmalpasswörtern -
Pager -
Paginierung -
Quicklink-Liste -
Reiter -
Section -
Sidebar -
Skip Link -
Social Media -
Stack -
Stage -
Status -
Suche -
Tabelle -
Tag update -
Trenner neu -
Video-Player -
Vorspann -
Zeitstempel -
Zitat
Das Pattern Input ermöglicht es Nutzer*innen Text zum Beispiel in Formularen und Suchfeldern einzugeben.
Interaktive Demo
<wm-input type="text" data-demo-pattern="wm-input-preview" label="Vorname"></wm-input>Weitere Beispiele
Alle Formularelemente können nativ in HTML abgebildet werden. Aufgrund der mangelnden Abhängigkeit von JavaScript ist das auch der bevorzugte Weg. Wird erweiterte Funktionalität wie clientseitige Validierung, Ein- und Ausblenden von Passwörtern, Anzeigen der maximalen Zeichenanzahl et cetera benötigt, müssen Sie alternativ die Webcomponent-Variante verwenden. Die aufklappbare Zusatzinformation ist nur mit den Webkomponenten umsetzbar, diese Funktionalität gibt es bei nativem HTML nicht.
Formular: Eingabefeld
<wm-input label="Vorname"></wm-input>Formular: Eingabefeld Pflichtfeld
* Wird automatisch durch die Präsenz des required Attributs angezeigt.
<wm-input label="Vorname" required="required"></wm-input>Formular: Eingabefeld Pflichtfeld ohne Sternchen
* Wird automatisch durch die Präsenz des hideAsterisk Attributs ersetzt.
<wm-input label="Vorname" required="required" hideAsterisk="hideAsterisk"></wm-input>Formular: Pflichtfeld ohne Sternchen mit benutzerdefiniertem Text
* Wird automatisch durch die Präsenz des hideAsterisk und mit dem Wert des requiredText Attributs ersetzt.
<wm-input label="Vorname" required="required" requiredText="Bitte angeben" hideAsterisk="hideAsterisk"></wm-input>Formular: Eingabefeld Passwort
Der Button blendet das Passwort ein- und aus.
<wm-input type="password" label="Passwort" autocomplete="current-password"></wm-input>Formular: Eingabehilfe
<wm-input type="number" label="Kundennummer" hint="Geben Sie Ihre 10-stellige Kundennummer ein.
"></wm-input>Formular: Eingabehilfe mit Fehler
dass HTML übergeben wird.
<wm-input type="number" label="Kundenummer" hint="Geben Sie Ihre 10-stellige Kundennummer ein.">
<div slot="error">
<wm-highlight color="morgenrot-light">
Das Besondere an diesem Fehler ist,<br>
dass HTML übergeben wird.
</wm-highlight>
</div>
</wm-input>Formular: Eingabefeld mit maximaler Zeichenlänge
Die verfügbare Zeichenanzahl wird live angezeigt und für Screen Reader Nutzer*innen angekündigt.
<wm-input label="Vorname" maxlength="4"></wm-input>Formular: Combobox
Weitere Beispiele finden Sie im Pattern Combobox.
- alle
- Grundlagenerhebung
- Konzepterstellung
- Widmungsverfahren
- Gemeinderatsbeschluss
- In Umsetzung
- Umgesetzt
<wm-input type="combobox" label="Projektstand" toggleButton="toggleButton" filter="filter">
<ul slot="options">
<li value="">alle</li>
<li value="grundlagenerhebung">Grundlagenerhebung</li>
<li value="konzepterstellung">Konzepterstellung</li>
<li value="widmungsverfahren">Widmungsverfahren</li>
<li value="gemeinderatsbeschluss">Gemeinderatsbeschluss</li>
<li value="inumsetzung">In Umsetzung</li>
<li value="umgesetzt">Umgesetzt</li>
</ul>
</wm-input>Formular: Eingabefeld mit hinterlegten Events (siehe Konsole)
<wm-form>
<form>
<wm-input type="email" label="E-Mail" id="events" required="required"></wm-input>
<button>Send</button>
</form>
</wm-form>
<script>
const input = document.querySelector('#events');
input
.addEventListener('wm-focus', e => {
console.log(e.type)
console.log(e.detail)
})
input
.addEventListener('wm-input', e => {
console.log(e.type)
console.log(e.detail)
})
input
.addEventListener('wm-change', e => {
console.log(e.type)
console.log(e.detail)
})
input
.addEventListener('wm-blur', e => {
console.log(e.type)
console.log(e.detail)
})
input
.addEventListener('wm-invalid', e => {
console.log(e.type)
console.log(e.detail)
})
</script>Eingabefelder mit Hervorhebung
Hinweise, Warnungen und Fehler können einfach oder prominent, mit Hintergrundfarbe und Innenabstand, dargestellt werden.
Formular: Wichtige Eingabehilfe mit Hervorhebung
Für wichtige Infos, die nicht übersehen werden sollen. 1 klare, kurze Aussage.
<wm-input type="date" label="Datum">
<div slot="hint">
<wm-highlight color="wasserblau-light">
Die Eingabe kann nach dem Absenden nicht mehr geändert werden.
</wm-highlight>
</div>
</wm-input>Formular: Eingabehilfe Warnung
<wm-input type="date" label="Datum">
<div slot="hint">
<wm-highlight color="goldgelb-light">
Hier steht ein Warnhinweis.
</wm-highlight>
</div>
</wm-input>Formular: Eingabefeld mit Fehler
dass HTML übergeben wird.
<wm-input type="date" label="Datum">
<div slot="error">
<wm-highlight color="morgenrot-light">
Das Besondere an diesem Fehler ist,<br>
dass HTML übergeben wird.
</wm-highlight>
</div>
</wm-input>Formular: Wichtige Zusatzinformation
Voraussichtliche Tagesgebühr
Betrag 78,00 Euro
Hinweis: Der tatsächliche Betrag kann sich durch weitere Eingaben noch verändern.
<wm-input type="number" label="Anzahl Tage"></wm-input>
<wm-notification type="info">
<h3>Voraussichtliche Tagesgebühr</h3>
<p>
<strong>Betrag 78,00 Euro</strong>
<br>
Hinweis: Der tatsächliche Betrag kann sich durch weitere Eingaben noch verändern.
</p>
</wm-notification>Formular: Zusatzinformation
Wenn zusätzliche Informationen hilfreich, aber nicht notwendig sind. Maximal 2 kurze Sätze.
<wm-input type="text" label="Kundennummer" info="Die Kundennummer finden Sie auf Ihrer letzten Rechnung."></wm-input>Formular: Eingabefeld
<div>
<label for="input-text">
Vorname
</label>
<input type="text" id="input-text"></div>Formular: Eingabefeld Pflichtfeld
<div>
<label for="input-text3">
Vorname
<abbr title="Pflichtfeld">*</abbr>
</label>
<input type="text" id="input-text3" required="required"></div>Formular: Pflichtfeld ohne Sternchen
<div>
<label for="input-text4">
Vorname (Pflichtfeld)
</label>
<input type="text" id="input-text4" required="required"></div>Formular: Eingabefeld mit Fehler
<div>
<label for="date2">
Datum
</label>
<input type="date" id="date2" aria-describedby="msg_date2" required="required" aria-invalid="true"/>
<div class="wm-forms-message" id="msg_date2">Bitte Datum angeben</div>
</div>Formular: Eingabehilfe
Hier kann kurz erklärt werden, was eingegeben werden soll. 1 kurzer Satz, Fokus auf Eingabe oder Format.
<div>
<label for="kundennummer">
Kundennummer
</label>
<div class="wm-forms-message" id="text_kundennummer">Geben Sie Ihre 10-stellige Kundennummer ein.</div>
<input type="text" id="kundennummer" aria-describedby="text_kundennummer"/>
</div>Formular: Eingabehilfe mit Fehler
<div>
<label for="kundenummer2">
Kundennummer
</label>
<div class="wm-forms-message" id="text_kundennummer2">Geben Sie Ihre 10-stellige Kundennummer ein.</div>
<input
type="text"
id="kundenummer2"
aria-describedby="text_kundennummer2 msg_kundenummer2"
required="required"
aria-invalid="true"/>
<div class="wm-forms-message" id="msg_kundenummer2">Bitte Kundennummer angeben</div>
</div>wm-input
Eigenschaften
| Eigenschaft | Beschreibung | Werte | Default |
|---|---|---|---|
showPasswordLabel
|
Gibt den lokalisierten Text für den Button zum Umschalten der Passwortsichtbarkeit zurück. Kann durch Setzen der Eigenschaft showPasswordLabel überschrieben werden. Fällt auf den lokalisierten Standard "Info anzeigen" zurück, falls nicht gesetzt. Dies ist eine öffentliche Eigenschaft, die sich reaktiv bei Sprachwechsel aktualisiert. |
String
|
"Info anzeigen"
|
toggleOptionsLabel
|
Gibt den lokalisierten Text für den Button zum Umschalten der Combobox-Optionen zurück. Kann durch Setzen der Eigenschaft toggleOptionsLabel überschrieben werden. Fällt auf den lokalisierten Standard "Vorschläge zeigen" zurück, falls nicht gesetzt. Dies ist eine öffentliche Eigenschaft, die sich reaktiv bei Sprachwechsel aktualisiert. |
String
|
"Vorschläge zeigen"
|
type
|
Art des Eingabefelds |
'combobox'|'date'|'datetime-local'|'email'|'number'|'password'|'tel'|'text'|'time'|'url'
|
"text"
|
dataset
|
Combobox: Feld in der Response, das die Daten enthält, zum Beispiel bei OGD üblicherweise "features" |
Boolean
|
""
|
toggleButton
|
Button in Combobox anzeigen |
Boolean
|
false
|
setvalue
|
Combobox: Wert programmatisch setzen |
Boolean
|
""
|
disabled
|
Disabled |
Boolean
|
false
|
pattern
|
Regulärer Expressen RegEx für die Validierung |
String
|
leer |
hasError
|
Gibt an, ob das Element einen Fehler hat Dies ist ein Statusattribut, das anzeigt, ob aktuell ein Validierungsfehler vorliegt. Es wird auf true gesetzt, wenn die Validierung fehlschlägt, und auf false zurückgesetzt, wenn die Validierung erfolgreich ist oder das Formular zurückgesetzt wird. |
Boolean
|
false
|
showErrors
|
Steuert die Anzeige von Fehlermeldungen Im Gegensatz zu 'hasError' steuert dieses Attribut, ob Fehlermeldungen angezeigt werden sollen. Wenn auf true gesetzt, werden Validierungsfehler sofort angezeigt, ohne auf eine Formularübermittlung zu warten. Wird typischerweise vom übergeordneten wm-form Element gesteuert. |
boolean
|
false
|
validate
|
Aktiviert die Validierung bei Eingabe Wenn auf true gesetzt, werden Eingaben sofort validiert und Fehler entsprechend angezeigt, ohne auf eine Formularübermittlung zu warten. Wird typischerweise vom übergeordneten wm-form Element gesteuert. |
boolean
|
false
|
validator
|
Validierungsfunktion |
Function
|
false
|
value
|
Aktueller Wert des Eingabefelds |
string
|
""
|
defaultValue
|
Standardwert für das Zurücksetzen des Formulars |
String
|
""
|
minlength
|
Minimale Länge |
Number
|
leer |
maxlength
|
Maximale Länge |
Number
|
leer |
min
|
Minimale Eingabe (z.B. Datum oder Zahl) Wird an das native weitergereicht (siehe render()). Für type="date" wird das Format YYYY-MM-DD empfohlen. Die Validierung erfolgt in _validateWithoutController(). |
string|undefined
|
leer |
max
|
Maximale Eingabe (z.B. Datum oder Zahl) Wird an das native weitergereicht (siehe render()). Für type="date" wird das Format YYYY-MM-DD empfohlen. Die Validierung erfolgt in _validateWithoutController(). |
string|undefined
|
leer |
label
|
Text für das Label |
String
|
leer |
hint
|
Text für den Hint |
String
|
leer |
required
|
Markiert Pflichtfelder |
Boolean
|
false
|
suppressError
|
Unterdrückt die Anzeige von Fehlermeldungen |
Boolean
|
false
|
errormessage
|
Fehlermeldung bei ungültiger Eingabe Diese Meldung wird direkt am Eingabefeld angezeigt, wenn es validiert wird und ungültig ist. |
String
|
""
|
summaryErrormessage
|
Spezifische Fehlermeldung für die Fehlerübersicht Diese Meldung wird in der Fehlerübersicht (wm-formerrorsummary) anstelle der normalen Fehlermeldung angezeigt. Dies ist nützlich, um in der Übersicht kontextspezifischere Fehlermeldungen anzuzeigen, z.B. 'Bitte geben Sie Ihren Namen bei \'Kontaktdaten\' ein' statt nur 'Dieses Feld ist erforderlich'. |
String
|
""
|
_initialValue
|
Initial value for reset functionality |
String
|
""
|
autocomplete
|
string
|
|
|
STATES
|
|
|
|
_componentState
|
Current component state |
String
|
|
_previousState
|
Previous component state for transitions |
String
|
null
|
error
|
Current error message |
String
|
''
|
_output
|
|
|
|
announcementText
|
Text, der angekündigt wird, wenn Optionen angezeigt werden |
String
|
"Suchvorschläge werden angezeigt. Verwenden Sie Pfeiltasten um zu navigieren"
|
maxlengthText
|
Text for maxlength message |
String
|
"Es sind noch {remaining} Zeichen verfügbar"
|
patternMismatchMessage
|
Pattern validation message |
String
|
"Bitte geben Sie einen gültigen Wert ein"
|
placeholder
|
placeholder-Attribut in HTML |
String
|
leer |
search
|
Art des Suchfeldes |
'hidden'|'visible'|'hiddenmobile'
|
leer |
size
|
size-Attribute in HTML |
String
|
leer |
filter
|
Liste in Combobox beim Tippen filtern |
Boolean
|
false
|
hideMaxlength
|
Verfügbare Zeichenanzahl verbergen |
Boolean
|
false
|
_highlightedOptionID
|
id of the currently Highlight Option |
String
|
leer |
info
|
string
|
leer | |
_infoOpen
|
boolean
|
false
|
Methoden
| Eigenschaft | Optionen | Argumente |
|---|---|---|
hideOptions
|
Liste in Combobox verbergen |
Fokus auf Input legen (true)
(Boolean) |
showError
|
Shows an error message for this input |
The error message to display
(string) |
clearError
|
Clears any error state from this input | / |
showOptions
|
Liste in Combobox anzeigen | / |
Events
| Event | Beschreibung | Rückgabewert |
|---|---|---|
|
|
Kontakt
Haben Sie noch Fragen, Feedback oder brauchen Sie ein Element, das die Pattern Library noch nicht
bietet?
handbuch@ma53.wien.gv.at