Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła