Zum Hauptinhalt springen

TimeField

In ChatGPT öffnen
Schatten dwc-field 23.02
Java API

TimeField ist eine Benutzeroberflächenkomponente, die es Benutzern ermöglicht, Zeiten in Stunden, Minuten und optional Sekunden einzugeben oder auszuwählen. Es bietet eine intuitive und effiziente Möglichkeit, zeitbezogene Informationen in verschiedenen Anwendungen zu verarbeiten.

Verwendung des TimeField​

Inheritance

This class is a Field component, and inherits its features and behaviors. For an overview of Field properties, events, and other important information, please refer to the Field documentation.

TimeField erweitert die gemeinsame Field-Klasse, die gemeinsame Funktionen für alle Feldkomponenten bereitstellt. Das folgende Beispiel erstellt ein Erinnerungs-TimeField, das auf die aktuelle Zeit initialisiert wird.

Code anzeigen

Verwendungen​

Das TimeField eignet sich ideal zum Auswählen und Anzeigen von Zeiten in Ihrer App. Hier sind einige Beispiele, wann das TimeField verwendet werden sollte:

  1. Ereignisplanung: Zeitfelder sind in Apps, die die Festlegung von Zeiten für Veranstaltungen, Termine oder Besprechungen beinhalten, unerlässlich.

  2. Zeitverfolgung und -protokollierung: Apps, die Zeit verfolgen, wie z. B. Stundennachweise, benötigen Zeitfelder für genaue Einträge.

  3. Erinnerungen und Alarme: Die Verwendung eines Zeitfelds vereinfacht den Eingabeprozess für Benutzer, die Erinnerungen oder Alarme in Ihrer App festlegen.

Minimal- und Maximalwert​

Mit den Methoden setMin() und setMax() können Sie einen Bereich akzeptabler Zeiten festlegen.

  • Für setMin(): Wenn der in die Komponente eingegebene Wert früher ist als die angegebene Mindestzeit, schlägt die Validierung der Einschränkung fehl. Wenn sowohl die min- als auch die max-Werte gesetzt sind, muss der min-Wert eine Zeit sein, die gleich oder früher als der max-Wert ist.

  • Für setMax(): Wenn der in die Komponente eingegebene Wert später ist als die angegebene Höchstzeit, schlägt die Validierung der Einschränkung fehl. Wenn sowohl die min- als auch die max-Werte gesetzt sind, muss der max-Wert eine Zeit sein, die gleich oder später als der min-Wert ist.

Werteverarbeitung und Lokalisierung​

Intern vertreten die TimeField-Komponente ihre Werte unter Verwendung eines LocalTime-Objekts aus dem java.time-Paket. Dies ermöglicht Entwicklern, mit genauen Zeitwerten zu interagieren, unabhängig davon, wie sie visuell dargestellt sind.

Während die clientseitige Komponente die Zeit unter Verwendung der Browsersprache des Benutzers anzeigt, ist das geparste und gespeicherte Format immer als HH:mm:ss standardisiert.

Wenn Sie einen raw String-Wert festlegen, verwenden Sie die Methode setText() mit Bedacht:

timeField.setText("09:15:00"); // gültig
Warnung

Wenn Sie die Methode setText() verwenden, wird eine IllegalArgumentException ausgelöst, wenn die Komponente den Eingabewert nicht im HH:mm:ss-Format parsen kann.

Picker-Benutzeroberfläche

Das Erscheinungsbild der Benutzeroberfläche für den Zeitwähler hängt nicht nur von der ausgewählten Sprache ab, sondern auch vom verwendeten Browser und Betriebssystem. Dies sorgt für automatische Konsistenz mit der Benutzeroberfläche, die die Benutzer bereits kennen.

Statische Hilfsprogramme​

Die TimeField-Klasse bietet auch die folgenden statischen Hilfsmethoden:

  • fromTime(String timeAsString): Konvertiert einen Zeit-String im HH:mm:ss-Format in ein LocalTime-Objekt, das dann mit dieser Klasse oder anderswo verwendet werden kann.

  • toTime(LocalTime time): Konvertiert ein LocalTime in einen Zeit-String im HH:mm:ss-Format.

  • isValidTime(String timeAsString): Überprüft, ob der angegebene String eine gültige HH:mm:ss-Zeit ist. Dies gibt einen booleschen Wert true zurück, wenn dies der Fall ist, andernfalls false.

Best Practices​

  • Klare Beispiele für das Zeitformat bereitstellen: Zeigen Sie den Benutzern das erwartete Zeitformat klar in der Nähe des TimeField an. Verwenden Sie Beispiele oder Platzhalter, um ihnen zu helfen, die Zeit korrekt einzugeben. Wenn möglich, zeigen Sie das Zeitformat basierend auf dem Standort des Benutzers an.

  • Zugänglichkeit: Nutzen Sie die TimeField-Komponente mit Blick auf die Zugänglichkeit und stellen Sie sicher, dass sie den Standards für Zugänglichkeit entspricht, wie z. B. durch Bereitstellung angemessener Beschriftungen, ausreichendem Farbkontrast und Kompatibilität mit Hilfstechnologien.

  • Zurücksetzen-Option: Bieten Sie eine Möglichkeit, für Benutzer die TimeField-Eingabe einfach auf einen leeren oder Standardzustand zurückzusetzen.