Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

method — sposób przesyłania formularza

Atrybut method elementu form wybiera get, post albo dialog. Określa sposób przesłania danych lub zamknięcie okna dialogowego zamiast żądania sieciowego.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<form method="get|post|dialog">…</form>

Atrybut method elementu form wybiera sposób obsługi wysłania formularza. Dozwolone wartości to get, post i dialog. Brak atrybutu oraz nieprawidłowa wartość, także pusty ciąg lub put, oznaczają stan GET.

Dla adresów HTTP(S) get umieszcza zakodowane dane formularza w części zapytania adresu URL, a post przesyła je w treści żądania. Atrybut action określa adres docelowy; enctype określa kodowanie treści przy post.

Wartość dialog zamyka najbliższy nadrzędny element dialog, nie wysyłając danych przez sieć. Bez takiego przodka nie dochodzi do wysłania. Walidacja nadal może zablokować tę operację. W przykładzie przycisk ustawia returnValue okna na ok.

Atrybut formmethod na użytym przycisku wysyłającym zastępuje method formularza. Gdy go brak, obowiązuje ustawienie formularza; nieprawidłowe formmethod wybiera GET, zamiast dziedziczyć ustawienie.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>method demo</title>
<dialog id="choice">
  <form method="dialog">
    <button type="submit" value="ok">OK</button>
  </form>
</dialog>
<pre id="result">waiting</pre>
<script>
  const choice = document.getElementById('choice');
  const result = document.getElementById('result');
  choice.addEventListener('close', () => {
    result.textContent = `returnValue=${choice.returnValue}`;
  });
  choice.showModal();
</script>
</html>

Wynik

returnValue=ok

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła