Elemento input (type=month)

Si no sabes lo que es un elemento o cómo debes usarlo, te recomiendo leer el tutorial "Tags y atributos en HTML" que puedes encontrar en la sección de tutoriales HTML.

Descripción

El elemento input, teniendo el valor "month" en su atribtuo type, representa un campo para la entrada de un mes. En los navegadores que soportan el mecanismo, estos campos pueden estar representados por controles que permiten a los usuarios cambiar su valor de manera gráfica (como, por ejemplo, un calendario), en lugar de tener que ingresarlo directamente como una cadena.

Previo al envío del formulario, los navegadores que soportan este mecanismo convierten la información ingresada a una cadena que representa un mes. Las reglas para componer un mes válido se describen a continuación.

Meses

La sintaxis de un mes está compuesta por:

  1. Un año mayor que cero, compuesto por, al menos, cuatro dígitos.
  2. Un signo menos o guión ("-").
  3. Un mes entre 1 y 12, compuesto de dos dígitos.

Ejemplo

<time>2014-07</time>
<time>0512-12</time>

El soporte provisto por los navegadores para campos de mes es muy bajo. Para mejorar la compatibilidad, los autores pueden tener que recurrir a programas con el fin de proveer controles avanzados y validar los datos antes del envío.

Los atributos min y max pueden ser usados en este elemento para establecer un rango de meses válidos que el usuario tendrá permitido enviar.

Ejemplos

En el primer ejemplo crearemos solamente un formulario con un control de mes. Aquí podrás notar la funcionalidad provista por tu navegador (si la tiene) para el control.

<form action="../../form-result.php" target="_blank">
  <p>Mes de nacimiento: <input type="month" name="mesnacimiento"> <input type="submit" value="Enviar datos"></p>
</form>

Mes de nacimiento:

En nuestro segundo ejemplo proveeremos una lista de valores sugeridos mediante el elemento datalist, para que el usuario pueda seleccionar rápidamente uno de los valores predefinidos cuando el navegador los sugiera. El control estará enlazado al datalist debido a la coincidencia entre el atributo id de la lista y el atributo list del control.

El soporte provisto por los navegadores para datalist es incompleto. Los autores pueden tener que recurrir a programas para proveer esta funcionalidad consistentemente.

Los valores provistos por el elemento datalist deben acatar los requerimientos de las cadenas de mes.

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Elije un mes para tus vacaciones: <input type="month" name="mesvacaciones" list="listamesesvacaciones">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listamesesvacaciones">
  <option value="2015-07">
  <option value="2015-12">
  <option value="2016-01">
  <option value="2016-02">
</datalist>

Elije un mes para tus vacaciones:

En nuestro último ejemplo trabajaremos con los atributos min, max y step para poner restricciones a los valores que el usuario puede ingresar. Con esta configuración estableceremos un mes mínimo, un mes máximo, y la distancia entre un mes seleccionable y el siguiente, respectivamente. Más específicamente, sólo permitiremos al usuario seleccionar cualquier mes par entre el 06/2015 y el 10/2016.

Cuando el atributo step está presente, los autores deberían especificar un mes para ser tomado como paso inicial. Esto puede hacerse mediante los atributos min y value. Cuando ambos están presentes, el atributo min tiene precedencia.

Los valores provistos en los atributos min, max y step deben acatar los requerimientos de las cadenas de mes.

<form action="../../form-result.php" target="_blank">
  <p>
    Selecciona un mes: <input type="month" name="messeleccionado" min="2015-06" max="2016-10" step="2">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Selecciona un mes:

Atributos

Atributos específicos

autofocus

Un valor booleano que instruye al navegador a establecer el enfoque sobre este control cuando el documento termina de cargarse o cuando el cuadro de diálogo (dialog) donde el control se encuentra es mostrado. Si el atributo tiene el valor "autofocus" o la cadena vacía (""), o si simplemente está presente, el control debería obtener el enfoque tan pronto como sea posible, luego de que la página o cuadro de diálogo hayan sido cargados.

Ejemplo

<p>Unirse a la clase en: <input type="month" name="mesunirse" autofocus></p>

disabled

Un valor booleano que indica si el control se encuentra deshabilitado o no. Si el atributo toma el valor "disabled" o la cadena vacía (""), o si está simplemente presente, el control estará deshabilitado.

Los controles deshabilitados son representados en color gris (si son visibles), son impedidos para interactuar con el usuario y, lo más importante, sus valores (si lo tienen) no son enviados cuando el formulario es despachado.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Comenzar el primer día de: <input type="month" name="mescomienzo" disabled>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Comenzar el primer día de:

form

El valor del atributo id del formulario con el que este control está asociado.

Este atributo es nuevo en HTML5 y ayuda a definir la pertenencia de los controles en formularios anidados o distantes.

Ejemplo

<p>Partida: <input type="month" name="mespartida" form="formulario1"></p>
<form id="formulario1" action="../../form-result.php" method="post" target="_blank">
  <p><input type="submit" value="Enviar datos"></p>
</form>

Partida:

list

Un identificador que concuerda con el valor del atributo id del elemento datalist con el que este control está asociado. El datalist referenciado por este atributoproveerá un número de sugerencias que los usuarios pueden escoger para autocompletar el control.

El soporte provisto por los navegadores para datalist es incompleto. Los autores pueden tener que recurrir a programas para proveer esta funcionalidad consistentemente.

