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.