<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.
email 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 -->
Kad tiek iesniegta iepriekš minētā veidlapa, ievades rezultātā tiek nosūtīts gan pāra augļi=ķirsis nosaukums/vērtība, gan pāra fruit.dir=ltr nosaukums/virziens.

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:

 

  1. _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.
  2. 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:datedatetime-localmonthtime, 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 maxvē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 enterkeyhint tā vietā.

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>:

Subtitri, 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:

Loading

Noderīgs raksts? Dalies ar citiem: