TimeField

Avaa ChatGPT:ssä

Varjo dwc-field 23.02

Java API

TimeField on käyttöliittymäkomponentti, joka mahdollistaa käyttäjien ajan syöttämisen tai valitsemisen tunti-minuutti-tarkkuudella. Jos sekunnit annetaan, komponentti hylkää ne.

Käyttö 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 laajentaa jaettua Field-luokkaa, joka tarjoaa yleisiä ominaisuuksia kaikille kenttäkomponenteille. Seuraava esimerkki luo muistutuksen TimeField, joka on alustettu nykyiseen aikaan.

Käyttötarkoitukset

TimeField on ihanteellinen ajan valitsemiseen ja esittämiseen sovelluksessasi. Tässä on joitakin esimerkkejä siitä, milloin käyttää TimeField-komponenttia:

1. Tapahtumien Aikatauluttaminen: Aikakentät ovat olennaisia sovelluksissa, jotka sisältävät aikojen asettamisen tapahtumille, tapaamisille tai kokouksille.

2. Ajan Seuranta ja Kirjaaminen: Aikojen seurantaan, kuten työtunteihin, tarvitaan aikakenttiä tarkkojen tietojen syöttämiseen.

3. Muistutukset ja Hälytykset: Aikakentän käyttö yksinkertaistaa syöttöprosessia käyttäjille, jotka asettavat muistutuksia tai hälytyksiä sovelluksessasi.

Minimija maksimiarvo

setMin()- ja setMax()-metodien avulla voit määrittää hyväksyttävien aikojen alueen.

• setMin()-metodille: Jos komponenttiin syötetty arvo on aikaisempi kuin määritetty minimiaika, komponentti epäonnistuu rajoitusvalidoinnissa. Kun sekä min- että max-arvot on asetettu, minimiajan on oltava sama tai aikaisempi kuin maksimiaika.

• setMax()-metodille: Jos komponenttiin syötetty arvo on myöhäisempi kuin määritetty maksimiaika, komponentti epäonnistuu rajoitusvalidoinnissa. Kun sekä min- että max-arvot on asetettu, maksimiajan on oltava sama tai myöhäisempi kuin minimaika.

Arvon käsittely ja lokalisointi

Sisäisesti TimeField-komponentti edustaa arvoaan käyttäen LocalTime-objektia java.time-paketista. Tämä mahdollistaa kehittäjille vuorovaikuttaa tarkkojen aikojen kanssa riippumatta siitä, miten ne näytetään visuaalisesti.

Selaimen perusteella valitaan, miten valitsija esittää ajan käyttäjän paikallisessa ympäristössä. Kentän tekstiarvo käyttää 24 tunnin HH:mm-muotoa, ja sen LocalTime-arvo on katkaistu minuutteihin.

Jos asetat raakatekstiarvon, käytä setText()-metodia huolellisesti:

timeField.setText("09:15");    // kelpaa
timeField.setText("09:15:30"); // myös kelpaa; sekunnit hylätään, jää vain 09:15

varoitus

Kun käytät setText(), IllegalArgumentException heitetään, jos syötettä ei voida jäsentää kelvolliseksi ajaksi. Sekä HH:mm- että HH:mm:ss-syötteet hyväksytään, mutta sekunnit hylätään.

Valitsijan käyttöliittymä

Ajanvalitsijan syöttöliittymän ulkonäkö riippuu valitusta paikallisesta ympäristöstä, selaimesta ja käyttöjärjestelmästä. Tämä luo automaattista yhtenäisyyttä käyttöliittymän kanssa, johon käyttäjät ovat jo tottuneet.

Staattiset työkaluohjelmat

TimeField-luokka tarjoaa myös seuraavat staattiset työkalumetodit:

• fromTime(String timeAsString): Jäsentää aikatekstin, sekunnit mukaan lukien tai ilman, LocalTime-objektiksi, joka on katkaistu minuutteihin.

• toTime(LocalTime time): Muuntaa LocalTime-objektin merkkijonoksi HH:mm-muodossa, hyläten sekunnit.

• isValidTime(String timeAsString): Tarkistaa, onko aikamerkkijono kelvollinen, mukaan lukien HH:mm- ja HH:mm:ss-syötteet. Palauttaa true, jos se on kelvollinen, ja false muuten.

Parhaat käytännöt

• Tarjoa Selkeät Aikamuotoesimerkit: Näytä käyttäjille selvästi odotettu aikamuoto lähellä TimeField-komponenttia. Käytä esimerkkejä tai paikkamerkkejä auttaaksesi heitä syöttämään ajan oikein. Jos mahdollista, näytä aikamuoto käyttäjän sijainnin mukaan.

• Esteettömyys: Käytä TimeField-komponenttia esteettömyys mielessä pitäen, noudattaen esteettömyysstandardeja, kuten asianmukaisia etikettejä, riittävää värieroa ja yhteensopivuutta apuvälineiden kanssa.

• Nollausvaihtoehto: Tarjoa tapa käyttäjille tyhjentää TimeField helposti tyhjään tai oletustilaan.

Jatka oppimista

ArtikkeliInput masks in Java: phone, currency, and date fields