CKTIS / HTML
elemento HTML: button
O elemento botão nativo representa um comando com nome e pode funcionar como controlo de formulário cujo tipo determina o comportamento.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<button type="submit" name="action" value="save">Save</button>button aceita para type os valores submit, reset e button; reset elimina alterações do utilizador, por isso só deve ser oferecido com necessidade clara.
Num botão de formulário comum, type ausente ou inválido conduz ao comportamento submit; usa explicitamente type="button" para uma ação apenas de script.
Só o submitter ativado contribui com name e value; SubmitEvent.submitter identifica o controlo e o construtor FormData pode incluí-lo.
disabled impede ativação e contribuição de dados. Um button comum não pode conter descendentes interativos como a ou input, nem um descendente com tabindex; o conteúdo visível deve nomear claramente a ação.
Exemplos
<!doctype html>
<meta charset="utf-8">
<form id="order">
<label>Item <input name="item" value="book"></label>
<button id="save" name="action" value="save">Save order</button>
<button id="preview" type="button">Preview</button>
</form>
<output id="result"></output>
<script>
const order = document.querySelector("#order");
const save = document.querySelector("#save");
const preview = document.querySelector("#preview");
order.addEventListener("submit", event => {
event.preventDefault();
const data = new FormData(order, event.submitter);
document.querySelector("#result").textContent = `submitter=${event.submitter.id}; action=${data.get("action")}; item=${data.get("item")}; saveType=${save.type}; previewType=${preview.type}`;
}, { once: true });
save.click();
</script>
Resultado
submitter=save; action=save; item=book; saveType=submit; previewType=button
O exemplo chama `click()` no botão `submit` e usa `FormData` para observar o submitter escolhido, dados do campo e tipo explícito do botão de pré-visualização.