CKTIS / HTML
formenctype — formát údajov pre konkrétne tlačidlo odoslania
Atribút formenctype umožňuje tlačidlu odoslania prepísať enctype formulára. Formát údajov požiadavky POST vyberá iba vtedy, keď sa formulár odošle týmto tlačidlom.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype určuje formát údajov používaný konkrétnym tlačidlom odoslania formulára. Platí pre button, ktorý slúži ako tlačidlo odoslania, a pre input s type="submit" alebo type="image". Pri button je užitočné nastaviť type="submit" výslovne. Prepísanie sa týka iba odoslania týmto tlačidlom; atribút enctype formulára nemení.
Povolené hodnoty sú application/x-www-form-urlencoded (percentuálne kódované dvojice názov–hodnota), multipart/form-data (samostatné časti, ktoré môžu prenášať obsah súborov) a text/plain (čitateľný, ale nejednoznačný formát nevhodný na spoľahlivé parsovanie).
Ak formenctype chýba, použije sa enctype priradeného formulára. Prázdna alebo neplatná hodnota namiesto toho vyberie application/x-www-form-urlencoded, nie nastavenie formulára. Ak enctype chýba aj formuláru, jeho predvoleným formátom je application/x-www-form-urlencoded.
Pri odoslaní cez HTTP tento formát určuje telo požiadavky POST; nemení metódu na POST. Pri použití GET sa údaje bez ohľadu na formenctype vložia do URL vo formáte application/x-www-form-urlencoded. V JavaScripte sa zodpovedajúca vlastnosť nazýva formEnctype. Príklad odoslanie zruší a zobrazí vybraný formát bez odoslania požiadavky.
Prí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ýsledok
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ýsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.