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

CKTIS / HTML

formtarget — dónde se muestra el resultado del envío de un formulario

El atributo formtarget determina dónde se carga el resultado del envío de un formulario iniciado por un botón concreto. Para ese envío, sustituye el target del formulario y permite usar la pestaña actual, una ventana o pestaña nueva, o un marco con nombre.

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

Sintaxis

formtarget="_self|_blank|_parent|_top|target-name"

formtarget especifica el destino de navegación de un envío de formulario. Se aplica a los botones de envío: button de tipo submit e input de tipo submit o image. No es un atributo del elemento form ni de un campo de texto normal.

El valor del botón utilizado para enviar tiene prioridad sobre el target del formulario asociado. Si se omite formtarget, el formulario determina el destino. El atributo no cambia la URL de la solicitud, el método ni los datos; formaction sustituye la URL y formmethod el método.

El valor es un nombre de destino válido o una palabra clave. _self indica el contexto actual, _blank un contexto nuevo de nivel superior, normalmente una pestaña o ventana, _parent el contexto padre y _top el contexto superior. Si no hay padre, _parent y _top funcionan como _self. Un nombre como preview puede seleccionar un iframe con un name coincidente; un id por sí solo no basta. Es un atributo de valor de cadena, no un atributo booleano.

Abre demo.html mediante un servidor HTTP local; no se necesita código del lado del servidor. El script llama automáticamente a requestSubmit() para cada botón. Standard usa el destino _self del formulario (la página actual), mientras que Preview establece formtarget="preview", que prevalece sobre target="_self" y selecciona el iframe con ese nombre. El controlador del evento submit llama a preventDefault(), así que ninguno de los dos botones envía el formulario ni provoca una navegación. La consola muestra los destinos seleccionados, no un resultado cargado.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Button-specific form target</title>
</head>
<body>
  <h1>Choose a form target</h1>
  <form id="example" action="#result" target="_self">
    <button type="submit">Standard</button>
    <button type="submit" formtarget="preview">Preview</button>
  </form>
  <p id="result">Local destination for this example.</p>
  <iframe id="preview-frame" name="preview" title="Local preview" srcdoc="<p>Local preview frame.</p>"></iframe>
  <script>
    const form = document.getElementById('example');
    const frame = document.getElementById('preview-frame');
    form.addEventListener('submit', event => {
      event.preventDefault();
      const button = event.submitter;
      const target = button.hasAttribute('formtarget') ? button.formTarget : form.target;
      const destination = target === '_self' ? 'current page' :
        window.frames[target] === frame.contentWindow ? 'named iframe' : 'unmatched target';
      console.log(`${button.textContent}: ${target} (${destination})`);
    });
    for (const button of form.querySelectorAll('button')) {
      form.requestSubmit(button);
    }
  </script>
</body>
</html>

Resultado

Standard: _self (current page)
Preview: preview (named iframe)

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