Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

formmethod — metoda wysłania dla przycisku

Atrybut formmethod określa metodę wysłania formularza dla konkretnego przycisku wysyłającego. Obsługuje get, post i dialog, zastępując method formularza przy wysłaniu zainicjowanym tym przyciskiem.

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

Składnia

formmethod="get|post|dialog"

formmethod stosuje się do przycisków wysyłających: elementów button, które pełnią tę funkcję, oraz elementów input z type="submit" lub type="image". Element button może być przyciskiem wysyłającym także bez atrybutu type; jawne type="submit" nie jest wymagane. Atrybut formmethod działa dla wysłania zainicjowanego danym przyciskiem, nie zmieniając atrybutu method formularza.

get przesyła dane w adresie URL, a post — w treści żądania HTTP. dialog zamyka otaczający formularz element dialog, zamiast wysyłać dane; bez takiego przodka wysłanie nie następuje.

Brak formmethod oznacza użycie method powiązanego formularza. Nieprawidłowa wartość, również pusty ciąg, wybiera natomiast get, a nie metodę formularza. Gdy sam formularz nie ma method, domyślna metoda to get.

W przykładzie formmethod="dialog" zastępuje method="post". Kliknięcie Close zamyka okno bez żądania formularza i ustawia jego returnValue na done, czyli wartość przycisku.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>formmethod</title>
<dialog id="demo">
  <form method="post">
    <button type="submit" formmethod="dialog" value="done">Close</button>
  </form>
</dialog>
<output id="result">waiting</output>
<script>
  const demo = document.getElementById('demo');
  const result = document.getElementById('result');
  demo.addEventListener('close', () => {
    result.textContent = demo.returnValue;
  });
  demo.showModal();
</script>

Wynik

done

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

Źródła