CKTIS / HTML
formaction — URL na odoslanie tlačidlom
Atribút formaction prepíše action formulára, keď odoslanie spustí konkrétne tlačidlo. Umožňuje odosielať ten istý formulár na rôzne URL bez zmeny jeho predvoleného cieľa.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">formaction určuje URL na odoslanie konkrétnym odosielacím tlačidlom: odosielacím prvkom button alebo prvkom input s type="submit" či type="image". Nesmie sa použiť na bežnom tlačidle ani na tlačidle na resetovanie.
Ak má tlačidlo, ktoré odosiela formulár, atribút formaction, jeho hodnota pri tomto odoslaní prepíše action súvisiaceho formulára. Bez tohto atribútu sa použije action formulára. Hodnota musí byť platná, neprázdna URL; relatívna URL je povolená.
Atribút mení cieľ, nie metódu HTTP, kódovanie ani pravidlá overovania. V príklade formulár nemá atribút method, takže predvolenou metódou je GET. Obsluha udalosti submit zruší odoslanie a do konzoly vypíše iba text tlačidla a fragment vybranej URL: #publish pre Publish a #preview pre Preview. Príklad neodosiela žiadnu požiadavku GET.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Button-specific form action</title>
</head>
<body>
<h1>Choose a form action</h1>
<form id="editor" action="#publish">
<button type="submit">Publish</button>
<button type="submit" formaction="#preview">Preview</button>
</form>
<p id="publish">Local publish destination.</p>
<p id="preview">Local preview destination.</p>
<script>
const form = document.getElementById('editor');
form.addEventListener('submit', event => {
event.preventDefault();
const button = event.submitter;
const action = button.hasAttribute('formaction') ? button.formAction : form.action;
console.log(`${button.textContent}: ${new URL(action).hash}`);
});
for (const button of form.querySelectorAll('button')) {
form.requestSubmit(button);
}
</script>
</body>
</html>Výsledok
Publish: #publish Preview: #preview
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.