Elemento input (type=week)

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 "week" en su atributo type, representa un campo para la entrada de una semana. 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 una semana. Las reglas para componer una semana válida se describen a continuación.

Semanas

La syntaxis de una semana está compuesta por:

  1. Un año-semana (apenas diferente a los años regulares, delimitado por los límites de las semanas) mayor a cero, compuesto por, al menos, cuatro dígitos.
  2. Un signo menos o guión ("-").
  3. Una letra W mayúscula.
  4. Dos dígitos representando el número de semana, entre 1 y el número máximo de semanas presente en este año particular, siendo bien 52 o 53.

Una semana en este modelo es considerada como el período de siete días que comienza un Lunes. La primera semana de un año es la que tiene el primer Jueves.

Ejemplo

<time>1986-W03</time>
<time>2014-W52</time>

El soporte provisto por los navegadores para campos de semana 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 semanas válidas que el usuario tendrá permitido enviar.

Ejemplos

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

<form action="../../form-result.php" target="_blank">
  <p>Selecciona una semana: <input type="week" name="unasemana"> <input type="submit" value="Enviar datos"></p>
</form>

Selecciona una semana:

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 semana.

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Elige una semana para tus vacaciones: <input type="week" name="semanavacaciones" list="listasemanasvacaciones">
    <input type="submit" value="Enviar valores">
  </p>
</form>
<datalist id="listasemanasvacaciones">
  <option value="2015-W53">
  <option value="2015-W01">
  <option value="2016-W02">
  <option value="2016-W03">
  <option value="2016-W04">
</datalist>

Elige una semana 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 una semana mínima, una semana máxima, y la distancia entre una semana seleccionable y la siguiente, respectivamente. Más específicamente, sólo permitiremos al usuario seleccionar cualquier semana par entre 2015-W06 y 2015-W24.

Cuando el atributo step está presente, los autores deberían especificar una semana para ser tomada 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 semana.

<form action="../../form-result.php" target="_blank">
  <p>
    Selecciona una semana: <input type="week" name="semanaelegida" min="2015-W06" max="2015-W24" step="2">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Selecciona una semana:

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="week" name="semanaunirse" 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 en: <input type="week" name="semanacomenzar" disabled>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Comenzar en:

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="week" name="semanapartida" 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 semana.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    La aventura comienza en: <input type="week" name="semanaaventura" list="listasemanasaventura">
    <input type="submit" value="Enviar valores">
  </p>
</form>
<datalist id="listasemanasaventura">
  <option value="2015-W30">
  <option value="2015-W31">
  <option value="2016-W01">
  <option value="2016-W02">
</datalist>

La aventura comienza en:

max

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

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

Ejemplo

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

Detener advertencias hasta:

min

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

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

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Enviar mensajes desde: <input type="week" name="enviardesde" min="2016-W02">
    <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>
    Semana de la fiesta de graduación: <input type="week" name="semanafiestagraduacion">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Semana de la fiesta 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="week" name="semanasuscripcion" value="2003-W05" 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="week" name="miembrodesde" 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 una semana para ser tomada 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="week" name="ultimasvacaciones" step="4" min="2000-W01">
    <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="week" 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 semana.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>Enviarme alertas en: <input type="week" name="alertas" value="2016-W02"></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.