Elemento input (type=number)

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 "number" en su atributo type, representa un campo para la entrada de un número. En los navegadores modernos los campos numéricos son habitualmente representados por controles que permiten a los usuarios cambiar su valor de manera gráfica, 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 número. Las reglas para componer un número válido se describen a continuación.

Números

La sintaxis de un número está compuesta por:

  1. Opcionalmente un signo menos o carácter guión ("-").
  2. Uno o ambos de los siguientes, en el orden dado:
    1. Uno o más dígitos.
    2. Un carácter punto (".") seguido por uno o más dígitos.
  3. Opcionalmente:
    1. Una letra E (insensible a mayúsculas/minúsculas).
    2. Opcionalmente un signo menos o carácter guión ("-").
    3. Uno o más dígitos.

Ejemplo

468765
24.56
1.54e-31

El soporte provisto por los navegadores para campos numéricos es incompleto. 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 números válidas que el usuario tendrá permitido enviar.

Ejemplos

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

Nota que este control solo acepta números enteros. Esta conducta será cambiada en el segundo ejemplo mediante el atributo step.

<form action="../../form-result.php" method="post" target="_blank">
  <p>Tu edad: <input type="number" name="edad"> <input type="submit" value="Enviar datos"></p>
</form>

Tu edad:

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.

Para que este ejemplo trabaje correctamente, estableceremos el atributo step a 0.01. El atributo step será tratado en el siguiente ejemplo.

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

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Peso del compuesto: <input type="number" name="pesocompuesto" list="listapesos" step="0.001">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listapesos">
  <option value="0.58">
  <option value="16.5">
  <option value="148">
  <option value="26.469">
</datalist>

Peso del compuesto:

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 número mínimo, un número máximo, y la distancia entre un número seleccionable y el siguiente, respectivamente. Más específicamente, sólo permitiremos al usuario seleccionar un número entre 1 y 5 que puede tener opcionalmente un medio como parte decimal.

Cuando el atributo step está presente, los autores deberían especificar un número 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.

Nota que le valor por defecto para step es 1. Estando este atributo ausente, el usuario no podrá ingresar un número con decimales, ni seleccionar valores con decimales de un datalist.

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Limones usados para el jugo: <input type="number" name="limonesusados" min="1" max="5" step="0.5">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Limones usados para el jugo:

Atributos

Atributos específicos

autocomplete

El atributo autocomplete provee información acerca de si y cómo los navegadores deberían sugerir opciones automáticamente para este control, como un intento de adivinar lo que el usuario está escribiendo. Existen tres valores posibles para este atributo:

  • El valor on, indicando al navegador que debería sugerir opciones automáticamente pero sin proveer ninguna otra información acerca del tipo de datos que se espera en el control.
  • El valor off, indicando al navegador que no debería sugerir opciones automáticamente, ya sea debido a que la información a ser ingresada en el control es particularmente sensible (como el usuario para acceder a un área muy segura) o debido a que su valor nunca será reutilizado (como una clave de uso único en un proceso de registración).
  • Una lista de identificadores de detalles de autocompletado, indicando al navegador que debería sugerir opciones automáticamente y especificando el tipo de valor que se espera recibir.

Una lista de identificadores de detalles de autocompletado puede estar compuesta por los siguientes identificadores en el orden especificado.

  1. Opcionalmente, un identificador que comience con la cadena "section-" (insensible a mayúsculas/minúsculas), indicando el grupo al cual el campo pertenece.
  2. Opcionalmente, uno de los dos identificadores siguientes (insensibles a mayúsculas/minúsculas):
    • shipping: el campo es parte de la dirección de envío.
    • billing: el campo es parte de la dirección de facturación.
  3. Una de las dos opciones siguientes:
    • Cualquiera de los siguientes identificadores (insensibles a mayúsculas/minúsculas):
      • cc-month: el mes de expiración del instrumento de pago.
      • cc-year: el año de expiración del instrumento de pago.
      • transaction-amount: el monto de la transacción, como al ingresar un valor en una subasta.
      • bday-day: el día de una fecha de nacimiento.
      • bday-month: el mes de una fecha de nacimiento.
      • bday-year: el año de una fecha de nacimiento.
    • Opcionalmente, un identificador que coincide (insensible a mayúsculas/minúsculas) con alguno de los valores siguientes:
      • home: indicando que el campo es para contactar a alguien en su residencia.
      • work: indicando que el campo es para contactar a alguien en su lugar de trabajo.
      • mobile: indicando que el campo es para contactar a alguien en su dispositivo móvil.
      • fax: indicando que el campo describe datos de contacto de una máquina de fax.
      • pager: indicando que el campo describe datos de contacto de un pager ó beeper.

Usualmente, los navegadores llevan a cabo las operaciones de autocompletado recuperando datos de una base de datos con entradas previas u otras fuentes con información del usuaio.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Fecha de expiración de la tarjeta de crédito:
    <input type="number" name="mesexpiracion" autocomplete="billing cc-month">
    <input type="number" name="anoexpiracion" autocomplete="billing cc-year">
    <input type="submit" value="Establecer">
  </p>
</form>

Fecha de expiración de la tarjeta de crédito:

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>Autos adquiridos: <input type="number" name="autosadquiridos" 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>
    Niños invitados: <input type="number" name="ninosinvitados" disabled>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Niños invitados:

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>Dias de descanso: <input type="number" name="diasdescanso" form="formulario1"></p>
<form id="formulario1" action="../../form-result.php" method="post" target="_blank">
  <p><input type="submit" value="Enviar datos"></p>
</form>

Dias de descanso:

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 numéricas.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Huevo comprados: <input type="number" name="huevoscomprados" list="listahuevos">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listahuevos">
  <option value="6">
  <option value="12">
  <option value="24">
  <option value="48">
</datalist>

Huevo comprados:

max

El número 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 número superior a la especificada en este atributo.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas numéricas.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Clavos: <input type="number" name="clavos" max="100">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Clavos:

min

El número 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 número inferior a la especificada en este atributo.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas numéricas.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Tornillos necesarios: <input type="number" name="tornillosnecesarios" min="10">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Tornillos necesarios:

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>
    Producción mensual de botellas: <input type="number" name="produccionbotellas">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Producción mensual de botellas:

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>
    Niños: <input type="number" name="ninos" value="2" readonly>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Niños:

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>
    Estudiantes: <input type="number" name="estudiantes" required>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Estudiantes:

step

Un número 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 número 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.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas numéricas.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Distancia (en metros): <input type="number" name="distanciametros" step="0.01" min="0">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Distancia (en metros):

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="number" name="pedazos">

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 numéricas.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>Partes disponibles: <input type="number" name="partesdisponibles" value="25"></p>
  <p>
    <input type="submit" value="Enviar datos">
    <input type="reset" value="Restaurar formulario">
  <p>
</form>

Partes disponibles:

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.