enhancement
major
minor
major
minor
critical
#29665
TL Views: Ein Klick in ein Rich-Text-Feld mit versteckter Beschriftung setzt die Schaltfläche „Fett“ im Editor in den Fokus, wodurch der eingegebene Text verloren geht.
Problem
Ein Klick in den Textbereich eines Rich-Text-Feldes (HTML), dessen Beschriftung ausgeblendet ist (label-position="hide-label"), setzt den Cursor nicht in den Editor: Der Fokus landet auf der Schaltfläche „Fett“ (Fettdruck) in der Editor-Symbolleiste, und alles, was anschließend eingegeben wird, wird nicht übernommen (und der Klick kann möglicherweise die Fettdruck-Funktion umschalten). Das Feld kann nur bearbeitet werden, nachdem der Fokus per Skript auf den bearbeitbaren Bereich gesetzt wurde. Beobachtet in der TL Development-App (Snapshot-Build 42) im Kommentar-Editor und in der Ticketbeschreibung im Bearbeitungsmodus.
Ursache
TLFormField.tsx rendert den Eingabebereich eines Feldes mit versteckter Beschriftung wie folgt:
<label className="tlFormField__input">
<span className="tlVisuallyHidden">{label}</span>
<TLChild control={field} />
</label>
(der barrierefreie Name aus #29608). Das Aktivierungsverhalten der HTML-Beschriftung leitet einen Klick auf einen beliebigen nicht-interaktiven Inhalt eines <label> an das *beschriftbare Steuerelement* der Beschriftung weiter – ohne „for“-Attribut ist dies der erste beschriftbare Nachkomme. In einem Rich-Text-Editor ist dies die erste Symbolleiste <button>, nicht der „contenteditable“-Bereich (der überhaupt nicht beschriftbar ist). Jedes zusammengesetzte Eingabefeld, bei dem sich eine Schaltfläche vor dem eigentlichen Eingabefeld befindet, ist auf dieselbe Weise betroffen.
Erwartet
Ein Klick innerhalb des Eingabefelds eines Feldes wird an die beabsichtigte Stelle weitergeleitet. Der barrierefreie Name eines Feldes mit einer versteckten Beschriftung wird ohne umschließendes <label> bereitgestellt – z. B. über `aria-label`/`aria-labelledby` am Eingabesteuerelement oder über ein <label for> -Element, das auf das eigentliche Eingabefeld verweist –, sodass kein Klick umgeleitet wird.
Lösung
- Der Eingabebereich eines Formularfelds ist immer ein einfacher Container, kein <label> mehr; ein Klick in das Eingabeelement landet dort, wo er hinzielt.
- Formularfeld und Eingabesteuerelement verweisen über IDs aufeinander (Bridge-Modul field-label.ts, Hook useFieldLabelProps): Das Steuerelement im Eingabebereich des Felds meldet die ID seines eigentlichen Eingabeelements und setzt darauf `aria-labelledby ` auf den Beschriftungstext. Tiefer verschachtelte Steuerelemente (z. B. Eingaben in Tabellenzeilen innerhalb eines Feldes) übernehmen die Beschriftung nicht. Implementiert für Text, Passwort, Zahl, Datum, Farbe, Schieberegler, Kontrollkästchen, Auswahl, Dropdown, Icon-Auswahl, Auswahlgruppen, Werteliste, Datei-Upload, mehrsprachige Eingaben, Rich-Text-, Code- und TL-Script-Editor. Dies gilt sowohl für ausgeblendete als auch für sichtbare Beschriftungen – bisher war ein Eingabefeld mit sichtbarer Beschriftung für assistive Technologien gar nicht benannt.
- Eine sichtbare Beschriftung dient ihrem Eingabeelement: Sie ist ein <label for> für das gemeldete Element; ein Klick darauf schaltet also ein Kontrollkästchen um bzw. fokussiert ein Text-, Auswahl- oder Datumsfeld. Wo das Ziel nativ nicht beschriftbar ist (Rich-Text-Bereich, Radio-Gruppe, Combobox, Werteliste, Auswahlschaltfläche), fokussiert der Klick das Element selbst bzw. darin die ausgewählte Option, andernfalls das erste wertaufnehmende Eingabeelement – ohne eine Option auszuwählen oder eine Schaltfläche auszulösen.
- Eine versteckte Beschriftung ist ein unsichtbarer Text neben (nicht um) dem Eingabebereich.