enhancement
major
minor
major
minor
major
#29548
React-View-Benutzeroberfläche: Die Attribute „URL“, „E-Mail“ und „Telefon“ werden als Eingabefelder bearbeitet und als Links angezeigt.
Betrifft 8.0.0-alpha8 (React-View-UI).
Das Problem
Ein Attribut vom Typ „tl.util:URL“ wird in der React-View-Benutzeroberfläche als reines Textfeld angezeigt. FieldControlService verfügt über keinen diesem Typ zugeordneten Provider, sodass die Anfrage an den Fallback „TextInputControlProvider“ weitergeleitet wird, der ein „ReactTextInputControl“ erstellt. Auf dem Client ist in „TLTextInput.tsx“ „type="text"“ fest codiert.
Die Folgen für ein Formular oder eine Tabellenzelle, die eine URL enthält:
- Im Bearbeitungsmodus bietet der Browser keine URL-Tastatur, keine URL-Validierung und keine Autovervollständigung zuvor eingegebener Adressen, da es sich bei der Eingabe nicht um ein URL-Eingabefeld handelt.
- Im Anzeigemodus wird der Wert als Text geschrieben. Ein Benutzer, der die Adresse öffnen möchte, muss sie markieren, kopieren und in die Adressleiste einfügen. Dasselbe gilt für eine URL-Spalte in einem <table>.
- Ein Wert, der ohne Schema eingegeben wird (example.com), entspricht der Eingabe des Benutzers, wird jedoch weder vervollständigt noch abgelehnt.
Eine Anwendung, die ein nutzbares URL-Feld benötigt, muss einen eigenen `ReactFieldControlProvider` für `tl.util:URL` registrieren, eine Unterklasse von `ReactFormFieldControl` schreiben und eine zweite React-Komponente für Texteingaben bereitstellen, deren einzige Unterschiede der Eingabetyp und ein daneben befindlicher Link sind. Das ist ein vollständig benutzerdefiniertes Steuerelement für eine Änderung an nur einem Attribut.
Es gibt überhaupt keine Modelltypen für E-Mail-Adressen und Telefonnummern, obwohl es sich bei beiden um dieselbe Art von Wert handelt: einen Text mit einem dedizierten Eingabetyp und einem Link (mailto:, tel:).
Lösung
Typisierte Texteingabe. ReactTextInputControl erhält einen Eingabetyp (InputType: text, url, email, tel, search), der als State an den Client übergeben und in TLTextInput.tsx als „type“-Attribut des Eingabefelds gerendert wird. Der Standardwert ist „text“, sodass bestehende Felder unverändert bleiben. Ein Steuerelement bedient alle Typen: Das Eingabeprotokoll (Debounce, Flush bei Fokusverlust, Absenden bei Enter, Commit bei Fokusverlust, Fehleranzeige, mehrzeilige Variante) ist einheitlich, nur das „input“-Attribut, die Link-Regel und die Normalisierungsregel unterscheiden sich.
Anzeige von Links: Bei „url“, „email“ und „tel“ leitet der Client ein Linkziel aus dem Wert ab (bei den beiden letzteren„mailto:“ bzw. „tel:“, bei der Telefonnummer ohne Leerzeichen). Im Anzeigemodus und somit in Tabellenzellen wird der Wert als <a href target="_blank" rel="noopener noreferrer"> dargestellt. Im Bearbeitungsmodus wird neben dem Eingabefeld ein Symbol für einen offenen Link angezeigt, solange der Wert nicht leer und fehlerfrei ist. Das einzeilige Eingabefeld befindet sich immer im selben Wrapper, sodass das Erscheinen oder Verschwinden des Links das Eingabefeld nicht neu anordnet und der Fokus beim Tippen erhalten bleibt.
Normalisierung auf dem Client. Ein URL-Feld kürzt seinen Wert und fügt einem Wert ohne Schema „https://“ vor, wenn das Feld den Fokus verliert (und wenn die Eingabe mit der Eingabetaste abgeschickt wird), bevor der Wert gesendet wird. Der Benutzer sieht den Wert, der gespeichert wird; Werte mit einem Schema (einschließlich „mailto:“) werden unverändert weitergeleitet. Ein URL -Feld sendet seinen Wert erst beim Verlassen des Fokus (sendValueOnBlur), sodass die zwischendurch halb eingegebene Adresse vom Server niemals ausgewertet wird. Der Server lehnt zudem einen nicht leeren URL-Wert, der keine absolute URI ist, mit der Feldfehlermeldung „Ungültige Webadresse“ ab – als Sicherheitsmaßnahme gegen Clients, die die Normalisierung umgehen.
Konfigurierbarer Provider. „TextInputControlProvider“ erhält eine Konfigurationseigenschaft für den Eingabetyp. Die Standardkonfiguration von „FieldControlService“ ordnet „tl.util:URL“, „tl.util:EMail“ und „tl.util:Phone“ diesem mit dem passenden Eingabetyp zu; es ist keine typbezogene Providerklasse erforderlich.
Modelltypen. tl.util:EMail und tl.util:Phone werden neben tl.util:URL hinzugefügt (String-Datentypen, die in bestehenden Datenbanken durch die kbase-Migration „Ticket_29548_create_email_phone“ angelegt werden). Die React-Attribut-Demo (tl-demo-react) erhält neben ihrem URL-Attribut ein E-Mail- und ein Telefon-Attribut, und ihre Tabelle zeigt die drei Spalten an.
Test
- TestReactTextInputControl (tl-layout-react): Zustand des Eingabetyps, URL-Validierung, „send-on-blur“.
- TestTextInputControlProvider (tl-layout-view): Konfigurierter Eingabetyp, mitgelieferte Typzuordnung.
- tl-demo-react: „Attribut“ → „Auswahl + Formular“: URL, E-Mail-Adresse, Telefonnummer als Eingabefelder mit Open-Link-Symbol, Normalisierung bei Fokusverlust, Ablehnung einer ungültigen Adresse, Links im Ansichtsmodus und in den Tabellenspalten.
Migration
Die Datentypen tl.util:EMail und tl.util:Phone werden in bestehenden Datenbanken durch die automatische kbase-Migration Ticket_29548_create_email_phone (Modul tl-element) angelegt; es ist kein manueller Schritt erforderlich. Eine Anwendung, die im Modul tl.util bereits einen Typ namens „EMail“ oder „Phone“ definiert hat, würde mit den Framework-Typen kollidieren und muss vor dem Update ihre eigene Definition umbenennen oder entfernen.