CKTIS / HTML
formenctype — format danych dla konkretnego przycisku wysyłania
Atrybut formenctype pozwala przyciskowi wysyłania zastąpić enctype formularza. Określa format danych żądania POST tylko wtedy, gdy formularz zostaje wysłany tym przyciskiem.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype określa format danych wysyłanych przez konkretny przycisk formularza. Dotyczy button będącego przyciskiem wysyłania oraz input o type="submit" lub type="image". Dla button warto jawnie ustawić type="submit". Nadpisanie dotyczy tylko wysłania tym przyciskiem; nie zmienia atrybutu enctype formularza.
Dozwolone wartości to application/x-www-form-urlencoded (pary nazwa–wartość z kodowaniem procentowym), multipart/form-data (oddzielne części, umożliwiające przesłanie zawartości plików) i text/plain (czytelny, ale niejednoznaczny format, nieodpowiedni do niezawodnego parsowania).
Brak formenctype oznacza użycie enctype powiązanego formularza. Pusta lub nieprawidłowa wartość oznacza natomiast application/x-www-form-urlencoded, a nie powrót do ustawienia formularza. Gdy formularz również nie ma enctype, domyślnym formatem jest application/x-www-form-urlencoded.
Przy wysyłaniu HTTP format ten określa treść żądania POST; nie zmienia metody na POST. Dla GET dane trafiają do adresu URL z kodowaniem application/x-www-form-urlencoded, niezależnie od formenctype. W JavaScript właściwość odzwierciedlająca atrybut nazywa się formEnctype. Przykład anuluje wysyłanie i pokazuje wybrany format, bez wykonywania żądania.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>formenctype demo</title>
<form id="demo" method="post" enctype="application/x-www-form-urlencoded">
<input name="message" value="hello world" aria-label="Message">
<button type="submit">Default</button>
<button type="submit" formenctype="multipart/form-data">Multipart</button>
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('demo');
const result = document.getElementById('result');
form.addEventListener('submit', (event) => {
event.preventDefault();
const button = event.submitter;
result.textContent = button && button.hasAttribute('formenctype')
? button.formEnctype
: form.enctype;
});
</script>
</html>Wynik
Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.