Siirry sivun sisältöön Avut CSS HTML JS Wp

INPUT-elementti XHTML 1.0 Strict -dokumenttityypissä

INPUT-elementillä merkataan erityyppisiä lomakkeen syötekenttiä, kuten valintaruutuja, tekstikenttiä, toimintanappeja, yms.

INPUT-elementin attribuutit

INPUT-elementin tiedot lähetetään eteenpäin nimi/arvo (NAME/VALUE) -pareina:

• NAME-attribuutilla nimeämme lomakekentän antamalla sille tunnuksen (CDATA-tietotyyppi), jota sitten palvelinpuolella käytetään kentän tunnistamiseen. Attribuutti on pakollinen kaikissa kentissä, paitsi lähetys- ja palautuspainikkeissa (submit ja reset -tyypeissä).

• Lomaketiedoissa lähetetyt arvot riippuvat kenttien tyypeistä ja lähettäjän syötteestä. VALUE-attribuutilla määritellään kentälle alkuarvo (CDATA-tietotyyppi). Lähetys- ja palautuspainikkeissa attribuutin arvoa käytetään ohittamaan painikkeiden oletusteksti. Attribuutti on pakollinen valintaruuduissa ja -napeissa (checkbox ja radio -tyypeissä).

Elementin TYPE-attribuutilla määrittelemme minkä tyyppisestä syöttökentästä on kyse. Mahdolliset arvot ovat:

• text - Määrittelee yksirivisen tekstikentän. Tämä on oletusarvo. Tekstikenttäesimerkki.
• password - Määrittelee salasanakentän. Tämän kenttä eroaa edellisestä ainoastaan siinä, etteivät syötetyt merkit tulostu näytölle sellaisenaan. Tämä mekanismi ei siis muuten suojaa kentän arvoa, joten yksistään se ei sovellu sensitiivisen tiedon lähettämiseen. Salasanakenttäesimerkki.
• checkbox - Määrittelee valintaruudun, joka mahdollistaa yksittäisen tai ryhmään kuuluvien vaihtoehtojen valinnan tai valintojen poistamisen. Valintaruutuja ryhmitetään antamalla kaikille samaan ryhmään kuuluville elementeille identtinen NAME-attribuutin arvo. Valintaruutuesimerkki.
• radio - Määrittelee valintanapin, joka mahdollistaa ainoastaan yhden valinnan (yhdenmukaisella NAME-attribuutilla ryhmitetyllä) valintanappiryhmästä. Valintanappiesimerkki.
• hidden - Määrittelee piilokentän, jonka tietoja ei esitetä asiakkaalle. Piilokentällä välitetään jotain palvelinpuolella hyödynnettävää tietoa. Tämä mekanismi ei mitenkään suojaa kentän arvoa, joten se ei sovellu sensitiivisen tiedon lähettämiseen. Piilokenttäesimerkki.
• file - Määrittelee tiedostonlähetyskentän, jonka avulla voidaan osoittaa joku asiakkaan tiedosto liitettäväksi osaksi lähetettäviä lomaketietoja. Tiedostonlähetysesimerkki.
• submit - Määrittelee lomaketietojen lähetyspainikkeen. Lomake saa sisältää useamman lähetyspainikkeen. Lähetyspainike-esimerkki.
• image - Määrittelee lomaketietojen graafisen lähetyspainikkeen. Lomaketietojen mukana lähtevät myös klikatun kohdan koordinaatit. Graafisen lähetyspainikkeen esimerkki.
• reset - Määrittelee lomaketietojen palautuspainikkeen, jonka aktivointi palauttaa lomakkeen alkutilaansa. Palautuspainike-esimerkki.
• button - Määrittelee pelkän painikkeen ilman toimintoa. Painike on tarkoitettu asiakaspuolen skriptien ajamiseen. Painike-esimerkki.

CHECKED-attribuutilla (checked="checked") voidaan asettaa valintaruutujen ja -nappien (checkbox ja radio -tyyppejä) alkuarvo valituksi. Katso valintanappiesimerkkiä.

SIZE-attribuutilla voimme ehdottaa kentälle leveyttä. Leveys annetaan kuvapisteinä, paitsi teksti- ja salasanakentissä (text ja password -tyyppejä), jossa annettu arvo (CDATA-tietotyyppi) tarkoittaa kentän merkkien määrää. Katso tekstikenttäesimerkkiä.

MAXLENGTH-attribuutilla voidaan asettaa teksti- ja salasanakenttiin (text ja password -tyyppisiin) syötettävien merkkien yläraja. Attribuutin arvoksi annetaan merkkien määrä (Number-tietotyyppi). Katso salasanakenttäesimerkkiä.

DISABLED-attribuutilla (disabled="disabled") voidaan kenttä asettaa pois käytöstä. Tällöin käyttäjä ei voi muuttaa kentän arvoa, eikä lähetettyyn lomakedataan sisällytetä kentän tietoja. Kentän tilaan voidaan vaikuttaa skripteillä. Katso DISABLED-attribuutin testisivua.

READONLY-attribuutilla (readonly="readonly") voidaan kenttä asettaa vain luku -tilaan. Tällöin käyttäjä ei voi muuttaa kentän arvoa, mutta lähetettyyn lomakedataan sisällytetään kentän tiedot. Attribuutti koskee teksti- ja salasanakenttiä (text ja password -tyyppejä). Kentän tilaan voidaan vaikuttaa skripteillä. Katso READONLY-attribuutin testisivua.

SRC-attribuutilla (source, lähde) viitataan graafisen lähetyspainikkeen (image-tyypin) kuvatiedostoon. Attribuutin arvoksi annetaan kuvatiedoston osoite (URI-tietotyyppi). ALT-attribuutilla (alternate text) taas määritellään kuvalle vaihtoehtoinen teksti (CDATA-tietotyyppi), joka astuu voimaan tilanteissa, joissa asiakasohjelma ei tue kuvia ja mahdollisesti myös silloin kun selaimen käyttäjä on poistanut päältä kuvien latautumisen. Katso graafisen lähetyspainikkeen esimerkkiä.

USEMAP-attribuutilla määritellään graafinen lähetyspainikke (image-tyyppi) asiakaspuolen kuvakartaksi (client side image map), jolloin karttamääritykset löytyvät MAP-elementistä. Attribuutin arvoksi annetaan MAP-elementin osoite (URI), yleensä yhteensopivuussyistä samasta dokumentista löytyvä kohdeankkuri (esim. usemap="#MunKartta"). Katso USEMAP-attribuutin testisivua.

ACCEPT-attribuutilla voidaan tiedostonlähetyskentässä (file-tyyppi) ilmoittaa lomakekäsittelijän hyväksymät sisältötyypit (ContentTypes-tietotyyppi). Tieto on tarkoitettu asiakasohjelmien hyödynnettäväksi. Lisätietoja: Filtering (through a file type filter).

Kohdistusattribuuttien lisäksi INPUT-elementti hyväksyy kaksi lomaketapahtuma-attribuuttia, joiden arvoksi annetaan ohjelmointikoodia (Script-tietotyyppi), jonka asiakasohjelma suorittaa havaittuaan määritetyn tapahtuman:

• ONCHANGE - kun kentän arvo on muuttunut (kohdistuksen siirryttyä). Katso ONCHANGE-attribuutin testisivua.
• ONSELECT - kun käyttäjä valitsee tekstiä. Katso ONSELECT-attribuutin testisivua.

Huomiot

Tapahtuma-attribuuttien käyttö edellyttää käytetyn skriptikielen ilmoittamista META-elementin HTTP-EQUIV-attribuutilla. Esimerkiksi JavaScript seuraavasti:

<meta
 http-equiv="Content-Script-Type"
 content="text/javascript" />