CKTIS / HTML
form — formularz HTML
Element form łączy kontrolki w formularz i określa sposób wysyłania danych. Obsługuje natywne przesyłanie oraz walidację; JavaScript może przechwycić wysłanie.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<form action="/search" method="get">…</form>form reprezentuje formularz, którego kontrolki mogą dostarczać dane do przetworzenia. Wymaga znacznika otwierającego i zamykającego; nie wolno zagnieżdżać formularzy. Obsługiwane kontrolki poza formularzem można powiązać z nim atrybutem form wskazującym jego id.
action określa adres docelowy. method="get" (wartość domyślna) umieszcza dane w zapytaniu URL, a method="post" — w treści żądania. Przy przesyłaniu plików przez POST użyj enctype="multipart/form-data". Sam POST nie zapewnia szyfrowania.
Klucze danych pochodzą z name, nie z id. Wyłączone kontrolki i niezaznaczone pola wyboru są pomijane. Kontrolki bez nazwy są zwykle pomijane, ale nienazwany przycisk graficzny (<input type="image">) użyty do wysłania formularza dodaje do danych współrzędne o kluczach x i y. Powiąż etykiety z polami. Walidacja przeglądarki pomaga użytkownikowi, ale nie zastępuje walidacji na serwerze.
Przy zwykłym wysyłaniu formularza interaktywna walidacja odbywa się przed zdarzeniem submit, chyba że zostanie pominięta. Jeśli walidacja się nie powiedzie, wysyłanie zostaje przerwane i zdarzenie submit nie występuje. Atrybut novalidate pozwala pominąć interaktywną walidację. W skryptach preferuj requestSubmit(): w przeciwieństwie do submit() zachowuje walidację i zdarzenie submit.
Przykłady
<!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>Wynik
q=html
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.