CKTIS / HTML
formaction — URL za pošiljanje z gumbom
Atribut formaction nadomesti action obrazca, kadar pošiljanje sproži določen gumb. Tako lahko isti obrazec pošljete na različne URL-je, ne da bi spremenili njegov privzeti cilj.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">formaction določa URL za pošiljanje z določenim gumbom za oddajo: z elementom button, ki odda obrazec, ali z elementom input z vrednostjo type="submit" ali type="image". Ne sme biti uporabljen na običajnem gumbu ali gumbu za ponastavitev.
Če ima gumb, ki odda obrazec, atribut formaction, njegova vrednost nadomesti action povezanega obrazca samo pri tem pošiljanju. Brez tega atributa velja action obrazca. Vrednost mora biti veljaven, neprazen URL; relativni URL je dovoljen.
Atribut spremeni cilj, ne pa metode HTTP, kodiranja ali pravil preverjanja. V primeru obrazec nima atributa method, zato je privzeta metoda GET. Obdelovalnik dogodka submit prekliče oddajo in v konzolo izpiše le besedilo gumba in fragment izbranega URL-ja: #publish za Publish in #preview za Preview. Primer ne pošlje nobene zahteve GET.
Primeri
<!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>Rezultat
Publish: #publish Preview: #preview
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.