CKTIS / HTML
onsubmit — gestionar un intento de envío de formulario
El atributo onsubmit especifica el código JavaScript que gestiona el evento submit. Permite reaccionar a un intento de envío del formulario y cancelar el envío predeterminado; no confirma que los datos hayan llegado al servidor.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };onsubmit es un atributo de gestión del evento submit. Normalmente se coloca en el elemento form, no en el botón de envío. Aunque está disponible en todos los elementos HTML, el formulario es el destino de este evento, que se propaga a sus antecesores. El valor del atributo es código JavaScript, no la dirección de destino del formulario.
El evento se produce antes del envío predeterminado, por ejemplo, al activar un botón de envío o llamar a form.requestSubmit(). Si el navegador realiza la validación de restricciones y el formulario no la supera, el evento submit no se produce. El método form.submit() omite tanto esa validación como el evento submit.
El código del atributo recibe el parámetro event. Llamar a event.preventDefault() o ejecutar return false cancela el envío predeterminado. Esto no detiene la propagación del evento. Llamar sin más a una función que devuelve false, sin transmitir su resultado mediante return, no cancela el envío.
JavaScript también permite asignar una función a form.onsubmit; una asignación posterior reemplaza la función anterior de esa propiedad. El ejemplo usa el atributo, cancela el envío y cambia el texto de estado. Se requiere que JavaScript esté habilitado y que la política de seguridad permita los controladores de eventos en línea.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsubmit demo</title>
<form onsubmit="event.preventDefault(); document.getElementById('result').textContent = 'Submission canceled';">
<button type="submit">Submit</button>
</form>
<p id="result" role="status">Ready</p>
</html>Resultado
Submission canceled
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.