Zum Inhalt springen
Dokumentation

Komponenten

Passwortfeld (PasswordInput)

Stabil

Ein 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 Input die richtige Wahl.
  • Für einen Einmalcode aus der Authenticator-App passt InputOTP besser: 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.

Beispiel und Quelltext
anmeldung.tsx
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.

Beispiel und Quelltext
gesperrt.tsx
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 input mit type="password"; die Umschaltung wechselt auf type="text" und wieder zurück. Das ist im Komponententest abgesichert.
  • Die Schaltfläche daneben ist ein natives button mit type="button"; sie wird über Tab erreicht und mit Enter oder Leertaste ausgelöst.
  • Ihr Name wechselt mit dem Zustand zwischen „Passwort anzeigen“ und „Passwort verbergen“; aria-pressed gibt den Zustand zusätzlich an. Beides prüft der Komponententest.
  • Der sichtbare Text neben dem Feld verbindet sich über htmlFor und id mit dem Eingabefeld und liefert den zugänglichen Namen.
  • Das Feld ist in hell und dunkel frei von axe-Verstößen.

Props

Props von PasswordInput
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
containerClassNamestring–NeinAdditional classes for the wrapper that holds the input and toggle.
disabledboolean–Nein–

Siehe auch