accept
Csak a file
bemeneti típusra érvényes, a accept
attribútum határozza meg, hogy mely fájltípusok választhatók ki a file
feltöltés vezérlőben. Lásd a fájl beviteli típusát.
alt
Csak a image
gombra érvényes, a attribútum alternatív szöveget ad a képhez, megjelenítve az attribútum értékét, ha a kép src
hiányzik vagy más módon nem tölthető be. Lásd a kép beviteli típusát.
autocomplete
(Nem logikai attribútum!) A autocomplete
attribútum értékét veszi fel szóközzel elválasztott karakterlánc, amely leírja, hogy a bemenetnek milyen típusú automatikus kiegészítést kell nyújtania. Az automatikus kiegészítés tipikus megvalósítása visszahívja az ugyanabban a beviteli mezőben megadott korábbi értékeket, de az automatikus kiegészítés bonyolultabb formái is létezhetnek. Például egy böngésző integrálhat egy eszköz névjegyzékébe, hogy automatikusan kitöltse a email
címeket egy e-mail beviteli mezőbe. Az engedélyezett értékeket lásd: A HTML automatikus kiegészítés attribútum értékei.
A autocomplete
attribútum érvényes a hidden
, text
, search
, url
, tel
, email
, date
, month
, week
, time
, datetime-local
, number
, range
, color
és password
. Ez az attribútum nincs hatással azokra a bemeneti típusokra, amelyek nem adnak vissza numerikus vagy szöveges adatokat, és minden bemeneti típusra érvényes, kivéve a checkbox
, radio
, file
, vagy bármelyik gombtípus.
Lásd: A HTML automatikus kiegészítés attribútum f vagy további információk, ideértve a jelszóbiztonságra vonatkozó információkat, valamint azt, hogy a autocomplete
hogyan különbözik kissé a hidden
nél, mint más bemeneti típusoknál. div id = “cdf8ebc16d”>
Logikai attribútum, amely – ha van – azt jelzi, hogy a bemenetnek automatikusan fókuszálnia kell, amikor az oldal betöltődik (vagy amikor a <dialog>
elem).
Megjegyzés: A autofocus
attribútummal rendelkező elem a esemény elindul.
A dokumentumban csak egy elemnél lehet autofocus
attribútum. Ha egynél több elemet helyez el, akkor az első az attribútummal együtt fókuszt kap.
A autofocus
attribútum nem használható a , mivel a rejtett bemenetek nem fókuszálhatók.
Figyelem: Az űrlapvezérlés automatikus fókuszálása összekeverheti a képernyőolvasási technológiát használó látássérülteket és a kognitív fogyatékossággal élő embereket. A autofocus
hozzárendelésekor a képernyőolvasók előzetes figyelmeztetés nélkül “teleportálják” felhasználójukat az űrlapvezérlőhöz.
Gondosan mérlegelje az akadálymentességet, amikor a autofocus
attribútum alkalmazása. A vezérlőelemre történő automatikus összpontosítás az oldal görgetését okozhatja. A fókusz miatt dinamikus billentyűzetek is megjelenhetnek egyes érintőképernyős eszközökön. Míg a képernyőolvasó bejelenti az űrlapvezérlés címkéjét, amely a fókuszt kapja, a képernyőolvasó semmit sem jelent be a címke előtt, és egy kis eszköz látó felhasználója ugyanúgy hiányolja az előző tartalom által létrehozott kontextust.
capture
Bevezetésre került a HTML Media Capture specifikációba, és csak a file
bemeneti típusra érvényes, a capture
attribútum meghatározza, hogy melyik adathordozót – mikrofont, videót vagy kamerát – kell használni egy új fájl rögzítéséhez feltöltésre a file
feltöltési vezérléssel a támogató forgatókönyvekben. Lásd a fájl beviteli típusát.
checked
Mind a radio
, mind a checkbox
type, checked
egy logikai attribútum. Ha radio
típusnál van, akkor ez azt jelzi, hogy a választógomb az azonos nevű rádiógombok csoportjában jelenleg kiválasztott gomb. Ha checkbox
típusnál van, akkor azt jelzi, hogy a jelölőnégyzet alapértelmezés szerint be van jelölve (amikor az oldal betöltődik). Nem jelzi, hogy ez a jelölőnégyzet jelenleg be van-e jelölve: ha a jelölőnégyzet állapota megváltozik, ez a tartalmi attribútum nem tükrözi a változást. (Csak az HTMLInputElement
s checked
IDL attribútum frissül.)
Megjegyzés: Más beviteli vezérlőktől eltérően a jelölőnégyzetek és a választógombok értéke csak akkor szerepel a beküldött adatokban, ha azok jelenleg checked
. Ha vannak, akkor beküldik az ellenőrzött vezérlők nevét és értékét.
Például, ha egy jelölőnégyzet, amelynek name
fruit
value
értéke cherry
, és a jelölőnégyzet be van jelölve, a beküldött űrlapadatok tartalmazzák a fruit=cherry
. Ha a jelölőnégyzet nincs “aktív”, akkor egyáltalán nem szerepel az űrlap adatai között. A négyzetek és választógombok alapértelmezett value
értéke on
.
dirname
Csak text
és search
bemeneti típusokra érvényes, a dirname
attribútum lehetővé teszi az elem irányának beküldését. Ha benne van, az űrlapvezérlő két név / érték párral küldi el: az első a name
és a value
, a második pedig az érték a dirname
nevet, amelynek ltr
vagy rtl
értékét a böngésző.
A fenti űrlap elküldésével a bemenet a name
/ value
fruit=cherry
és az elküldendő dirname
/ iránypár fruit.dir=ltr
.
disabled
Boole-attribútum, amely – ha van – azt jelzi, hogy a felhasználónak nem szabad interakcióba lépnie a bemenettel. A letiltott bemeneteket általában sötétebb színnel vagy más módon jelzik, hogy a mező nem használható.
Pontosabban, a letiltott bemenetek nem kapják meg a click
esemény, és a letiltott bemeneteket nem küldjük be az űrlappal.
Megjegyzés: Bár a specifikáció nem írja elő, a Firefox alapértelmezés szerint továbbra is fennáll egy <input>
az oldal betöltésekor. Használja a autocomplete
attribútumot ennek a szolgáltatásnak a vezérléséhez.
form
A
elem, amelyhez az input társul (vagyis az űrlaptulajdonos). Ennek a karakterláncnak az értékének, ha van, meg kell egyeznie egy
id
egy<form>
elemnek ugyanabban a dokumentumban. Ha ez az attribútum nem “t” megadott, a<input>
elem társul a legközelebbi tartalmazó űrlaphoz, ha van ilyen.
A form
attribútum lehetővé teszi helyezzen be egy adatbevitelt bárhová a dokumentumban, de mellékelje egy űrlappal a dokumentum másutt.
Megjegyzés: Egy bemenet csak egy űrlaphoz társítható.
formaction
Csak a image
és submit
beviteltípusokra érvényes. További információkért lásd a beküldés típusát.
formenctype
Érvényes a image
és a bemeneti típusok. További információkért lásd a beküldés típusát.
formmethod
Érvényes a image
és bemeneti típusok. További információkért lásd a beküldés típusát.
formnovalidate
Érvényes a image
és bemeneti típusok. További információkért lásd a beküldés típusát.
formtarget
Érvényes a image
és a bemeneti típusok. További információkért lásd a beküldés típusát.
height
Csak a image
beviteli gombra érvényes, a height
a megjelenítendő képfájl magassága, amely a grafikus beküldés gombot jelöli. Lásd a kép bemeneti típusát.
id
Minden elemre érvényes globális attribútum, beleértve az összes bemeneti típust, meghatároz egy egyedi azonosítót (ID), amelynek egyedinek kell lennie az egész dokumentumban. Célja az elem azonosítása összekapcsoláskor. Az értéket a <label>
“s for
attribútum értékeként használják, hogy összekapcsolják a címkét az űrlapvezérlővel. Lásd: <label>
.
inputmode
Minden elemre érvényes globális érték, tippet ad a böngészőknek a virtuális billentyűzet konfigurációjának típusáról. használja ennek az elemnek vagy annak tartalmának szerkesztésekor. Az értékek közé tartozik: none
, text
, tel
, url
, email
, numeric
, decimal
és search
.
list
A list
attribútum értékének id
Az azonos dokumentumban található <datalist>
elem div> -je. Az <datalist>
egy előre definiált értékeket tartalmaz, amelyeket javasolhat a felhasználónak ehhez a bemenethez. A lista azon értékei, amelyek nem kompatibilisek a type
fájlokkal, nem szerepelnek a javasolt opciókban. A megadott értékek javaslatok, nem követelmények: a felhasználók választhatnak ebből az előre definiált listából, vagy más értéket adhatnak meg.
Ez érvényes: text
, search
, url
, tel
, email
, date
, month
, week
, time
, datetime-local
, number
, range
és color
.
A specifikációk szerint a list
attribútumot nem támogatja a hidden
, password
, checkbox
, radio
, file
, vagy bármely más a gombtípusok közül.
A böngészőtől függően a felhasználó láthatja a javasolt egyéni színpalettát, a tartomány mentén tic jeleket, vagy akár egy olyan bemenetet, amely megnyílik, mint egy <select>
de lehetővé teszi a nem felsorolt va szifilisz. Nézze meg a böngésző kompatibilitási táblázatát a többi bemeneti típusról.
Lásd a <datalist>
elemet.
max
Érvényes: date
, month
, week
, time
, datetime-local
, number
és range
, meghatározza a legnagyobb érték a megengedett értékek tartományában. Ha az elembe beírt value
túllépi ezt, az elem nem felel meg a kényszer érvényesítésének. Ha a max
attribútum értéke nem “ta”, akkor az elemnek nincs maximális értéke.
Van egy speciális eset: ha az adattípus periodikus (például dátumokra vagy időkre vonatkozóan) a max
értéke alacsonyabb lehet, mint a min
értéke, ami azt jelzi, hogy a tartomány körbefuttatás; például ez lehetővé teszi az időtartam megadását 10 és 4 óra között.
maxlength
Érvényes: text
, search
, url
, tel
, email
és password
meghatározza a maximális karakterszámot (UTF-16 kódegységként), amelyet a felhasználó bevihet a mezőbe. Ennek egész számnak kell lennie. 0
vagy magasabb. Ha nincs megadva maxlength
, vagy érvénytelen értéket ad meg, akkor a mezőnek nincs maximális hossza. Ennek az értéknek is meg kell adnia nagyobb vagy egyenlő a
A bemenet sikertelen lesz a korlátozás érvényesítésében, ha a mezőbe beírt szöveg hossza nagyobb, mint maxlength
UTF-16 kódegységek hosszúak. Alapértelmezés szerint a böngészők megakadályozzák, hogy a felhasználók több karaktert írjanak be, mint amennyit a maxlength
attribútum megenged. További információkért lásd: ügyféloldali érvényesítés.
min
Érvényes: date
, month
, week
, time
, datetime-local
, number
és range
, meghatározza a legnegatívabb értéket az engedélyezett értékek tartományában. Ha az elembe beírt value
ennél kisebb, akkor az elem nem érvényesíti a kényszert. Ha a min
attribútum értéke nem “ta”, akkor az elemnek nincs minimális értéke.
Ennek az értéknek kisebbnek vagy egyenlőnek kell lennie, mint a max
attribútum. Ha a min
attribútum jelen van, de nincs megadva, vagy érvénytelen, akkor nincs min
értéket alkalmazunk. Ha a min
attribútum érvényes, és egy nem üres érték kisebb, mint a min
attribútum, a korlátozás érvényesítése megakadályozza az űrlap elküldését. További információ: Ügyféloldali ellenőrzés.
Van egy speciális eset: ha az adattípus periodikus (például dátumokra vagy időkre), akkor a max
alacsonyabb lehet, mint az min
értéke, ami azt jelzi, hogy a tartomány körbefuthat; például ez lehetővé teszi az idő megadását 22 és 4 óra között változhat.
minlength
Érvényes: text
, search
, url
, tel
, email
és password
, meghatározza a felhasználó számára a beviteli mezőbe beírható karakterek minimális számát (UTF-16 kódegységként). Ennek nem negatív egész értéknek kisebbnek vagy egyenlőnek kell lennie, mint a maxlength
által megadott érték. Ha nincs megadva minlength
, vagy érvénytelen érték van megadva, akkor a bemenetnek nincs minimális hossza.
A bemenet sikertelen lesz a korlátozás érvényesítésében, ha a szöveg hossza a mezőbe beírt mező kevesebb, mint minlength
UTF-16 kódegység hosszú, megakadályozva az űrlapküldést. További információ: Ügyféloldali érvényesítés.
multiple
A logikai multiple
attribútum, ha be van állítva, a felhasználót jelenti. vesszővel elválasztott e-mail címeket írhat be az e-mail widgetbe, vagy választhat több fájlt is a file
bemenettel. Tekintse meg az e-mail és a fájl beviteli típusát.
name
Karakterlánc, amely megadja a bemeneti vezérlő nevét. Ezt a nevet a vezérlő értékével együtt adjuk be, amikor az űrlapadatokat elküldjük.
Mi van egy névben
Vegye figyelembe a name
egy kötelező attribútum (annak ellenére, hogy nem). Ha egy bemenethez nincs megadva name
, vagy ha name
üres, akkor a az input értékét nem adják meg az űrlappal! (A letiltott vezérlőket, a be nem jelölt rádiógombokat, a be nem jelölt jelölőnégyzeteket és a reset gombokat sem küldjük el.)
Két speciális eset létezik:
-
_charset_
: Ha egy<input>
típusú rejtett elem neveként használják, akkor az “svalue
bemenetet automatikusan beállítja az űrlap beküldéséhez használt karakterkódolás felhasználói ügynöke. -
isindex
: Történelmi okokból aisindex
nem engedélyezett.
név és választógombok
A name
attribútum egyedi viselkedést hoz létre a választógombok számára.
Egyazon nevű rádiógombcsoportban egyszerre csak egy választógomb ellenőrizhető. A csoport bármelyik választógombjának kiválasztása automatikusan törli az ugyanabban a csoportban jelenleg kiválasztott választógombok kijelölését. hogy az űrlap beküldése esetén egy bejelölt választógombot küldünk a névvel együtt,
Ha ugyanazon megnevezett rádiógombok csoportja, ha be van jelölve, akkor az összpontosít. Ha nincsenek csoportosítva forrási sorrendben, ha valamelyik csoport be van jelölve, akkor a csoportba való lapozás akkor kezdődik, amikor a csoportban az első találkozik, kihagyva mindazokat, amelyek nincsenek bejelölve. Más szavakkal, ha be van jelölve, a lapozás kihagyja a csoport nem ellenőrzött rádiógombjait. Ha egyik sincs bejelölve, akkor a rádiógombcsoport összpontosít, amikor eléri az azonos névcsoport első gombját.
Amint a csoport egyik választógombja fókuszba kerül, a nyílbillentyűkkel az összes az azonos nevű rádiógombok, még akkor is, ha a rádiógombok nincsenek csoportosítva a forrás sorrendjében.
HTMLFormElement.elements
Ha egy bemeneti elemnek name
, ez a név a “s HTMLFormElement.elements
tulajdonság tulajdonjogává válik. Ha van olyan bemenete, amelynek name
beállítása guest
és egy másik, amelynek name
hat-size
, a következő kód használható:
Ha ez a kód lefutott, guestName
lesz az HTMLInputElement
a guest
mezőhöz, és hatSize
az objektum a hat-size
mező.
name
adását, amely megfelel az űrlap beépített tulajdonságának, mivel ekkor felülírná az előre meghatározott tulajdonságot vagy metódust ezzel a hivatkozással a megfelelő bemenetre. pattern
A pattern
attribútum, ha meg van adva, egy reguláris kifejezés, amelyet a a “s value
bemenetnek meg kell egyeznie annak érdekében, hogy az érték áthaladjon a korlát érvényesítésén. Érvényes JavaScript reguláris kifejezésnek kell lennie, amelyet a RegExp
típus használ, és amelyet a reguláris kifejezésekről szóló útmutatónk dokumentál; a "u"
zászlót megadjuk a reguláris kifejezés összeállításakor, így a mintát az Unicode kódpontok sorozataként kezeljük, nem pedig ASCII néven. A mintaszöveg körül nem szabad előrejelezni a perjeleket.
Ha a pattern
attribútum jelen van, de nincs megadva vagy érvénytelen, akkor nem alkalmazunk reguláris kifejezést, és ez attribútumot teljesen figyelmen kívül hagyják.Ha a minta attribútum érvényes, és egy nem üres érték nem egyezik meg a mintával, a korlátozás ellenőrzése megakadályozza az űrlap elküldését.
Tipp: Ha a pattern
attribútum, tájékoztassa a felhasználót a várható formátumról a magyarázó szöveg közelségével. Felvehet egy title
attribútumot is, hogy elmagyarázza, milyen követelményeknek kell megfelelnie a mintának; a legtöbb böngésző ezt a címet eszköztippként jeleníti meg. Az elérhetőséghez a látható magyarázat szükséges. Az eszköztipp egy továbbfejlesztés.
További információkért lásd: ügyféloldali érvényesítés.
placeholder
A placeholder
attribútum egy karaktersorozat, amely rövid tippet ad a felhasználónak arra vonatkozóan, hogy milyen információk várhatók a mezőben. Olyan szónak vagy rövid kifejezésnek kell lennie, amely inkább magyarázatot vagy felszólítást ad, és inkább a várható adatok típusára utal. A szöveg nem tartalmazhat kocsivisszát vagy sortáblázatot. Tehát például, ha egy mező várhatóan elfogja a felhasználó keresztnevét, és a címke “Keresztnév”, akkor megfelelő helyőrző lehet “pl. Musztafa “.
Megjegyzés: A placeholder
attribútum szemantikailag nem annyira hasznos, mint az űrlap magyarázatának egyéb módjai, és váratlan technikai problémákat okozhat a tartalom. Lásd: < input > címkék: További információ az Input (Form Input) elemnél.
readonly
Logikai attribútum, amely – ha van – azt jelzi, hogy a felhasználónak nem szabad szerkesztenie a bemenet értékét. A readonly
attribútum támogatott text
, search
, url
, tel
, email
, date
, month
, week
, time
, datetime-local
, number
és password
beviteltípusok.
További információt a HTML attribútumban talál: readonly
.
required
egy logikai attribútum, amely – ha van – azt jelzi, hogy a felhasználónak meg kell adnia a bemenet értékét, mielőtt a tulajdonosi űrlap beküldhető lenne. A required
attribútumot text
, search
, , tel
, email
, date
, month
, week
, time
, datetime-local
, number
, password
, checkbox
, radio
, és file
bemenetek.
További információért lásd: ügyféloldali érvényesítés és HTML attribútum: required
.
size
Érvényes:email
,password
,tel
éstext
input
típusok. Megadja, hogy a bemenet mekkora részét jelenítse meg. Alapvetően ugyanazt az eredményt hozza létre, mint a CSSwidth
tulajdonság beállítását néhány különlegességgel. Az érték tényleges egysége a bemeneti típustól függ. Apassword
éstext
esetében ez egy karakterek száma (vagyem
egység)20
alapértelmezett értéke, másoknak pedigpixel
s. A CSS szélessége elsőbbséget élvez a méretattribútummal szemben.src
Csak a image
beviteli gombra érvényes, a src
karakterlánc adja meg a megjelenítendő képfájl URL-je, amely a grafikus beküldés gombot jelöli. Tekintse meg a kép beviteli típusát.
step
Érvényes a numerikus beviteltípusokhoz, ideértve a number
dátumot / time beviteltípusok, és range
, a step
attribútum olyan szám, amely meghatározza az érték részletességét.
Ha nincs kifejezetten benne:
-
step
alapértelmezés szerint 1 anumber
és arange
. - A dátum / idő beviteltípusoknál a
step
másodpercben van kifejezve, az alapértelmezett lépés 60 másodperc . A léptékskála tényezője 1000 (amely a másodperceket milliszekundummá alakítja, ahogy más algoritmusokban használják).
Az értéknek pozitív számnak kell lennie – egész számnak vagy lebegőnek – vagy a any
, ami azt jelenti, hogy nincs szükség lépésre, és bármilyen érték megengedett (kizárva más korlátozásokat, például min
és max
).
Ha a any
nincs explicit módon beállítva, akkor a number
, a dátum / idő beviteli típusok és a range
bemeneti típusok megegyeznek a lépés alapjával – a min
értékkel és a lépésérték növekményeivel, egészen a max
érték, ha meg van adva.
Például, ha van <input type="number" min="10" step="2">
, akkor tetszőleges páros egész szám, 10
vagy nagyobb, érvényes. Ha kihagyja, <input type="number">
, akkor bármely egész szám érvényes, de az úszók (például 4.2
) nem érvényesek, mert step
alapértelmezés szerint 1
. A 4.2
érvényességéhez a step
-et any
, 0,1 értékre kellett volna állítani , 0,2 vagy bármelyik min
értéknek .2
végződésű számnak kellett volna lennie, például <input type="number" min="-5.2">
Megjegyzés: Ha a felhasználó által megadott adatok nem tartják be a lépcsőzetes konfigurációt, akkor az érték érvénytelennek minősül a kényszerellenőrzés során, és meg fog egyezni a :invalid
pseudoclass.
További információkért lásd az ügyféloldali érvényesítést.
tabindex
Minden elemre érvényes globális attribútum, beleértve az összes bemeneti típust, egy egész attribútum, amely jelzi, hogy az elem képes-e bemenet fókuszálásra (fókuszálható), ha részt kell vennie a szekvenciális billentyűzet navigációban. fókuszálhatók, ezt az attribútumot nem szabad használni az űrlapvezérlőkön, mert ehhez a foc kezelésére lenne szükség megrendeljük a dokumentum összes elemét, annak kockázatával, hogy helytelenül tennénk a felhasználhatóságot és az akadálymentességet.
title
Minden elemre érvényes globális attribútum, beleértve az összes bemeneti típust , amely olyan szöveget tartalmaz, amely tanácsadó információkat tartalmaz az elemhez kapcsolódóan. Az ilyen információkat tipikusan, de nem feltétlenül, eszköztippként lehet bemutatni a felhasználónak. A cím NEM használható az űrlapvezérlés elsődleges magyarázataként. Ehelyett használja a <label>
elemet egy for
attribútummal, amely az “s id
attribútum. Lásd az alábbi címkéket.
type
Karakterlánc, amely meghatározza a megjelenítendő vezérlés típusát. Például jelölőnégyzet létrehozásához a checkbox
kerül felhasználásra. Ha kihagyja (vagy ismeretlen érték van megadva), akkor a text
bemeneti típust használja, sima szövegű bemeneti mezőt létrehozva.
Az engedélyezett értékek a fenti <input>
típusokban vannak felsorolva.
value
A bemeneti vezérlő értéke. Ha a HTML-ben meg van adva, ez a kezdeti érték, és ettől kezdve bármikor módosítható vagy lekérhető a JavaScript használatával a megfelelő HTMLInputElement
objektum “s value
tulajdonság. A value
attribútum mindig választható, bár kötelezőnek kell tekinteni a checkbox
, radio
és hidden
.
width
Érvényes a image
beviteli gomb, a width
a megjelenítendő képfájl szélessége, amely a grafikus beküldés gombot ábrázolja. Lásd a képbeviteli típust.