CKTIS / HTML
element HTML: button
Natywny element przycisku reprezentuje nazwaną komendę i może działać jako kontrolka formularza o zachowaniu określonym przez rodzaj.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<button type="submit" name="action" value="save">Save</button>button obsługuje wartości type równe submit, reset i button; reset usuwa zmiany użytkownika, więc powinien być oferowany tylko z wyraźną potrzebą.
W zwykłym formularzu brak lub błędny type prowadzi do zachowania submit; dla akcji wyłącznie skryptowej jawnie ustaw type="button", aby uniknąć przypadkowej wysyłki.
Tylko aktywowany submitter wnosi swoje name i value; SubmitEvent.submitter wskazuje kontrolkę, a konstruktor FormData może uwzględnić właśnie ją.
disabled blokuje aktywację i udział w danych. Zwykły button nie może zawierać interaktywnych potomków takich jak a czy input ani potomka z tabindex; widoczna treść powinna jasno nazywać działanie.
Przykłady
<!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>
Wynik
submitter=save; action=save; item=book; saveType=submit; previewType=button
Przykład wywołuje `click()` na przycisku `submit` i przez `FormData` obserwuje wybranego submittera, dane pola oraz jawny typ przycisku podglądu.