CKTIS / HTML
formaction — URL di invio di un pulsante
L’attributo formaction sostituisce action di un modulo quando un pulsante specifico ne avvia l’invio. Consente di inviare lo stesso modulo a URL diverse senza modificarne la destinazione predefinita.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">formaction specifica l’URL di invio per un pulsante di invio specifico: un button che invia il modulo oppure un input con type="submit" o type="image". Non deve essere inserito su un pulsante ordinario né su un pulsante di reset.
Se il pulsante che invia il modulo ha formaction, il suo valore sostituisce action del modulo associato solo per quell’invio. Senza questo attributo, si applica action del modulo. Il valore deve essere un URL valido e non vuoto; è consentito un URL relativo.
L’attributo cambia la destinazione, non il metodo HTTP, la codifica o le regole di convalida. Nell’esempio, il modulo non ha l’attributo method, quindi il metodo predefinito è GET. Il gestore dell’evento submit annulla l’invio e scrive nella console soltanto il testo del pulsante e il frammento dell’URL selezionato: #publish per Publish e #preview per Preview. L’esempio non invia alcuna richiesta GET.
Esempi
<!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>Risultato
Publish: #publish Preview: #preview
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.