Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

formenctype — formát dat pro konkrétní odesílací tlačítko

Atribut formenctype umožňuje odesílacímu tlačítku přepsat enctype formuláře. Formát dat požadavku POST vybírá pouze tehdy, když je formulář odeslán tímto tlačítkem.

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

Syntaxe

formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"

formenctype určuje formát dat používaný konkrétním odesílacím tlačítkem formuláře. Platí pro button, který slouží jako odesílací tlačítko, a pro input s type="submit" nebo type="image". U button je užitečné nastavit type="submit" výslovně. Přepsání se týká pouze odeslání tímto tlačítkem; atribut enctype formuláře nemění.

Povolené hodnoty jsou application/x-www-form-urlencoded (procentově kódované dvojice název–hodnota), multipart/form-data (samostatné části, které mohou přenášet obsah souborů) a text/plain (čitelný, ale nejednoznačný formát nevhodný pro spolehlivé parsování).

Pokud formenctype chybí, použije se enctype přiřazeného formuláře. Prázdná nebo neplatná hodnota místo toho zvolí application/x-www-form-urlencoded, nikoli nastavení formuláře. Pokud enctype chybí i formuláři, je jeho výchozím formátem application/x-www-form-urlencoded.

Při odeslání přes HTTP tento formát určuje tělo požadavku POST; nemění metodu na POST. Při použití GET se data bez ohledu na formenctype vloží do URL ve formátu application/x-www-form-urlencoded. V JavaScriptu se odpovídající vlastnost jmenuje formEnctype. Příklad odeslání zruší a zobrazí vybraný formát, aniž by odeslal požadavek.

Příklady

<!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>

Výsledek

Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje