CKTIS / HTML
action — endereço de envio do formulário
`action` identifica o destino do formulário, mas o botão que o envia pode substituí-lo com o seu próprio `formaction`.
Versão: HTML Living Standard
Sintaxe
<form action="/save"><button formaction="/preview">Preview</button></form>Em form, indica um URL relativo ou absoluto válido e não vazio. Os relativos são resolvidos com o URL base do documento. Sem atributo, usa-se o endereço do documento; um valor vazio pode agir de forma semelhante, mas não é uma escrita conforme.
action não escolhe método HTTP, formato ou contexto de destino: isso cabe a method, enctype e target. O formaction de um botão de envio tem prioridade para esse envio. O endereço não substitui validação nem proteção CSRF; não envies segredos com GET.
O exemplo chama requestSubmit() com um botão específico. O formulário indica /save, mas o pedido GET chega a /preview?q=two+words. O recetor local confirma o destino. Fora do teste é necessária uma rota correspondente no servidor.
Exemplos
<!doctype html><meta charset="utf-8">
<form id="form" action="/save" method="get" target="receipt">
<label>Query <input name="q" value="two words"></label>
<button id="preview" formaction="/preview">Preview</button></form>
<iframe id="receipt" name="receipt" title="Submission receipt" hidden></iframe>
<output id="result"></output>
<script>
const form = document.querySelector('form');
document.querySelector('#receipt').addEventListener('load', event => {
const response = event.target.contentDocument.querySelector('#received');
if (response) document.querySelector('#result').textContent = response.textContent;
});
form.requestSubmit(document.querySelector('#preview'));
</script>Resultado
GET /preview?q=two+words
Verifica-se o pedido real e a ausência de pedidos para `/save`, sem contactar a produção.