CKTIS / HTML
element HTML: button
Izvorni element gumba predstavlja poimenovan ukaz in lahko deluje kot kontrolnik obrazca, katerega vrsta določa vedenje.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<button type="submit" name="action" value="save">Save</button>button za type podpira vrednosti submit, reset in button; reset zavrže spremembe uporabnika, zato ga ponudi le ob jasni potrebi.
Pri navadnem gumbu obrazca manjkajoči ali neveljavni type povzroči vedenje submit; za izključno skriptno dejanje izrecno uporabi type="button".
Le aktivirani submitter prispeva svoja name in value; SubmitEvent.submitter ga določi, konstruktor FormData pa ga lahko vključi.
disabled prepreči aktiviranje in prispevek podatkov. Navaden button ne sme vsebovati interaktivnih potomcev, kot sta a ali input, niti potomca s tabindex; vidna vsebina naj jasno poimenuje dejanje.
Primeri
<!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>
Rezultat
submitter=save; action=save; item=book; saveType=submit; previewType=button
Primer pokliče `click()` na gumbu `submit` in s `FormData` opazuje izbrani submitter, podatke polja ter izrecno vrsto gumba za predogled.