Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes