Kentät
webforJ-kehys tukee yksitoista eri kenttäkomponenttityyppiä, mukaan lukien neljä maskattua kenttää, joilla on erilaisia käyttäytymisiä ja toteutuksia, jotka sopivat erilaisiin syöttötarpeisiin. Vaikka jokaisella näistä komponenteista on eroja toteutuksissaan, tämä artikkeli kuvaa yhteiset ominaisuudet kaikille kenttäluokille.
Tässä osiossa kuvataan monien kenttäkomponenttien yleisiä ominaisuuksia webforJ:ssä, ja se ei itsessään ole luokka, jota voidaan instansioida ja käyttää.
Yhteiset kenttäominaisuudet
Otsikko
Kenttäotsikko on kuvaileva teksti tai nimike, joka liittyy kenttään ja jonka voi määrittää konstruktiossa tai käyttämällä setLabel()-menetelmää. Otsikot tarjoavat lyhyen selityksen tai vihjeen, joka auttaa käyttäjiä ymmärtämään kyseisen kentän tarkoitusta tai odotettua syötettä. Kenttäotsikot ovat tärkeitä käytettävyyden kannalta ja niillä on keskeinen rooli saavutettavuudessa, sillä ne mahdollistavat ruudunlukijoiden ja apuvälineiden tarjoavan tarkkaa tietoa ja helpottavan näppäimistön navigointia.
Aputeksti
Jokainen kenttä voi näyttää aputekstiä syötteen alapuolella käyttämällä setHelperText()-menetelmää. Tämä aputeksti tarjoaa lisäkontekstia tai selityksiä käytettävissä olevista syötteistä varmistaen, että käyttäjillä on tarvittavat tiedot harkittujen valintojen tekemiseksi.
Pakollinen
Voit kutsua setRequired(true)-menetelmää vaatiaksesi, että käyttäjä antaa arvon ennen lomakkeen lähettämistä. Tämä ominaisuus toimii yhdessä kenttäotsikon kanssa, tarjoten visuaalisen indikaation siitä, että kenttä on välttämätön. Tämä visuaalinen vihje auttaa yksilöitä täyttämään lomakkeita tarkasti.
Kenttäkomponentit sisältävät sisäänrakennettua visuaalista validoimista ilmoittaakseen käyttäjille, kun pakollinen kenttä on tyhjää tai jos käyttäjä on poistanut arvon.
Oikoluku
Käyttämällä setSpellCheck(true) voit sallia selaimen tai käyttäjäagentin tarkistaa syötetyn tekstin oikeinkirjoituksen ja tunnistaa mahdolliset virheet.
Etuliite ja pääte
Slotit tarjoavat joustavia vaihtoehtoja kenttäkomponenttien kyvykkyyden parantamiseksi. Voit liittää kentän sisään kuvakkeita, otsikoita, latauspyörijöitä, tyhjennys/palautusmahdollisuuksia, avatar/profiilikuvia ja muita hyödyllisiä komponentteja, jotta käyttäjille selvennetään aikomuksia. Kentillä on kaksi slotia: prefix ja suffix -slotit. Käytä setPrefixComponent() ja setSuffixComponent() -menetelmiä eri komponenttien lisäämiseksi näyttövalinnan eteen ja taakse kentässä. Tässä on esimerkki TextField-kentän käytöstä:
TextField textField = new TextField();
textField.setPrefixComponent(TablerIcon.create("box"));
textField.setSuffixComponent(TablerIcon.create("box"));
Tyylitys
Koska kaikki kenttäkomponentit on rakennettu yhdestä verkkokomponentista, ne jakavat kaikki seuraavat Shadow Parts ja CSS-ominaisuusasetukset.
Aiheet
Maskeeratut kentät
4 kohdetta
ColorField
A component that provides a default browser-based color picker, allowing users to select a color from an input field.
DateField
A component that provides a default browser-based date picker for selecting a date through an input field.
DateTimeField
A component that provides a default browser-based date and time picker for selecting both date and time through a single input field.
NumberField
A component that provides a default browser-based input field for entering numeric values, with built-in controls for incrementing or decrementing the value.
PasswordField
A single-line input component for securely entering and masking password data.
TextField
A single-line input component for entering and editing text data.
TimeField
A component that provides a default browser-based time picker for selecting a time value through an input field.
