<input>: ievades (veidlapas ievades) elements
<input> veidi:
Tas, kā <input> darbojas, ievērojami atšķiras atkarībā no tā tipa atribūta vērtības, tāpēc dažādie veidi ir aplūkoti atsevišķās atsauces lapās. Ja šis atribūts nav norādīts, noklusējuma veids ir teksts.
Pieejamie veidi ir šādi:
Type | Description | Basic Examples |
---|---|---|
button | Spiedpoga bez noklusējuma darbības, kas parāda vērtības atribūta vērtību, pēc noklusējuma tukša. | |
checkbox | Izvēles rūtiņa, kas ļauj atlasīt vai noņemt atlasi atsevišķas vērtības. | |
color | Kontrole krāsas norādīšanai; atverot krāsu atlasītāju, kad tas ir aktīvs pārlūkprogrammu atbalstam. | |
date | Vadlīnija datuma (gads, mēnesis un diena, bez laika) ievadīšanai. Atver datuma atlasītāju vai ciparu atlasi gadam, mēnesim vai dienai, kad tas ir aktīvs pārlūkprogrammu atbalstam. | |
datetime-local | Vadlīnija datuma un laika ievadīšanai bez laika joslas. Atver datuma atlasītāju vai ciparu atlasi datuma un laika komponentiem, ja tas ir aktīvs pārlūkprogrammu atbalstam. | |
Lauks e-pasta adreses rediģēšanai. Izskatās pēc teksta ievades, taču tam ir validācijas parametri un atbilstoša tastatūra, kas atbalsta pārlūkprogrammas un ierīces ar dinamiskām tastatūrām. | ||
file | Vadība, kas ļauj lietotājam izvēlēties failu. Izmantojiet akceptēt atribūtu, lai definētu failu veidus, kurus vadīkla var atlasīt. | |
hidden | Vadība, kas netiek rādīta, bet kuras vērtība tiek iesniegta serverim. Nākamajā kolonnā ir piemērs, bet tas ir paslēpts! | |
image | Grafiska iesniegšanas poga. Parāda attēlu, ko nosaka src atribūts. Alt atribūts tiek parādīts, ja trūkst attēla src. | |
month | Kontrole mēneša un gada ievadīšanai bez laika joslas. | |
number | Kontrole skaitļa ievadīšanai. Parāda spinneri un pievieno noklusējuma validāciju. Dažās ierīcēs ar dinamiskajām tastatūrām parāda ciparu tastatūru. | |
password | Vienas rindiņas teksta lauks, kura vērtība ir aizklāta. Brīdinās lietotāju, ja vietne nav droša. | |
radio | Radio poga, kas ļauj atlasīt vienu vērtību no vairākām iespējām ar vienu un to pašu nosaukuma vērtību. | |
range | Vadīkla skaitļa ievadīšanai, kura precīza vērtība nav svarīga. Tiek rādīts kā diapazona logrīks, kura noklusējuma vērtība ir vidējā vērtība. Izmanto kopā ar min un max, lai definētu pieņemamo vērtību diapazonu. | |
reset | Poga, kas atiestata veidlapas saturu uz noklusējuma vērtībām. Nav ieteicams. | |
search | Vienas rindiņas teksta lauks meklēšanas virkņu ievadīšanai. Rindas pārtraukumi tiek automātiski noņemti no ievades vērtības. Var ietvert dzēšanas ikonu atbalsta pārlūkprogrammās, ko var izmantot lauka notīrīšanai. Dažās ierīcēs ar dinamiskām tastatūrām tiek rādīta meklēšanas ikona, nevis ievadīšanas taustiņš. | |
submit | Poga, kas iesniedz veidlapu. | |
tel | Vadība tālruņa numura ievadīšanai. Parāda tālruņa tastatūru dažās ierīcēs ar dinamiskām tastatūrām. | |
text | Noklusējuma vērtība. Vienrindas teksta lauks. Rindas pārtraukumi tiek automātiski noņemti no ievades vērtības. | |
time | Vadība laika vērtības ievadīšanai bez laika joslas. | |
url | Lauks URL ievadīšanai. Izskatās pēc teksta ievades, taču tam ir validācijas parametri un atbilstoša tastatūra, kas atbalsta pārlūkprogrammas un ierīces ar dinamiskām tastatūrām. | |
week | Vadlīnija datuma ievadīšanai, kas sastāv no nedēļas gada numura un nedēļas numura bez laika joslas. | |
Novecojušas vērtības | ||
datetime |
Novecojusi Vadlīnija datuma un laika (stunda, minūte, sekunde un sekundes daļa) ievadīšanai, pamatojoties uz UTC laika joslu. |
Atribūti
Elements <input> ir tik spēcīgs tā atribūtu dēļ; type atribūts, kas aprakstīts ar iepriekš minētajiem piemēriem, ir vissvarīgākais. Tā kā katrs elements <input> neatkarīgi no veida ir balstīts uz HTMLInputElement saskarni, tiem tehniski ir tieši tāda pati atribūtu kopa. Tomēr patiesībā lielākā daļa atribūtu ietekmē tikai noteiktu ievades veidu apakškopu. Turklāt veids, kā daži atribūti ietekmē ievadi, ir atkarīgs no ievades veida, dažādos veidos ietekmējot dažādus ievades veidus.
Šajā sadaļā ir sniegta tabula, kurā uzskaitīti visi atribūti ar īsu aprakstu. Šai tabulai seko saraksts, kurā sīkāk aprakstīts katrs atribūts, kā arī ievades veidi, ar kuriem tie ir saistīti. Tie, kas ir kopīgi lielākajai daļai vai visiem ievades veidiem, ir sīkāk definēti tālāk. Atribūti, kas ir unikāli noteiktiem ievades veidiem — vai atribūti, kas ir kopīgi visiem ievades veidiem, bet kuriem ir īpaša darbība, ja tos izmanto konkrētam ievades veidam, — tiek dokumentēti šo tipu lapās.
Elementa <input> atribūti ietver globālos HTML atribūtus un papildus:
Attribūts | Type vai Tipi | Apraksts |
---|---|---|
accept |
fails |
Padoms par paredzamo faila veidu failu augšupielādes vadīklās |
alt |
attēls | alt atribūts attēla tipam. Nepieciešams pieejamībai |
autocomplete |
visi izņemotcheckbox ,radio , un buttons |
Padoms par veidlapu automātiskās aizpildīšanas funkciju |
capture |
fails | Multivides uztveršanas ievades metode failu augšupielādes vadīklās |
checked |
checkbox ,radio |
Vai komanda vai vadīkla ir pārbaudīta |
dirname |
search ,text |
Veidlapas lauka nosaukums, kas jāizmanto elementa virziena nosūtīšanai veidlapas iesniegšanā |
disabled |
visi | Vai veidlapas vadīkla ir atspējota |
form |
visi | Saista vadīklu ar formas elementu |
formaction |
image ,submit |
URL, kas jāizmanto veidlapas iesniegšanai |
formenctype |
image ,submit |
Veidlapas datu kopas kodēšanas veids, ko izmantot veidlapas iesniegšanai |
formmethod |
image ,submit |
HTTP metode, kas jāizmanto veidlapas iesniegšanai |
formnovalidate |
image ,submit |
Apiet veidlapas kontroles validāciju veidlapas iesniegšanai |
formtarget |
image ,submit |
Veidlapas iesniegšanas pārlūkošanas konteksts |
height |
image |
Tāds pats kā augstums atribūtam <img>; vertikālā dimensija |
list |
visi izņemothidden ,password ,checkbox ,radio , un buttons |
Automātiskās pabeigšanas opciju <datalist> atribūta id vērtība |
max |
date ,month ,week ,time ,datetime-local ,number ,range |
Maksimālā vērtība |
maxlength |
text ,search ,url ,tel ,email ,password |
Maksimālais vērtības garums (rakstzīmju skaits). |
min |
date ,month ,week ,time ,datetime-local ,number ,range |
Maksimālā vērtība |
minlength |
text ,search ,url ,tel ,email ,password |
Vērtības minimālais garums (rakstzīmju skaits). |
multiple |
email ,file |
Boolean. Vai atļaut vairākas vērtības |
name |
visi | Veidlapas vadīklas nosaukums. Iesniegts kopā ar veidlapu kā daļa no nosaukuma/vērtības pāra |
pattern |
text ,search ,url ,tel ,email ,password |
Raksts, lai vērtība būtu derīga |
placeholder |
text ,search ,url ,tel ,email ,password ,number |
Teksts, kas tiek rādīts veidlapas vadīklā, ja tam nav iestatīta vērtība |
readonly |
visi izņemot hidden ,range ,color ,checkbox ,radio , and buttons |
Boolean.Teksts, tiek rādīts veidlaps vadīklā, un tam nav kas norādīta vērtība |
required |
visi izņemot hidden ,range ,color , and buttons |
Boolean. Lai veidlapu varētu iesniegt, ir jānorāda vērtība vai jāatzīmē |
size |
text ,search ,url ,tel ,email ,password |
Kontroles izmērs |
src |
image |
Tāds pats kā src atribūts <img>; attēla resursa adrese |
step |
date ,month ,week ,time ,datetime-local ,number ,range |
Derīgas pieauguma vērtības |
type |
visi | Veidlapas kontroles veids |
value |
visi | Vadības elementa sākotnējā vērtība |
width |
image |
Tāds pats kā platuma atribūts <img> |
Pēc standarta atribūtu aprakstiem ir norādīti daži papildu nestandarta atribūti.
Individuālie atribūti
accept
Derīgs tikai faila ievades tipam, atribūts akceptēt nosaka, kuri failu veidi ir atlasāmi faila augšupielādes vadīklā. Skatiet faila ievades veidu.
alt
Derīgs tikai attēla pogai, atribūts alt nodrošina attēla alternatīvu tekstu, parādot atribūta vērtību, ja trūkst attēla src vai to neizdodas ielādēt citādi. Skatiet attēla ievades veidu.
autocomplete
(Nav Būlean atribūts!) Automātiskās pabeigšanas atribūts kā vērtību izmanto ar atstarpi atdalītu virkni, kas apraksta, kāda veida automātiskās pabeigšanas funkcionalitāte ievadei ir jānodrošina. Tipiska automātiskās pabeigšanas ieviešana atsauc atmiņā iepriekšējās vērtības, kas ievadītas tajā pašā ievades laukā, taču var pastāvēt sarežģītākas automātiskās pabeigšanas formas. Piemēram, pārlūkprogramma var integrēties ar ierīces kontaktu sarakstu, lai automātiski aizpildītu e-pasta adreses e-pasta ievades laukā. Atļautās vērtības skatiet automātiskās pabeigšanas sadaļā.
Automātiskās pabeigšanas atribūts ir derīgs slēptajam, tekstam, meklēšanai, url, tel, e-pasta adresei, datumam, mēnesim, nedēļai, laikam, datetime-local, numuram, diapazonam, krāsai un parolei. Šis atribūts neietekmē ievades veidus, kas neatgriež ciparu vai teksta datus, jo tas ir derīgs visiem ievades veidiem, izņemot izvēles rūtiņu, radio, failu vai jebkuru no pogu veidiem.
Skatiet automātiskās pabeigšanas atribūtu, lai iegūtu papildinformāciju, tostarp informāciju par paroles drošību un to, kā automātiskā pabeigšana nedaudz atšķiras no slēptās ievades veida nekā citiem ievades veidiem.
autofocus
Būlean atribūts, kas, ja tāds ir, norāda, ka ievadei ir jābūt automātiski fokusētai, kad lapa ir pabeigusi ielādi (vai kad ir parādīts <dialog>
, kas satur šo elementu).
Piezīme: Elements ar autofokusa atribūtu var tikt fokusēts pirms DOMContentLoaded notikuma aktivizēšanas.
Autofokusa atribūts nedrīkst būt vairāk kā vienam dokumenta elementam. Ja tiek uzlikti vairāki elementi, pirmais ar atribūtu tiek fokusēts.
Autofokusa atribūtu nevar izmantot slēptām ievadēm, jo slēptās ievades nevar fokusēt.
Brīdinājums. Veidlapas vadīklas automātiska fokusēšana var mulsināt cilvēkus ar redzes traucējumiem, kuri izmanto ekrānlasīšanas tehnoloģiju, un cilvēkus ar kognitīviem traucējumiem. Kad ir piešķirts autofokuss, ekrāna lasītāji “teleportē” savu lietotāju uz veidlapas vadīklu, iepriekš nebrīdinot.
Lietojot autofokusa atribūtu, rūpīgi apsveriet pieejamību. Automātiska fokusēšana uz vadīklu var izraisīt lapas ritināšanu ielādes laikā. Fokuss var izraisīt arī dinamisko tastatūru rādīšanu dažās skārienierīcēs. Kamēr ekrāna lasītājs paziņos par fokusa veidlapas vadīklas iezīmi, ekrāna lasītājs neko nepaziņos pirms etiķetes, un redzīgs lietotājs mazā ierīcē tikpat labi nepamanīs kontekstu, ko izveidojis iepriekšējais saturs.
capture
Tveršanas atribūts, kas ir ieviests HTML Media Capture specifikācijā un ir derīgs tikai faila ievades tipam, nosaka, kurš multivides līdzeklis — mikrofons, video vai kamera — ir jāizmanto, lai tvertu jaunu failu augšupielādei ar faila augšupielādes vadību atbalsta scenārijos. Skatiet faila ievades veidu.
checked
Derīgs gan radio, gan izvēles rūtiņām, atzīmēts ir Būlean atribūts. Ja tā ir pieejama radio tipam, tas norāda, ka radiopoga ir pašlaik atlasītā radiopogu grupā ar tādu pašu nosaukumu. Ja tā ir izvēles rūtiņas veidam, tas norāda, ka izvēles rūtiņa ir atzīmēta pēc noklusējuma (lapas ielādes laikā). Tas nenorāda, vai šī izvēles rūtiņa pašlaik ir atzīmēta: ja tiek mainīts izvēles rūtiņas stāvoklis, šis satura atribūts neatspoguļo izmaiņas. (Tiek atjaunināts tikai HTMLInputElement pārbaudītais IDL atribūts.)
Piezīme. Atšķirībā no citām ievades vadīklām, izvēles rūtiņas un radiopogu vērtība tiek iekļauta iesniegtajos datos tikai tad, ja tie pašlaik ir atzīmēti. Ja tā ir, tiek iesniegts pārbaudīto vadīklu nosaukums un vērtība(-s).
Piemēram, ja izvēles rūtiņai, kuras nosaukums ir auglis, ir vērtība ķirsis, un šī izvēles rūtiņa ir atzīmēta, iesniegtajos veidlapas datos būs iekļauts auglis=ķirsis. Ja izvēles rūtiņa nav aktīva, tā vispār nav norādīta veidlapas datos. Ir ieslēgta izvēles rūtiņu un radio pogu noklusējuma vērtība.
dirname
Derīgs tikai teksta un meklēšanas ievades veidiem, atribūts dirname ļauj iesniegt elementa virzienu. Ja veidlapas vadīkla ir iekļauta, tā tiks iesniegta ar diviem nosaukuma/vērtības pāriem: pirmais ir nosaukums un vērtība, otrais ir dirname vērtība kā nosaukums ar ltr vai rtl vērtību, ko iestata pārlūkprogramma.
<form action="lapa.html" method="post">
<label
>Auglis:
<input type="text" name="auglis" dirname="auglis.dir" value="ķirsis" />
</label>
<input type="sūtīt" />
</form>
<!-- lapa.html?auglis=ķirsis&auglis.dir=ltr -->
disabled
Būlean atribūts, kas, ja tāds ir, norāda, ka lietotājam nevajadzētu mijiedarboties ar ievadi. Atspējotās ievades parasti tiek atveidotas ar blāvāku krāsu vai izmantojot kādu citu norādi, ka lauks nav pieejams lietošanai.
Konkrēti, atspējotie ievadi nesaņem klikšķa notikumu, un atspējotie ievadi netiek iesniegti kopā ar veidlapu.
Piezīme. Lai gan specifikācija to neprasa, Firefox pēc noklusējuma saglabās dinamiski atspējotu <input> stāvokli lapas ielādes laikā. Izmantojiet automātiskās pabeigšanas atribūtu, lai kontrolētu šo līdzekli.
form
Virkne, kas norāda <form> elementu, ar kuru ir saistīta ievade (tas ir, tās veidlapas īpašnieks). Šīs virknes vērtībai, ja tāda ir, ir jāatbilst <form> elementa ID tajā pašā dokumentā. Ja šis atribūts nav norādīts, elements <input> tiek saistīts ar tuvāko saturošo formu, ja tāda ir.
Formas atribūts ļauj ievietot ievadi jebkurā dokumentā, bet iekļaut to veidlapā citur dokumentā.
Piezīme. Ievadi var saistīt tikai ar vienu veidlapu.
formaction
Derīgs tikai attēlam un iesniegšanas ievades veidiem.
formenctype
Derīgs tikai attēlam un iesniegšanas ievades veidiem.
formmethod
Derīgs tikai attēlam un iesniegšanas ievades veidiem.
formnovalidate
Derīgs tikai attēlam un iesniegšanas ievades veidiem.
formtarget
Derīgs tikai attēlam un iesniegšanas ievades veidiem.
height
Derīgs tikai attēla ievades pogai. Augstums ir attēla faila augstums, kas jāparāda, lai attēlotu grafisko iesniegšanas pogu. Skatiet attēla ievades veidu.
id
Globālais atribūts, kas ir derīgs visiem elementiem, ieskaitot visus ievades veidus, definē unikālu identifikatoru (ID), kam jābūt unikālam visā dokumentā. Tās mērķis ir identificēt elementu, veidojot saiti. Vērtība tiek izmantota kā atribūta <label> vērtība, lai saistītu etiķeti ar formas vadīklu. Skatiet <label>.
inputmode
ievades režīms
Globālā vērtība, kas derīga visiem elementiem, sniedz pārlūkprogrammām mājienu par virtuālās tastatūras konfigurācijas veidu, kas jāizmanto, rediģējot šo elementu vai tā saturu. Vērtībās ietilpst neviens, teksts, tel, url, e-pasts, skaitļi, decimālzīme un meklēšana.
list
Vērtībai, kas piešķirta saraksta atribūtam, ir jābūt <datalist> elementa ID, kas atrodas tajā pašā dokumentā. <datalist> nodrošina iepriekš definētu vērtību sarakstu, ko ieteikt lietotājam šai ievadei. Visas sarakstā esošās vērtības, kas nav saderīgas ar veidu, nav iekļautas ieteiktajās opcijās. Norādītās vērtības ir ieteikumi, nevis prasības: lietotāji var izvēlēties no šī iepriekš definētā saraksta vai norādīt citu vērtību.
Tas ir derīgs tekstam, meklēšanai, url, tel, e-pasta ziņojumiem, datumam, mēnesim, nedēļai, laikam, datumam un lokālajam, numuram, diapazonam un krāsai.
Saskaņā ar specifikācijām saraksta atribūtu neatbalsta slēptā, parole, izvēles rūtiņa, radio, fails vai kāds no pogu veidiem.
Atkarībā no pārlūkprogrammas lietotājs var redzēt ieteiktu pielāgotu krāsu paleti, atzīmes diapazonā vai pat ievadi, kas tiek atvērta kā <select>, bet ļauj izmantot sarakstā neuzrādītas vērtības. Pārējos ievades veidus skatiet pārlūkprogrammas saderības tabulā.
Skatiet elementu <datalist>.
max
Derīgs datumam, mēnesim, nedēļai, laikam, datetime-local, skaitlim un diapazonam, tas definē lielāko vērtību atļauto vērtību diapazonā. Ja elementā ievadītā vērtība pārsniedz šo vērtību, elementa ierobežojuma validācija neizdodas. Ja atribūta max vērtība nav skaitlis, elementam nav maksimālās vērtības.
Pastāv īpašs gadījums: ja datu tips ir periodisks (piemēram, datumiem vai laikiem), maksimālā vērtība var būt mazāka par min vērtību, kas norāda, ka diapazons var aptvert; piemēram, tas ļauj norādīt laika diapazonu no 22:00 līdz 4:00.
maxlength
Derīgs tekstam, meklēšanai, url, tel, e-pasta adresei un parolei, tas nosaka maksimālo rakstzīmju skaitu (kā UTF-16 koda vienības), ko lietotājs var ievadīt laukā. Tam ir jābūt veselam skaitlim 0 vai lielākai. Ja nav norādīts maksimālais garums vai ir norādīta nederīga vērtība, laukam nav maksimālā garuma. Šai vērtībai arī jābūt lielākai par mingaruma vērtību vai vienādai ar to.
Ievades ierobežojuma validācija neizdosies, ja laukā ievadītā teksta garums ir lielāks par maksimālo UTF-16 koda vienību garumu. Pēc noklusējuma pārlūkprogrammas neļauj lietotājiem ievadīt vairāk rakstzīmju, nekā pieļauj atribūts maxlength. Papildinformāciju skatiet sadaļā Klienta puses validācija.
min
Tas ir derīgs datumam, mēnesim, nedēļai, laikam, datetime-local, skaitlim un diapazonam; tā nosaka visnegatīvāko vērtību atļauto vērtību diapazonā. Ja elementā ievadītā vērtība ir mazāka par šo, elementa ierobežojuma validācija neizdodas. Ja atribūta min vērtība nav skaitlis, elementam nav minimālās vērtības.
Šai vērtībai ir jābūt mazākai par atribūta max vērtību vai vienādai ar to. Ja min atribūts ir, bet nav norādīts vai ir nederīgs, minimālā vērtība netiek lietota. Ja min atribūts ir derīgs un vērtība, kas nav tukša, ir mazāka par minimālo, ko pieļauj atribūts min, ierobežojuma validācija novērsīs veidlapas iesniegšanu. Papildinformāciju skatiet sadaļā Klienta puses validācija.
Pastāv īpašs gadījums: ja datu tips ir periodisks (piemēram, datumiem vai laikiem), maksimālā vērtība var būt mazāka par min vērtību, kas norāda, ka diapazons var aptvert; piemēram, tas ļauj norādīt laika diapazonu no 22:00 līdz 4:00.
minlength
Derīgs tekstam, meklēšanai, url, tel, e-pasta adresei un parolei, tas nosaka minimālo rakstzīmju skaitu (kā UTF-16 koda vienības), ko lietotājs var ievadīt ievades laukā. Tam ir jābūt nenegatīvam veselam skaitlim, kas ir mazāks par vērtību, kas norādīta ar maxlength, vai vienāda ar to. Ja mingarums nav norādīts vai ir norādīta nederīga vērtība, ievadei nav minimālā garuma.
Ievades ierobežojuma validācija neizdosies, ja laukā ievadītā teksta garums ir mazāks par minimālo UTF-16 koda vienību garumu, tādējādi novēršot veidlapas iesniegšanu. Papildinformāciju skatiet sadaļā Klienta puses validācija.
multiple
Būlean vairāku atribūts, ja tas ir iestatīts, nozīmē, ka lietotājs e-pasta logrīkā var ievadīt ar komatu atdalītas e-pasta adreses vai izvēlēties vairāk nekā vienu failu ar faila ievadi. Skatiet e-pasta un faila ievades veidu.
none
Virkne, kas norāda ievades vadīklas nosaukumu. Šis nosaukums tiek iesniegts kopā ar vadīklas vērtību, kad tiek iesniegti veidlapas dati.
Uzskatiet nosaukumu par obligātu atribūtu (lai gan tas tā nav). Ja ievadei nav norādīts nosaukums vai nosaukums ir tukšs, ievades vērtība netiek iesniegta kopā ar veidlapu. (Netiek nosūtītas arī atspējotās vadīklas, neatzīmētās radio pogas, neatzīmētās izvēles rūtiņas un atiestatīšanas pogas.)
Ir divi īpaši gadījumi:
- _charset_: ja tiek izmantots kā slēpta tipa <input> elementa nosaukums, lietotāja aģents automātiski iestata ievades vērtību rakstzīmju kodējumam, kas tiek izmantots veidlapas iesniegšanai.
- isindex: vēsturisku iemeslu dēļ nosaukums isindex nav atļauts.
Atribūts nosaukums rada radiopogām unikālu darbību.
Vienlaicīgi var pārbaudīt tikai vienu radiopogu tāda paša nosaukuma radiopogu grupā. Atlasot jebkuru radiopogu šajā grupā, tiek automātiski atcelta atlase jebkurai pašlaik atlasītajai radiopogai tajā pašā grupā. Šīs vienas atzīmētās radio pogas vērtība tiek nosūtīta kopā ar nosaukumu, ja veidlapa ir iesniegta,
Pārejot uz virkni ar tādu pašu nosaukumu radiopogu grupu, kas ir atzīmēta, tā tiks fokusēta. Ja tie nav sagrupēti kopā avota secībā, ja ir atzīmēta kāda no grupām, cilne grupā sākas, kad tiek sastapta pirmā grupā, izlaižot visus, kas nav atzīmēti. Citiem vārdiem sakot, ja kāds ir atzīmēts, tabulēšana izlaiž grupā neatzīmētās radio pogas. Ja neviens nav atzīmēts, radio pogu grupa tiek fokusēta, kad tiek sasniegta pirmā poga tajā pašā nosaukuma grupā.
Kad viena no grupas radio pogām ir fokusēta, izmantojot bulttaustiņus, tiks pārvietotas visas viena nosaukuma radiopogas, pat ja radio pogas nav sagrupētas avota secībā.
Kad ievades elementam tiek piešķirts nosaukums, šis nosaukums kļūst par veidlapas elementa HTMLFormElement.elements rekvizītu. Ja jums ir ievade, kuras nosaukums ir iestatīts kā viesis, bet cita, kuras nosaukums ir cepures izmērs, var izmantot šādu kodu:
let form = document.querySelector("form");
let guestName = form.elements.guest;
let hatSize = form.elements["hat-size"];
Kad šis kods ir palaists, guestName būs HTMLInputElement viesa laukam un hatSize objekts cepures izmēra laukam.
Brīdinājums. Nepiešķiriet veidlapas elementiem nosaukumu, kas atbilst veidlapas iebūvētajam rekvizītam, jo tad jūs ignorētu iepriekš definēto rekvizītu vai metodi, izmantojot šo atsauci uz atbilstošo ievadi.
pattern
Derīgs tekstam, meklēšanai, url, tel, e-pastam un parolei, modeļa atribūts definē regulāro izteiksmi, kurai ir jāatbilst ievades vērtībai, lai vērtība izturētu ierobežojuma validāciju. Tai ir jābūt derīgai JavaScript regulārai izteiksmei, ko izmanto RegExp tips un kā dokumentēts mūsu regulāro izteiksmju rokasgrāmatā; “u” karodziņš tiek norādīts, kompilējot regulāro izteiksmi, lai modelis tiktu uzskatīts par Unikoda koda punktu secību, nevis kā ASCII. Ap raksta tekstu nedrīkst norādīt uz priekšu vērstas slīpsvītras.
Ja modeļa atribūts ir, bet nav norādīts vai ir nederīgs, regulārā izteiksme netiek lietota un šis atribūts tiek pilnībā ignorēts. Ja modeļa atribūts ir derīgs un vērtība, kas nav tukša, neatbilst modelim, ierobežojuma validācija novērsīs veidlapas iesniegšanu.
Piezīme. Ja izmantojat modeļa atribūtu, informējiet lietotāju par paredzamo formātu, tuvumā iekļaujot paskaidrojošu tekstu. Varat arī iekļaut nosaukuma atribūtu, lai paskaidrotu, kādas ir prasības, lai atbilstu modelim; vairums pārlūkprogrammu šo nosaukumu parādīs kā rīka padomu. Pieejamībai ir nepieciešams redzams paskaidrojums. Rīka padoms ir uzlabojums.
placeholder
Viettura atribūts ir derīgs tekstam, meklēšanai, url, tel, e-pasta adresei, parolei un numuram. Viettura atribūts sniedz lietotājam īsu mājienu par to, kāda veida informācija ir sagaidāma laukā. Tam ir jābūt vārdam vai īsai frāzei, kas sniedz mājienu par paredzamo datu veidu, nevis paskaidrojumu vai uzvedni. Teksts nedrīkst ietvert vagona atgriešanas vai rindu plūsmas. Piemēram, ja laukā ir paredzēts tvert lietotāja vārdu un tā etiķete ir “Vārds”, piemērots vietturis varētu būt “piem., Visvaldis”.
Piezīme. Viettura atribūts nav semantiski tik noderīgs kā citi veidi, kā izskaidrot veidlapu, un tas var izraisīt neparedzētas tehniskas problēmas ar saturu. Plašāku informāciju skatiet sadaļā Etiķetes.
readonly
Būlean atribūts, kas, ja tāds ir, norāda, ka lietotājam nevajadzētu rediģēt ievades vērtību. Tikai lasāmo atribūtu atbalsta teksta, meklēšanas, url, tālruņa, e-pasta, datuma, mēneša, nedēļas, laika, datuma un laika vietējā, numura un paroles ievades veidi.
required
Nepieciešams ir Būlean atribūts, kas, ja tāds ir, norāda, ka lietotājam ir jānorāda ievades vērtība, pirms var iesniegt īpašumtiesību veidlapu. Nepieciešamo atribūtu atbalsta teksts, meklēšana, url, tālrunis, e-pasts, datums, mēnesis, nedēļa, laiks, datums un vietējais, numurs, parole, izvēles rūtiņa, radio un failu ievades.
size
Derīgs e-pastam, parolei, tel, url un tekstam; lieluma atribūts norāda, cik liela daļa ievades tiek parādīta. Pamatā tiek izveidots tāds pats rezultāts kā CSS platuma rekvizīta iestatīšana ar dažām specialitātēm. Faktiskā vērtības vienība ir atkarīga no ievades veida. Parolei un tekstam tas ir rakstzīmju skaits (vai em vienības) ar noklusējuma vērtību 20, bet citiem tas ir pikseļi (vai pikseļu vienības). CSS platumam ir prioritāte pār lieluma atribūtu.
src
Derīga tikai attēla ievades pogai, src ir virkne, kas norāda attēla faila URL, kas jāparāda, lai attēlotu grafisko iesniegšanas pogu. Skatiet attēla ievades veidu.
step
Soļu atribūts ir derīgs datumam, mēnesim, nedēļai, laikam, datetime-local, skaitlim un diapazonam. Step atribūts ir skaitlis, kas norāda precizitāti, kas ir jāievēro vērtībai.
Ja tas nav tieši iekļauts:
step noklusējuma vērtība ir 1 numuram un diapazonam.
Katram datuma/laika ievades veidam ir noklusējuma step vērtība, kas atbilst veidam; skatiet atsevišķas ievades lapas:date
, datetime-local
, month
, time
, un week
..
Vērtībai ir jābūt pozitīvam skaitlim — veselam skaitlim vai peldošajam skaitlim — vai īpašajai vērtībai jebkura, kas nozīmē, ka netiek norādīts solis, un jebkura vērtība ir atļauta (izņemot citus ierobežojumus, piemēram, min
un max
).).
Ja kāda nav skaidri iestatīta, derīgās vērtības skaitļa, datuma/laika ievades veidiem un diapazona ievades veidiem ir vienādas ar soļu bāzi — min
vērtību un soļa vērtības pieaugumu līdz max
vērtībai, ja tā ir norādīta.
Piemēram, ja jums ir
<input type="number" min="10" step="2">
, tad derīgs ir jebkurš pāra vesels skaitlis — 10 vai lielāks. Ja tas ir izlaists,
<input type="number">
, jebkurš vesels skaitlis ir derīgs, bet pludiņi (piemēram, 4.2) nav derīgi, jo darbība pēc noklusējuma ir 1. Lai 4.2 būtu derīga, solis būtu jāiestata uz jebkuru, 0.1. , 0,2 vai jebkurai minimālajai vērtībai bija jābūt skaitlim, kas beidzas ar .2, piemēram,
<input type="number" min="-5.2">
Piezīme. Ja lietotāja ievadītie dati neatbilst soļu konfigurācijai, ierobežojuma validācijā vērtība tiek uzskatīta par nederīgu un atbilst pseidoklasi :invalid.
tabindex
Globālais atribūts, kas derīgs visiem elementiem, tostarp visiem ievades veidiem, vesela skaitļa atribūts, kas norāda, vai elements var fokusēt ievadi (ir fokusējams), vai tam ir jāpiedalās secīgā tastatūras navigācijā. Tā kā visi ievades veidi, izņemot ievades veidu paslēpts, ir fokusējami, šo atribūtu nevajadzētu izmantot veidlapas vadīklās, jo, lai to izdarītu, būtu jāpārvalda fokusa secība visiem dokumenta elementiem, tādējādi radot risku, ka tiks apdraudēta lietojamība un pieejamība. nepareizi.
title
Globālais atribūts, kas derīgs visiem elementiem, tostarp visiem ievades veidiem, satur tekstu, kas atspoguļo konsultatīvu informāciju saistībā ar elementu, kuram tas pieder. Šādu informāciju parasti, bet ne obligāti, var parādīt lietotājam kā rīka padomu. Virsrakstu NEDRĪKST izmantot kā primāro veidlapas vadīklas mērķa skaidrojumu. Tā vietā izmantojiet elementu <label> ar atribūtu for, kas iestatīts uz formas vadīklas id atribūtu. Skatiet tālāk norādītās etiķetes.
type
Virkne, kas norāda atveidojamās vadīklas veidu. Piemēram, lai izveidotu izvēles rūtiņu, tiek izmantota izvēles rūtiņas vērtība. Ja tas ir izlaists (vai ir norādīta nezināma vērtība), tiek izmantots ievades veida teksts, izveidojot vienkārša teksta ievades lauku.
Atļautās vērtības ir norādītas iepriekš sadaļā Ievades veidi.
value
Ievades vadīklas vērtība. Ja tā ir norādīta HTML, tā ir sākotnējā vērtība, un turpmāk to var mainīt vai izgūt jebkurā laikā, izmantojot JavaScript, lai piekļūtu attiecīgā HTMLInputElement objekta vērtības īpašumam. Vērtības atribūts vienmēr ir neobligāts, taču tas ir jāuzskata par obligātu izvēles rūtiņām, radio un slēptajam.
width
Derīgs tikai attēla ievades pogai. Platums ir attēla faila platums, kas jāparāda, lai attēlotu grafisko iesniegšanas pogu. Skatiet attēla ievades veidu.
Nestandarta atribūti
Dažās pārlūkprogrammās ir pieejami arī šādi nestandarta atribūti. Parasti jums vajadzētu izvairīties no to lietošanas, ja vien to nevar palīdzēt.
Attribūts | Apraksts |
---|---|
autocorrect |
Virkne, kas norāda, vai automātiskā labošana ir ieslēgta vai izslēgta. Safari |
incremental |
Vai nosūtīt atkārtotus meklēšanas notikumus, lai atļautu atjaunināt reāllaika meklēšanas rezultātus, kamēr lietotājs joprojām rediģē lauka vērtību. WebKit un Blink tikai (Safari, Chrome, Opera, u.t.t.). |
mozactionhint |
Virkne, kas norāda darbības veidu, kas tiks veikts, kad lietotājs lauka rediģēšanas laikā nospiež taustiņu Enter vai Return. to izmanto, lai noteiktu atbilstošu etiķeti šim taustiņam uz virtuālās tastatūras.
Novecojis: izmanto |
orient |
Iestata diapazona slīdņa orientāciju. Firefox only. |
results |
Maksimālais vienumu skaits, kas jāparāda iepriekšējo meklēšanas vaicājumu nolaižamajā sarakstā. Safari only. |
webkitdirectory |
Boolean norāda, vai ļaut lietotājam izvēlēties tikai direktoriju (vai direktorijus, ja ir arī vairāki) |
autocorrect
(tikai Safari). Virkne, kas norāda, vai aktivizēt automātisko labošanu, kamēr lietotājs rediģē šo lauku. Atļautās vērtības ir:
on
Iespējot automātisku drukas kļūdu labošanu, kā arī teksta aizstāšanas apstrādi, ja tādas ir konfigurētas.
off
Atspējot automātisko labošanu un teksta aizstāšanu.
incremental
Būla inkrementālais atribūts ir WebKit un Blink paplašinājums (tātad to atbalsta Safari, Opera, Chrome utt.), kas, ja tāds ir, liek lietotāja aģentam apstrādāt ievadi kā reāllaika meklēšanu. Lietotājam rediģējot lauka vērtību, lietotāja aģents nosūta meklēšanas notikumus uz HTMLInputElement objektu, kas apzīmē meklēšanas lodziņu. Tas ļauj jūsu kodam atjaunināt meklēšanas rezultātus reāllaikā, kad lietotājs rediģē meklēšanu.
Ja inkrementāls nav norādīts, meklēšanas notikums tiek nosūtīts tikai tad, kad lietotājs tieši sāk meklēšanu (piemēram, lauka rediģēšanas laikā nospiežot taustiņu Enter vai Return).
Meklēšanas notikumam ir ierobežots ātrums, lai tas netiktu nosūtīts biežāk nekā ieviešanas noteiktā intervālā.
orient
Līdzīgi kā -moz-orient nestandarta CSS rekvizīts, kas ietekmē <progress> un <meter> elementus, atribūts orient nosaka diapazona slīdņa orientāciju. Vērtības ietver horizontālo, kas nozīmē, ka diapazons tiek renderēts horizontāli, un vertikāli, kur diapazons tiek renderēts vertikāli.
results
atribūts, ko atbalsta tikai Safari, ir skaitliska vērtība, kas ļauj ignorēt maksimālo ierakstu skaitu, kas jāparāda elementa <input> sākotnēji nodrošinātajā iepriekšējo meklēšanas vaicājumu nolaižamajā izvēlnē.
Vērtībai ir jābūt nenegatīvam decimālskaitlim. Ja tas nav norādīts vai ir norādīta nederīga vērtība, tiek izmantots pārlūkprogrammas noklusējuma maksimālais ierakstu skaits.
webkitdirectory
Nestandarta
Būla tīmekļa komplekta atribūts, ja tāds ir, norāda, ka ir jābūt pieejamiem tikai direktorijiem, kurus lietotājs var atlasīt failu atlasītāja saskarnē. Papildinformāciju un piemērus skatiet HTMLInputElement.webkitdirectory.
Lai gan sākotnēji tas tika ieviests tikai uz WebKit balstītām pārlūkprogrammām, tīmekļa komplektu direktoriju var izmantot arī Microsoft Edge, kā arī Firefox 50 un jaunākās versijās. Tomēr, lai gan tam ir salīdzinoši plašs atbalsts, tas joprojām nav standarta un to nevajadzētu izmantot, ja vien jums nav citas alternatīvas.
Metodes
Tālāk norādītās metodes nodrošina interfeiss HTMLInputElement, kas attēlo <input> elementus DOM. Ir pieejamas arī tās metodes, kuras nosaka vecākinterfeiss — HTMLElement, Element, Node un EventTarget.
pārbaudiet Validity()
Atgriež patieso, ja elementa vērtība iztur derīguma pārbaudes; pretējā gadījumā atgriež false un elementā aktivizē nederīgu notikumu.
reportValidity()
Atgriež patieso, ja elementa vērtība iztur derīguma pārbaudes; pretējā gadījumā atgriež false, elementā aktivizē nederīgu notikumu un (ja notikums netiek atcelts) ziņo par problēmu lietotājam.
select ()
Atlasa visu elementa <input> saturu, ja elementa saturs ir atlasāms. Elementiem, kuriem nav atlasāma teksta satura (piemēram, vizuālais krāsu atlasītājs vai kalendāra datuma ievade), šī metode neko nedara.
setCustomValidity()
Iestata pielāgotu ziņojumu, kas tiek rādīts, ja ievades elementa vērtība nav derīga.
setRangeText()
Iestata norādītā rakstzīmju diapazona saturu ievades elementā noteiktai virknei. Ir pieejams SelectMode parametrs, kas ļauj kontrolēt, kā tiek ietekmēts esošais saturs.
setSelectionRange()
Atlasa norādīto rakstzīmju diapazonu teksta ievades elementā. Neko nedara ievadei, kas netiek parādīta kā teksta ievades lauki.
stepDown ()
Samazina ciparu ievades vērtību par vienu, pēc noklusējuma vai par norādīto vienību skaitu.
stepUp ()
Palielina ciparu ievades vērtību par vienu vai par norādīto vienību skaitu.
CSS
Ievadiem, kas ir aizstāti elementi, ir dažas funkcijas, kas nav piemērojamas elementiem, kas nav formas elementi. Ir CSS atlasītāji, kas var īpaši atlasīt veidlapas vadīklas, pamatojoties uz to lietotāja interfeisa funkcijām, kas pazīstamas arī kā lietotāja interfeisa pseidoklases. Ievades elementu var atlasīt arī pēc veida, izmantojot atribūtu atlasītājus. Ir dažas īpašības, kas ir arī īpaši noderīgas.
UI pseidoklases
Paraksti, kas īpaši atbilst elementam <input>:
Pseido-klases | Apraksts |
---|---|
:enabled |
Jebkurš pašlaik iespējots elements, kuru var aktivizēt (atlasīt, noklikšķināt, ierakstīt utt.) vai pieņemt fokusu, un kuram ir arī atspējots stāvoklis, kurā to nevar aktivizēt vai pieņemt fokusu. |
:disabled |
Jebkurš pašlaik atspējots elements, kuram ir iespējots statuss, kas nozīmē, ka citādi to varētu aktivizēt (atlasīt, noklikšķināt, ierakstīt utt.) vai pieņemt fokusu, ja tas nebūtu atspējots. |
:read-only |
Lietotājs nevar rediģēt elementu |
:read-write |
Elements, ko var rediģēt lietotājs. |
:placeholder-shown |
Elements, kurā pašlaik tiek rādīts viettura teksts, tostarp <input> un <textarea> elementi ar viettura atribūtu, kuram pagaidām nav vērtības. |
:default |
Veidlapas elementi, kas ir noklusējuma elementi saistīto elementu grupā. Atbilst izvēles rūtiņām un radio ievades veidiem, kas tika atzīmēti lapas ielādes vai renderēšanas laikā. |
:checked |
Atbilst pašlaik atzīmētajiem izvēles rūtiņas un radio ievades veidiem (un pašlaik atlasītajam (<opcija> <atlasīt>). |
:indeterminate |
izvēles rūtiņas elementi, kuru nenoteikto rekvizītu JavaScript ir iestatījis uz True, radioelementi, kad nav atzīmētas visas radio pogas ar vienādu nosaukuma vērtību veidlapā, un <progress> elementi nenoteiktā stāvoklī. |
:valid |
Veidlapas vadīklas, kurām var būt piemērota ierobežojuma validācija un kuras pašlaik ir derīgas. |
:invalid |
Veidlapas vadīklas, kurām ir piemērota ierobežojuma validācija un kuras pašlaik nav derīgas. Atbilst veidlapas vadīklai, kuras vērtība neatbilst ierobežojumiem, ko tai nosaka tās atribūti, piemēram, required , pattern , step and max . |
:in-range |
Ievade, kas nav tukša un kuras pašreizējā vērtība ir diapazona robežās, kas norādītas min and max atribūti un step . |
:out-of-range |
Ievade, kas nav tukša un kuras pašreizējā vērtība NAV diapazona robežās, ko nosaka atribūts min un max, vai neatbilst soļa ierobežojumam. |
:required |
Elements <input>, <select> vai <textarea>, kuram ir iestatīts nepieciešamais atribūts. Atbilst tikai elementiem, kas var būt nepieciešami. Atribūts, kas iekļauts neobligātā elementā, neatbildīs. |
:optional |
Elements <input>, <select> vai <textarea>, kuram NAV iestatīts nepieciešamais atribūts. Neatbilst elementiem, kurus nevar pieprasīt. |
:blank |
<input> un <textarea> elementi, kuriem pašlaik nav vērtības. |
:user-invalid |
Līdzīgi kā :invalid, bet tiek aktivizēts aizmiglot. Atbilst nederīgai ievadei, bet tikai pēc lietotāja mijiedarbības, piemēram, koncentrējoties uz vadīklu, atstājot vadīklu vai mēģinot iesniegt veidlapu, kurā ir nederīga vadīkla. |
Pseidoklases piemērs
Mēs varam veidot izvēles rūtiņas etiķeti atkarībā no tā, vai izvēles rūtiņa ir atzīmēta vai nav. Šajā piemērā mēs veidojam color
un font-weight
no <label>
, kas tiek parādīts uzreiz pēc pārbaudītas ievades. Ja ievade nav atzīmēta, mēs neesam lietojuši nevienu stilu.
input:checked + label {
color: red;
font-weight: bold;
}
Atribūtu atlasītāji
Izmantojot atribūtu atlasītājus, ir iespējams atlasīt dažādu veidu veidlapas vadīklas atkarībā no to veida. CSS atribūtu atlasītāji saskaņo elementus, pamatojoties tikai uz atribūta klātbūtni vai noteiktā atribūta vērtību.
/* atbilst ievadītajai parolei */
input[type="password"] {
}
/* atbilst veidlapas vadīklai, kuras derīgās vērtības ir ierobežotas ar vērtību diapazonu*/
input[min][max] {
}
/* saskaņo formas vadīklu ar modeļa atribūtu */
input[pattern] {
}
::placeholder
Pēc noklusējuma viettura teksta izskats ir caurspīdīgs vai gaiši pelēks. ::placeholder pseidoelements ir ievades viettura teksts. To var veidot ar ierobežotu CSS rekvizītu apakškopu.
::placeholder {
color: blue;
}
Noteikumā var izmantot tikai to CSS rekvizītu apakškopu, kas attiecas uz ::pirmās rindas pseidoelementu, atlasītājā izmantojot ::placeholder.
appearance
Rekvizīts izskats ļauj parādīt (gandrīz) jebkuru elementu kā platformas vietējo stilu, pamatojoties uz operētājsistēmas motīvu, kā arī noņemt jebkuru platformas vietējo stilu ar vērtību None.
Varat likt <div> izskatīties kā radiopogai ar div {appearance: radio;} vai radio izskatīties kā izvēles rūtiņai ar [type=”radio”] {appearance: checkbox;}, bet tā nav.
Izskata iestatīšana: neviens nenoņem platformas vietējās apmales, bet nenoņem funkcionalitāti.
caret-color
Rekvizīts, kas raksturīgs ar teksta ievadi saistītajiem elementiem, ir rekvizīts CSS caret-color, kas ļauj iestatīt krāsu, kas tiek izmantota teksta ievades līnijas zīmēšanai:
HTML
<label for="textInput">Ievērojiet sarkano paklāju:</label>
<input id="textInput" class="custom" size="32" />
CSS
input.custom {
caret-color: red;
font: 16px "Helvetica", "Arial", "sans-serif";
}
object-position and object-fit
Dažos gadījumos (parasti izmantojot netekstuālu ievadi un specializētas saskarnes) elements <input> ir aizstāts elements. Ja tā ir, elementa izmēra pozīciju un izmēru, kā arī novietojumu tā rāmī var pielāgot, izmantojot CSS. object-position
un object-fit
iestatījumi.
Styling
Lai iegūtu papildinformāciju par krāsu pievienošanu elementiem HTML, skatiet resurss angļu valodā:
Vēl resursi:
Atbildēt
Lai komentētu, jums jāpiesakās sistēmā.