accept
Alleen geldig voor het file
invoertype, het accept
attribuut definieert welke bestandstypen kunnen worden geselecteerd in een file
uploadcontrole. Bekijk het bestandstype.
alt
Alleen geldig voor de image
-knop, de alt
attribuut biedt alternatieve tekst voor de afbeelding, waarbij de waarde van het attribuut wordt weergegeven als de afbeelding src
ontbreekt of anderszins niet kan worden geladen. Bekijk het invoertype voor afbeeldingen.
autocomplete
(Geen Booleaans kenmerk!) Het autocomplete
-attribuut neemt als waarde een door spaties gescheiden string die beschrijft wat, indien aanwezig, type autocomplete functionaliteit de invoer zou moeten bieden. Een typische implementatie van autocomplete roept eerdere waarden op die in hetzelfde invoerveld zijn ingevoerd, maar er kunnen complexere vormen van autocomplete bestaan. Een browser kan bijvoorbeeld worden geïntegreerd met de contactenlijst van een apparaat om email
adressen automatisch aan te vullen in een e-mailinvoerveld. Zie Waarden in het kenmerk HTML automatisch aanvullen voor toegestane waarden.
Het autocomplete
kenmerk is geldig op hidden
, text
, search
, url
, tel
, email
, date
, month
, week
, time
, datetime-local
, number
, range
, color
en password
. Dit kenmerk heeft geen effect op invoertypen die geen numerieke of tekstgegevens retourneren, en is geldig voor alle invoertypen behalve checkbox
, radio
, file
, of een van de knoptypes.
Zie Het kenmerk HTML autocomplete f of aanvullende informatie, inclusief informatie over wachtwoordbeveiliging en hoe autocomplete
iets anders is voor hidden
dan voor andere invoertypes.
autofocus
Een Booleaans attribuut dat, indien aanwezig, aangeeft dat de invoer automatisch de focus moet hebben wanneer de pagina is geladen (of wanneer het <dialog>
met het element is weergegeven).
Opmerking: een element met het autofocus
-attribuut kan de aandacht krijgen voordat het DOMContentLoaded
gebeurtenis is geactiveerd.
Niet meer dan één element in het document mag het autofocus
attribuut hebben. Als het op meer dan één element wordt gezet, krijgt het eerste met het attribuut de focus.
Het autofocus
attribuut kan niet gebruikt worden op invoer van het type hidden
, aangezien verborgen invoer niet kan worden gefocust.
Waarschuwing: het automatisch scherpstellen van een formulierbesturingselement kan visueel gehandicapte mensen die schermleestechnologie gebruiken en mensen met cognitieve beperkingen in verwarring brengen. Wanneer autofocus
is toegewezen, “teleporteren” schermlezers hun gebruiker naar het formulierbesturingselement zonder hen vooraf te waarschuwen.
Wees voorzichtig met toegankelijkheid wanneer het toepassen van het autofocus
attribuut. Door automatisch op een besturingselement te focussen, kan de pagina scrollen bij het laden. De focus kan er ook voor zorgen dat dynamische toetsenborden worden weergegeven op sommige aanraakapparaten. Terwijl een schermlezer het label aankondigt van het formulierbesturingselement waarop focus wordt ontvangen, zal de schermlezer niets aankondigen vóór het label, en de ziende gebruiker op een klein apparaat zal evenzeer de context missen die is gecreëerd door de voorgaande inhoud.
capture
Geïntroduceerd in de HTML Media Capture-specificatie en alleen geldig voor het file
invoertype, het capture
definieert welke media (microfoon, video of camera) moet worden gebruikt om een nieuw bestand vast te leggen voor uploaden met file
uploadcontrole in ondersteunende scenario’s. Bekijk het bestandstype.
checked
Geldig voor zowel radio
als checkbox
types, checked
is een Booleaans kenmerk. Indien aanwezig op een radio
type, geeft dit aan dat het keuzerondje het momenteel geselecteerde is in de groep van gelijknamige keuzerondjes. Indien aanwezig op een checkbox
type, geeft dit aan dat het selectievakje standaard is aangevinkt (wanneer de pagina wordt geladen). Het geeft niet aan of dit selectievakje momenteel is aangevinkt: als de status van het selectievakje is gewijzigd, weerspiegelt dit inhoudskenmerk de wijziging niet. (Alleen het HTMLInputElement
’s checked
IDL-kenmerk is bijgewerkt.)
Opmerking: in tegenstelling tot andere invoerbesturingen, worden een waarde voor selectievakjes en keuzerondjes alleen opgenomen in de verzonden gegevens als ze momenteel checked
zijn. Als dat het geval is, worden de naam en de waarde (n) van de aangevinkte besturingselementen verzonden.
Bijvoorbeeld, als een selectievakje waarvan name
fruit
heeft een value
van cherry
, en het selectievakje is aangevinkt, de ingediende formuliergegevens bevatten fruit=cherry
. Als het selectievakje niet actief is, wordt het helemaal niet in de formuliergegevens vermeld. De standaard value
voor selectievakjes en keuzerondjes is on
.
dirname
Alleen geldig voor text
en search
invoertypen, de dirname
attribuut maakt het indienen van de directionaliteit van het element mogelijk. Indien opgenomen, wordt het formulierbesturingselement verzonden met twee naam / waarde-paren: de eerste is de name
en value
, de tweede is de waarde van de dirname
als de naam met de waarde van ltr
of rtl
die wordt ingesteld door de browser.
Wanneer het bovenstaande formulier wordt verzonden, veroorzaakt de invoer zowel het name
/ value
paar fruit=cherry
en het dirname
/ direction paar fruit.dir=ltr
te verzenden.
disabled
Een Booleaans attribuut dat, indien aanwezig, aangeeft dat de gebruiker niet zou moeten kunnen communiceren met de invoer. Uitgeschakelde invoer wordt meestal weergegeven met een zwakkere kleur of met een andere vorm van indicatie dat het veld niet beschikbaar is voor gebruik.
In het bijzonder ontvangen uitgeschakelde invoer niet de click
-gebeurtenis, en uitgeschakelde invoer wordt niet verzonden met het formulier.
Opmerking: hoewel dit niet vereist is door de specificatie, zal Firefox standaard de dynamische uitgeschakelde status van een over het laden van pagina’s. Gebruik het autocomplete
attribuut om deze functie te besturen.
form
Een string die de <form>
-element waarmee de invoer is geassocieerd (dat wil zeggen, de eigenaar van het formulier). De waarde van deze tekenreeks, indien aanwezig, moet overeenkomen met de id
van een <form>
-element in hetzelfde document. Als dit kenmerk niet is “t gespecificeerd, wordt het <input>
-element geassocieerd met de dichtstbijzijnde bevattende vorm, indien aanwezig.
Met het form
-attribuut kunt u plaats een invoer ergens in het document, maar laat het opnemen met een formulier elders in het document.
Opmerking: een invoer kan maar aan één formulier worden gekoppeld.
formaction
Alleen geldig voor de image
en submit
invoertypes. Zie het invoertype voor indienen voor meer informatie.
formenctype
Geldig voor de image
en submit
alleen invoertypes. Zie het invoertype voor indienen voor meer informatie.
formmethod
Geldig voor de image
en submit
alleen invoertypes. Zie het invoertype voor indienen voor meer informatie.
formnovalidate
Geldig voor de image
en submit
alleen invoertypes. Zie het invoertype voor indienen voor meer informatie.
formtarget
Geldig voor de image
en submit
alleen invoertypes. Zie het invoertype voor indienen voor meer informatie.
height
Alleen geldig voor de image
invoerknop, de height
is de hoogte van het afbeeldingsbestand dat moet worden weergegeven om de grafische verzendknop weer te geven. Bekijk het invoertype voor afbeeldingen.
id
Globaal kenmerk geldig voor alle elementen, inclusief alle invoertypes, het definieert een unieke identificatie (ID) die uniek moet zijn in het hele document. Het doel is om het element te identificeren bij het koppelen. De waarde wordt gebruikt als de waarde van het <label>
“s for
-attribuut om het label te koppelen aan het formulierbesturingselement. Zie <label>
.
inputmode
Globale waarde geldig voor alle elementen, het geeft browsers een hint over het type virtuele toetsenbordconfiguratie gebruiken bij het bewerken van dit element of de inhoud ervan. Waarden zijn onder meer none
, text
, tel
, url
, email
, numeric
, decimal
en search
.
list
De waarde die wordt gegeven aan het list
-attribuut moet het id
van een <datalist>
-element dat zich in hetzelfde document bevindt. De <datalist>
biedt een lijst met vooraf gedefinieerde waarden om de gebruiker voor te stellen voor deze invoer. Alle waarden in de lijst die niet compatibel zijn met de type
zijn niet opgenomen in de voorgestelde opties. De opgegeven waarden zijn suggesties, geen vereisten: gebruikers kunnen kiezen uit deze vooraf gedefinieerde lijst of een andere waarde opgeven.
Het is geldig op text
, search
, url
, tel
, email
, date
, month
, week
, time
, datetime-local
, number
, range
, en color
.
Volgens de specificaties wordt het list
-attribuut niet ondersteund door het hidden
, password
, checkbox
, radio
, file
of eender welke van de knoptypen.
Afhankelijk van de browser kan de gebruiker een voorgesteld kleurenpalet, tikmarkeringen langs een bereik of zelfs een invoer die wordt geopend als een <select>
maar staat niet-vermelde va toe lues. Bekijk de browsercompatibiliteitstabel voor de andere invoertypes.
Zie het <datalist>
-element.
max
Geldig voor date
, month
, week
, time
, datetime-local
, number
, en range
, het definieert de grootste waarde in het bereik van toegestane waarden. Als de value
die in het element is ingevoerd dit overschrijdt, mislukt de validatie van de beperking. Als de waarde van het max
attribuut geen “ta-nummer” is, dan heeft het element geen maximumwaarde.
Er is een speciaal geval: als het datatype periodiek is (zoals voor datums of tijden), de waarde van max
kan lager zijn dan de waarde van min
, wat aangeeft dat het bereik wrap around; hiermee kunt u bijvoorbeeld een tijdbereik opgeven van 22.00 uur tot 04.00 uur.
maxlength
Geldig voor text
, search
, url
, tel
, email
, en password
, definieert het het maximum aantal tekens (als UTF-16 code-eenheden) dat de gebruiker in het veld kan invoeren. Dit moet een geheel getal zijn 0
of hoger. Als er geen maxlength
is opgegeven of als er een ongeldige waarde is opgegeven, heeft het veld geen maximale lengte. Deze waarde moet ook groter zijn dan of gelijk zijn aan de waarde van
De invoer mislukt de validatie van de beperking als de lengte van de tekst die in het veld is ingevoerd groter is dan maxlength
UTF-16 code-eenheden lang. Browsers voorkomen standaard dat gebruikers meer tekens invoeren dan is toegestaan door het kenmerk maxlength
. Zie validatie aan clientzijde voor meer informatie.
min
Geldig voor date
, month
, week
, time
, datetime-local
, number
, en range
, definieert het de meest negatieve waarde in het bereik van toegestane waarden. Als de value
die in het element is ingevoerd kleiner is dan dit, mislukt de validatie van de beperking. Als de waarde van het min
-attribuut geen getal is, heeft het element geen minimumwaarde.
Deze waarde moet kleiner zijn dan of gelijk zijn aan de waarde van het max
attribuut. Als het min
attribuut aanwezig is maar niet gespecificeerd of ongeldig is, geen min
-waarde wordt toegepast. Als het min
-attribuut geldig is en een niet-lege waarde kleiner is dan het minimum dat is toegestaan door de min
attribuut, beperking validatie zal het indienen van formulieren voorkomen. Zie Client-side validatie voor meer informatie.
Er is een speciaal geval: als het gegevenstype periodiek is (zoals voor datums of tijden), de waarde van max
kan lager zijn dan de waarde van min
, wat aangeeft dat het bereik rond kan lopen; hiermee kunt u bijvoorbeeld een tijd specificeren bereik van 22.00 uur tot 04.00 uur.
minlength
Geldig voor text
, search
, url
, tel
, email
, en password
, het definieert het minimum aantal tekens (als UTF-16 code-eenheden) dat de gebruiker in het invoerveld kan invoeren. Dit moet een niet-negatief geheel getal zijn dat kleiner is dan of gelijk is aan de waarde die is opgegeven door maxlength
. Als er geen minlength
is opgegeven, of een ongeldige waarde is opgegeven, heeft de invoer geen minimumlengte.
De invoer mislukt de validatie van de beperking als de lengte van de tekst ingevoerd in het veld is minder dan minlength
UTF-16 code-eenheden lang, waardoor formulierverzending niet mogelijk is. Zie Client-side validatie voor meer informatie.
multiple
Het Booleaanse multiple
-attribuut, indien ingesteld, betekent de gebruiker kan door komma’s gescheiden e-mailadressen invoeren in de e-mailwidget of kan meer dan één bestand kiezen met de file
-invoer. Bekijk het invoertype voor e-mail en bestanden.
name
Een tekenreeks die een naam specificeert voor het invoerbesturingselement. Deze naam wordt samen met de waarde van het besturingselement verzonden wanneer de formuliergegevens worden verzonden.
Wat zit er in een naam
Beschouw de name
een vereist kenmerk (ook al is het “niet). Als voor een invoer geen name
is opgegeven, of name
is leeg, de input “s waarde is niet verzonden met het formulier! (Uitgeschakelde besturingselementen, niet-aangevinkte keuzerondjes, niet-aangevinkte selectievakjes en resetknoppen worden ook niet verzonden.)
Er zijn twee speciale gevallen:
-
_charset_
: indien gebruikt als de naam van een<input>
element van het type verborgen, wordt de invoer “svalue
automatisch ingesteld door de user-agent naar de tekencodering die wordt gebruikt om het formulier in te dienen. -
isindex
: om historische redenen is de naamisindex
is niet toegestaan.
naam en keuzerondjes
Het name
-attribuut creëert een uniek gedrag voor keuzerondjes.
Er kan slechts één keuzerondje in een gelijknamige groep keuzerondjes tegelijk worden aangevinkt. Als u een keuzerondje in die groep selecteert, wordt de selectie van elk momenteel geselecteerd keuzerondje in dezelfde groep automatisch opgeheven. De waarde van dat ene aangevinkte keuzerondje wordt meegestuurd met de naam als het formulier is verzonden,
Bij het tabellen in een reeks van dezelfde -benoemde groep keuzerondjes, als er een is aangevinkt, krijgt die focus. Als ze niet in de volgorde van de bron zijn gegroepeerd, en als een van de groepen is aangevinkt, begint het tabben in de groep wanneer de eerste in de groep wordt aangetroffen, waarbij alle niet zijn aangevinkt. Met andere woorden, als er een is aangevinkt, slaat het tabben de niet-aangevinkte keuzerondjes in de groep over. Als er geen is aangevinkt, krijgt de groep keuzerondjes focus wanneer de eerste knop in dezelfde naamgroep wordt bereikt.
Zodra een van de keuzerondjes in een groep focus heeft, kunt u met de pijltoetsen door alle de keuzerondjes met dezelfde naam, zelfs als de keuzerondjes niet gegroepeerd zijn in de volgorde van de bron.
HTMLFormElement.elements
Wanneer een invoerelement een name
, wordt die naam een eigenschap van het formulierelement “s HTMLFormElement.elements
-eigenschap van het formulierelement. Als u een invoer heeft waarvan name
is ingesteld op guest
en een andere waarvan name
is hat-size
, de volgende code kan worden gebruikt:
Wanneer deze code is uitgevoerd, is guestName
de HTMLInputElement
voor het guest
veld, en hatSize
het object voor het hat-size
veld.
Waarschuwing: geef formulierelementen geen name
die overeenkomt met een ingebouwde eigenschap van het formulier, aangezien u dan de vooraf gedefinieerde eigenschap of methode zou overschrijven met deze verwijzing naar de overeenkomstige invoer.
pattern
Het pattern
-attribuut is, indien gespecificeerd, een reguliere expressie die de input “s value
moet overeenkomen om ervoor te zorgen dat de waarde de beperkende validatie doorstaat. Het moet een geldige JavaScript-reguliere expressie zijn, zoals gebruikt door het RegExp
-type, en zoals gedocumenteerd in onze gids over reguliere expressies; de vlag "u"
wordt opgegeven bij het compileren van de reguliere expressie, zodat het patroon wordt behandeld als een reeks Unicode-codepunten in plaats van als ASCII. Er mogen geen schuine strepen rond de patroontekst worden opgegeven.
Als het kenmerk pattern
aanwezig is maar niet is opgegeven of ongeldig is, wordt geen reguliere expressie toegepast en dit attribuut wordt volledig genegeerd.Als het patroonattribuut geldig is en een niet-lege waarde niet overeenkomt met het patroon, voorkomt validatie van beperkingen het indienen van formulieren.
Tip: als u de pattern
attribuut, informeer de gebruiker over het verwachte formaat door verklarende tekst in de buurt op te nemen. U kunt ook een title
-attribuut opnemen om uit te leggen wat de vereisten zijn om bij het patroon te passen; de meeste browsers geven deze titel weer als tooltip. De zichtbare uitleg is nodig voor toegankelijkheid. De tooltip is een verbetering.
Zie Client-side validatie voor meer informatie.
placeholder
De placeholder
attribuut is een tekenreeks die de gebruiker een korte hint geeft over wat voor soort informatie in het veld wordt verwacht. Het moet een woord of een korte zin zijn die een hint geeft over het verwachte type gegevens, in plaats van een uitleg of prompt. De tekst mag geen regelteruglopen of regelfeeds bevatten. Dus als bijvoorbeeld van een veld wordt verwacht dat het de voornaam van een gebruiker vastlegt, en het label is “Voornaam”, kan een geschikte tijdelijke aanduiding zijn “bijv. Mustafa “.
Opmerking: het placeholder
-attribuut is niet zo semantisch nuttig als andere manieren om uw formulier uit te leggen, en kan onverwachte technische problemen veroorzaken met uw inhoud. Zie Labels in < input >: het Input (Form Input) -element voor meer informatie.
readonly
Een Booleaans kenmerk dat, indien aanwezig, aangeeft dat de gebruiker de waarde van de invoer niet mag bewerken. De readonly
kenmerk wordt ondersteund text
, search
, url
, tel
, email
, date
, month
, week
, time
, datetime-local
, number
, en password
invoertypen.
Zie het HTML-kenmerk: readonly
voor meer informatie.
required
is een Booleaans attribuut dat, indien aanwezig, aangeeft dat de gebruiker een waarde voor de invoer moet specificeren voordat het formulier kan worden verzonden. Het required
kenmerk wordt ondersteund door text
, search
, url
, tel
, email
, date
, month
, week
, time
, datetime-local
, number
, password
, checkbox
, radio
, en file
invoer.
Zie Client-side validatie en het HTML-kenmerk: required
voor meer informatie.
size
Geldig vooremail
,password
,tel
, entext
input
typen alleen. Geeft aan hoeveel van de invoer wordt weergegeven. Creëert in principe hetzelfde resultaat als het instellen van CSSwidth
eigenschap met een paar specialiteiten. De werkelijke eenheid van de waarde hangt af van het invoertype. Voorpassword
entext
is het een aantal tekens (ofem
eenheden) met een standaardwaarde van20
, en voor anderen is hetpixel
s. CSS-breedte heeft voorrang op het kenmerk size.src
Alleen geldig voor de image
invoerknop, de src
specificeert een tekenreeks de URL van het afbeeldingsbestand dat moet worden weergegeven om de grafische verzendknop weer te geven. Bekijk het invoertype voor afbeeldingen.
step
Geldig voor de numerieke invoertypes, inclusief number
, datum / time invoertypen, en range
, het step
-attribuut is een getal dat de granulariteit aangeeft waaraan de waarde moet voldoen.
Indien niet expliciet opgenomen:
-
step
wordt standaard ingesteld op 1 voornumber
enrange
. - Voor de invoertypes voor datum / tijd wordt
step
uitgedrukt in seconden, met de standaardstap 60 seconden . De stapschaalfactor is 1000 (die de seconden omzet in milliseconden, zoals gebruikt in andere algoritmen).
De waarde moet een positief getal zijn — geheel getal of zwevend — of de speciale waarde any
, wat betekent dat stappen niet worden geïmpliceerd, en elke waarde is toegestaan (behoudens andere beperkingen, zoals min
en max
).
Als any
niet expliciet is ingesteld, geldige waarden voor de number
, datum / tijd-invoertypen en range
invoertypen zijn gelijk aan de basis voor stepping – de min
waarde en incrementen van de stapwaarde, tot aan de max
waarde, indien gespecificeerd.
Als je bijvoorbeeld <input type="number" min="10" step="2">
hebt, dan elk even integer, 10
of hoger, is geldig. Indien weggelaten, <input type="number">
, is elk geheel getal geldig, maar floats (zoals 4.2
) zijn niet geldig, omdat step
is standaard 1
. Om 4.2
geldig te laten zijn, zou step
moeten worden ingesteld op any
, 0.1 , 0.2 of een van de min
-waarde zou een getal moeten zijn dat eindigt op .2
, zoals <input type="number" min="-5.2">
Opmerking: als de gegevens die door de gebruiker zijn ingevoerd niet voldoen aan de stepping-configuratie, wordt de waarde als ongeldig beschouwd bij contraintvalidatie en komt deze overeen met de :invalid
pseudoclass.
Zie Client-side validatie voor meer informatie.
tabindex
Globaal attribuut geldig voor alle elementen, inclusief alle invoertypen, een integer-attribuut dat aangeeft of het element invoerfocus kan krijgen (is focusbaar), of het moet deelnemen aan sequentiële toetsenbordnavigatie. Zoals alle invoertypes behalve voor invoer van het type verborgen focusseerbaar zijn, mag dit attribuut niet worden gebruikt op formulierbesturingen, omdat dit het beheer van de focus vereist ons bestellen voor alle elementen in het document met het risico de bruikbaarheid en toegankelijkheid in gevaar te brengen als het onjuist wordt gedaan.
title
Globaal kenmerk geldig voor alle elementen, inclusief alle invoertypes , met een tekst die adviesinformatie bevat met betrekking tot het element waartoe het behoort. Dergelijke informatie kan typisch, maar niet noodzakelijk, aan de gebruiker worden gepresenteerd als een tooltip. De titel mag NIET worden gebruikt als de primaire uitleg van het doel van het formulierbesturingselement. Gebruik in plaats daarvan het <label>
-element met een for
-attribuut ingesteld op het formulier control “s id
attribuut. Zie Labels hieronder.
type
Een tekenreeks die het type besturingselement specificeert dat moet worden weergegeven. Om bijvoorbeeld een selectievakje te maken, de waarde checkbox
wordt gebruikt. Indien weggelaten (of een onbekende waarde is opgegeven), wordt het invoertype text
gebruikt, waardoor een invoerveld in platte tekst wordt gemaakt.
Toegestane waarden worden weergegeven in <input>
typen hierboven.
value
De waarde van het invoerbesturingselement. Indien gespecificeerd in de HTML, is dit de initiële waarde, en vanaf dat moment kan deze op elk moment worden gewijzigd of opgehaald met JavaScript om toegang te krijgen tot het respectievelijke HTMLInputElement
object “s value
eigenschap. Het value
kenmerk is altijd optioneel, maar moet als verplicht worden beschouwd voor checkbox
, radio
, en hidden
.
width
Geldig voor de image
invoerknop, de width
is de breedte van het afbeeldingsbestand dat moet worden weergegeven om de grafische verzendknop weer te geven. Bekijk het invoertype voor afbeeldingen.