CKTIS / HTML
formenctype — gegevensformaat voor een specifieke verzendknop
Met het attribuut formenctype kan een verzendknop de enctype van het formulier overschrijven. Het kiest het gegevensformaat van het POST-verzoek alleen wanneer het formulier met die knop wordt verzonden.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"formenctype bepaalt het gegevensformaat dat een specifieke verzendknop van een formulier gebruikt. Het geldt voor een button die als verzendknop fungeert en voor input met type="submit" of type="image". Bij button is het handig om type="submit" expliciet in te stellen. De overschrijving geldt alleen voor verzenden met die knop; het attribuut enctype van het formulier verandert er niet door.
Toegestane waarden zijn application/x-www-form-urlencoded (percentgecodeerde naam-waardeparen), multipart/form-data (afzonderlijke delen die bestandsinhoud kunnen bevatten) en text/plain (een leesbaar maar dubbelzinnig formaat dat niet geschikt is voor betrouwbare verwerking).
Als formenctype ontbreekt, wordt de enctype van het bijbehorende formulier gebruikt. Een lege of ongeldige waarde kiest daarentegen application/x-www-form-urlencoded en valt niet terug op de instelling van het formulier. Als ook het formulier enctype weglaat, is het standaardformaat application/x-www-form-urlencoded.
Bij verzending via HTTP bepaalt dit formaat de inhoud van het POST-verzoek; het verandert de methode niet in POST. Met GET komen de gegevens in de URL te staan met application/x-www-form-urlencoded, ongeacht formenctype. In JavaScript heet de reflecterende eigenschap formEnctype. Het voorbeeld annuleert de verzending en toont het gekozen formaat zonder een verzoek te doen.
Voorbeelden
<!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>Resultaat
Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.