accept
Gäller endast för file ingångstyp, accept attributet definierar vilka filtyper som kan väljas i en file uppladdningskontroll. Se typ av filinmatning.
alt
Gäller endast image -knappen, alt -attributet ger alternativ text för bilden, som visar attributets värde om bilden src saknas eller på annat sätt inte laddas. Se bildinmatningstypen.
autocomplete
(Inte ett booleskt attribut!) Attributet autocomplete tar sitt värde en mellanseparerad sträng som beskriver vilken, om någon, typ av autofullständig funktionalitet ingången ska tillhandahålla. En typisk implementering av autofullständig återkallar tidigare värden som har skrivits in i samma inmatningsfält, men mer komplexa former av autofullständighet kan finnas. Till exempel kan en webbläsare integreras med enhetens kontaktlista för att autofullföra email -adresser i ett e-postinmatningsfält. Se Värden i HTML-autofullständig attribut för tillåtna värden.
Attributet autocomplete är giltigt på hidden, text, search, url, tel, email, date, month, week, time, datetime-local, number, range, color och password. Detta attribut har ingen effekt på inmatningstyper som inte returnerar numeriska data eller textdata, och är giltigt för alla inmatningstyper utom checkbox, radio, file eller någon av knapptyperna.
Se HTML-attributet autoslutför f eller ytterligare information, inklusive information om lösenordssäkerhet och hur autocomplete är något annorlunda för hidden än för andra ingångstyper.
autofocus
Ett booleskt attribut som, om det finns, indikerar att ingången automatiskt ska ha fokus när sidan har laddats (eller när <dialog> som innehåller elementet har visats).
Obs: Ett element med attributet autofocus kan få fokus innan DOMContentLoaded -händelsen avfyras.
Inte mer än ett element i dokumentet kan ha attributet autofocus. Om det läggs på mer än ett element får det första med attributet fokus.
Attributet autofocus kan inte användas på ingångar av typen hidden, eftersom dolda ingångar inte kan fokuseras.
Varning: Att automatiskt fokusera en formulärkontroll kan förvirra synskadade med skärmläsningsteknik och personer med kognitiva funktionsnedsättningar. När autofocus tilldelas ”teleporterar” skärmläsare sin användare till formulärkontrollen utan att varna dem i förväg.
Var noga med att ta hänsyn till tillgänglighet när tillämpa attributet autofocus. Att fokusera automatiskt på en kontroll kan få sidan att rulla vid laddning. Fokus kan också få dynamiska tangentbord att visas på vissa pekdon. Medan en skärmläsare kommer att meddela etiketten för formulärkontrollens fokus, kommer skärmläsaren inte att meddela någonting före etiketten, och den synade användaren på en liten enhet kommer också att missa det sammanhang som skapats av föregående innehåll.
capture
Infördes i HTML Media Capture-specifikationen och giltig endast för file -ingångstyp, capture attribut definierar vilket media – mikrofon, video eller kamera – som ska användas för att fånga en ny fil för uppladdning med file uppladdningskontroll i stödjande scenarier. Se filinmatningstypen.
checked
Gäller både radio och checkbox types, checked är ett booleskt attribut. Om det finns en radio -typ indikerar det att radioknappen är den för närvarande valda i gruppen med samma namnknappar. Om det finns i en checkbox -typ indikerar det att kryssrutan är markerad som standard (när sidan laddas). Det anger inte om den här kryssrutan är markerad för närvarande: om kryssrutans tillstånd ändras återspeglar inte innehållsattributet ändringen. (Endast HTMLInputElement s checked IDL-attribut uppdateras.)
Obs: Till skillnad från andra ingångskontroller ingår ett kryssrutor och alternativknappar endast i de inlämnade uppgifterna om de för närvarande är checked. Om de är så skickas namnet och värdet på de kontrollerade kontrollerna.
Till exempel om en kryssruta vars name är fruit har en value av cherry, och kryssrutan är markerad, formulärdata som skickas inkluderar fruit=cherry. Om kryssrutan inte är aktiv visas den inte alls i formulärdata. Standard value för kryssrutor och alternativknappar är on.
dirname
Gäller endast för text och search ingångstyper, dirname attribut möjliggör inlämning av elementets riktning. När den ingår inkluderas formulärkontrollen med två namn / värdepar: det första är name och value, det andra är värdet av dirname som namnet med värdet ltr eller rtl som ställs in av webbläsare.
När formuläret ovan skickas orsakar ingången både name / value par av fruit=cherry och dirname / riktningspar av fruit.dir=ltr som ska skickas.
disabled
Ett booleskt attribut som, om det finns, indikerar att användaren inte ska kunna interagera med ingången. Inaktiverade ingångar återges vanligtvis med en mörkare färg eller med någon annan indikation på att fältet inte är tillgängligt.
Specifikt får inaktiverade ingångar inte click händelse och inaktiverade ingångar skickas inte med formuläret.
Obs: Även om det inte krävs enligt specifikationen, kommer Firefox som standard att kvarhålla det dynamiska inaktiverade tillståndet för ett <input> över sidladdningar. Använd attributet autocomplete för att styra den här funktionen.
form
En sträng som anger <form> -element som ingången är associerad med (det vill säga dess formägare). Den här strängens värde, om det finns, måste matcha id för ett <form> -element i samma dokument. Om detta attribut inte är ”t angiven är <input> -elementet associerat med den närmaste innehållande formen, om någon.
form -attributet låter placera en inmatning var som helst i dokumentet men ha den inkluderad i ett formulär någon annanstans i dokumentet.
Obs: En inmatning kan bara associeras med en form.
formaction
Gäller endast ingångstyperna image och submit. Se inmatningstypen för mer information.
formenctype
Gäller för image och submit endast inmatningstyper. Se inlämningstypen för mer information.
formmethod
Gäller för image och submit endast inmatningstyper. Se inmatningstypen för mer information.
formnovalidate
Gäller för image och submit endast inmatningstyper. Se inlämningstypen för mer information.
formtarget
Gäller för image och submit endast inmatningstyper. Se skicka inmatningstypen för mer information.
height
Gäller endast inmatningsknappen image, height är höjden på bildfilen som ska visas för att representera den grafiska inlämningsknappen. Se bildinmatningstypen.
id
Globalt attribut giltigt för alla element, inklusive alla inmatningstyper, det definierar en unik identifierare (ID) som måste vara unik i hela dokumentet. Syftet är att identifiera elementet vid länkning. Värdet används som värdet för attributet <label> ”s for för att länka etiketten till formulärkontrollen. Se <label>.
inputmode
Globalt värde giltigt för alla element, det ger en ledtråd till webbläsare om typen av virtuellt tangentbordskonfiguration som används när du redigerar detta element eller dess innehåll. Värdena inkluderar none, text, tel, url, email, numeric, decimal och search.
list
Värdet som ges till attributet list ska vara id av ett <datalist> -element i samma dokument. <datalist> ger en lista med fördefinierade värden att föreslå för användaren för denna inmatning. Alla värden i listan som inte är kompatibla med type ingår inte i de föreslagna alternativen. Värdena som tillhandahålls är förslag, inte krav: användare kan välja från den här fördefinierade listan eller ange ett annat värde.
Det är giltigt på text, search, url, tel, email, date, month, week, time, datetime-local, number, range och color.
Enligt specifikationerna stöds attributet list inte av hidden, password, checkbox, radio, file eller någon annan av knapptyperna.
Beroende på webbläsaren kan användaren se en anpassad färgpalett föreslagen, tic-markeringar längs ett intervall eller till och med en ingång som öppnas som en <select> men möjliggör icke-noterade va lues. Kolla in webbläsarens kompatibilitetstabell för andra ingångstyper.
Se <datalist> -elementet.
max
Gäller för date, month, week, time, datetime-local, number och range definierar den det största värdet inom området tillåtna värden. Om value som anges i elementet överskrider detta, misslyckas elementet med valideringsbegränsning. Om värdet för attributet max inte är ”ta”, har elementet inget maximalt värde.
Det finns ett speciellt fall: om datatypen är periodisk (som för datum eller tider) kan värdet för max vara lägre än värdet för min, vilket indikerar att intervallet kan linda runt, till exempel kan du ange ett tidsintervall från 22:00 till 04:00.
maxlength
Gäller för text, search, url, tel, email och password, det definierar det maximala antalet tecken (som UTF-16-kodenheter) som användaren kan ange i fältet. Detta måste vara ett heltal 0 eller högre. Om inget maxlength anges eller om ett ogiltigt värde anges har fältet ingen maximal längd. Detta värde måste också vara större än eller lika med värdet på
Inmatningen misslyckas med valideringsbegränsning om längden på den text som matas in i fältet är större än maxlength UTF-16 kodenheter långa. Som standard hindrar webbläsare användare från att ange fler tecken än vad som tillåts av attributet maxlength. Se validering på klientsidan för mer information.
min
Gäller för date, month, week, time, datetime-local, number, och range, definierar det det mest negativa värdet inom området tillåtna värden. Om value som matats in i elementet är mindre än detta, misslyckas elementet med valideringsbegränsning. Om värdet för attributet min inte är ”ta” har elementet inget minimivärde.
Detta värde måste vara mindre än eller lika med värdet på attributet max. Om attributet min finns men inte anges eller är ogiltigt, finns inget min -värde tillämpas. Om min -attributet är giltigt och ett icke-tomt värde är mindre än det minsta som min tillåter attribut, begränsning av validering förhindrar inlämnande av formulär. Se validering på klientsidan för mer information.
Det finns ett speciellt fall: om datatypen är periodisk (t.ex. för datum eller tider), är värdet max kan vara lägre än värdet för min, vilket indikerar att intervallet kan lindas; till exempel kan du ange en tid från 22:00 till 04:00.
minlength
Gäller för text, search, url, tel, email och password, den definierar det minsta antalet tecken (som UTF-16-kodenheter) som användaren kan ange i inmatningsfältet. Detta måste vara ett icke-negativt heltal som är mindre än eller lika med det värde som anges av maxlength. Om inget minlength anges eller om ett ogiltigt värde anges har ingången ingen minsta längd.
Inmatningen misslyckas med valideringsbegränsning om längden på texten in i fältet är färre än minlength UTF-16-kodenheter långa, vilket förhindrar inlämnande av formulär. Se validering på klientsidan för mer information.
multiple
Attributet Boolean iv id = ”e42bd49909” , om det är inställt, betyder användaren kan ange kommaseparerade e-postadresser i e-postwidgeten eller välja mer än en fil med inmatningen file. Se e-post och filinmatningstyp.
name
En sträng som anger ett namn för ingångskontrollen. Detta namn skickas tillsammans med kontrollens värde när formulärdata skickas.
Vad finns i ett namn
Tänk på name ett obligatoriskt attribut (även om det inte är). Om en ingång inte har name angiven, eller name är tom, ingångens värde skickas inte med formuläret! (Inaktiverade kontroller, avmarkerade alternativknappar, avmarkerade kryssrutor och återställningsknappar skickas inte heller.)
Det finns två speciella fall:
-
_charset_: Om det används som namnet på ett<input>-element av typen dold, ställs ingången ”svaluein automatiskt av användaragenten till den teckenkodning som används för att skicka formuläret. -
isindex: Av historiska skäl, namnetisindexär inte tillåtet.
namn och radioknappar
Attributet name skapar ett unikt beteende för radioknappar.
Endast en alternativknapp i samma grupp av radioknappar kan kontrolleras åt gången. Om du väljer en alternativknapp i den gruppen avmarkeras automatiskt alla valda alternativknappar i samma grupp. att en markerad alternativknapp skickas tillsammans med namnet om formuläret skickas,
När du flikar in i en serie av samma – namngiven grupp av radioknappar, om en är markerad, kommer den att få fokus. Om de inte är grupperade i källföljd, om en av gruppen är markerad, startar fliken i gruppen när den första i gruppen påträffas och hoppar över alla som inte är markerade. Med andra ord, om en är markerad hoppar fliken över de okontrollerade alternativknapparna i gruppen. Om ingen är markerad får radioknappsgruppen fokus när den första knappen i samma namngrupp nås.
När en av radioknapparna i en grupp har fokus, använder du piltangenterna genom alla radioknapparna med samma namn, även om radioknapparna inte är grupperade i källordningen.
HTMLFormElement.elements
När ett inmatningselement ges name, det namnet blir en egenskap för det ägande formulärelementet ”s HTMLFormElement.elements egenskap. Om du har en ingång vars name är inställt på guest och en annan vars name är hat-size, följande kod kan användas:
När den här koden har körts blir guestName HTMLInputElement för guest -fältet och hatSize objektet för hat-size fält.
name som motsvarar en inbyggd egenskap hos formuläret, eftersom du sedan åsidosätter den fördefinierade egenskapen eller metoden med denna referens till motsvarande ingång. pattern
pattern -attributet, när det anges, är ett reguljärt uttryck att ingången ”s value måste matcha för att värdet ska klara valideringen av begränsningen. Det måste vara ett giltigt JavaScript-reguljärt uttryck, som används av RegExp -typen, och som dokumenteras i vår guide om reguljära uttryck; "u" -flaggan anges när du kompilerar det reguljära uttrycket, så att mönstret behandlas som en sekvens av Unicode-kodpunkter, istället för som ASCII. Inga snedstreck framåt bör anges runt mönstrstexten.
Om pattern -attributet är närvarande men inte anges eller är ogiltigt tillämpas inget reguljärt uttryck och detta attribut ignoreras helt.Om mönsterattributet är giltigt och ett icke-tomt värde inte matchar mönstret förhindrar begränsning av validering formulärsändande.
Tips: Om du använder pattern attribut, informera användaren om det förväntade formatet genom att inkludera förklarande text i närheten. Du kan också inkludera ett title -attribut för att förklara vad kraven är för att matcha mönstret; de flesta webbläsare visar den här titeln som ett verktygstips. Den synliga förklaringen krävs för tillgänglighet. Verktygstipsen är en förbättring.
Se validering på klientsidan för mer information.
placeholder
placeholder attribut är en sträng som ger en kort ledtråd till användaren om vilken typ av information som förväntas i fältet. Det bör vara ett ord eller en kort fras som ger en ledtråd till den förväntade typen av data snarare än en förklaring eller uppmaning. Texten får inte innehålla vagnreturer eller radmatningar. Så till exempel om ett fält förväntas fånga en användares förnamn, och dess etikett är ”Förnamn”, kan en lämplig platshållare vara ”t.ex. Mustafa ”.
Obs! Attributet placeholder är inte lika semantiskt användbart som andra sätt att förklara ditt formulär och kan orsaka oväntade tekniska problem med din innehåll. Se Etiketter i < input >: Input (Form Input) -elementet för mer information.
readonly
Ett booleskt attribut som, om det finns, indikerar att användaren inte ska kunna redigera ingångens värde. readonly stöds text, search, url, tel, email, date, month, week, time, datetime-local, number och password inmatningstyper.
Se HTML-attributet: readonly för mer information.
required är ett booleskt attribut som, om det finns, indikerar att användaren måste ange ett värde för inmatningen innan det ägande formuläret kan skickas. Attributet required stöds av text, search, url, tel, email, date, month, week, time, datetime-local, number, password, checkbox, radio file -ingångar.
Se validering på klientsidan och HTML-attributet: required för mer information.
sizeGäller föremail,password,telochtextinput-typer. Anger hur mycket av ingången som visas. Skapar i grund och botten samma resultat som att ställa in CSSwidthegenskap med några specialiteter. Den faktiska värdenheten beror på ingångstypen. Förpasswordochtextär det ett antal tecken (elleremenheter) med ett standardvärde på20, och för andra är detpixels. CSS-bredd har företräde framför storleksattribut.src
Gäller endast inmatningsknappen image, src anger sträng webbadressen till den bildfil som ska visas för att representera den grafiska inlämningsknappen. Se bildinmatningstyp.
step
Gäller för de numeriska inmatningstyperna, inklusive number, datum / tidsinmatningstyper och range, attributet step är ett tal som anger granulariteten som värdet måste följa.
Om det inte uttryckligen ingår:
-
stepär standard 1 förnumberochrange. - För datum- / tidsinmatningstyperna uttrycks
stepi sekunder, med standardsteget 60 sekunder . Stegskalafaktorn är 1000 (som omvandlar sekunderna till millisekunder, som används i andra algoritmer).
Värdet måste vara ett positivt tal – heltal eller flyt – eller specialvärdet any, vilket innebär att ingen stegning är underförstådd, och något värde är tillåtet (uteslutande andra begränsningar, såsom min och max).
Om any inte är inställd på explicitet, gäller giltiga värden för number, datum / tid inmatningstyper och range ingångstyperna är lika med basen för stegning – min -värdet och steg för stegvärdet, upp till max värde, om det är specificerat.
Om du till exempel har <input type="number" min="10" step="2">, så är ett jämnt heltal, 10 eller högre, är giltigt. Om <input type="number"> utelämnas är alla heltal giltiga, men floats (som 4.2) är inte giltiga, eftersom step är 1. För att 4.2 skulle vara giltigt, skulle step behöva ställas in på any, 0,1 , 0,2 eller något min -värdet måste ha varit ett tal som slutar på .2, såsom <input type="number" min="-5.2">
Obs: När data som matas in av användaren inte följer stegkonfigurationen, anses värdet ogiltigt vid validering av kontrasten och kommer att matcha :invalid pseudoklass.
Se validering på klientsidan för mer information.
tabindex
Globalt attribut giltigt för alla element, inklusive alla ingångstyper, ett heltalsattribut som indikerar om elementet kan ta inmatningsfokus (kan fokuseras), om det ska delta i sekventiell tangentbordsnavigering. Som alla ingångstyper utom för ingång av typen dold är fokuserbara, bör detta attribut inte användas på formulärkontroller, eftersom detta skulle kräva hantering av foc vi beställer alla element i dokumentet med risk för att skada användbarhet och tillgänglighet om de görs felaktigt.
title
Globalt attribut giltigt för alla element, inklusive alla ingångstyper , innehållande en text som representerar rådgivande information relaterad till det element den tillhör. Sådan information kan vanligtvis, men inte nödvändigtvis, presenteras för användaren som ett verktygstips. Titeln ska INTE användas som den primära förklaringen till syftet med formulärkontrollen. Använd istället <label> -elementet med ett for -attribut inställt på formulärkontrollen ”s id attribut. Se etiketter nedan.
type
En sträng som anger vilken typ av kontroll som ska återges. Till exempel, för att skapa en kryssruta, värdet checkbox används. Om det utelämnas (eller ett okänt värde anges) används ingångstypen text, vilket skapar ett inmatningsfält i klartext.
Tillåtna värden listas i <input> -typerna ovan.
value
Ingångskontrollens värde. När det anges i HTML är detta det ursprungliga värdet, och från och med det kan det ändras eller hämtas när som helst med JavaScript för att komma åt respektive HTMLInputElement objekt ”s value -egenskap. value -attributet är alltid valfritt, men bör betraktas som obligatoriskt för checkbox, radio och hidden.
width
Gäller för image endast inmatningsknapp, width är bredden på den bildfil som ska visas för att representera den grafiska inlämningsknappen. Se bildinmatningstypen.