Grundlagen
Texte und Sprache
StabilDer Textkatalog der Library, Platzhalter mit formatMessage, Formate für de-AT und Regeln für deutsche UI-Texte.
NeodinProvider bringt zwei Dinge mit, die jede Oberfläche braucht: eine
Sprache für Formate und einen Katalog für die Texte, die in den Komponenten
stecken. Beides liegt an einer Stelle und gilt für alles darunter.
Sprache wählen
locale ist standardmäßig de-AT. Beginnt der Wert mit de, verwendet die
Library den deutschen Katalog, sonst den englischen. Auf die Zahlen- und
Datumsformate wirkt locale direkt: NumberInput, StatTile, FileUpload,
die Diagramme und Timeline formatieren mit der Sprache aus dem Provider.
import { NeodinProvider } from "@neodin-eu/ui";
export function App({ children }: { children: React.ReactNode }) {
return <NeodinProvider locale="de-AT">{children}</NeodinProvider>;
}Der Katalog
Alle Bedienungstexte stehen in packages/ui/src/lib/messages.ts als flache
Zuordnung von Schlüssel zu Text. Die Tabelle liest das Modul beim Bauen der
Seite und zeigt beide Fassungen; sie kann deshalb nicht veralten.
| Schlüssel | Deutsch | Englisch | Platzhalter |
|---|---|---|---|
noResults | Keine Treffer | No results | — |
noEntries | Keine Einträge | No entries | — |
loading | Wird geladen … | Loading … | — |
close | Schließen | Close | — |
search | Suchen … | Search … | — |
previous | Zurück | Previous | — |
next | Weiter | Next | — |
page | Seite {page} von {total} | Page {page} of {total} | {page} {total} |
rowsSelected | {count} ausgewählt | {count} selected | {count} |
themeLight | Hell | Light | — |
themeDark | Dunkel | Dark | — |
themeSystem | System | System | — |
copy | Kopieren | Copy | — |
copied | Kopiert | Copied | — |
code | Code | Code | — |
required | Pflichtfeld | Required | — |
invalidDate | Ungültiges Datum | Invalid date | — |
showPassword | Passwort anzeigen | Show password | — |
hidePassword | Passwort verbergen | Hide password | — |
removeItem | {label} entfernen | Remove {label} | {label} |
dropFiles | Dateien hierher ziehen oder auswählen | Drag files here or choose files | — |
fileTooLarge | Datei ist größer als {max} | File is larger than {max} | {max} |
fileTypeNotAllowed | Dateityp nicht erlaubt | File type not allowed | — |
toggleSidebar | Seitenleiste umschalten | Toggle sidebar | — |
sidebar | Seitenleiste | Sidebar | — |
breadcrumb | Brotkrümelnavigation | Breadcrumb | — |
moreActions | Weitere Aktionen | More actions | — |
selectAll | Alle auswählen | Select all | — |
selectRow | Zeile auswählen | Select row | — |
columns | Spalten | Columns | — |
retry | Erneut versuchen | Retry | — |
commandPalette | Befehlspalette | Command palette | — |
selectOption | Auswählen | Select | — |
date | Datum | Date | — |
dateRange | Zeitraum | Date range | — |
rangeStart | Von | From | — |
rangeEnd | Bis | To | — |
openCalendar | Kalender öffnen | Open calendar | — |
time | Uhrzeit | Time | — |
invalidTime | Ungültige Uhrzeit | Invalid time | — |
errorTitle | Etwas ist schiefgelaufen | Something went wrong | — |
pagination | Seitennavigation | Pagination | — |
goToPage | Seite {page} | Page {page} | {page} |
stepCompleted | Abgeschlossen | Completed | — |
stepCurrent | Aktueller Schritt | Current step | — |
stepUpcoming | Ausstehend | Upcoming | — |
trendUp | steigend | increasing | — |
trendDown | fallend | decreasing | — |
trendFlat | unverändert | unchanged | — |
Wer einen Schlüssel braucht, liest ihn über useNeodinMessages() in einer
Client-Komponente. Für eigene Texte außerhalb der Library ist der Katalog
nicht gedacht: Feldnamen und Erklärungen deiner Anwendung kommen aus deiner
Anwendung.
Platzhalter und formatMessage
Fünf Schlüssel enthalten Platzhalter in geschweiften Klammern: page,
rowsSelected, removeItem, fileTooLarge und goToPage. formatMessage
setzt sie ein; unbekannte Platzhalter bleiben stehen, damit nichts
stillschweigend verschwindet.
import { deMessages, formatMessage } from "@neodin-eu/ui";
formatMessage(deMessages.page, { page: 2, total: 7 });
formatMessage(deMessages.removeItem, { label: "Übergabeprotokoll" });
formatMessage(deMessages.page, { page: 2 });Die drei Aufrufe ergeben „Seite 2 von 7“, „Übergabeprotokoll entfernen“ und
„Seite 2 von {total}“: Der fehlende Platzhalter bleibt sichtbar, statt
stillschweigend zu verschwinden.
Gibst du keine Variablen mit, kommt die Vorlage unverändert zurück. Das
Verhalten ist im Library-Test (messages.test.ts) abgesichert.
Einzelne Texte überschreiben
messages am Provider ersetzt nur die genannten Schlüssel; alle anderen
bleiben beim Standard. So heißt eine leere Ergebnisliste „Nichts gefunden“,
ohne dass du den ganzen Katalog kopieren musst:
<NeodinProvider messages={{ noResults: "Nichts gefunden" }}>{children}</NeodinProvider>Die vollständige Beschreibung samt Beispiel steht unter NeodinProvider.
Formate für de-AT
Die Library formatiert nach der Sprache aus dem Provider, nicht nach der
Sprache des Browsers. Mit de-AT gilt:
| Wert | Ausgabe | Komponente |
|---|---|---|
1234.5 | 1.234,5 | NumberInput, StatTile |
5000000 Bytes | 5 MB | FileUpload |
| Datum 19.11.2026 | 19.11.2026 | DatePicker, DateRangePicker |
| Uhrzeit 08:30 | 08:30 (24-Stunden-Anzeige) | TimePicker |
| Zeitstempel | 19.11.2026, 08:30 | Timeline |
| Diagrammwert | 1.234,5 | Diagramme (Tooltip) |
Zahlen laufen über Intl.NumberFormat, Datumsfelder über date-fns mit der
Locale de-AT und dem Muster dd.MM.yyyy; die Woche beginnt am Montag. Die
Uhrzeit ist immer HH:mm im 24-Stunden-Format. Eigene Texte formatiert deine
Anwendung mit demselben Intl-Aufruf und derselben Locale, damit die Seite
einheitlich bleibt.
Schreibregeln
Knöpfe nennen die Handlung
Ein Knopf sagt, was passiert, nicht dass etwas passiert:
„Dienstplan veröffentlichen“ statt „OK“, „Schicht tauschen“ statt „Senden“.
Ein kurzes Verb und ein Objekt reichen. Für Abbrechen und Zurück gibt es
Button variant="outline" und variant="ghost"; die Beschriftung bleibt
trotzdem konkret („Änderungen verwerfen“).
Du oder Sie: eine Entscheidung pro Produkt
Der Katalog der Library adressiert niemanden direkt. Die Texte sind neutral und unpersönlich: „Keine Treffer“, „Wird geladen …“, „Schließen“, „Weiter“. Das ist Absicht – die Library legt die Anrede nicht fest.
Ob ein Produkt die Mitarbeitenden duzt oder siezt, entscheidet das Produkt und hält es über alle Seiten, Formulare und Fehlermeldungen durch. Ein Wechsel mitten im Ablauf („Bitte wählen Sie …“ neben „Gib den Grund an“) liest sich wie ein Fehler. Diese Doku verwendet durchgehend „du“.
Typografie
- Deutsche Anführungszeichen: „Dienstplan“ – nicht
"Dienstplan". - Halbgeviertstrich für Bereiche und Gegensätze:
08:00–16:00,Hell–Dunkel. Nie einen Bindestrich als Gedankenstrich verwenden. - Auslassungspunkte als einzelnes Zeichen mit Leerzeichen davor, wie im Katalog: „Wird geladen …“, „Suchen …“.
- Ein Leerzeichen nach dem Doppelpunkt, keines vor Satzzeichen. Umlaute
ausschreiben („Übergabe“), nicht
Uebergabe.
Fehlermeldungen sagen, was zu tun ist
Eine Meldung nennt das Feld und den nächsten Schritt: „Bitte gib das Datum der
Schicht an.“ Statt nur „Ungültig“. Die Library liefert für ihre Bausteine
kurze Texte wie „Ungültiges Datum“ (invalidDate) oder „Pflichtfeld“
(required); die fachliche Meldung schreibt die Anwendung. Wie Fehler mit
dem Feld verbunden werden, steht unter Formular (Form).
Keine Patientendaten in Beispielen
Beispiele und Screenshots zeigen Rollen, Stationen und Abläufe, keine echten Personen: „Station 3“, „Frühdienst“, „Zimmer 102“. Namen in Beispielen sind erfunden. Das gilt auch für Fehlermeldungen und Logs in der Doku.
Barrierefreiheit
- Katalogtexte sind zugängliche Namen:
copy,close,toggleSidebarundremoveItembeschriften Knöpfe und werden vorgelesen. Überschreib sie nicht mit leerem Text – sonst verliert der Knopf seinen Namen. - Platzhalter gehören in den Satz, nicht an den Rand: „Übergabeprotokoll entfernen“ liest sich für Screenreader wie für alle anderen.
- Sprachwechsel am Dokument setzen:
<html lang="de">. Die Seitensprache hilft Screenreadern bei Aussprache und Silbentrennung. - Gekürzte Texte („…“) brauchen den vollständigen Text als zugänglichen
Namen, etwa über
aria-labeloder einen Tooltip mit Text.