Handbuch wien.gv.at
Startseite wien.gv.at
Menü

Formular: Input

Das Pattern Input ermöglicht es Nutzer*innen Text zum Beispiel in Formularen und Suchfeldern einzugeben.

Dev

Interaktive Demo

Vorschau Code
<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.

Webcomponent

Formular: Eingabefeld

Vorschau Code
<wm-input label="Vorname"></wm-input>

Formular: Eingabefeld Pflichtfeld

* Wird automatisch durch die Präsenz des required Attributs angezeigt.

Vorschau Code
<wm-input label="Vorname" required="required"></wm-input>

Formular: Eingabefeld Pflichtfeld ohne Sternchen

* Wird automatisch durch die Präsenz des hideAsterisk Attributs ersetzt.

Vorschau Code
<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.

Vorschau Code
<wm-input label="Vorname" required="required" requiredText="Bitte angeben" hideAsterisk="hideAsterisk"></wm-input>

Formular: Eingabefeld Passwort

Der Button blendet das Passwort ein- und aus.

Vorschau Code
<wm-input type="password" label="Passwort" autocomplete="current-password"></wm-input>

Formular: Eingabehilfe

Vorschau Code
<wm-input type="number" label="Kundennummer" hint="Geben Sie Ihre 10-stellige Kundennummer ein.
"
>
</wm-input>

Formular: Eingabehilfe mit Fehler

Vorschau
Das Besondere an diesem Fehler ist,
dass HTML übergeben wird.
Code
<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.

Vorschau Code
<wm-input label="Vorname" maxlength="4"></wm-input>

Formular: Combobox

Weitere Beispiele finden Sie im Pattern Combobox.

Vorschau
  • alle
  • Grundlagenerhebung
  • Konzepterstellung
  • Widmungsverfahren
  • Gemeinderatsbeschluss
  • In Umsetzung
  • Umgesetzt
Code
<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)

Vorschau
Code
<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.

Vorschau
Die Eingabe kann nach dem Absenden nicht mehr geändert werden.
Code
<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

Vorschau
Hier steht ein Warnhinweis.
Code
<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

Vorschau
Das Besondere an diesem Fehler ist,
dass HTML übergeben wird.
Code
<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

Vorschau

Voraussichtliche Tagesgebühr

Betrag 78,00 Euro
Hinweis: Der tatsächliche Betrag kann sich durch weitere Eingaben noch verändern.

Code
<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.

Vorschau Code
<wm-input type="text" label="Kundennummer" info="Die Kundennummer finden Sie auf Ihrer letzten Rechnung."></wm-input>
HTML

Formular: Eingabefeld

Vorschau
Code
<div>
<label for="input-text">
Vorname
</label>
<input type="text" id="input-text"></div>

Formular: Eingabefeld Pflichtfeld

Vorschau
Code
<div>
<label for="input-text3">
Vorname
<abbr title="Pflichtfeld">*</abbr>
</label>
<input type="text" id="input-text3" required="required"></div>

Formular: Pflichtfeld ohne Sternchen

Vorschau
Code
<div>
<label for="input-text4">
Vorname (Pflichtfeld)
</label>
<input type="text" id="input-text4" required="required"></div>

Formular: Eingabefeld mit Fehler

Vorschau
Bitte Datum angeben
Code
<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.

Vorschau
Geben Sie Ihre 10-stellige Kundennummer ein.
Code
<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

Vorschau
Geben Sie Ihre 10-stellige Kundennummer ein.
Bitte Kundennummer angeben
Code
<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>
API

wm-input

Eigenschaften

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