TimeField
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 is een gebruikersinterfacecomponent die gebruikers in staat stelt om tijden in uren, minuten en optioneel seconden in te voeren of te selecteren. Het biedt een intuïtieve en efficiënte manier om tijdgerelateerde informatie in verschillende applicaties te beheren.
Toon code
- Java
Usages
De TimeField is ideaal voor het kiezen en weergeven van tijden in je app. Hier zijn enkele voorbeelden van wanneer je de TimeField kunt gebruiken:
-
Evenementplanning: Tijdvelden zijn essentieel in apps die betrekking hebben op het instellen van tijden voor evenementen, afspraken of vergaderingen.
-
Tijdregistratie en logging: Apps die tijd registreren, zoals urenlijsten, hebben tijdvelden nodig voor nauwkeurige invoer.
-
Herinneringen en alarmen: Het gebruik van een tijdveld vereenvoudigt het invoerproces voor gebruikers die herinneringen of alarmen in je app instellen.
Min- en maxwaarde
Met de methoden setMin() en setMax() kun je een reeks acceptabele tijden specificeren.
-
Voor
setMin(): Als de waarde die in de component wordt ingevoerd eerder is dan de gespecificeerde minimumtijd, faalt de component in het valideren van de beperkingen. Wanneer zowel de min- als maxwaarden zijn ingesteld, moet de minwaarde een tijd zijn die gelijk is aan of eerder is dan de maxwaarde. -
Voor
setMax(): Als de waarde die in de component wordt ingevoerd later is dan de gespecificeerde maximumtijd, faalt de component in het valideren van de beperkingen. Wanneer zowel de min- als maxwaarden zijn ingesteld, moet de maxwaarde een tijd zijn die gelijk is aan of later is dan de minwaarde.
Waardebehandeling en lokalisatie
Intern vertegenwoordigt de TimeField component zijn waarde met behulp van een LocalTime object uit het java.time pakket. Dit stelt ontwikkelaars in staat om interactie te hebben met nauwkeurige tijdwaarden, ongeacht hoe ze visueel worden weergegeven.
Hoewel de client-side component de tijd weergeeft met behulp van de browser-locale van de gebruiker, is het geparseerde en opgeslagen formaat altijd gestandaardiseerd als HH:mm:ss.
Als je een ruwe tekenreekswaarde instelt, gebruik dan de setText() methode voorzichtig:
timeField.setText("09:15:00"); // geldig
Wanneer je de setText() methode gebruikt, wordt er een IllegalArgumentException opgegooid als de component de invoer niet kan parseren in het HH:mm:ss formaat.
De uitstraling van de tijdkiezer invoerinterface hangt niet alleen af van de geselecteerde locale, maar ook van de browser en het besturingssysteem dat wordt gebruikt. Dit zorgt voor automatische consistentie met de interface waar gebruikers al mee bekend zijn.
Statische hulpprogramma's
De TimeField klasse biedt ook de volgende statische hulpprogramma-methoden:
-
fromTime(String timeAsString): Converteer een tijdstring in HH:mm:ss formaat naar eenLocalTimeobject dat vervolgens met deze klasse of elders kan worden gebruikt. -
toTime(LocalTime time): Converteer eenLocalTimenaar een tijdstring in HH:mm:ss formaat. -
isValidTime(String timeAsString): Controleer of de gegeven string een geldige HH:mm:ss tijd is. Dit retourneert een boolean waarde true als dat zo is, false anders.
Beste praktijken
-
Bied duidelijke voorbeelden van tijdformaten: Toon gebruikers duidelijk het verwachte tijdformaat nabij de
TimeField. Gebruik voorbeelden of plaatsaanduidingen om hen te helpen de tijd correct in te voeren. Als het mogelijk is, toon dan het tijdformaat op basis van de locatie van de gebruiker. -
Toegankelijkheid: Gebruik de
TimeFieldcomponent met toegankelijkheid in gedachten, en zorg ervoor dat deze voldoet aan toegankelijkheidsnormen zoals het bieden van juiste labels, voldoende kleurcontrast en compatibiliteit met ondersteunende technologieën. -
Resetoptie: Bied een manier voor gebruikers om de
TimeFieldgemakkelijk leeg of op de standaardstatus terug te zetten.