accept
Platí pouze pro typ vstupu file, atribut accept definuje, jaké typy souborů lze vybrat v ovládacím prvku file. Viz typ vstupu souboru.
alt
Platí pouze pro tlačítko image, poskytuje alternativní text pro obrázek, který zobrazuje hodnotu atributu, pokud obrázek src chybí nebo se jinak nepodaří načíst. Viz typ vstupu obrázku.
autocomplete
(Není to logický atribut!) Jako hodnotu má atribut autocomplete řetězec oddělený mezerou, který popisuje, jaký typ funkce automatického doplňování, pokud má nějaký, by měl vstup poskytovat. Typická implementace automatického doplňování připomíná předchozí hodnoty zadané ve stejném vstupním poli, ale mohou existovat složitější formy automatického doplňování. Prohlížeč by se například mohl integrovat se seznamem kontaktů zařízení a automaticky doplňovat email adresy do pole pro zadávání e-mailů. Povolené hodnoty naleznete v části Hodnoty v atributu Automatické doplňování HTML.
Atribut autocomplete je platný hidden, text, search, url, tel, email, date, month, week, time, datetime-local, number, range, color a password. Tento atribut nemá žádný vliv na typy vstupu, které nevracejí číselná ani textová data, platí pro všechny typy vstupu kromě checkbox, radio, file nebo některý z typů tlačítek.
Viz atribut automatického doplňování HTML f nebo další informace, včetně informací o zabezpečení heslem a o tom, jak se autocomplete u hidden mírně liší od ostatních typů vstupu.
autofocus
Booleovský atribut, který, pokud je přítomen, naznačuje, že vstup by měl být automaticky zaměřen, jakmile se stránka načte (nebo když <dialog> obsahující prvek byl zobrazen).
Poznámka: Prvek s atributem autofocus může být zaostřen před DOMContentLoaded událost je aktivována.
Atribut autofocus nesmí mít více než jeden prvek v dokumentu. Pokud je kladen na více než jeden prvek, první s atributem se zaostří.
Atribut autofocus nelze použít na vstupy typu hidden, protože skryté vstupy nelze zaměřit.
Upozornění: Automatické zaostření ovládacího prvku formuláře může zmást zrakově postižené lidi pomocí technologie čtení obrazovky a lidi s kognitivními poruchami. Když je přiřazen autofocus, čtečky obrazovky „teleportují“ svého uživatele do ovládacího prvku formuláře, aniž by je předem varovali.
Při přístupu pečlivě zvažte použití atributu autofocus. Automatické zaostření na ovládací prvek může způsobit, že se stránka při načítání posouvá. Zaostření může také způsobit zobrazení dynamických klávesnic na některých dotykových zařízeních. Zatímco čtečka obrazovky oznámí štítek přijímajícího fokusu ovládacího prvku formuláře, čtečka obrazovky neoznámí nic před štítkem a viděnému uživateli na malém zařízení bude stejně chybět kontext vytvořený předchozím obsahem.
capture
Představený ve specifikaci HTML Media Capture a platný pouze pro file typ vstupu, capture definuje, která média – mikrofon, video nebo kamera – by měla být použita k zachycení nového souboru k nahrání s file ovládacím prvkem nahrávání v podpůrných scénářích. Viz typ vstupu souboru.
checked
Platí pro radio i checkbox types, checked je booleovský atribut. Pokud je přítomen na radio typu, znamená to, že přepínač je aktuálně vybraný ve skupině stejnojmenných přepínačů. Pokud je k dispozici u typu checkbox, znamená to, že je zaškrtávací políčko ve výchozím nastavení zaškrtnuto (při načtení stránky). Neznačí to, zda je toto zaškrtávací políčko aktuálně zaškrtnuto: pokud se změní stav zaškrtávacího políčka, tento atribut obsahu změnu nezohlední. (Aktualizován je pouze HTMLInputElement s checked atribut IDL.)
Poznámka: Na rozdíl od jiných ovládacích prvků vstupu jsou zaškrtávací políčka a hodnoty přepínačů zahrnuty do odeslaných dat, pouze pokud jsou aktuálně checked. Pokud jsou, odešle se název a hodnoty kontrolovaných ovládacích prvků.
Například pokud je zaškrtávací políčko, jehož name je fruit má value cherry a je zaškrtnuto políčko, odeslané údaje formuláře budou obsahovat fruit=cherry. Pokud zaškrtávací políčko není aktivní, není vůbec uvedeno v datech formuláře. Výchozí value pro zaškrtávací políčka a přepínače je on.
dirname
Platí pouze pro text a search typy vstupu, dirname atribut umožňuje zadání směrovosti prvku. Pokud je zahrnut, ovládací prvek formuláře se odešle se dvěma páry název / hodnota: první je name a value, druhý je hodnota dirname jako název s hodnotou ltr nebo rtl nastavenou prohlížeč.
Po odeslání výše uvedeného formuláře způsobí vstup dvojici name / value fruit=cherry a dvojice dirname / direction fruit.dir=ltr k odeslání.
disabled
Booleovský atribut, který, pokud je přítomen, naznačuje, že uživatel by neměl být schopen komunikovat se vstupem. Zakázané vstupy se obvykle vykreslují se stmívací barvou nebo pomocí jiné formy indikace, že pole není k dispozici pro použití.
Konkrétně zakázané vstupy neobdrží click a deaktivované vstupy se s formulářem neodesílají.
Poznámka: Ačkoli to specifikace nevyžaduje, Firefox ve výchozím nastavení přetrvává dynamický deaktivovaný stav <input> napříč stránkami. K ovládání této funkce použijte atribut autocomplete.
form
Řetězec specifikující <form> prvek, ke kterému je vstup přidružen (tj. Jeho vlastník formuláře). Hodnota tohoto řetězce, pokud existuje, se musí shodovat s id prvku <form> ve stejném dokumentu. Pokud tento atribut není zadán, prvek <input> je přidružen k nejbližšímu obsahujícímu formuláři, pokud existuje.
Atribut form vám umožňuje umístit vstup kdekoli v dokumentu, ale nechat ho zahrnout do formuláře kdekoli v dokumentu.
Poznámka: Vstup lze spojit pouze s jedním formulářem.
formaction
Platí pouze pro typy vstupu image a submit. Další informace najdete v typu vstupu pro odeslání.
formenctype
Platí pro image a submit pouze typy vstupu. Další informace najdete v typu vstupu pro odeslání.
formmethod
Platí pro image a submit pouze typy vstupu. Další informace najdete v typu vstupu pro odeslání.
formnovalidate
Platí pro image a submit pouze typy vstupu. Další informace najdete v typu vstupu pro odeslání.
formtarget
Platí pro image a submit pouze typy vstupu. Další informace najdete v typu vstupu pro odeslání.
height
Platí pouze pro vstupní tlačítko image, height je výška obrazového souboru, který se má zobrazit a který představuje grafické tlačítko pro odeslání. Viz typ vstupu obrázku.
id
Globální atribut platný pro všechny prvky, včetně všech typů vstupu, definuje jedinečný identifikátor (ID), který musí být jedinečný v celém dokumentu. Jeho účelem je identifikovat prvek při propojení. Hodnota se používá jako hodnota atributu <label> „s for k propojení štítku s ovládacím prvkem formuláře. Viz <label>.
inputmode
Globální hodnota platná pro všechny prvky, poskytuje prohlížečům nápovědu, pokud jde o typ konfigurace virtuální klávesnice, použít při úpravách tohoto prvku nebo jeho obsahu. Hodnoty zahrnují none, text, tel, url, email, numeric, decimal a search.
list
Hodnota přiřazená atributu list by měla být id prvku <datalist> umístěného ve stejném dokumentu. <datalist> poskytuje seznam předdefinovaných hodnot, které lze uživateli pro tento vstup navrhnout. Veškeré hodnoty v seznamu, které nejsou kompatibilní s type, nejsou do navrhovaných možností zahrnuty. Poskytnuté hodnoty jsou návrhy, nikoli požadavky: uživatelé si mohou vybrat z tohoto předdefinovaného seznamu nebo zadat jinou hodnotu.
Platí dne text, search, url, tel, email, date, month, week, time, datetime-local, number, range a color.
Podle specifikací atribut list není podporován v hidden, password, checkbox, radio, file nebo jakýkoli jiný typů tlačítek.
V závislosti na prohlížeči se uživateli může zobrazit navržená vlastní paleta barev, tikové značky podél rozsahu nebo dokonce vstup, který se otevře jako <select>, ale umožňuje neuvedené va lues. Podívejte se na tabulku kompatibility prohlížeče s dalšími typy vstupů.
Viz prvek <datalist>.
max
Platí pro date, month, week, time, datetime-local, number a range definuje největší hodnota v rozsahu povolených hodnot. Pokud value zadaný do prvku překročí toto, prvek selže při ověření omezení. Pokud hodnota atributu max není číslo, pak prvek nemá maximální hodnotu.
Existuje speciální případ: pokud je datový typ periodický (například pro data nebo časy) může být hodnota max nižší než hodnota min, což naznačuje, že rozsah může být zabalit; například to vám umožní určit časový rozsah od 22:00 do 4:00.
maxlength
Platí pro text, search, url, tel, email a password definuje maximální počet znaků (jako jednotky kódu UTF-16), které může uživatel zadat do pole. Musí to být celočíselná hodnota 0 nebo vyšší. Pokud není zadána maxlength nebo je zadána neplatná hodnota, pole nemá maximální délku. Tato hodnota musí být také být větší nebo roven hodnotě
Zadání selže při ověření omezení, pokud je délka textu zadaného do pole větší než maxlength Jednotky kódu UTF-16 dlouhé. Ve výchozím nastavení prohlížeče brání uživatelům v zadání více znaků, než kolik umožňuje atribut maxlength. Další informace najdete v části Ověření na straně klienta.
min
Platí pro date, month, week, time, datetime-local, number a range definuje nejnegativnější hodnotu v rozsahu povolených hodnot. Pokud je value zadaný do prvku menší než toto, prvek selže při ověření omezení. Pokud hodnota atributu min není číslo, pak prvek nemá žádnou minimální hodnotu.
Tato hodnota musí být menší nebo rovna hodnotě atribut max. Pokud je atribut min přítomen, ale není specifikován nebo je neplatný, žádný min. Pokud je atribut min platný a neprázdná hodnota je menší než minimum povolené min atribut, ověření omezení znemožní odeslání formuláře. Další informace najdete v části Ověření na straně klienta.
Existuje speciální případ: pokud je datový typ pravidelný (například pro data nebo časy), hodnota max může být nižší než hodnota min, což naznačuje, že se rozsah může ohýbat; například to vám umožní určit čas rozmezí od 22:00 do 4:00.
minlength
Platí pro text, search, url, tel, email a password, definuje minimální počet znaků (jako jednotky kódu UTF-16), které může uživatel zadat do vstupního pole. Musí to být nezáporná celočíselná hodnota menší nebo rovna hodnotě určené parametrem maxlength. Pokud není zadán minlength nebo je zadána neplatná hodnota, nemá vstup žádnou minimální délku.
Vstup selže při ověření omezení, pokud je délka textu zadaný do pole je méně než minlength kódových jednotek UTF-16 dlouhý, což brání odeslání formuláře. Další informace najdete v části Ověření na straně klienta.
multiple
Atribut Boolean multiple, pokud je nastaven, znamená uživatele můžete do e-mailového widgetu zadat e-mailové adresy oddělené čárkou nebo vybrat více než jeden soubor se vstupem file. Viz typ vstupu e-mailu a souboru.
name
Řetězec určující název ovládacího prvku vstupu. Tento název je odeslán spolu s hodnotou ovládacího prvku při odeslání dat formuláře.
Co je v názvu
Zvažte name požadovaný atribut (i když to není). Pokud vstup nemá zadaný name nebo je name prázdný, hodnota vstupu není odeslána s formulářem! (Zakázané ovládací prvky, nezaškrtnuté přepínače, nezaškrtnuté zaškrtávací políčka a resetovací tlačítka se také neodesílají.)
Existují dva speciální případy:
-
_charset_: Pokud je použit jako název<input>prvku typu skrytý, je vstup „svalueautomaticky nastaven uživatelský agent na kódování znaků, které se používá k odeslání formuláře. -
isindex: Z historických důvodů názevisindexnení povoleno.
název a přepínače
Atribut name vytváří jedinečné chování přepínačů.
Současně lze zaškrtnout pouze jeden přepínač ve stejné skupině přepínačů. Výběr libovolného přepínače v této skupině automaticky zruší výběr libovolného aktuálně vybraného přepínače ve stejné skupině. Hodnota že jeden zaškrtnutý přepínač je odeslán spolu se jménem, pokud je formulář odeslán,
Při vytváření záložek do řady stejných – pojmenovaná skupina přepínacích tlačítek, pokud je zaškrtnuta, bude zaostřena. Pokud nejsou seskupeny ve zdrojovém pořadí, je-li zaškrtnuta jedna ze skupin, spustí se tablování do skupiny, když dojde k prvnímu ve skupině, a přeskočí všechny, které nejsou zaškrtnuty. Jinými slovy, pokud je zaškrtnuto, tabbing přeskočí nezaškrtnuté přepínače ve skupině. Pokud není zaškrtnuto žádné, skupina přepínacích tlačítek dostane fokus, když je dosaženo prvního tlačítka ve skupině se stejným názvem.
Jakmile je jedno z přepínacích tlačítek ve skupině aktivováno, pomocí kláves se šipkami můžete procházet všemi přepínače se stejným názvem, i když přepínače nejsou seskupeny ve zdrojovém pořadí.
HTMLFormElement.elements
Když je vstupnímu prvku přidělen name se toto jméno stane vlastnictvím vlastnění prvku s HTMLFormElement.elements prvku formuláře. Pokud máte vstup, jehož name je nastaven na guest a další, jehož name je hat-size, následující kód lze použít:
Po spuštění tohoto kódu bude guestName HTMLInputElement pro pole guest a hatSize objekt pro hat-size pole.
name, které odpovídají integrované vlastnosti formuláře, protože tím byste předefinovali vlastnost nebo metodu s tímto odkazem na odpovídající vstup. pattern
Pokud je uveden atribut pattern, je to regulární výraz, který vstup „s value se musí shodovat, aby hodnota mohla projít ověřením omezení. Musí to být platný regulární výraz JavaScriptu, který používá typ RegExp a jak je popsán v naší příručce k regulárním výrazům; příznak "u" je zadán při kompilaci regulárního výrazu, takže se se vzorem zachází jako s posloupností kódových bodů Unicode, nikoli jako s ASCII. V textu vzoru by neměla být zadána žádná lomítka.
Pokud je atribut pattern k dispozici, ale není zadán nebo je neplatný, nepoužije se regulární výraz a toto atribut je zcela ignorován.Pokud je atribut pattern platný a neprázdná hodnota neodpovídá vzoru, ověření omezení zabrání odeslání formuláře.
Tip: Pokud používáte pattern, informuje uživatele o očekávaném formátu zahrnutím vysvětlujícího textu poblíž. Můžete také zahrnout atribut title, který vysvětlí, jaké jsou požadavky na shodu vzoru; většina prohlížečů zobrazí tento název jako popis. Viditelné vysvětlení je vyžadováno pro usnadnění přístupu. Popis je vylepšením.
Další informace najdete v části Ověření na straně klienta.
placeholder
Atribut placeholder je řetězec, který uživateli poskytuje krátký tip, jaký druh informací se v poli očekává. Mělo by to být slovo nebo krátká fráze, která poskytuje raději očekávaný typ dat, než vysvětlení nebo výzva. Text nesmí obsahovat konce řádku ani posun řádků. Například pokud se očekává, že pole zachytí křestní jméno uživatele a jeho štítek je „křestní jméno“, vhodným zástupným znakem může být „např. Mustafa „.
Poznámka: Atribut placeholder není tak sémanticky užitečný jako jiné způsoby, jak vysvětlit formulář, a může způsobit neočekávané technické problémy s vaším obsah. Další informace naleznete v části Štítky ve < input >: Element Input (Form Input).
readonly
Booleovský atribut, který, pokud je přítomen, naznačuje, že uživatel by neměl být schopen upravovat hodnotu vstupu. readonly je podporován text, search, url, tel, email, date, month, week, time, datetime-local, number a password typy vstupu.
Další informace najdete v atributu HTML: readonly.
required je booleovský atribut, který, pokud je přítomen, znamená, že uživatel musí zadat hodnotu pro vstup, než bude možné odeslat vlastnící formulář. Atribut required podporuje text, search, url, tel, email, date, month, week, time, datetime-local, number, password, checkbox, radio a file vstupy.
Další informace najdete v části Ověření na straně klienta a atribut HTML: required.
sizePlatí proemail,password,telatextinputpouze typy. Určuje, jak velká část vstupu je zobrazena. V zásadě vytváří stejný výsledek jako nastavení vlastnosti CSSwidths několika specialitami. Skutečná jednotka hodnoty závisí na typu vstupu. Upasswordatextje to řada znaků (neboemjednotek) s výchozí hodnota20a pro ostatní je topixels. Šířka CSS má přednost před atributem size.src
Platí pouze pro vstupní tlačítko image, src určuje řetězec URL obrazového souboru, který se má zobrazit, aby představoval grafické tlačítko pro odeslání. Viz typ vstupu obrázku.
step
Platí pro typy numerického vstupu, včetně number, data / time input types, a range je atribut step číslo, které specifikuje zrnitost, které musí hodnota dodržovat.
Pokud není výslovně zahrnuto:
-
stepvýchozí hodnota je 1 pronumberarange. - U typů vstupu datum / čas je
stepvyjádřen v sekundách, výchozí krok je 60 sekund . Faktor krokového měřítka je 1000 (což převádí sekundy na milisekundy, jak se používá v jiných algoritmech).
Hodnota musí být kladné číslo – celé číslo nebo plovák – nebo speciální hodnota any, což znamená, že není naznačeno žádné krokování, a je povolena jakákoli hodnota (kromě jiných omezení, například min a max).
Pokud any není nastavena explicita, platné hodnoty pro number, typy vstupu datum / čas a range typy vstupu se rovnají základu pro krokování – hodnota min a přírůstky hodnoty kroku, až do max hodnota, pokud je uvedena.
Například pokud máte <input type="number" min="10" step="2">, pak jakékoli sudé celé číslo, 10 nebo vyšší, je platný. Pokud je vynecháno, <input type="number"> je platné celé číslo, ale plovoucí znaky (jako 4.2) nejsou platné, protože step Výchozí nastavení je 1. Aby byla 4.2 platná, muselo by být step nastaveno na any, 0,1 , 0,2 nebo jakákoli min hodnota by musela být číslo končící .2, například <input type="number" min="-5.2">
Poznámka: Pokud data zadaná uživatelem nedodržují krokovou konfiguraci, bude hodnota považována za neplatnou při ověření protiproudu a bude odpovídat :invalid pseudoklasa.
Další informace najdete v části Ověření na straně klienta.
tabindex
Globální atribut platný pro všechny prvky, včetně všech typů vstupu, celočíselný atribut označující, zda může prvek převzít fokus vstupu (je fokusovatelný), zda by se měl účastnit sekvenční navigace pomocí klávesnice. Jako všechny typy vstupu kromě vstupu typu skrytý jsou zaměřitelné, tento atribut by neměl být použit na ovládacích prvcích formulářů, protože by to vyžadovalo správu foc objednáváme všechny prvky v dokumentu s rizikem poškození použitelnosti a přístupnosti, pokud bude provedeno nesprávně.
title
Globální atribut platný pro všechny prvky, včetně všech typů vstupů , obsahující text představující poradenské informace týkající se prvku, ke kterému patří. Takové informace lze obvykle, ale ne nutně, poskytnout uživateli jako nápovědu. Název by neměl být používán jako primární vysvětlení účelu ovládacího prvku formuláře. Místo toho použijte element <label> s atributem for nastaveným na ovládací prvek formuláře „s id atribut. Viz Štítky níže.
type
Řetězec určující typ ovládacího prvku, který se má vykreslit. Chcete-li například vytvořit zaškrtávací políčko, hodnota checkbox je použito. Pokud je vynecháno (nebo je zadána neznámá hodnota), použije se typ vstupu text, který vytvoří vstupní pole ve formátu prostého textu.
Povolené hodnoty jsou uvedeny v <input> typech výše.
value
Hodnota ovládacího prvku vstupu. Pokud je zadán v HTML, jedná se o počáteční hodnotu a od té doby ji lze kdykoli změnit nebo načíst pomocí JavaScriptu pro přístup k příslušnému HTMLInputElement objektu „s value. Atribut value je vždy volitelný, měl by však být považován za povinný pro checkbox, radio a hidden.
width
Platí pro image, width je šířka obrazového souboru, který se má zobrazit, aby představoval tlačítko grafického odeslání. Viz typ vstupu obrázku.