accept
Gælder kun for file inputtypen, accept attribut definerer hvilke filtyper der kan vælges i en file upload kontrol. Se filinputtypen.
alt
Gælder kun for knappen image, alt -attribut giver alternativ tekst til billedet, der viser værdien af attributten, hvis billedet src mangler eller på anden måde ikke indlæses. Se billedinputtypen.
autocomplete
(Ikke en boolsk attribut!) autocomplete -attributten tager som sin værdi en pladsadskilt streng, der beskriver, hvilken type autofuldførelsesfunktionaliteten inputen skal give, hvis nogen. En typisk implementering af autofuldførelse minder om tidligere værdier indtastet i det samme indtastningsfelt, men der kan eksistere mere komplekse former for autofuldførelse. F.eks. Kunne en browser integreres med en enheds kontaktliste for at autofuldføre email -adresser i et e-mail-indtastningsfelt. Se Værdier i HTML-autofuldførelsesattributten for tilladte værdier.
autocomplete -attributten er gyldig på hidden, text, search, url, tel, email, date, month, week, time, datetime-local, number, range, color og password. Denne attribut har ingen effekt på inputtyper, der ikke returnerer numeriske data eller tekstdata, og er gyldig for alle inputtyper undtagen checkbox, radio, file eller en hvilken som helst af knappetyperne.
Se HTML-autofuldførelsesattribut f eller yderligere oplysninger, herunder oplysninger om adgangskodesikkerhed, og hvordan autocomplete er lidt anderledes for hidden end for andre inputtyper.
autofocus
En boolsk attribut, som, hvis den er til stede, indikerer at input automatisk skal have fokus, når siden er indlæst (eller når <dialog> indeholdende elementet er blevet vist).
Bemærk: Et element med attributten autofocus kan få fokus inden DOMContentLoaded begivenheden udløses.
Ikke mere end et element i dokumentet kan have attributten autofocus. Hvis der er sat mere end et element på, får det første med attributten fokus.
Attributten autofocus kan ikke bruges på indgange af typen hidden, da skjulte indgange ikke kan fokuseres.
Advarsel: Automatisk fokusering af en formkontrol kan forvirre synshandicappede ved hjælp af skærmlæsningsteknologi og personer med kognitive handicap. Når autofocus er tildelt, “teleporterer” skærmlæsere deres bruger til formularkontrollen uden at advare dem på forhånd.
Vær omhyggelig opmærksom på tilgængelighed, når anvende autofocus attributten. Automatisk fokusering på en kontrol kan få siden til at rulle ved indlæsning. Fokus kan også få dynamiske tastaturer til at blive vist på nogle berøringsenheder. Mens en skærmlæser annoncerer etiketten for den formularkontrol, der modtager fokus, annoncerer skærmlæser ikke noget før etiketten, og den synede bruger på en lille enhed vil ligeledes gå glip af den sammenhæng, der er skabt af det foregående indhold.
capture
Introduceret i HTML Media Capture-specifikationen og kun gyldig for file inputtypen, capture -attribut definerer, hvilket medium — mikrofon, video eller kamera — der skal bruges til at fange en ny fil til upload med file uploadkontrol i understøttende scenarier. Se filinputtypen.
checked
Gælder for både radio og checkbox types, checked er en boolsk attribut. Hvis den findes på en radio -type, angiver det, at radioknappen er den aktuelt valgte i gruppen med samme navngivne radioknapper. Hvis det findes på en checkbox -type, angiver det, at afkrydsningsfeltet er markeret som standard (når siden indlæses). Det angiver ikke, om dette afkrydsningsfelt i øjeblikket er markeret. Hvis afkrydsningsfeltets tilstand ændres, afspejler denne indholdsattribut ikke ændringen. (Kun HTMLInputElement ’s checked IDL-attribut opdateres.)
Bemærk: I modsætning til andre indgangskontroller er en afkrydsningsfelt og radioknappens værdi kun inkluderet i de indsendte data, hvis de i øjeblikket er checked. Hvis de er det, indsendes navnet og værdien (e) på de kontrollerede kontroller.
For eksempel, hvis et afkrydsningsfelt, hvis name er fruit har en value af cherry, og afkrydsningsfeltet er markeret, de indsendte formulardata inkluderer fruit=cherry. Hvis afkrydsningsfeltet ikke er aktivt, vises det slet ikke i formulardataene. Standard value for afkrydsningsfelter og radioknapper er on.
dirname
Gælder kun for text og search input-typerne, dirname attribut muliggør indsendelse af elementets retningsretning. Når det er inkluderet, indsendes formkontrol med to navn / værdipar: det første er name og value, det andet er værdien af dirname som navnet med værdien ltr eller rtl, der indstilles af browser.
Når formularen ovenfor indsendes, forårsager input både name / value par af fruit=cherry og dirname / retningspar til fruit.dir=ltr, der skal sendes.
disabled
En boolsk attribut, som, hvis den er til stede, indikerer at brugeren ikke skal være i stand til at interagere med input. Deaktiverede indgange gengives typisk med en lysere farve eller ved hjælp af en anden form for indikation af, at feltet ikke er tilgængeligt.
Specifikt modtager deaktiverede indgange ikke click begivenhed, og deaktiverede input sendes ikke sammen med formularen.
Bemærk: Selvom det ikke kræves af specifikationen, vil Firefox som standard opretholde den dynamiske deaktiverede tilstand af en <input> på tværs af sideindlæsninger. Brug attributten autocomplete til at kontrollere denne funktion.
form
En streng, der angiver <form> element, som input er tilknyttet (dvs. formularens ejer). Denne streng “s værdi, hvis den findes, skal matche id for et <form> element i det samme dokument. Hvis denne attribut ikke er” t angivet, <input> -elementet er tilknyttet den nærmeste indeholdende form, hvis nogen.
form -attributten giver dig mulighed for placer et input hvor som helst i dokumentet, men få det inkluderet i en formular andetsteds i dokumentet.
Bemærk: Et input kan kun tilknyttes en formular.
formaction
Gælder kun for image og submit inputtyper. Se den indsendte inputtype for at få flere oplysninger.
formenctype
Gyldig for image og submit kun inputtyper. Se indsend inputtypen for mere information.
formmethod
Gyldig for image og submit kun inputtyper. Se den indsendte inputtype for at få flere oplysninger.
formnovalidate
Gyldig for image og submit kun inputtyper. Se den indsendte inputtype for at få flere oplysninger.
formtarget
Gælder for image og submit kun inputtyper. Se den indsendte inputtype for at få flere oplysninger.
height
Gælder kun for image input-knappen, height er højden på den billedfil, der skal vises for at repræsentere den grafiske sendeknap. Se billedinputtypen.
id
Global attribut, der er gyldig for alle elementer, inklusive alle inputtyper, den definerer en unik identifikator (ID), som skal være unik i hele dokumentet. Dens formål er at identificere elementet ved sammenkædning. Værdien bruges som værdien for attributten <label> “s for for at linke etiketten med formkontrol. Se <label>.
inputmode
Global værdi gyldig for alle elementer, det giver et tip til browsere om typen af virtuelt tastaturkonfiguration til bruges til redigering af dette element eller dets indhold. Værdier inkluderer none, text, tel, url, email, numeric, decimal og search.
list
Den værdi, der gives til attributten list, skal være id af et <datalist> -element, der er placeret i det samme dokument. <datalist> giver en liste over foruddefinerede værdier, der skal foreslås til brugeren for denne input. Eventuelle værdier på listen, der ikke er kompatible med type, er ikke inkluderet i de foreslåede indstillinger. De angivne værdier er forslag, ikke krav: brugere kan vælge fra denne foruddefinerede liste eller angive en anden værdi.
Den er gyldig på text, search, url, tel, email, date, month, week, time, datetime-local, number, range og color.
I henhold til specifikationerne understøttes list attributten ikke af hidden, password, checkbox, radio, file eller en hvilken som helst af knappetyperne.
Afhængig af browseren kan brugeren muligvis se en tilpasset farvepalet foreslået, tic-markeringer langs et interval eller endda en input, der åbnes som en <select> men giver mulighed for ikke-noteret va langsomt. Tjek browserkompatibilitetstabellen for de andre inputtyper.
Se <datalist> -elementet.
max
Gælder for date, month, week, time, datetime-local, number og range definerer den den største værdi i området af tilladte værdier. Hvis value indtastet i elementet overstiger dette, mislykkes elementet validering af begrænsning. Hvis værdien af attributten max ikke er “ta”, har elementet ingen maksimumværdi.
Der er et specielt tilfælde: hvis datatypen er periodisk (f.eks. for datoer eller tidspunkter) kan værdien af max være lavere end værdien af min, hvilket indikerer, at området kan vikle rundt; for eksempel giver dette dig mulighed for at angive et tidsinterval fra kl. 22 til kl. 4.
maxlength
Gælder for text, search, url, tel, email og password, det definerer det maksimale antal tegn (som UTF-16-kodenheder), som brugeren kan indtaste i feltet. Dette skal være et heltal 0 eller højere. Hvis der ikke er angivet maxlength, eller der er angivet en ugyldig værdi, har feltet ingen maksimal længde. Denne værdi skal også være større end eller lig med værdien af
Inputet mislykkes begrænsning af validering, hvis længden af den tekst, der indtastes i feltet, er større end maxlength UTF-16 kodeenheder er lange. Som standard forhindrer browsere brugere i at indtaste flere tegn end tilladt af attributten maxlength. Se validering på klientsiden for at få flere oplysninger.
min
Gyldig for date, month, week, time, datetime-local, number og range definerer den den mest negative værdi i området af tilladte værdier. Hvis value, der er indtastet i elementet, er mindre end dette, mislykkes elementets valideringsbegrænsning. Hvis værdien af attributten min ikke er “ta”, har elementet ingen minimumsværdi.
Denne værdi skal være mindre end eller lig med værdien af max -attributten. Hvis min -attributten er til stede, men ikke er angivet eller er ugyldig, er der ingen min værdi anvendes. Hvis min attributten er gyldig, og en ikke-tom værdi er mindre end det tilladte minimum af min attribut, begrænsning validering forhindrer indsendelse af formularer. Se validering på klientsiden for at få flere oplysninger.
Der er et specielt tilfælde: hvis datatypen er periodisk (f.eks. for datoer eller tidspunkter), er værdien max kan være lavere end værdien af min, hvilket indikerer, at området kan vikles rundt; for eksempel giver dette dig mulighed for at angive et tidspunkt fra 22:00 til 04:00.
minlength
Gælder for text, search, url, tel, email og password, det definerer det mindste antal tegn (som UTF-16-kodenheder), som brugeren kan indtaste i indtastningsfeltet. Dette skal være et ikke-negativt heltal, der er mindre end eller lig med den værdi, der er angivet af maxlength. Hvis der ikke er angivet minlength, eller der er angivet en ugyldig værdi, har indgangen ingen minimumslængde.
Inputet mislykkes begrænsning af validering, hvis længden af teksten indtastet i feltet er mindre end minlength UTF-16-kodenheder lang, hvilket forhindrer formularafsendelse. Se validering på klientsiden for at få flere oplysninger.
multiple
Attributten Boolsk multiple, hvis den er angivet, betyder brugeren kan indtaste komma-adskilte e-mail-adresser i e-mail-widgeten eller kan vælge mere end en fil med input file. Se e-mail- og filinputtypen.
name
En streng, der angiver et navn til inputkontrollen. Dette navn indsendes sammen med kontrolværdien, når formulardata indsendes.
Hvad er der i et navn
Overvej name en påkrævet attribut (selvom den ikke er). Hvis en input ikke har angivet name, eller name er tom, input “s værdi er ikke indsendt med formularen! (Deaktiverede kontroller, ikke-markerede radioknapper, ikke-markerede afkrydsningsfelter og reset-knapper sendes heller ikke.)
Der er to specielle tilfælde:
-
_charset_: Hvis det bruges som navnet på et<input>element af typen skjult, indstilles input “svalueaf brugeragenten til den tegnkodning, der bruges til at indsende formularen. -
isindex: Af historiske årsager skal navnetisindexer ikke tilladt.
navn og radioknapper
name -attribut skaber en unik opførsel for radioknapper.
Kun en radioknap i en gruppe med radioknapper med samme navn kan kontrolleres ad gangen. Hvis du vælger en hvilken som helst radioknap i denne gruppe, fjernes automatisk enhver aktuelt valgt radioknap i samme gruppe. Værdien af at en afkrydset alternativknap sendes sammen med navnet, hvis formularen sendes,
Når du taster til en serie af samme -navngivet gruppe af radioknapper, hvis en er markeret, vil den ene få fokus. Hvis de ikke er grupperet i kilde rækkefølge, hvis en af gruppen er markeret, starter tabning i gruppen, når den første i gruppen er stødt på, og springer alle dem, der ikke er markeret. Med andre ord, hvis en er markeret, springer fanen over de ukontrollerede radioknapper i gruppen. Hvis ingen er markeret, får radioknappegruppen fokus, når den første knap i gruppen med samme navn nås.
Når en af radioknapperne i en gruppe har fokus, bruger piletasterne gennem alle radioknapperne med samme navn, selvom radioknapperne ikke er grupperet i kildearrangementet.
HTMLFormElement.elements
Når et inputelement får name, dette navn bliver en egenskab for det ejende formelement “s HTMLFormElement.elements egenskab. Hvis du har et input, hvis name er sat til guest og en anden hvis name er hat-size, den følgende kode kan bruges:
Når denne kode er kørt, vil guestName være HTMLInputElement til guest -feltet og hatSize objektet til hat-size felt.
name, der svarer til en indbygget egenskab i formularen, da du derefter tilsidesætter den foruddefinerede egenskab eller metode med denne henvisning til det tilsvarende input. pattern
Attributten pattern er, når det er specificeret, et regulært udtryk for, at input “s value skal matche for at værdien skal bestå begrænsning validering. Det skal være et gyldigt JavaScript-regulært udtryk som brugt af typen RegExp og som dokumenteret i vores guide til regulære udtryk; "u" -flaget er angivet, når man sammensætter det regulære udtryk, så mønsteret behandles som en sekvens af Unicode-kodepunkter i stedet for som ASCII. Der skal ikke angives skråstreg fremad omkring mønsterteksten.
Hvis pattern -attributten er til stede, men ikke er angivet eller er ugyldig, anvendes der ikke noget regulært udtryk, og dette attribut ignoreres fuldstændigt.Hvis mønsterattributten er gyldig, og en ikke-tom værdi ikke matcher mønsteret, forhindrer valideringsbegrænsning indsendelse af formular.
Tip: Hvis du bruger pattern attribut, informer brugeren om det forventede format ved at medtage forklarende tekst i nærheden. Du kan også inkludere en title -attribut for at forklare, hvad kravene er for at matche mønsteret; de fleste browsere viser denne titel som et værktøjstip. Den synlige forklaring kræves for tilgængelighed. Værktøjstip er en forbedring.
Se validering på klientsiden for mere information.
placeholder
placeholder attribut er en streng, der giver et kort tip til brugeren om, hvilken slags information der forventes i marken. Det skal være et ord eller en kort sætning, der giver et tip til den forventede datatype snarere end en forklaring eller prompt. Teksten må ikke indeholde vognretur eller linjefeed. Så for eksempel, hvis et felt forventes at fange en brugers fornavn, og dets etiket er “Fornavn”, kan en passende pladsholder være “f.eks. Mustafa “.
Bemærk: placeholder -attributten er ikke så semantisk nyttig som andre måder at forklare din formular på og kan forårsage uventede tekniske problemer med din Se etiketter i < input >: Elementet Input (Form Input) for at få flere oplysninger.
readonly
En boolsk attribut, der, hvis den er til stede, angiver, at brugeren ikke skal være i stand til at redigere værdien af input. readonly attribut understøttes text, search, url, tel, email, date, month, week, time, datetime-local, number og password inputtyper.
Se HTML-attributten: readonly for at få flere oplysninger.
required er en boolsk attribut, som, hvis den er til stede, angiver, at brugeren skal angive en værdi for inputet, før ejerskabsformularen kan sendes. Attributten required understøttes af text, search, url, tel, email, date, month, week, time, datetime-local, number, password, checkbox, radio og file input.
Se validering på klientsiden og HTML-attributten: required for at få flere oplysninger.
sizeGyldig foremail,password,telogtextinputtyper. Angiver, hvor meget af input der vises. Grundlæggende skaber det samme resultat som at indstille CSSwidthejendom med et par specialiteter. Den aktuelle enhed af værdien afhænger af inputtypen. Forpasswordogtexter det et antal tegn (elleremenheder) med en standardværdi på20, og for andre er detpixels. CSS-bredde har forrang over størrelsesattribut.src
Gælder kun inputknappen image, src angiver streng URL-adressen til den billedfil, der skal vises for at repræsentere den grafiske knap til afsendelse. Se billedinputtypen.
step
Gælder for de numeriske inputtyper, inklusive number, dato / tidsindgangstyper og range, attributten step er et tal, der specificerer den granularitet, som værdien skal overholde.
Hvis ikke eksplicit inkluderet:
-
steper som standard 1 fornumberogrange. - For dato- / klokkeslætindgangstyperne udtrykkes
stepi sekunder, hvor standardtrinnet er 60 sekunder . Trinskalafaktoren er 1000 (som konverterer sekunder til millisekunder, som brugt i andre algoritmer).
Værdien skal være et positivt tal — heltal eller float — eller den specielle værdi any, hvilket betyder, at ingen trin er underforstået, og enhver værdi er tilladt (uden andre begrænsninger, såsom min og max).
Hvis any ikke er indstillet eksplicitet, gælder gyldige værdier for number, dato / klokkeslæt inputtyper og range inputtyper er lig med basis for trin – min værdi og trin for trinværdien, op til max værdi, hvis det er angivet.
For eksempel, hvis du har <input type="number" min="10" step="2">, så et hvilket som helst ens heltal, 10 eller højere er gyldig. Hvis udeladt, <input type="number">, er ethvert heltal gyldigt, men floats (som 4.2) er ikke gyldige, fordi step er 1 som standard. For at 4.2 skulle være gyldig, ville step skulle have været indstillet til any, 0,1 , 0,2 eller en hvilken som helst min -værdien ville have været et tal, der slutter med .2, såsom <input type="number" min="-5.2">
Bemærk: Når de data, der er indtastet af brugeren, ikke overholder trinkonfigurationen, betragtes værdien som ugyldig i kontrastervalidering og svarer til :invalid pseudoklasse.
Se validering på klientsiden for at få flere oplysninger.
tabindex
Global attribut gyldig for alle elementer, inklusive alle inputtyper, en heltalsattribut, der angiver, om elementet kan tage inputfokus (kan fokuseres), om det skal deltage i sekventiel tastaturnavigation. Som alle inputtyper undtagen input af typen skjult kan fokuseres, skal denne attribut ikke bruges til formkontrol, fordi det kræver styring af foc vi bestiller for alle elementer i dokumentet med risiko for at skade usability og tilgængelighed, hvis de gøres forkert.
title
Global attribut, der er gyldig for alle elementer, inklusive alle inputtyper , der indeholder en tekst, der repræsenterer rådgivende information relateret til det element, den tilhører. Sådan information kan typisk, men ikke nødvendigvis, præsenteres for brugeren som et værktøjstip. Titlen skal IKKE bruges som den primære forklaring på formålet med formularkontrollen. Brug i stedet elementet <label> med et for -attribut, der er indstillet til formkontrol “s id attribut. Se etiketter nedenfor.
type
En streng, der angiver den type kontrol, der skal gengives. For eksempel, for at oprette et afkrydsningsfelt, en værdi på checkbox bruges. Hvis udeladt (eller der er angivet en ukendt værdi), bruges inputtypen text, hvilket skaber et inputtekstfelt med almindelig tekst.
Tilladte værdier er angivet i <input> -typer ovenfor.
value
Indgangskontrolens værdi. Når det er angivet i HTML, er dette den oprindelige værdi, og fra da af kan den ændres eller hentes når som helst ved hjælp af JavaScript for at få adgang til det respektive HTMLInputElement objekt “s value egenskab. value -attributten er altid valgfri, men skal betragtes som obligatorisk for checkbox, radio og hidden.
width
Gælder for image kun inputknap, width er bredden på den billedfil, der skal vises for at repræsentere den grafiske afsendeknap. Se billedinputtypen.