accept
Valabil numai pentru tipul de intrare file atributul accept definește tipurile de fișiere care pot fi selectate într-un control de încărcare file. Consultați tipul de introducere a fișierului.
alt
Valabil numai pentru butonul image, oferă text alternativ pentru imagine, afișând valoarea atributului dacă imaginea src lipsește sau nu reușește să se încarce. Vedeți tipul de introducere a imaginii.
autocomplete
(Nu este un atribut boolean!) Atributul autocomplete ia ca valoare un șir separat de spațiu care descrie ce tip de funcționalitate de completare automată ar trebui să furnizeze intrarea. O implementare tipică a completării automate reamintește valorile anterioare introduse în același câmp de intrare, dar pot exista forme mai complexe de completare automată. De exemplu, un browser s-ar putea integra cu lista de contacte a dispozitivului pentru completarea automată a adreselor email într-un câmp de introducere a e-mailului. Consultați Valorile din atributul de completare automată HTML pentru valorile permise.
Atributul autocomplete este valid pe hidden, text, search, url, tel, email, date, month, week, time, datetime-local, number, range, color, și password. Acest atribut nu are efect asupra tipurilor de intrare care nu returnează date numerice sau text, fiind valabil pentru toate tipurile de intrare, cu excepția checkbox, radio, file sau oricare dintre tipurile de butoane.
Consultați atributul HTML de completare automată f sau informații suplimentare, inclusiv informații despre securitatea parolei și modul în care autocomplete este ușor diferit pentru hidden decât pentru alte tipuri de intrare.
autofocus
Un atribut boolean care, dacă este prezent, indică faptul că intrarea ar trebui să se concentreze automat atunci când pagina a terminat de încărcat (sau când <dialog> care conține elementul a fost afișat).
Notă: un element cu atributul autofocus poate câștiga focalizarea înainte de este declanșat.
Nu mai mult de un element din document poate avea atributul autofocus. Dacă este pus mai mult de un element, primul cu atributul primește focalizare.
Atributul autofocus nu poate fi utilizat la intrările de tip hidden, deoarece intrările ascunse nu pot fi focalizate.
Atenție: focalizarea automată a unui control de formular poate confunda persoanele cu deficiențe de vedere care utilizează tehnologia de citire a ecranului și persoanele cu deficiențe cognitive. Când autofocus este atribuit, cititoarele de ecran „teleportează” utilizatorul către controlul formularului fără a-i avertiza în prealabil.
Utilizați o atenție atentă pentru accesibilitate atunci când aplicând atributul autofocus. Focalizarea automată pe un control poate duce la derularea paginii la încărcare. Focusul poate provoca, de asemenea, afișarea tastaturilor dinamice pe unele dispozitive tactile. În timp ce un cititor de ecran va anunța eticheta focalizării de control a formularului, cititorul de ecran nu va anunța nimic înaintea etichetei, iar utilizatorul văzut de pe un dispozitiv mic va pierde în mod egal contextul creat de conținutul precedent.
capture
Introdus în specificația HTML Media Capture și valid pentru tipul de intrare file numai, capture definește ce suport media – microfon, videoclip sau cameră foto – ar trebui utilizat pentru a captura un fișier nou pentru încărcare cu file control de încărcare în scenarii de sprijin. Consultați tipul de introducere a fișierului.
checked
Valabil atât pentru radio, cât și pentru checkbox types, checked este un atribut boolean. Dacă este prezent pe un tip radio, indică faptul că butonul radio este cel selectat în prezent în grupul de butoane radio cu același nume. Dacă este prezent pe un tip checkbox, indică faptul că caseta de selectare este bifată implicit (când pagina se încarcă). Nu indică dacă această casetă de selectare este bifată în prezent: dacă starea casetei de selectare este modificată, acest atribut de conținut nu reflectă modificarea. (Numai atributul HTMLInputElement checked IDL este actualizat.)
Notă: spre deosebire de alte controale de intrare, o casetă de selectare și valoarea butoanelor radio sunt incluse numai în datele trimise numai dacă sunt în prezent checked. Dacă sunt, numele și valoarea (controalele) controalelor verificate sunt trimise.
De exemplu, dacă o casetă de selectare al cărei name este fruit are un value de cherry, iar caseta de selectare este bifată, datele formularului trimise vor include fruit=cherry. Dacă caseta de selectare nu este „activă”, nu este deloc listată în datele formularului. Setarea implicită value pentru casetele de selectare și butoanele radio este on.
dirname
Valabil numai pentru tipurile de intrare text și search, dirname atributul permite transmiterea direcționalității elementului. Când este inclus, controlul formularului se va trimite cu două perechi nume / valoare: prima fiind name și value, a doua fiind valoarea din dirname ca nume cu valoarea ltr sau rtl fiind setat de browser.
Când este trimis formularul de mai sus, introducerea cauzează atât perechea name / value id = „98b062a97f”> și dirname / perechea de direcție a fruit.dir=ltr care urmează să fie trimise.
disabled
Un atribut boolean care, dacă este prezent, indică faptul că utilizatorul nu ar trebui să poată interacționa cu intrarea. Intrările dezactivate sunt de obicei redate cu o culoare mai slabă sau folosind o altă formă de indicație că câmpul nu este disponibil pentru utilizare.
În mod specific, intrările dezactivate nu primesc click eveniment și intrările dezactivate nu sunt trimise împreună cu formularul.
Notă: Deși nu este cerut de specificație, Firefox va persista în mod implicit starea dinamică dezactivată a unui <input> între încărcări de pagină. Utilizați atributul autocomplete pentru a controla această caracteristică.
form
Un șir care specifică <form> element cu care este asociată intrarea (adică proprietarul formularului). Valoarea acestui șir, dacă este prezentă, trebuie să se potrivească cu id al unui element <form> din același document. Dacă acest atribut nu este „t specificat, elementul <input> este asociat cu cea mai apropiată formă conținută, dacă există.
Atributul form vă permite plasați o intrare oriunde în document, dar includeți-o cu un formular în altă parte a documentului.
Notă: o intrare poate fi asociată doar cu un formular. div id = „d4a3166041”>
Valabil numai pentru tipurile de intrare image și submit. Consultați tipul de introducere pentru mai multe informații.
formenctype
Valabil pentru image și submit numai tipuri de intrare. Consultați tipul de introducere pentru mai multe informații.
formmethod
Valabil pentru image și submit numai tipuri de intrare. Consultați tipul de introducere pentru mai multe informații.
formnovalidate
Valabil pentru image și submit numai tipuri de intrare. Consultați tipul de introducere pentru mai multe informații.
formtarget
Valabil pentru image și submit numai tipuri de intrare. Consultați tipul de introducere pentru mai multe informații.
height
Valabil numai pentru butonul de introducere image, height este înălțimea fișierului imagine de afișat pentru a reprezenta butonul de trimitere grafic. Consultați tipul de introducere a imaginii.
id
Atribut global valid pentru toate elementele, inclusiv pentru toate tipurile de intrare, definește un identificator unic (ID) care trebuie să fie unic în întregul document. Scopul său este de a identifica elementul la conectare. Valoarea este utilizată ca valoare a atributului <label> „s for pentru a lega eticheta de controlul formularului. Consultați <label>.
inputmode
Valoare globală valabilă pentru toate elementele, oferă un indiciu browserelor cu privire la tipul de configurație a tastaturii virtuale pentru utilizați atunci când editați acest element sau conținutul acestuia. Valorile includ none, text, tel, url, email, numeric, decimal și search.
list
Valoarea dată atributului list ar trebui să fie id a unui element <datalist> situat în același document. <datalist> oferă o listă de valori predefinite pentru a sugera utilizatorului această intrare. Toate valorile din listă care nu sunt compatibile cu type nu sunt incluse în opțiunile sugerate. Valorile furnizate sunt sugestii, nu cerințe: utilizatorii pot selecta din această listă predefinită sau pot furniza o altă valoare.
Este valabilă pe text, search, url, tel, email, date, month, week, time, datetime-local, number, range și color.
Conform specificațiilor, atributul list nu este acceptat de hidden, password, checkbox, radio, file sau orice alt din tipurile de butoane.
În funcție de browser, utilizatorul poate vedea o paletă de culori personalizată sugerată, marcaje de tic de-a lungul unui interval sau chiar o intrare care se deschide ca un <select> dar permite va sifilis. Consultați tabelul de compatibilitate al browserului pentru celelalte tipuri de intrare.
Consultați elementul <datalist>.
max
Valabil pentru date, month, week, time, datetime-local, number și range, definește cea mai mare valoare din gama valorilor permise. Dacă value introdus în element îl depășește, elementul nu reușește validarea constrângerii. Dacă valoarea atributului max nu este un număr, elementul nu are valoare maximă.
Există un caz special: dacă tipul de date este periodic (cum ar fi pentru date sau ore), valoarea max poate fi mai mică decât valoarea min, ceea ce indică faptul că înconjurați; de exemplu, acest lucru vă permite să specificați un interval de timp de la 22:00 la 4:00.
maxlength
Valabil pentru text, search, url, tel, email și password, definește numărul maxim de caractere (ca unități de cod UTF-16) pe care utilizatorul le poate introduce în câmp. Aceasta trebuie să fie o valoare întreagă 0 sau mai mare. Dacă nu este specificat maxlength sau este specificată o valoare nevalidă, câmpul nu are lungime maximă. Această valoare trebuie, de asemenea, să fie să fie mai mare sau egală cu valoarea
Introducerea va eșua validarea constrângerii dacă lungimea textului introdus în câmp este mai mare decât maxlength Unități de cod UTF-16 lungi. În mod implicit, browserele împiedică utilizatorii să introducă mai multe caractere decât cele permise de atributul maxlength. Consultați validarea partea client pentru mai multe informații.
min
Valabil pentru date, month, week, time, datetime-local, number și range, definește cea mai negativă valoare din intervalul valorilor permise. Dacă value introdus în element este mai mic decât acesta, elementul nu reușește validarea constrângerii. Dacă valoarea atributului min nu este un număr, elementul nu are valoare minimă.
Această valoare trebuie să fie mai mică sau egală cu valoarea atributul max. Dacă atributul min este prezent, dar nu este specificat sau nu este valid, nu există min se aplică valoarea. Dacă atributul min este valid și o valoare care nu este goală este mai mică decât minimul permis de min atribut, validarea constrângerii va împiedica trimiterea formularului. Pentru mai multe informații, consultați validarea partea clientului.
Există un caz special: dacă tipul de date este periodic (cum ar fi pentru date sau ore), valoarea max poate fi mai mic decât valoarea min, ceea ce indică faptul că intervalul se poate înfășura; de exemplu, acest lucru vă permite să specificați o oră variază de la 22:00 la 4:00.
minlength
Valabil pentru text, search, url, tel, email și password, definește numărul minim de caractere (ca unități de cod UTF-16) pe care utilizatorul le poate introduce în câmpul de introducere. Aceasta trebuie să fie o valoare întreagă non-negativă mai mică sau egală cu valoarea specificată de maxlength. Dacă nu este specificat niciun minlength sau este specificată o valoare nevalidă, intrarea nu are lungime minimă.
Intrarea va eșua validarea constrângerii dacă lungimea textului introdus în câmp este mai mic de minlength lungime de unități de cod UTF-16, împiedicând trimiterea formularului. Consultați validarea partea client pentru mai multe informații.
multiple
Atributul boolean multiple, dacă este setat, înseamnă utilizator poate introduce adrese de e-mail separate prin virgulă în widgetul de e-mail sau poate alege mai multe fișiere cu intrarea file. Consultați tipul de intrare pentru e-mail și fișier.
name
Un șir care specifică un nume pentru controlul de intrare. Acest nume este trimis împreună cu valoarea „controlului” atunci când sunt trimise datele formularului.
Ce este într-un nume
Luați în considerare name un atribut necesar (chiar dacă nu este). Dacă o intrare nu are specificat name sau name este gol, valoarea de intrare nu este trimisă împreună cu formularul! (De asemenea, comenzile dezactivate, butoanele radio nebifate, casetele de selectare bifate și butoanele de resetare nu sunt trimise.)
Există două cazuri speciale:
-
_charset_: Dacă este folosit ca numele unui element<input>de tip ascuns, intrarea „svalueeste setată automat de agentul utilizatorului la codificarea caracterelor fiind utilizat pentru a trimite formularul. -
isindex: Din motive istorice, numeleisindexnu este permis.
butoane de nume și radio
Atributul name creează un comportament unic pentru butoanele radio.
Doar un singur buton radio dintr-un grup cu același nume de butoane radio poate fi verificat odată. Selectarea oricărui buton radio din grupul respectiv deselectează automat orice buton radio selectat în prezent din același grup. Valoarea că un buton radio bifat este trimis împreună cu numele dacă formularul este trimis,
Atunci când introduceți o serie din același -numit grup de butoane radio, dacă este bifat, acesta va primi focalizare. Dacă nu sunt grupate în ordine sursă, dacă unul dintre grupuri este bifat, tabularea în grup începe atunci când se întâlnește primul din grup, omitând toate cele care nu sunt bifate. Cu alte cuvinte, dacă unul este bifat, tabularea omite butoanele radio neselectate din grup. Dacă niciunul nu este bifat, grupul de butoane radio primește focalizarea la atingerea primului buton din același grup de nume.
Odată ce unul dintre butoanele radio dintr-un grup are focalizare, folosind tastele săgeată va naviga prin toate butoanele radio cu același nume, chiar dacă butoanele radio nu sunt grupate împreună în ordinea sursă.
HTMLFormElement.elements
Când unui element de intrare i se dă un name, acel nume devine o proprietate a proprietății elementului de formular „s HTMLFormElement.elements. Dacă aveți o intrare a cărei name este setat la guest și altul al cărui name este hat-size, următorul cod poate fi folosit:
Când acest cod a rulat, guestName va fi HTMLInputElement pentru câmpul guest și hatSize obiectul pentru hat-size câmp.
Avertisment: evitați să dați elementelor formularului un name care corespunde unei proprietăți încorporate a formularului, deoarece atunci veți înlocui proprietatea predefinită sau metoda cu această referință la intrarea corespunzătoare.
pattern
Atributul pattern, atunci când este specificat, este o expresie regulată pe care input „s value trebuie să se potrivească pentru ca valoarea să treacă validarea constrângerii. Trebuie să fie o expresie regulată JavaScript validă, așa cum este utilizată de tipul RegExp și așa cum este documentat în ghidul nostru privind expresiile regulate; steagul "u" este specificat la compilarea expresiei regulate, astfel încât modelul să fie tratat ca o secvență de puncte de cod Unicode, în loc de ASCII. Nu trebuie specificate bare oblice înainte în jurul textului modelului.
Dacă atributul pattern este prezent, dar nu este specificat sau este nevalid, nu se aplică nicio expresie regulată și aceasta atributul este ignorat complet.Dacă atributul model este valid și o valoare care nu este goală nu se potrivește cu modelul, validarea constrângerilor va împiedica trimiterea formularului.
Sfat: Dacă utilizați pattern atribut, informați utilizatorul despre formatul așteptat, incluzând text explicativ în apropiere. De asemenea, puteți include un atribut title pentru a explica care sunt cerințele pentru a se potrivi cu modelul; majoritatea browserelor vor afișa acest titlu ca o descriere. Explicația vizibilă este necesară pentru accesibilitate. Sfatul de lucru este o îmbunătățire.
Pentru mai multe informații, consultați validarea partea clientului.
placeholder
Atributul placeholder este un șir care oferă utilizatorului o scurtă sugestie cu privire la ce tip de informații sunt așteptate în câmp. Ar trebui să fie un cuvânt sau o frază scurtă care să ofere o sugestie cu privire la tipul de date așteptat, mai degrabă decât o explicație sau prompt. Textul nu trebuie să includă retururi de transport sau fluxuri de linii. De exemplu, dacă se așteaptă ca un câmp să capteze prenumele unui utilizator și eticheta acestuia este „Prenume”, un substituent adecvat ar putea fi „de ex. Mustafa „.
Notă: atributul placeholder nu este la fel de util din punct de vedere semantic ca alte modalități de a explica formularul și poate cauza probleme tehnice neașteptate cu conținut. Consultați etichete în < input >: elementul Input (Form Input) pentru mai multe informații.
readonly
Un atribut boolean care, dacă este prezent, indică faptul că utilizatorul nu ar trebui să poată edita valoarea intrării. readonly este acceptat text, search, url, tel, email, date, month, week, time, datetime-local, number și password tipuri de intrare.
Consultați atributul HTML: readonly pentru mai multe informații.
required este un atribut boolean care, dacă este prezent, indică faptul că utilizatorul trebuie să specifice o valoare pentru intrare înainte ca formularul proprietar să poată fi trimis. Atributul required este acceptat de text, search, url, tel, email, date, month, week, time, datetime-local, number, password, checkbox, radio și file intrări.
Consultați validarea partea clientului și atributul HTML: required pentru mai multe informații.
sizeValabil pentruemail,password,telșitextinputnumai tipuri. Specifică cât de mult din intrare este afișat. Practic creează același rezultat ca și setarea proprietății CSSwidthcu câteva specialități. Unitatea efectivă a valorii depinde de tipul de intrare. Pentrupasswordșitext, este un număr de caractere (sauemunități) cu o valoare implicită20, iar pentru alții, estepixels. Lățimea CSS are prioritate față de atributul dimensiune.src
Valabil doar pentru butonul de intrare image, src specifică șirul adresa URL a fișierului imagine de afișat pentru a reprezenta butonul de trimitere grafic. Consultați tipul de introducere a imaginii.
step
Valabil pentru tipurile de intrare numerică, inclusiv number, data / time input types și range, atributul step este un număr care specifică granularitatea la care trebuie să respecte valoarea.
Dacă nu este inclus explicit:
-
stepeste implicit 1 pentrunumberșirange. - Pentru tipurile de intrare dată / oră,
stepeste exprimat în secunde, pasul implicit fiind de 60 de secunde . Factorul scării pasului este 1000 (care convertește secundele în milisecunde, așa cum este utilizat în alți algoritmi).
Valoarea trebuie să fie un număr pozitiv – întreg sau float – sau valoarea specială any, ceea ce înseamnă că nu este implicat nici un pas și este permisă orice valoare (cu excepția altor constrângeri, precum min și max).
Dacă any nu este setat în mod explicit, valorile valabile pentru number, tipurile de intrare dată / oră și range tipurile de intrare sunt egale cu baza pentru pas – valoarea min și incrementele valorii pasului, până la max valoare, dacă este specificată.
De exemplu, dacă aveți <input type="number" min="10" step="2">, atunci orice număr întreg, 10 sau mai mare, este valid. Dacă este omis, <input type="number">, orice număr întreg este valid, dar floats (cum ar fi 4.2) nu sunt valide, deoarece step implicit la 1. Pentru ca 4.2 să fie valid, step ar fi trebuit setat la any, 0.1 , 0,2 sau orice valoare min ar fi trebuit să fie un număr care se termină cu .2, cum ar fi <input type="number" min="-5.2">
Notă: Atunci când datele introduse de utilizator nu aderă la configurația pas cu pas, valoarea este considerată nevalidă în contravalidare și se va potrivi cu :invalid pseudoclasă.
Consultați validarea partea clientului pentru mai multe informații.
tabindex
Atribut global valabil pentru toate elementele, inclusiv pentru toate tipurile de intrare, un atribut întreg care indică dacă elementul poate focaliza intrarea (poate fi focalizat), dacă ar trebui să participe la navigarea secvențială de la tastatură. Ca toate tipurile de intrare, cu excepția intrării de tip ascuns sunt focalizabile, acest atribut nu ar trebui să fie utilizat la controalele de formular, deoarece acest lucru ar necesita gestionarea focului comandați-ne pentru toate elementele din document cu riscul de a afecta usabilitatea și accesibilitatea dacă este făcut incorect.
title
Atribut global valid pentru toate elementele, inclusiv pentru toate tipurile de intrare , care conține un text reprezentând informații de consiliere legate de elementul căruia îi aparține. Astfel de informații pot fi prezentate în mod obișnuit, dar nu neapărat, utilizatorului ca o descriere. Titlul NU trebuie utilizat ca explicație principală a scopului controlului formularului. În schimb, utilizați elementul <label> cu un atribut for setat la controlul formularului „s id atribut. A se vedea etichetele de mai jos.
type
Un șir care specifică tipul de control de redat. De exemplu, pentru a crea o casetă de selectare, o valoare de checkbox este utilizat. Dacă este omis (sau este specificată o valoare necunoscută), se utilizează tipul de intrare text, creându-se un câmp de intrare în format text.
Valorile permise sunt listate în tipurile <input> de mai sus.
value
Valoarea controlului de intrare. Când este specificat în HTML, aceasta este valoarea inițială și, de atunci, poate fi modificată sau recuperată în orice moment folosind JavaScript pentru a accesa respectivul HTMLInputElement obiect „s value. Atributul value este întotdeauna opțional, deși ar trebui considerat obligatoriu pentru checkbox, radio și hidden.
width
Valabil pentru image numai butonul de introducere, width este lățimea fișierului imagine de afișat pentru a reprezenta butonul de trimitere grafic. Consultați tipul de introducere a imaginii.