accept
Gyldig kun for file inngangstype, accept attributtet definerer hvilke filtyper som kan velges i en file opplastingskontroll. Se filtypen.
alt
Gjelder bare image -knappen, alt attributt gir alternativ tekst for bildet, og viser verdien av attributtet hvis bildet src mangler eller på annen måte ikke kan lastes inn. Se bildetypen.
autocomplete
(Ikke et boolsk attributt!) autocomplete -attributtet tar sin verdi en mellomromsseparert streng som beskriver hvilken type eventuelt autofullføringsfunksjonalitet inngangen skal gi. En typisk implementering av autofullføring husker tidligere verdier som er angitt i det samme inndatafeltet, men mer komplekse former for autofullføring kan eksistere. For eksempel kan en nettleser integreres med enhetens kontaktliste for å fullføre autofullføring email adresser i et e-postinntastingsfelt. Se Verdier i attributtet HTML autofullføring for tillatte verdier.
autocomplete attributtet er gyldig på hidden, text, search, url, tel, email, date, month, week, time, datetime-local, number, range, color og password. Dette attributtet har ingen effekt på inndatatyper som ikke returnerer numeriske data eller tekstdata, og er gyldig for alle inndatatyper unntatt checkbox, radio, file, eller noen av knappetypene.
Se HTML-autofullfør-attributt f eller tilleggsinformasjon, inkludert informasjon om passordsikkerhet og hvordan autocomplete er litt annerledes for hidden enn for andre inngangstyper.
autofocus
Et boolsk attributt som, hvis det er tilstede, indikerer at inngangen automatisk skal ha fokus når siden er lastet inn (eller når <dialog> som inneholder elementet har blitt vist).
Merk: Et element med attributtet autofocus kan få fokus før DOMContentLoaded hendelsen er utløst.
Ikke mer enn ett element i dokumentet kan ha attributtet autofocus. Hvis det settes på mer enn ett element, får det første med attributtet fokus.
autofocus -attributtet kan ikke brukes på innganger av typen hidden, siden skjulte innganger ikke kan fokuseres.
Advarsel: Automatisk fokusering av skjemakontroll kan forvirre synshemmede ved hjelp av skjermleseteknologi og personer med kognitive funksjonsnedsettelser. Når autofocus er tildelt, «teleporterer» skjermlesere brukeren til skjemakontrollen uten å advare dem på forhånd.
Vær nøye med hensyn til tilgjengelighet når bruker autofocus attributtet. Automatisk fokusering på en kontroll kan føre til at siden blar under belastning. Fokuset kan også føre til at dynamiske tastaturer vises på noen berøringsenheter. Mens en skjermleser vil kunngjøre etiketten til skjemakontrollen som mottar fokus, vil skjermleseren ikke kunngjøre noe før etiketten, og den seende brukeren på en liten enhet vil også savne konteksten som ble opprettet av det foregående innholdet. div id = «7986378a1b»>
Bare introdusert i HTML Media Capture-spesifikasjonen og gyldig for file -typen, capture attributt definerer hvilket medium — mikrofon, video eller kamera — som skal brukes til å fange en ny fil for opplasting med file opplastingskontroll i støttende scenarier. Se filtypen.
checked
Gyldig for både radio og checkbox types, checked er et boolsk attributt. Hvis det er tilstede på en radio -type, indikerer det at alternativknappen er den valgte i gruppen med samme navneknapper. Hvis det finnes på en checkbox -type, indikerer det at avkrysningsruten er merket av som standard (når siden lastes inn). Det indikerer ikke om denne avkrysningsruten er merket av for øyeblikket. Hvis avkrysningsrundens tilstand endres, gjenspeiler ikke dette innholdsattributtet endringen. (Bare HTMLInputElement ’s checked IDL-attributt er oppdatert.)
Merk: I motsetning til andre inngangskontroller er en avkrysningsrute og alternativknappverdi bare inkludert i de innsendte dataene hvis de for øyeblikket er checked. Hvis de er det, sendes navnet og verdien på kontrollerte kontroller.
For eksempel hvis en avkrysningsrute hvis name er fruit har en value av cherry, og avkrysningsruten er merket, skjemadataene som sendes inn vil omfatte fruit=cherry. Hvis avkrysningsruten ikke er aktiv, vises den ikke i skjemadataene i det hele tatt. Standard value for avkrysningsruter og alternativknapper er on.
dirname
Gyldig bare for text og search inngangstyper, dirname attributt muliggjør innlevering av elementets retningsretning. Når det er inkludert, vil skjemakontrollen sende inn med to navn / verdipar: den første er name og value, den andre er verdien av dirname som navnet med verdien ltr eller rtl som er satt av nettleser.
Når skjemaet ovenfor sendes inn, forårsaker inngangen både name / value par av fruit=cherry og dirname / retningspar for fruit.dir=ltr som skal sendes.
disabled
Et boolsk attributt som, hvis det er tilstede, indikerer at brukeren ikke skal kunne samhandle med inngangen. Deaktiverte innganger blir vanligvis gjengitt med en dimmerfarge eller med en annen indikasjon på at feltet ikke er tilgjengelig for bruk.
Spesifikt mottar deaktiverte innganger ikke click hendelse, og deaktiverte innganger sendes ikke med skjemaet.
Merk: Selv om det ikke kreves av spesifikasjonen, vil Firefox som standard fortsette den dynamiske deaktiverte tilstanden til en <input> på tvers av sider. Bruk autocomplete -attributtet til å kontrollere denne funksjonen.
form
En streng som spesifiserer <form> element som inngangen er tilknyttet (det vil si forminneieren). Denne strengens verdi, hvis den er tilstede, må samsvare med id til et <form> -element i samme dokument. Hvis dette attributtet ikke er «t spesifisert, er <input> -elementet knyttet til den nærmeste formen, hvis noen.
form -attributtet lar deg plasser en inngang hvor som helst i dokumentet, men ha den med i et skjema et annet sted i dokumentet.
Merk: En inngang kan bare knyttes til ett skjema.
formaction
Gyldig kun for inngangstypene image og submit. Se innsendingstypen for mer informasjon.
formenctype
Gyldig for image og submit bare inndatatyper. Se innsendingstypen for mer informasjon.
formmethod
Gyldig for image og submit bare inndatatyper. Se innsendingstypen for mer informasjon.
formnovalidate
Gyldig for image og submit bare inndatatyper. Se innsendingstypen for mer informasjon.
formtarget
Gyldig for image og submit bare inndatatyper. Se innsendingstypen for mer informasjon.
height
Gjelder kun image inngangsknappen, height er høyden på bildefilen som skal vises for å representere den grafiske sendeknappen. Se bildetypen.
id
Globalt attributt som er gyldig for alle elementer, inkludert alle inngangstyper, det definerer en unik identifikator (ID) som må være unik i hele dokumentet. Hensikten er å identifisere elementet når du kobler sammen. Verdien brukes som verdien for <label> «s for -attributtet for å koble etiketten med skjemakontrollen. Se <label>.
inputmode
Global verdi gyldig for alle elementer, det gir et tips til nettlesere om typen virtuelt tastaturkonfigurasjon som brukes når du redigerer dette elementet eller dets innhold. Verdiene inkluderer none, text, tel, url, email, numeric, decimal, og search.
list
Verdien gitt til list -attributtet skal være id av et <datalist> -element i samme dokument. <datalist> gir en liste over forhåndsdefinerte verdier som skal foreslås til brukeren for denne inngangen. Verdier i listen som ikke er kompatible med type, er ikke inkludert i de foreslåtte alternativene. Verdiene som er gitt er forslag, ikke krav: brukere kan velge fra denne forhåndsdefinerte listen eller oppgi en annen verdi.
Den er gyldig på text, search, url, tel, email, date, month, week, time, datetime-local, number, range og color.
I henhold til spesifikasjonene støttes ikke list -attributtet av hidden, password, checkbox, radio, file, eller en hvilken som helst av knappetypene.
Avhengig av nettleseren, kan det hende at brukeren ser en tilpasset fargepalett, tic-merker langs et område eller til og med en inngang som åpnes som en <select> men tillater ikke-noterte va lues. Sjekk nettleserkompatibilitetstabellen for de andre inndatatypene.
Se <datalist> -elementet.
max
Gyldig for date, month, week, time, datetime-local, number, og range, den definerer den største verdien i området tillatte verdier. Hvis value angitt i elementet overstiger dette, mislykkes elementet validering av begrensning. Hvis verdien til max -attributtet ikke er «ta-nummer, har elementet ingen maksimumsverdi.
Det er et spesielt tilfelle: hvis datatypen er periodisk (for eksempel for datoer eller klokkeslett), kan verdien til max være lavere enn verdien til min, noe som indikerer at området kan vikle rundt, for eksempel lar dette deg spesifisere et tidsintervall fra kl. 22.00 til kl. 04.00.
maxlength
Gyldig for text, search, url, tel, email og password, det definerer maksimalt antall tegn (som UTF-16-kodenheter) brukeren kan angi i feltet. Dette må være et heltall 0 eller høyere. Hvis ingen maxlength er spesifisert, eller en ugyldig verdi er spesifisert, har feltet ingen maksimal lengde. Denne verdien må også være større enn eller lik verdien av
Inngangen mislykkes validering av begrensning hvis lengden på teksten som er angitt i feltet er større enn maxlength UTF-16-kodenheter lange. Som standard forhindrer nettlesere brukere fra å skrive inn flere tegn enn tillatt av maxlength -attributtet. Se validering på klientsiden for mer informasjon.
min
Gyldig for date, month, week, time, datetime-local, number, og range, definerer den den mest negative verdien i området tillatte verdier. Hvis value som er angitt i elementet, er mindre enn dette, mislykkes elementet validering av begrensning. Hvis verdien av min -attributtet ikke er «ta-nummer, har elementet ingen minimumsverdi.
Denne verdien må være mindre enn eller lik verdien til max attributtet. Hvis min attributtet er tilstede, men ikke er spesifisert eller er ugyldig, er ingen min -verdien brukes. Hvis min -attributtet er gyldig og en ikke-tom verdi er mindre enn det minimum som er tillatt av min attributt, vil validering av begrensning forhindre innlevering av skjema. Se Validering på klientsiden for mer informasjon.
Det er et spesielt tilfelle: Hvis datatypen er periodisk (for eksempel for datoer eller klokkeslett), er verdien max kan være lavere enn verdien til min, noe som indikerer at området kan brytes rundt; for eksempel lar dette deg spesifisere en tid varierer fra 22:00 til 04:00.
minlength
Gyldig for text, search, url, tel, email, og password, den definerer minimum antall tegn (som UTF-16-kodenheter) brukeren kan angi i inntastingsfeltet. Dette må være et ikke-negativt heltall som er mindre enn eller lik verdien som er angitt av maxlength. Hvis ingen minlength er spesifisert, eller en ugyldig verdi er spesifisert, har inngangen ingen minimumslengde.
Inngangen mislykkes validering av begrensning hvis lengden på teksten angitt i feltet er færre enn minlength UTF-16-kodenheter lang, og forhindrer innlevering av skjema. Se validering på klientsiden for mer informasjon.
multiple
Det boolske multiple -attributtet, hvis angitt, betyr brukeren kan skrive inn kommaadskilte e-postadresser i e-postmodulen eller velge mer enn en fil med inngangen file. Se typen e-post og filinndata.
name
En streng som angir et navn for inngangskontrollen. Dette navnet sendes sammen med kontrollens verdi når skjemadataene sendes inn.
Hva er i et navn
Vurder name et obligatorisk attributt (selv om det ikke er). Hvis en inngang ikke har spesifisert name, eller name er tom, inngangsverdien sendes ikke sammen med skjemaet! (Deaktiverte kontroller, ukontrollerte radioknapper, ukontrollerte avkrysningsruter og tilbakestillingsknapper sendes heller ikke.)
Det er to spesielle tilfeller:
-
_charset_: Hvis det brukes som navnet på et<input>element av typen skjult, blir inngangen «svalueautomatisk satt av brukeragenten til tegnkodingen som brukes til å sende inn skjemaet. -
isindex: Av historiske årsaker, navnetisindexer ikke tillatt.
navn og radioknapper
name -attributtet skaper en unik oppførsel for radioknapper.
Bare en radioknapp i en gruppe med radioknapper med samme navn kan sjekkes av gangen. Hvis du velger en hvilken som helst alternativknapp i den gruppen, fjernes det automatisk valgt valgt knapp i samme gruppe. Verdien av at en merket alternativknapp sendes sammen med navnet hvis skjemaet sendes inn,
Når du tapper inn i en serie av samme -navnet gruppe radioknapper, hvis en er merket av, vil den ene få fokus. Hvis de ikke er gruppert i kildefølge, hvis en av gruppen er merket av, starter fanen i gruppen når den første i gruppen oppstår, og hopper over alle de som ikke er merket. Med andre ord, hvis en er krysset av, hopper tabbing over de ukontrollerte alternativknappene i gruppen. Hvis ingen er merket av, får radioknappgruppen fokus når den første knappen i gruppen med samme navn er nådd.
Når en av radioknappene i en gruppe har fokus, bruker du piltastene gjennom alle radioknappene med samme navn, selv om radioknappene ikke er gruppert i kildefølget.
HTMLFormElement.elements
Når et inngangselement får name, blir dette navnet en egenskap for det eier formelementet «s HTMLFormElement.elements -egenskap. Hvis du har en inngang hvis name er satt til guest og en annen hvis name er hat-size, følgende kode kan brukes:
Når denne koden har kjørt, vil guestName være HTMLInputElement for guest -feltet, og hatSize objektet for hat-size felt.
name som tilsvarer en innebygd egenskap for skjemaet, siden du da vil overstyre den forhåndsdefinerte egenskapen eller metoden med denne referansen til den tilsvarende inngangen. pattern
pattern -attributtet, når det er spesifisert, er et vanlig uttrykk for at inngang «s value må samsvare for at verdien skal bestå begrensningsvalidering. Det må være et gyldig JavaScript-regulært uttrykk, som det brukes av RegExp -typen, og som dokumentert i vår guide om regulære uttrykk; "u" flagget er spesifisert når du kompilerer det regulære uttrykket, slik at mønsteret blir behandlet som en sekvens av Unicode-kodepunkter, i stedet for som ASCII. Ingen skråstrek fremover skal spesifiseres rundt mønsterteksten.
Hvis pattern -attributtet er tilstede, men ikke er spesifisert eller er ugyldig, brukes ikke noe regulært uttrykk, og dette attributt ignoreres fullstendig.Hvis mønsterattributtet er gyldig og en ikke-tom verdi ikke samsvarer med mønsteret, vil begrensningsvalidering forhindre innlevering av skjema.
Tips: Hvis du bruker pattern attributt, informer brukeren om det forventede formatet ved å ta med forklarende tekst i nærheten. Du kan også inkludere et title -attributt for å forklare hva kravene er for å matche mønsteret; de fleste nettlesere vil vise denne tittelen som en verktøytips. Den synlige forklaringen kreves for tilgjengelighet. Verktøytipsen er en forbedring.
Se validering på klientsiden for mer informasjon.
placeholder
The placeholder attributt er en streng som gir et kort hint til brukeren om hva slags informasjon som forventes i feltet. Det bør være et ord eller en kort setning som gir et hint om den forventede typen data, snarere enn en forklaring eller ledetekst. Teksten må ikke inkludere vognretur eller linjefôring. Så for eksempel hvis et felt forventes å fange brukerens fornavn, og etiketten er «Fornavn», kan en passende plassholder være «f.eks. Mustafa «.
Merk: placeholder -attributtet er ikke like semantisk nyttig som andre måter å forklare skjemaet på, og kan forårsake uventede tekniske problemer med innhold. Se Etiketter i < input >: Input (Form Input) element for mer informasjon.
readonly
Et boolsk attributt som, hvis det er tilstede, indikerer at brukeren ikke skal kunne redigere verdien av inngangen. readonly attributt støttes text, search, url, tel, email, date, month, week, time, datetime-local, number og password inndatatyper.
Se HTML-attributtet: readonly for mer informasjon.
required er et boolsk attributt som, hvis det er tilstede, indikerer at brukeren må spesifisere en verdi for inngangen før eierskjemaet kan sendes inn. required -attributtet støttes av text, search, url, tel, email, date, month, week, time, datetime-local, number, password, checkbox, radio, og file innganger.
Se validering på klientsiden og HTML-attributtet: required for mer informasjon.
sizeGyldig foremail,password,tel, ogtextinputtyper. Spesifiserer hvor mye av inngangen som vises. Oppretter i utgangspunktet det samme resultatet som å sette CSSwidth-egenskap med noen få spesialiteter. Den faktiske verdienheten avhenger av inngangstypen. Forpasswordogtexter det et antall tegn (elleremenheter) med en standardverdi på20, og for andre er detpixels. CSS-bredde har forrang over størrelsesattributt.src
Gyldig kun for image inngangsknappen, src angir streng URL-en til bildefilen som skal vises for å representere den grafiske sendeknappen. Se bildeinngangstypen.
step
Gyldig for de numeriske inndatatypene, inkludert number, dato / tidsinngangstyper, og range, step -attributtet er et tall som spesifiserer granulariteten som verdien må overholde.
Hvis ikke eksplisitt inkludert:
-
steper som standard 1 fornumberogrange. - For dato- / klokkeslettstypene uttrykkes
stepi sekunder, med standardtrinnet 60 sekunder . Trinnskalafaktoren er 1000 (som konverterer sekundene til millisekunder, som brukt i andre algoritmer).
Verdien må være et positivt tall — heltall eller flyte — eller spesialverdien any, som betyr at ingen trinn er underforstått, og noen verdi er tillatt (uten andre begrensninger, for eksempel min og max).
Hvis any ikke er spesifisert, gyldige verdier for number, dato / klokkeslett og range inngangstyper er like trinn for trinn – min verdi og trinn for trinnverdien, opp til max verdi, hvis spesifisert.
For eksempel, hvis du har <input type="number" min="10" step="2">, så et hvilket som helst heltall, 10 eller høyere, er gyldig. Hvis utelatt <input type="number">, er ethvert heltall gyldig, men flottører (som 4.2) er ikke gyldige, fordi step er som standard 1. For at 4.2 skulle være gyldig, ville step måtte settes til any, 0,1 , 0.2, eller hvilken som helst min -verdien måtte ha vært et tall som slutter på .2, for eksempel <input type="number" min="-5.2">
Merk: Når dataene som er angitt av brukeren ikke overholder trinnkonfigurasjonen, blir verdien ansett som ugyldig i valideringen av kontrakten og vil samsvare med :invalid pseudoklasse.
Se validering på klientsiden for mer informasjon.
tabindex
Globalt attributt gyldig for alle elementer, inkludert alle inngangstyper, et heltallattributt som indikerer om elementet kan ta inngangsfokus (kan fokuseres), om det skal delta i sekvensiell tastaturnavigasjon. Som alle inngangstyper unntatt inngang av typen skjult er fokuserbare, bør ikke dette attributtet brukes på skjemakontroller, fordi det vil kreve ledelsen av foc oss bestille for alle elementene i dokumentet med risiko for å skade brukervennlighet og tilgjengelighet hvis de gjøres feil.
title
Globalt attributt gyldig for alle elementer, inkludert alle inngangstyper , som inneholder en tekst som representerer rådgivende informasjon relatert til elementet den tilhører. Slik informasjon kan vanligvis, men ikke nødvendigvis, presenteres for brukeren som en verktøytips. Tittelen skal IKKE brukes som den primære forklaringen på formålet med skjemakontrollen. Bruk i stedet <label> -elementet med et for -attributt satt til skjemakontrollen «s id attributt. Se etiketter nedenfor.
type
En streng som spesifiserer typen kontroll som skal gjengis. For eksempel, for å opprette en avkrysningsrute, verdien checkbox brukes. Hvis utelatt (eller en ukjent verdi er spesifisert), brukes inndatatypen text, og skaper et tekstfelt for ren tekst.
Tillatte verdier er oppført i <input> -typene ovenfor.
value
Inngangskontrollens verdi. Når det er spesifisert i HTML, er dette den opprinnelige verdien, og fra da av kan den endres eller hentes når som helst ved hjelp av JavaScript for å få tilgang til det respektive HTMLInputElement objektet «s value -egenskap. value -attributtet er alltid valgfritt, men skal betraktes som obligatorisk for checkbox, radio, og hidden.
width
Gyldig for image bare inngangsknappen, width er bredden på bildefilen som skal vises for å representere den grafiske sendeknappen. Se bildeinngangstypen.