form

Contexto de uso

Atributos

Como cualquier otro elemento HTML, este elemento soporta atributos globales

accept

Una lista separada por comas de los tipos de contenido que el servidor acepta.

Nota: Eeste atributo ha sido removido en HTML5 y no debe ser usado. En su lugar, usar el atributo accept del elemento especfico <input>.

accept-charset

Una lista de codificacin de caracteres que el servidor acepta. La lista puede ser delimitada por espacios o comas. El navegador los usa en el orden en que cada uno son listados. Los valores por defecto es la cadena reservada "UNKNOWN", en tal caso la codificacin corresponde a la codificacin del documento conteniendo el elemento form.

HTML 4: En versiones anteriores de HTML, las diferentes codificaciones de caracteres pueden ser delimitadas por espacios o comas. Este no es ms el caso en HTML5, donde slo los espacios son correctos.

action

La URI de un programa que procesa la informacin enviada por medio del formulario. Este valor puede ser sobreescrito por un atributo formaction en un <button> o en el elemento<input>.

autocomplete

Indica cuales de los controles en este formulario puede tener sus valores automticamente completados por el navegador. Esta configuracin puede ser sobreescrita por un atributo autocomplete en un elemento que pertenezca al formulario:

• off: El usuario debe ingresar explicitamente cada valor dentro de cada campo por cada uso, o el documento provee su propio mtodo de autocompletado; el navegador no autocompleta las entradas.
• on: El navegador puede completar automticamente valores basados en lo que el usuario ha ingresado durante entradas previas al formulario.

Nota: Si se establece autocomplete a un valor de off en un formulario porque el documento provee su propio auto-completado entonces tambin se debera establecer autocomplete al valor off para cada uno de los elementos de formulario input que el documento pueda autocompletar Notas para Google Chrome.

enctype

Cuando el valor del atributo method es post, este atributo es el tipo MIME del contenido que es usado para enviar el formulario al servidor. Los posibles valores son:

• application/x-www-form-urlencoded: El valor por defecto si un atributo no est especificado.
• multipart/form-data: Usar este valor si se est usando el elemento <input> con el atributo type ajustado a "file".
• text/plain (HTML5)

Este valor puede ser sobreescrito por un atributoformenctypeen un <button> o un elemento <input>.

method

El mtodo HTTP que el navegador usa para enviar el formulario. Valores posibles son:

• post: Corresponde al mtodo POST HTTP ; los datos del formulario son incluidos en el cuerpo del formulario y son enviados al servidor.
• get: Corresponde al mtodo GET HTTP; los datos del formulario son adjuntados a la URI del atributo action , con un '?' como separador, y la URI resultante es enviada al servidor. Use este mtodo cuando el formulario no tiene efectos secundarios y contiene solo caracteres ASCII.

Este valor puede ser sobreescrito por un atributo formmethod en un <button> o elemento <input>.

name

El nombre del formulario. En HTML4 ha quedado en desuso (debe usarse un id en su lugar). Debe ser nico entre los formularios en un documento y no una cadena vacia en HTML5.

novalidate

Este atributo booleano indica que el formulario no es validado cuando es enviado. Si el atributo no existe formnovalidate en un <button> o en un elemento <input> que pertenece al formulario.

target

Un nombre o keyword indicando donde mostrar la respuesta que es recibida despus de enviar el formulario. En HTML 4, este es el nombre de, o una palabra clave, para un marco. En HTML5, es un nombre de, o palabra clave para, un contexto de navegacin (por ejemplo, tab, window o marco en lnea). Las siguientes palabras clave tienen significados especiales:

• _self: Carga la respuesta dentro del mismo frame HTML 4 (o en HTML5, contexto de navegacin) como el marco actual. Este valor es por defecto si el atributo no es especificado.
• _blank: Carga la respuesta dentro de una nueva ventana sin nombre en HTML 4 o un contexto de navegacin en HTML5.
• _parent: Carga la respuesta en el marco padre del marco actual en HTML 4 o en el contexto de navegacin padre del marco actual en HTML5. Si no hay marco padre, esta opcin se comporta de la misma manera que _self.
• _top: HTML 4: Carga la respuesta en toda la ventana original, cancelando otros marcos. HTML5: Carga la respuesta en el contexto de navegacin de ms alto nivel (esto es, el contexto de navegacin que es ancestro del actual, y no tiene padre). Si no hay padre, esta opcin se comporta igual que _self.

HTML5: Este valor puede ser sobreescrito por un atributo formtarget en un elemento <button> o<input>.

Interfaz DOM

Este elemento implementa la interfaz HTMLFormElement.

Ejemplos

<!-- Formulario simple que enviar una peticin GET -->
<form action="">
  <label for="GET-name">Nombre:</label>
  <input id="GET-name" type="text" name="name" />
  <input type="submit" value="Save" />
</form>

<!-- Formulario simple que enviar una peticin POST -->
<form action="" method="post">
  <label for="POST-name">Nombre:</label>
  <input id="POST-name" type="text" name="name" />
  <input type="submit" value="Save" />
</form>

<!-- Formulario con conjunto de campos, leyenda y etiqueta -->
<form action="" method="post">
  <fieldset>
    <legend>Ttulo</legend>
    <input type="radio" name="radio" id="radio" />
    <label for="radio">Clic aqu</label>
  </fieldset>
</form>

Especificaciones

Compatibilidad con navegadores

Consulte tambin

Otros elementos que son usados para crear formularios: <button>, <datalist>, <fieldset>, <input>, <label>, <legend>, <meter>, <optgroup>, <option>, <output>, <progress>, <select>, <textarea>.