Los valores provistos por el elemento datalist deben acatar los requerimientos de las cadenas de mes.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    La aventura comienza: <input type="month" name="mesaventura" list="listamesesaventura">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listamesesaventura">
  <option value="2015-07">
  <option value="2015-12">
  <option value="2016-01">
  <option value="2016-02">
</datalist>

La aventura comienza:

max

El mes máximo que el usuario debería estar habilitado para seleccionar. Los navegadores que soporten el mecanismo deberían impedir la selección de cualquier mes superior a la especificada en este atributo.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas de mes.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Detener advertencias hasta: <input type="month" name="detenerhasta" max="2016-01">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Detener advertencias hasta:

min

El mes mínimo que el usuario debería estar habilitado para seleccionar. Los navegadores que soporten el mecanismo deberían impedir la selección de cualquier mes inferior a la especificada en este atributo.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas de mes.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Enviar mensajes desde: <input type="month" name="enviardesde" min="2016-02">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Enviar mensajes desde:

name

Un nombre para el control. Este nombre será enviado por el navegador al agente procesador, emparejado con el contenido del atributo value. Ambos atributos juntos conformarán un par nombre-valor que será utilizado para procesar la información del formulario.

Actualmente, el valor isindex, antiguamente utilizado de manera especial por algunos navegadores e incluido en el estándar HTML, no está permitido en este atributo.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Mes de graduación: <input type="month" name="mesgraduacion">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Mes de graduación:

readonly

Un valor booleano que instruye al navegador a impedir que el usuario cambie el valor del control. Si este atributo tiene el valor "readonly" o la cadena vacía (""), o si simplemente está presente, el usuario no tendrá premitido hacer cambios al valor en el control.

Aunque este atributo previene que el valor del control sea editado, no toda interacción es bloqueada: los usuario aún podrán seleccionar y copiar el texto en el control.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Suscripto desde: <input type="month" name="messuscripcion" value="2003-05" readonly>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Suscripto desde:

required

Un valor booleano que indica si este control puede ser dejado en blanco o no. Si este atributo tiene el valor "required" o la cadena vacía (""), o si está siplemente presente, el usuario tendrá que rellenar el control a fin de poder enviar el formulario.

Si un control con el atributo required presente es dejado en blanco, los navegadores que soporten este mecanismo arrojarán un error previo al envío y cancelarán el proceso inmediatamente.

El soporte provisto por los navegadores para el atributo required es incompleto. Los autores pueden tener que recurrir a programas para proveer esta funcionalidad consistentemente.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Miembro desde: <input type="month" name="miembro desde" required>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Miembro desde:

step

Un número de días para ser usado como la cantidad de espacio entre un valor permitido y el siguiente. La presencia de este atributo reduce el número de opciones que tendrá el usuario al restringir la selección de valores intermedios.

El valor especial any quita la restricción por defecto sobre la granularidad del control y permite a los usuarios ingresar valores tan precisos como deseen.

Para evitar comportamientos inesperados, los autores deberían especificar un mes para ser tomado como paso inicial. Esto puede hacerse mediante los atributos min y value. Cuando ambos están presentes, el atribtuo min tiene precedencia.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Últimas vacaciones: <input type="month" name="ultimasvacaciones" step="6" min="2000-01">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Últimas vacaciones:

type

Un valor que indica el tipo de campo que representa este elemento. Existen veintidós valores posibles (insensibles a mayúsculas/minúsculas):

  • hidden: un control oculto utilizado para enviar información al servidor, típicamente manejado por programas.
  • text: un control usado para la entrada de una sola línea de texto.
  • search: igaul a text pero con fines de búsqueda.
  • tel: un control usado para proveer un número de teléfono.
  • url: una caja de texto usada para el ingreso de un único URL absoluto.
  • email: un control diseñado para editar una o más direcciones de e-mail.
  • password: una caja de texto para la edición de contraseñas, donde los caracteres son representados por puntos.
  • date: un control para ingresar una fecha específica.
  • month: un control para ingresar un mes específico.
  • week: un control para ingresar una semana específica.
  • time: un control para ingresar una hora específica.
  • datetime-local: un control para ingresar una fecha y hora local específica.
  • number: un control para ingresar un número.
  • range: un control para ingresar uno o dos números dentro de un rango.
  • color: un control para ingresar un color.
  • checkbox: un control para ingresar un valor booleano (verdadero/falso).
  • radio: un control para elegir una única opción entre varias.
  • file: un control usado para subir archivos al servidor.
  • submit: un botón usado para enviar el formulario.
  • image: igual a submit pero con la habilidad de verse como una imagen en lugar de usar la apariencia predeterminada de los botones.
  • reset: un botón usado para reiniciar los controles del formulario a sus valores iniciales.
  • button: un botón sin una acción predeterminada asociada.

Cuando este atributo está ausente, el elemento se comporta como si tuviera el valor "text".

Ejemplo

<input type="month" name="comienzaen">

value

Un valor inicial para el control, que será establecido cuando la página se cargue y cuando el botón de reinicio sea presionado.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas de mes.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>Enviarme alertas en: <input type="month" name="alertas" value="2016-02"></p>
  <p>
    <input type="submit" value="Enviar datos">
    <input type="reset" value="Restaurar formulario">
  </p>
</form>

Enviarme alertas en:

Atributos globales

Para más información acerca de los atributos globales refiérete a esta lista de atributos gloables en HTML5.

Eventos

Eventos globales

Para más información acerca de los eventos globales refiérete a esta lista de eventos globales en HTML5.