From 1109132f09d75da9a28b649c7677bb6ce07c40c0 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:41:45 -0500 Subject: initial commit --- files/es/web/api/htmlformelement/index.html | 109 ++++++++++++++++++++++ files/es/web/api/htmlformelement/reset/index.html | 59 ++++++++++++ 2 files changed, 168 insertions(+) create mode 100644 files/es/web/api/htmlformelement/index.html create mode 100644 files/es/web/api/htmlformelement/reset/index.html (limited to 'files/es/web/api/htmlformelement') diff --git a/files/es/web/api/htmlformelement/index.html b/files/es/web/api/htmlformelement/index.html new file mode 100644 index 0000000000..4409f7e160 --- /dev/null +++ b/files/es/web/api/htmlformelement/index.html @@ -0,0 +1,109 @@ +--- +title: form +slug: Web/API/HTMLFormElement +tags: + - DOM + - Referencia_DOM_de_Gecko + - Todas_las_Categorías +translation_of: Web/API/HTMLFormElement +--- +
{{APIRef("HTML DOM")}}
+

Interfaz del elemento formulario de HTML

+ +

Los elementos FORM comparten todas las propiedades y métodos de los otros elementos HTML descritos en el capítulo del elemento. También tienen la interfaz especial HTMLFormElement.

+ +

Esta interfaz proporciona métodos para crear y modificar los elementos FORM usando el DOM. El siguiente ejemplo muestra como crear un nuevo formulario, como modificar sus atributos y enviarlo:

+ +
// Crea un formulario
+var f = document.createElement("form");
+
+// Lo añade en el cuerpo ('body') del documento
+document.body.appendChild(f);
+
+// Añade los atributos de acción y método
+f.action = "/cgi-bin/some.cgi";
+f.method = "POST"
+
+// Llama el método de enviar el formulario
+f.submit();
+
+ +

Además, el siguiente documento HTML muestra como se puede extraer información de un formulario y cambiar algunos de sus atributos.

+ +
<title>Ejemplo de formulario</title>
+<script type="text/javascript">
+  function getFormInfo() {
+    var info;
+
+    // Obtiene una referencia utilizando la colección de formularios
+    var f = document.forms["formularioA"];
+    info = "f.elements: " + f.elements + "\n"
+         + "f.length: " + f.length + "\n"
+         + "f.name: " + f.elements + "\n"
+         + "f.acceptCharset: " + f.acceptCharset + "\n"
+         + "f.action: " + f.action + "\n"
+         + "f.enctype: " + f.enctype + "\n"
+         + "f.encoding: " + f.encoding + "\n"
+         + "f.method: " + f.method + "\n"
+         + "f.target: " + f.target;
+    document.forms["formularioA"].elements['tex'].value = info;
+  }
+
+  // Se pasa la referencia al formulario desde el
+  // atributo al hacer clic ('onclick') del botón con la ayuda de este.formulario ('this.form')
+  function setFormInfo(f) {
+    f.method = "GET";
+    f.action = "/cgi-bin/evil_executable.cgi";
+    f.name   = "totally_new";
+  }
+</script>
+
+<h1>Ejemplo de formulario</h1>
+
+<form name="formularioA" id="formularioA"
+ action="/cgi-bin/test" method="POST">
+ <p>Haga clic en "Info" para ver informaciones de este formulario.
+    Haga clic en "Set" para cambiar los parámetros y otra vez en "Info" para ver los efectos</p>
+ <p>
+  <input type="button" value="Info"
+   onclick="getFormInfo();">
+  <input type="button" value="Set"
+   onclick="setFormInfo(this.form);">
+  <input type="reset" value="Reset">
+  <br>
+  <textarea id="tex" style="height:15em; width:20em">
+ </p>
+</form>
+
+ +

Propiedades

+ +
+
form.elements (todos los elementos del formulario) 
+
.elements devuelve una colección de todos los controles que hay en el formulario FORM.
+
form.length
+
.length devuelve la cantidad de controles que hay en el formulario
+
form.name
+
.name devuelve el nombre del formulario actual en forma de cadena.
+
form.acceptCharset
+
.acceptCharset devuelve una lista del conjunto de caracteres soportados para el actual elemento FORM.
+
form.action
+
.action obtiene/configura la acción del elemento FORM.
+
form.enctype
+
.enctype gets/sets the content type of the FORM element.
+
form.encoding
+
.encoding gets/sets the content type of the FORM element.
+
form.method
+
.method obtiene/configura el método HTTP utilizado para enviar el formulario.
+
form.target
+
.target obtiene/configura el objetivo de la acción (i.e., the frame to render its output in).
+
+ +

Métodos

+ +
+
form.submit
+
submit() manda el formulario.
+
form.reset
+
reset() restaura el formulario, lo devuelve al estado inicial.
+
diff --git a/files/es/web/api/htmlformelement/reset/index.html b/files/es/web/api/htmlformelement/reset/index.html new file mode 100644 index 0000000000..43f3df8e37 --- /dev/null +++ b/files/es/web/api/htmlformelement/reset/index.html @@ -0,0 +1,59 @@ +--- +title: HTMLFormElement.reset() +slug: Web/API/HTMLFormElement/reset +tags: + - API + - HTML DOM + - HTMLFormElement + - Method + - NeedsMarkupWork + - NeedsSpecTable + - Referencia +translation_of: Web/API/HTMLFormElement/reset +--- +
{{APIRef("HTML DOM")}}
+ +

El método HTMLFormElement.reset() restaura los elementos de un formulario a sus valores por defecto. Este método hace lo mismo que haciendo clic en el botón de restauración.

+ +

Si un control del formulario (como el botón de restaurar) tiene el nombre o un id de reset enmascarará el método de restauración del formulario. No restaura otros atributos del campo, como el de disabled.

+ +

Síntaxis

+ +
HTMLFormElement.reset()
+
+ +

Ejemplo

+ +
document.getElementById('myform').reset();
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + +
EspecificaciónEstadoComentario
{{SpecName('HTML WHATWG', '#dom-form-reset', 'HTMLFormElement: reset')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilidad con navegadores

+ + + +

{{Compat("api.HTMLFormElement.reset")}}

+ +

Vea también

+ + -- cgit v1.2.3-54-g00ecf