CKTIS / HTML
formenctype — oblika podatkov za posamezen gumb za pošiljanje
Atribut formenctype omogoča gumbu za pošiljanje, da preglasi enctype obrazca. Obliko podatkov zahteve POST določi samo, ko obrazec pošljete s tem gumbom.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype določa obliko podatkov, ki jo uporablja posamezen gumb za pošiljanje obrazca. Velja za button, ki deluje kot gumb za pošiljanje, in za input z type="submit" ali type="image". Pri button je koristno izrecno nastaviti type="submit". Preglasitev vpliva samo na pošiljanje s tem gumbom; atributa enctype obrazca ne spremeni.
Dovoljene vrednosti so application/x-www-form-urlencoded (z odstotki kodirani pari ime–vrednost), multipart/form-data (ločeni deli, ki lahko vsebujejo vsebino datotek) in text/plain (berljiva, vendar dvoumna oblika, neprimerna za zanesljivo razčlenjevanje).
Če formenctype ni naveden, se uporabi enctype povezanega obrazca. Prazna ali neveljavna vrednost namesto tega izbere application/x-www-form-urlencoded in se ne vrne na nastavitev obrazca. Če tudi obrazec ne navede enctype, je njegova privzeta oblika application/x-www-form-urlencoded.
Pri pošiljanju prek HTTP ta oblika določa telo zahteve POST; metode ne spremeni v POST. Pri GET se podatki ne glede na formenctype vključijo v URL z uporabo application/x-www-form-urlencoded. V JavaScriptu se ustrezna lastnost imenuje formEnctype. Primer prekliče pošiljanje in prikaže izbrano obliko, ne da bi poslal zahtevo.
Primeri
<!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>Rezultat
Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.