Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

formaction — adres wysyłania dla przycisku

Atrybut formaction zastępuje action formularza, gdy wysyłanie uruchamia dany przycisk. Pozwala kierować ten sam formularz do różnych adresów bez zmiany jego domyślnego celu.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<button type="submit" formaction="URL">...</button>
<input type="submit" formaction="URL">
<input type="image" src="IMAGE_URL" alt="..." formaction="URL">

formaction określa adres wysyłania dla konkretnego przycisku: button wysyłającego formularz albo input z type="submit" lub type="image". Nie należy go umieszczać na zwykłym przycisku ani przycisku resetowania.

Jeśli użyty przycisk ma formaction, jego wartość zastępuje action powiązanego formularza tylko podczas tego wysyłania. Bez tego atrybutu obowiązuje action formularza. Wartością musi być poprawny, niepusty URL; adres względny jest dozwolony.

Atrybut zmienia cel, nie metodę HTTP, kodowanie ani reguły walidacji. W przykładzie formularz nie ma atrybutu method, więc domyślną metodą jest GET. Procedura obsługi zdarzenia submit anuluje wysyłanie i wypisuje w konsoli jedynie nazwę przycisku oraz fragment wybranego adresu URL: #publish dla Publish i #preview dla Preview. Przykład nie wysyła żądania GET.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Button-specific form action</title>
</head>
<body>
  <h1>Choose a form action</h1>
  <form id="editor" action="#publish">
    <button type="submit">Publish</button>
    <button type="submit" formaction="#preview">Preview</button>
  </form>
  <p id="publish">Local publish destination.</p>
  <p id="preview">Local preview destination.</p>
  <script>
    const form = document.getElementById('editor');
    form.addEventListener('submit', event => {
      event.preventDefault();
      const button = event.submitter;
      const action = button.hasAttribute('formaction') ? button.formAction : form.action;
      console.log(`${button.textContent}: ${new URL(action).hash}`);
    });
    for (const button of form.querySelectorAll('button')) {
      form.requestSubmit(button);
    }
  </script>
</body>
</html>

Wynik

Publish: #publish
Preview: #preview

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła