Komponenten
Passwortfeld (PasswordInput)
StabilEin Passwort eingeben und bei Bedarf sichtbar machen – mit beschriftetem Auge.
Ein Passwortfeld verbirgt die Eingabe und bietet daneben eine Schaltfläche, die den Text sichtbar macht. Das hilft beim Tippen auf dem Stationsgerät, ohne dass das Passwort dauerhaft auf dem Bildschirm steht.
Wann verwenden
- Für Passwörter und andere Geheimnisse, die zeichenweise verborgen werden sollen, etwa die Anmeldung am Dienstkonto.
- Wenn Nutzer die Eingabe prüfen können sollen, bevor sie sie abschicken.
- Überall dort, wo
type="password"allein zu unfreundlich wäre.
Wann nicht
- Für normale Textfelder ohne Geheimnis ist
Inputdie richtige Wahl. - Für einen Einmalcode aus der Authenticator-App passt
InputOTPbesser: Die Ziffern sollen sichtbar und in Gruppen prüfbar sein. - Für eine Suche oder ein Suchfeld ist ein Passwortfeld sinnlos.
Eingabe und Sichtbarkeit
PasswordInput umschließt das Eingabefeld und setzt die Umschaltung als
eigene Schaltfläche daneben. Der zugängliche Name der Schaltfläche kommt aus
dem Nachrichtenkatalog: „Passwort anzeigen“ und „Passwort verbergen“.
Das Auge neben dem Feld zeigt den eingegebenen Text; ein zweiter Klick verbirgt ihn wieder.
import { Label, PasswordInput } from "@neodin-eu/ui";
function Anmeldung() {
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label htmlFor="dienstkonto">Passwort für das Dienstkonto</Label>
<PasswordInput
id="dienstkonto"
name="dienstkonto"
autoComplete="current-password"
placeholder="Mindestens zwölf Zeichen"
/>
<p className="text-xs text-muted-foreground">
Das Auge neben dem Feld zeigt den eingegebenen Text; ein zweiter Klick verbirgt ihn wieder.
</p>
</div>
);
}Gesperrter Zustand
Ist das Feld disabled, lassen sich weder das Passwort noch die Sichtbarkeit
ändern. Der Wert bleibt lesbar – allerdings weiterhin verborgen.
Vom Administrator gesperrt – Änderungen sind nur über die IT möglich.
import { Label, PasswordInput } from "@neodin-eu/ui";
function Gesperrt() {
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label htmlFor="gesperrtes-passwort">Passwort</Label>
<PasswordInput id="gesperrtes-passwort" defaultValue="geheim" disabled />
<p className="text-xs text-muted-foreground">
Vom Administrator gesperrt – Änderungen sind nur über die IT möglich.
</p>
</div>
);
}Barrierefreiheit
- Das Eingabefeld ist ein natives
inputmittype="password"; die Umschaltung wechselt auftype="text"und wieder zurück. Das ist im Komponententest abgesichert. - Die Schaltfläche daneben ist ein natives
buttonmittype="button"; sie wird überTaberreicht und mitEnteroderLeertasteausgelöst. - Ihr Name wechselt mit dem Zustand zwischen „Passwort anzeigen“ und
„Passwort verbergen“;
aria-pressedgibt den Zustand zusätzlich an. Beides prüft der Komponententest. - Der sichtbare Text neben dem Feld verbindet sich über
htmlForundidmit dem Eingabefeld und liefert den zugänglichen Namen. - Das Feld ist in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| containerClassName | string | – | Nein | Additional classes for the wrapper that holds the input and toggle. |
| disabled | boolean | – | Nein | – |