accept
Voimassa vain syötetyypille file, attribuutti accept määrittelee, mitkä tiedostotyypit ovat valittavissa file -lataussäätimessä. Katso tiedoston syöttötyyppi.
alt
Voimassa vain image -painikkeessa, alt -attribuutti tarjoaa kuvalle vaihtoehtoisen tekstin, joka näyttää attribuutin arvon, jos kuva src puuttuu tai sitä ei muuten ladata. Katso kuvan syöttötyyppi.
autocomplete
(Ei Boolen-attribuutti!) Määritteen autocomplete arvo otetaan välilyönnillä erotettu merkkijono, joka kuvaa mahdollisen automaattisen täydennyksen toiminnon tyypin, jonka syötteen tulisi tarjota. Tyypillinen automaattisen täydennyksen toteutus palauttaa aikaisemmat arvot, jotka on syötetty samaan syöttökenttään, mutta monimutkaisempia automaattisen täydennyksen muotoja voi olla. Esimerkiksi selain voisi integroida laitteen yhteystietoluetteloon täydentääksesi email osoitteet sähköpostin syöttökenttään. Katso sallitut arvot kohdasta HTML-automaattisen täydennyksen attribuutin arvot.
Attribuutti autocomplete on voimassa hidden, text, search, url, tel, email, date, month, week, time, datetime-local, number, range, color ja password. Tällä attribuutilla ei ole vaikutusta syötetyyppeihin, jotka eivät palauta numeerisia tai tekstitietoja, ja ne ovat kelvollisia kaikille syötetyypeille paitsi checkbox, radio, file tai minkä tahansa painiketyypin.
Katso HTML-automaattisen täydennyksen attribuutti f tai lisätietoja, mukaan lukien tiedot salasanasuojauksesta ja siitä, miten autocomplete on hieman erilainen hidden kuin muilla syötetyypeillä.
autofocus
Boolen attribuutti, joka ilmaisee, että syötteessä tulisi olla automaattisesti kohdistus, kun sivu on latautunut (tai kun <dialog>, joka sisältää elementin, on näytetty).
Huomaa: autofocus -attribuutilla varustettu elementti voi keskittyä ennen DOMContentLoaded -tapahtuma käynnistetään.
Enintään yhdellä asiakirjan elementillä voi olla autofocus -attribuutti. Jos asetetaan useampi kuin yksi elementti, ensimmäinen attribuutilla oleva kohde saa kohdistuksen.
Määritettä autofocus ei voida käyttää syötteisiin, joiden tyyppi on hidden, koska piilotettuja syötteitä ei voida kohdistaa.
Varoitus: Lomakkeen ohjauksen automaattinen tarkentaminen voi hämmentää näkövammaiset ihmiset, jotka käyttävät näytönlukutekniikkaa, ja ihmiset, joilla on kognitiivisia häiriöitä. Kun autofocus on määritetty, näytönlukijat ”teleportoivat” käyttäjänsä lomakekontrolliin varoittamatta heitä etukäteen.
Harkitse esteettömyyttä huolellisesti, kun käyttämällä autofocus -attribuuttia. Automaattinen kohdistaminen hallintalaitteeseen voi aiheuttaa sivun vierityksen latautumisen yhteydessä. Kohdistus voi myös saada dynaamiset näppäimistöt näkymään joissakin kosketuslaitteissa. Vaikka näytönlukija ilmoittaa tarkennuksen vastaanottavan lomakkeen ohjauksen etiketin, näytönlukija ei ilmoita mitään ennen tarraa, ja pienen laitteen näkevä käyttäjä kaipaa myös edellisen sisällön luomaa kontekstia.
capture
Sisällytetty HTML Media Capture -määritykseen ja voimassa vain file -tyyppille, capture -määritelmä määrittää, mitä mediaa – mikrofonia, videota tai kameraa – tulisi käyttää uuden tiedoston sieppaamiseen lähetettäväksi file -latausohjaimella tuetuissa skenaarioissa. Katso tiedoston syöttötyyppi.
checked
Voimassa sekä radio että checkbox tyypit, checked on Boolen määrite. Jos se on radio -tyypissä, se tarkoittaa, että valintanappi on tällä hetkellä valittu samannimisten radiopainikkeiden ryhmässä. Jos se esiintyy checkbox -tyypissä, se tarkoittaa, että valintaruutu on oletusarvoisesti valittu (sivun latautumisen yhteydessä). Se ei osoita, onko tämä valintaruutu valittu tällä hetkellä: jos valintaruudun tilaa muutetaan, tämä sisältömääritelmä ei heijasta muutosta. (Vain HTMLInputElement s checked IDL-attribuutti päivitetään.)
Huomaa: Toisin kuin muut syöttösäätimet, valintaruudut ja valintanappien arvo sisältyvät lähetettyihin tietoihin vain, jos ne ovat tällä hetkellä checked. Jos on, tarkistettujen ohjausobjektien nimi ja arvo lähetetään.
Esimerkiksi, jos valintaruutu, jonka name on fruit -kohdassa value on cherry ja valintaruutu on valittuna. Lähetetyt lomaketiedot sisältävät fruit=cherry. Jos valintaruutu ei ole aktiivinen, sitä ei ole lainkaan luettelossa lomaketiedoissa. Oletusarvoinen value valintaruutuille ja valintanäppäimille on on.
dirname
Voimassa vain text – ja search -tyypeille, dirname attribuutti mahdollistaa elementin suuntaviivan lähettämisen. Kun lomake sisältyy, se lähettää kaksi nimi / arvo-paria: ensimmäinen on name ja value, toinen on arvo dirname nimeksi, jonka arvo on ltr tai rtl, selain.
Kun yllä oleva lomake lähetetään, syöte aiheuttaa sekä name / value fruit=cherry ja lähetettävä dirname / suunta-pari fruit.dir=ltr.
disabled
Boolen attribuutti, joka ilmaisee, että käyttäjän ei pitäisi voida olla vuorovaikutuksessa syötteen kanssa, jos se on olemassa. Poistetut tulot renderoidaan yleensä himmentimellä tai käyttämällä jotakin muuta ilmaisua siitä, että kenttää ei ole käytettävissä.
Erityisesti käytöstä poistetut tulot eivät vastaanota click -tapahtuma, ja käytöstä poistettuja syötteitä ei lähetetä lomakkeen mukana.
Huomaa: Vaikka spesifikaatio ei vaadi sitä, Firefox säilyttää oletusarvoisesti <input> sivun lataamisen aikana. Käytä tätä ominaisuutta autocomplete -attribuutilla.
form
Merkkijono, joka määrittelee <form> elementti, johon syöte on liitetty (ts. Sen lomakkeen omistaja). Jos tämän merkkijonon arvon on oltava, sen on vastattava saman asiakirjan id -elementin <form> -elementtiä. Jos tämä attribuutti ei ole t määritetty, <input> -elementti liitetään lähimpään mahdolliseen sisältävään lomakkeeseen.
Määritteen form avulla voit sijoita syöte mihin tahansa asiakirjaan, mutta lisää se lomakkeen muualle asiakirjaan.
Huomaa: Syöttö voidaan liittää vain yhteen lomakkeeseen. div id = ”d4a3166041”>
Voimassa vain tulotyypeille image ja submit. Katso lisätietoja syöttötyypistä.
formenctype
Voimassa image ja iv id = ”086d1dbb18 Vain ”” -tyypit. Katso lisätietoja syöttötyypistä.
formmethod
Voimassa image – ja iv id = ”086d1dbb18 Vain ”” -tyypit. Katso lisätietoja syöttötyypistä.
formnovalidate
Voimassa image – ja iv id = ”086d1dbb18 Vain ”” -tyypit. Katso lisätietoja syöttötyypistä.
formtarget
Voimassa image – ja iv id = ”086d1dbb18 Vain ”” -tyypit. Katso lisätietoja syöttötyypistä.
height
Voimassa vain syöttöpainikkeella image, height on näytettävän kuvatiedoston korkeus, joka edustaa graafista lähetyspainiketta. Katso kuvan syötetyyppi.
id
Kaikille elementeille, myös kaikille syötetyypeille, voimassa oleva globaali attribuutti määrittelee yksilöllisen tunnisteen (ID), jonka on oltava yksilöllinen koko asiakirjassa. Sen tarkoituksena on tunnistaa elementti linkitettäessä. Arvoa käytetään <label> ”s for -attribuutin arvona linkitettäessä tarra lomakkeen ohjausobjektiin. Katso <label>.
inputmode
Kaikille elementeille kelvollinen globaali arvo, se antaa selaimille vihjeen virtuaalisen näppäimistön kokoonpanotyypistä Käytä tätä elementtiä tai sen sisältöä muokatessasi. Arvot sisältävät none, text, tel, url, email, numeric, decimal ja search.
list
list -attribuutille annettavan arvon tulisi olla id samassa asiakirjassa sijaitsevasta <datalist> -elementistä. <datalist> tarjoaa luettelon ennalta määritetyistä arvoista, joita käyttäjä voi ehdottaa tälle syötteelle. Luettelon arvot, jotka eivät ole yhteensopivia type kanssa, eivät sisälly ehdotettuihin vaihtoehtoihin. Annetut arvot ovat ehdotuksia, ei vaatimuksia: käyttäjät voivat valita tämän ennalta määritetyn luettelon tai antaa toisen arvon.
Se on voimassa text, search, url, tel, email, date, month, week, time, datetime-local, number, range ja color.
Määritelmien mukaan list -määritettä ei tueta hidden, password, checkbox, radio, file tai mikä tahansa
Selaimesta riippuen käyttäjä voi nähdä mukautetun väripaletin, tic-merkkejä alueen sisällä tai jopa syötteen, joka avautuu kuten <select> mutta sallii luetteloimattoman va lues. Katso selaimen yhteensopivuustaulukko muista syötetyypeistä.
Katso <datalist> -elementti.
max
Voimassa date, month, week, time, datetime-local, number ja range, se määrittelee suurin arvo sallittujen arvojen alueella. Jos elementtiin syötetty value ylittää tämän, elementti epäonnistuu rajoituksen tarkistuksessa. Jos max -attribuutin arvo ei ole ”ta” -numero, elementillä ei ole enimmäisarvoa.
On erityistapaus: jos tietotyyppi on jaksollinen (kuten päivämäärille tai kellonajoille) arvo max voi olla pienempi kuin arvon min arvo, mikä osoittaa, että alue voi olla kiertää; esimerkiksi tämän avulla voit määrittää ajanjakson klo 22.00–4.00.
maxlength
Voimassa osoitteessa text, search, url, tel, email ja password, se määrittelee enimmäismerkkimäärän (UTF-16-koodiyksikköinä), jonka käyttäjä voi syöttää kenttään. Tämän on oltava kokonaislukuarvo 0 tai uudempi. Jos maxlength -arvoa ei määritetä, kentässä ei ole enimmäispituutta. Tämän arvon on myös oltava olla suurempi tai yhtä suuri kuin arvo
Syöttö epäonnistuu rajoitusten tarkistuksessa, jos kenttään syötetyn tekstin pituus on suurempi kuin maxlength UTF-16-koodiyksiköt pitkä. Oletuksena selaimet estävät käyttäjiä syöttämästä enemmän merkkejä kuin maxlength -määritteessä sallitaan. Katso lisätietoja kohdasta Asiakaspuolen vahvistus.
min
Voimassa date, month, week, time, datetime-local, number ja range, se määrittelee negatiivisimman arvon sallittujen arvojen alueella. Jos elementtiin syötetty value on tätä pienempi, elementti epäonnistuu rajoituksen tarkistuksessa. Jos min -attribuutin arvo ei ole ”ta” -numero, elementillä ei ole vähimmäisarvoa.
Tämän arvon on oltava pienempi tai yhtä suuri kuin max -attribuutti. Jos min -attribuutti on olemassa, mutta sitä ei ole määritelty tai se on virheellinen, ei min -arvo on käytössä. Jos min -määrite on kelvollinen ja tyhjä arvo on pienempi kuin min sallima attribuutti, rajoituksen vahvistus estää lomakkeen lähettämisen. Katso lisätietoja kohdasta Asiakaspuolen vahvistus.
On erityistapaus: jos tietotyyppi on jaksollinen (kuten päivämäärien tai aikojen osalta), arvon max voi olla pienempi kuin arvon min arvo, mikä osoittaa, että alue voi kiertyä; esimerkiksi tämän avulla voit määrittää ajan vaihtelevat kello 22.00–4.00.
minlength
Voimassa text, search, url, tel, email ja password, se määrittää merkkien vähimmäismäärän (UTF-16-koodiyksiköinä), jonka käyttäjä voi syöttää syöttökenttään. Tämän on oltava ei-negatiivinen kokonaislukuarvo, joka on pienempi tai yhtä suuri kuin maxlength määritetty arvo. Jos minlength -vaihtoehtoa ei määritetä tai virheellinen arvo on määritetty, syötteellä ei ole vähimmäispituutta.
Syöttö epäonnistuu rajoitusten tarkistuksessa, jos tekstin pituus kenttään syötetty pituus on alle minlength UTF-16-koodiyksikköä pitkä, mikä estää lomakkeen lähettämisen. Katso lisätietoja kohdasta Asiakaspuolen vahvistus.
multiple
Totuusarvoinen multiple -attribuutti tarkoittaa käyttäjää voi kirjoittaa pilkuilla erotettuja sähköpostiosoitteita sähköposti-widgetiin tai valita useamman kuin yhden tiedoston file -syötöllä. Katso sähköpostin ja tiedoston syöttötyyppi.
name
Merkkijono, joka määrittää nimen syötteelle. Tämä nimi lähetetään ohjausobjektin arvon mukana, kun lomaketiedot lähetetään.
Mitä nimessä
Harkitse name vaadittu attribuutti (vaikka se ei olisikaan). Jos syötteelle ei ole määritetty name tai name on tyhjä, syötteen arvoa ei lähetetä lomakkeen mukana! (Estettyjä ohjaimia, valitsemattomia valintanappeja, valitsemattomia valintaruutuja ja nollauspainikkeita ei myöskään lähetetä.)
On olemassa kaksi erikoistapausta:
-
_charset_: Jos sitä käytetään piilotetun<input>-elementin nimellä, syötteen ”svalueasetus on automaattisesti käyttäjän agentti merkkikoodaukseen, jota käytetään lomakkeen lähettämiseen. -
isindex: Historiallisista syistä nimiisindexei ole sallittu.
nimi ja valintanapit
Attribuutti name luo ainutlaatuisen käyttäytymisen radiopainikkeille.
Vain yksi radiopainike samannimisessä radiopainikeryhmässä voidaan tarkistaa kerrallaan. Minkä tahansa ryhmän valintanapin valitseminen poistaa automaattisesti valinnan saman ryhmän valintanapista. että yksi valittu valintanappi lähetetään nimen mukana, jos lomake lähetetään,
Kun välilehtiä samaan sarjaan -nimetty ryhmä radiopainikkeita, jos yksi on valittu, se saa kohdistuksen. Jos heitä ei ole ryhmitelty lähdekoodijärjestyksessä, jos jokin ryhmästä on valittu, välilehtien lisääminen ryhmään alkaa, kun ryhmän ensimmäinen esiintyy, ohittaen kaikki ne, joita ei ole valittu. Toisin sanoen, jos jokin on valittu, välilehti ohittaa ryhmän tarkistamattomat valintanapit. Jos mikään ei ole valittuna, valintanappiryhmä saa kohdistuksen, kun saman nimiryhmän ensimmäinen painike saavutetaan.
Kun jokin ryhmän valintanäppäimistä on kohdennettu, nuolinäppäimillä navigoidaan läpi kaikki samannimiset radiopainikkeet, vaikka valintanäppäimiä ei ole ryhmitelty yhteen lähdekoodijärjestyksessä.
HTMLFormElement.elements
Kun syöttöelementille annetaan name, tästä nimestä tulee omistavan lomake-elementin ”s HTMLFormElement.elements ominaisuus. Jos sinulla on syöte, jonka name -asetuksena on guest ja toinen, jonka name on hat-size, seuraava koodi voidaan käyttää:
Kun tämä koodi on suoritettu, guestName on HTMLInputElement kentälle guest ja hatSize objektille hat-size -kenttä.
Varoitus: Vältä antamasta muotoelementeille name, joka vastaa lomakkeen sisäänrakennettua ominaisuutta, koska ohittaisit ennalta määritetyn ominaisuuden tai menetelmän tällä viitteellä vastaavaan tuloon.
pattern
Määritelmä pattern on määritelty säännöllinen lauseke, jonka syötteen ”s value on oltava sama, jotta arvo läpäisee rajoituksen tarkistuksen. Sen on oltava kelvollinen JavaScript-säännöllinen lauseke, jota RegExp -tyyppi käyttää, ja kuten säännöllisten lausekkeiden oppaassamme on dokumentoitu; "u" -lippu määritetään säännöllistä lauseketta koottaessa, joten kuviota käsitellään Unicode-koodipisteiden sarjana ASCII: n sijaan. Kaavion tekstin ympärille ei tule määrittää eteenpäin viivoja.
Jos pattern -attribuutti on olemassa, mutta sitä ei ole määritelty tai se on virheellinen, säännöllistä lauseketta ei käytetä ja tämä määritettä ohitetaan kokonaan.Jos malli-attribuutti on kelvollinen ja ei-tyhjä arvo ei vastaa mallia, rajoituksen vahvistus estää lomakkeen lähettämisen.
Vinkki: Jos käytät pattern attribute, kerro käyttäjälle odotetusta muodosta lisäämällä selittävä teksti lähelle. Voit myös sisällyttää title -attribuutin selittämään, mitkä vaatimukset vaatimuksen on vastattava mallia; useimmat selaimet näyttävät tämän otsikon työkaluvinkkinä. Esteettömyys edellyttää näkyvää selitystä. Työkaluvinkki on parannus.
Katso lisätietoja kohdasta Asiakaspuolen vahvistus.
placeholder
placeholder -attribuutti on merkkijono, joka antaa käyttäjälle lyhyen vihjeen siitä, millaista tietoa kentässä odotetaan. Sen pitäisi olla sana tai lyhyt lause, joka antaa vihjeen odotetusta tietotyypistä, ei selityksen tai kehotteen. Teksti ei saa sisältää rivinvaihtoa tai rivinvaihtoa. Joten jos esimerkiksi kentän odotetaan kaappaavan käyttäjän etunimen ja sen tunniste on ”Etunimi”, sopiva paikkamerkki voi olla ”esim. Mustafa ”.
Huomaa: placeholder -attribuutti ei ole semanttisesti hyödyllinen kuin muut tapat selittää lomakkeesi, ja se voi aiheuttaa odottamattomia teknisiä ongelmia sisältöä. Katso lisätietoja kohdasta < input >: Tarrat (Lomakkeen syöttö) -elementit.
readonly
Boolen attribuutti, joka jos se on olemassa, osoittaa, että käyttäjän ei pitäisi voida muokata syötteen arvoa. readonly -määritettä tuetaan text, search, url, tel, email, date, month, week, time, datetime-local, number ja password -tyypit.
Katso lisätietoja HTML-määritteestä: readonly.
required on Boolen määrite, joka ilmaisee, että käyttäjän on määritettävä syötteelle arvo ennen omistavan lomakkeen lähettämistä. required -attribuuttia tukee text, search, url, tel, email, date, month, week, time, datetime-local, number, password, checkbox, radio ja file -syötteet.
Katso lisätietoja asiakaspuolen tarkistuksesta ja HTML-määritteestä: required.
sizeVoimassaemail,password,tel– jatextinput-tyypit. Määrittää kuinka paljon syötteestä näytetään. Luo periaatteessa saman tuloksen kuin asettamalla CSSwidth-ominaisuus muutamalla erikoisuudella. Arvon todellinen yksikkö riippuu syötetyypistä.passwordjatext, se on merkkien määrä (taiemyksikköä) oletusarvo20, ja muille se onpixels. CSS-leveys on etusijalla kokomääritteeseen nähden.src
Voimassa vain syöttöpainikkeella image, src merkkijono määrittelee näytettävän kuvatiedoston URL-osoite, joka edustaa graafista lähetyspainiketta. Katso kuvan syöttötyyppi.
step
Voimassa numeerisille syöttötyypeille, mukaan lukien number, päivämäärä / time-syötetyypit ja range, step -attribuutti on luku, joka määrittää tarkkuuden, jota arvon on noudatettava.
Ellei sitä nimenomaisesti sisällytetä:
-
stepoletusarvoisestinumberjarange. - Päivämäärä / aika-syötetyypeille
stepilmaistaan sekunteina, oletusvaihe on 60 sekuntia . Vaiheasteikko on 1000 (joka muuntaa sekunnit millisekunteiksi, kuten muissa algoritmeissa käytetään).
Arvon on oltava positiivinen luku – kokonaisluku tai kelluva – tai erityisarvo any, mikä tarkoittaa, että askelia ei tarkoiteta, ja mikä tahansa arvo on sallittu (estäen muita rajoituksia, kuten min ja max).
Jos any ei ole määritelty yksiselitteisyydeksi, kelvolliset arvot number: lle, päivämäärä / aika-syötetyypeille ja range -tulotyypit ovat yhtä suuret kuin perustan astumiselle – min -arvolle ja askelarvon lisäyksille -arvo, jos määritetty.
Jos sinulla on esimerkiksi <input type="number" min="10" step="2">, sitten mikä tahansa parillinen kokonaisluku, 10 tai uudempi, on kelvollinen. Jos se jätetään pois, <input type="number">, mikä tahansa kokonaisluku on kelvollinen, mutta kelluvat (kuten 4.2) eivät kelpaa, koska step oletuksena 1. Jotta 4.2 olisi kelvollinen, step olisi pitänyt asettaa arvoon any, 0,1 , 0,2 tai minkä tahansa min -arvon olisi pitänyt olla numero, joka päättyy .2, kuten <input type="number" min="-5.2">
Huomaa: Kun käyttäjän syöttämät tiedot eivät noudata vaiheistuskokoonpanoa, arvoa pidetään virheellisenä kilpailun tarkistuksessa ja se vastaa arvoa :invalid näennäisluokka.
Katso lisätietoja kohdasta Asiakaspuolen vahvistus.
tabindex
Kaikille elementeille, myös kaikille syötetyypeille, voimassa oleva globaali attribuutti, kokonaislukuattribuutti, joka ilmoittaa, voiko elementti kohdistaa syötteen (on kohdennettavissa), jos sen pitäisi osallistua peräkkäiseen näppäimistön navigointiin. Kuten kaikki syöttötyypit paitsi tyypin syöttö piilotettu ovat kohdennettavissa, tätä attribuuttia ei tule käyttää lomakeohjaimissa, koska se edellyttäisi fokuksen hallintaa tilaamme asiakirjan kaikki elementit, mikä saattaa vaarantaa käytettävyyden ja käytettävyyden, jos se tehdään väärin.
title
Kaikille elementeille, myös kaikille syötetyypeille, voimassa oleva globaali attribuutti , joka sisältää tekstiä, joka kuvaa neuvoa-antavaa tietoa elementistä, johon se kuuluu. Tällaiset tiedot voidaan tyypillisesti, mutta ei välttämättä, esittää käyttäjälle työkaluvinkkinä. Otsikkoa EI saa käyttää lomakesäätimen tarkoituksen ensisijaisena selityksenä. Käytä sen sijaan <label> -elementtiä, jonka for -attribuutti on asetettu muodon ohjausobjektille ”s id attribute. Katso alla olevat tarrat.
type
Merkkijono, joka määrittää renderöidyn tyypin. Esimerkiksi valintaruudun luomiseksi arvo checkbox käytetään. Jos se jätetään pois (tai arvo määritetään tuntemattomaksi), käytetään syötetyyppiä text, mikä luo selkeän tekstikentän.
Sallitut arvot on lueteltu yllä olevissa <input> -tyypeissä.
value
Tulo-ohjaimen arvo. Kun HTML-koodi on määritetty, tämä on alkuarvo, ja siitä lähtien sitä voidaan muuttaa tai noutaa milloin tahansa käyttämällä JavaScriptiä pääsemään vastaavaan HTMLInputElement -objektiin ”s value -ominaisuus. value -attribuutti on aina valinnainen, vaikka sitä tulisi pitää pakollisena checkbox, radio ja hidden.
width
Voimassa image -näppäin, width on näytettävän kuvatiedoston leveys edustamaan graafista lähetyspainiketta. Katso kuvan syöttötyyppi.