Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

formaction — URL de envío de un botón

El atributo formaction sustituye a action en un formulario cuando un botón concreto inicia el envío. Permite enviar el mismo formulario a distintas URL sin cambiar su destino predeterminado.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

formaction especifica la URL de envío para un botón de envío concreto: un button que envía el formulario o un input con type="submit" o type="image". No debe colocarse en un botón normal ni en un botón de restablecimiento.

Si el botón que envía el formulario tiene formaction, su valor sustituye a action del formulario asociado solo para ese envío. Sin este atributo, se aplica action del formulario. El valor debe ser una URL válida y no vacía; se permite una URL relativa.

El atributo cambia el destino, no el método HTTP, la codificación ni las reglas de validación. En el ejemplo, el formulario no incluye el atributo method, por lo que GET es el método predeterminado. El controlador del evento submit cancela el envío y solo muestra en la consola el texto del botón y el fragmento de la URL seleccionada: #publish para Publish y #preview para Preview. El ejemplo no envía ninguna solicitud GET.

Ejemplos

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

Resultado

Publish: #publish
Preview: #preview

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes