CKTIS / HTML
form — HTML obrazac
Element form povezuje kontrole s obrascem i određuje kako se njihovi podaci šalju. Podržava izvorno slanje i provjeru valjanosti; JavaScript može presresti slanje.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<form action="/search" method="get">…</form>form predstavlja obrazac čije kontrole mogu pružiti podatke za obradu. Potrebne su i početna i završna oznaka; obrasci se ne smiju ugniježđivati. Podržane kontrole izvan obrasca mogu se povezati s njim atributom form koji upućuje na njegov id.
action određuje odredište. method="get" (zadana vrijednost) stavlja podatke u upit URL-a, dok ih method="post" stavlja u tijelo zahtjeva. Za prijenos datoteka metodom POST upotrijebite enctype="multipart/form-data". Sama metoda POST ne pruža šifriranje.
Ključevi podataka dolaze iz name, a ne iz id. Onemogućene kontrole i neoznačeni potvrdni okviri izostavljaju se. Kontrole bez naziva u pravilu se izostavljaju, ali ako se obrazac pošalje slikovnim gumbom za slanje (<input type="image">) bez naziva, taj gumb u podatke dodaje koordinate s ključevima x i y. Povežite oznake s poljima. Provjera valjanosti u pregledniku pomaže korisnicima, ali ne zamjenjuje provjeru na poslužitelju.
Pri uobičajenom slanju interaktivna provjera valjanosti provodi se prije pokretanja događaja submit, osim ako se provjera preskoči. Ako provjera valjanosti ne uspije, slanje se prekida i događaj submit ne pokreće se. Atribut novalidate omogućuje preskakanje interaktivne provjere valjanosti. U skriptama dajte prednost funkciji requestSubmit(): za razliku od submit(), ona zadržava provjeru valjanosti i događaj submit.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTML form example</title>
</head>
<body>
<form id="search" method="get">
<label for="query">Query</label>
<input id="query" name="q" value="html" required>
<button id="submit-query" type="submit">Submit query</button>
</form>
<output id="result" for="query" aria-live="polite"></output>
<script>
const form = document.getElementById('search');
const submitButton = document.getElementById('submit-query');
const result = document.getElementById('result');
form.addEventListener('submit', (event) => {
event.preventDefault();
const data = new FormData(form);
result.value = 'q=' + data.get('q');
console.log(result.value);
});
form.requestSubmit(submitButton);
</script>
</body>
</html>Rezultat
q=html
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.