Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

action — adres wysłania formularza

`action` wskazuje adres obsługi formularza, lecz przycisk wysyłający może zastąpić go własnym `formaction`.

Wersja: HTML Living Standard

Składnia

<form action="/save"><button formaction="/preview">Preview</button></form>

Na form wpisz poprawny, niepusty URL, względny lub bezwzględny. Względny adres jest rozwiązywany względem adresu bazowego dokumentu. Brak atrybutu prowadzi do wysłania na adres dokumentu; pusty zapis może działać podobnie, ale nie jest zgodną wartością autorską.

action nie wybiera metody HTTP, formatu ani okna docelowego: służą do tego method, enctype i target. Przycisk submit z formaction ma pierwszeństwo dla tego wysłania. Adres nie stanowi walidacji danych ani ochrony przed CSRF; nie wysyłaj sekretów metodą GET.

Przykład wywołuje requestSubmit() z konkretnym przyciskiem. Formularz wskazuje /save, ale żądanie GET trafia do /preview?q=two+words. Lokalny odbiornik potwierdza wybrany adres. Bez niego przykład wymagałby odpowiedniej trasy serwera.

Przykłady

<!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>

Wynik

GET /preview?q=two+words

Sprawdzono prawdziwe żądanie formularza i brak żądania do `/save`; nie użyto produkcyjnego serwera.

Źródła