Ejemplos y pautas de uso para estilos de control de formularios, opciones
de diseño y componentes personalizados para crear una amplia variedad de formularios.
Visión general
Los controles de formulario de Bootstrap se expanden en
nuestros estilos de formulario reiniciados
con clases.
Utilice estas clases para optar por sus pantallas personalizadas para una
representación más consistente en todos los navegadores y dispositivos.
Asegúrese de utilizar un
type
atributo apropiado en todas las entradas (por ejemplo,
email
para la dirección de correo electrónico o
number
para información numérica) para aprovechar los controles de entrada más
nuevos, como la verificación de correo electrónico, la selección de números y más.
Aquí hay un ejemplo rápido para demostrar los estilos de formulario de Bootstrap.
Siga leyendo para obtener documentación sobre las clases requeridas, el diseño de formularios y más.
Controles de formulario
Los controles de forma textual, como
<input>
s,
<select>
s y
<textarea>
s, se diseñan con la
.form-control
clase. Se incluyen estilos para apariencia general, estado de enfoque, tamaño y más.
Para las entradas de archivo, cambie
.form-control
por
.form-control-file.
Dimensionamiento
Establece alturas usando clases como
.form-control-lgy
.form-control-sm.
Solo lectura
Agregue el
readonly
atributo booleano en una entrada para evitar la modificación del valor de la entrada.
Las entradas de solo lectura aparecen más claras (al igual que las entradas
desactivadas), pero retienen el cursor estándar.
Texto sin formato de solo lectura
Si desea que los
<input readonly>
elementos de su formulario tengan un estilo de texto sin formato, use la
.form-control-plaintext
clase para eliminar el estilo predeterminado del campo del formulario y conservar el margen y el relleno correctos.
Entradas de rango
Configure entradas de rango desplazables horizontalmente usando
.form-control-range.
Casillas de verificación y radios
Casillas de verificación por defecto y radios están mejorados con la ayuda de
.form-check,
una sola clase para los dos tipos de entrada que mejora la distribución y el comportamiento de sus elementos HTML
. Las casillas de verificación son para seleccionar una o varias opciones en
una lista, mientras que las radios son para seleccionar una opción entre muchas.
Se admiten casillas de verificación y radios deshabilitadas. El
disabled
atributo aplicará un color más claro para ayudar a indicar el estado de la entrada.
Las casillas de verificación y los botones de opción admiten la validación de formularios basada en HTML y proporcionan etiquetas concisas y accesibles. Como tal, nuestros
<input> y
<label>
son elementos hermanos en lugar de un
<input>
dentro de a
<label>
. Esto es un poco más detallado, ya que debe especificar
id
y
for
atributos para relacionar
<input>
y
<label>.
Predeterminado (apilado)
De forma predeterminada, cualquier número de casillas de verificación y radios que sean hermanos inmediatos se apilarán verticalmente y se espaciarán adecuadamente
.form-check.
En línea
Agrupe casillas de verificación o radios en la misma fila horizontal agregando
.form-check-inline
a cualquiera
.form-check.
Sin etiquetas
Agregue
.position-static
a las entradas
.form-check
que no tienen texto de etiqueta.
Recuerde seguir proporcionando alguna forma de nombre accesible para las tecnologías de asistencia (por ejemplo, uso
aria-label
).
Diseño
Desde Bootstrap se aplica
display: block
y
width: 100%
que casi todos nuestros controles de formulario, formularios por defecto pila vertical.
Se pueden usar clases adicionales para variar este diseño en función de cada formulario.
Formar grupos
La
.form-group
clase es la forma más fácil de agregar algo de estructura a los formularios.
Proporciona una clase flexible que fomenta la agrupación adecuada de etiquetas, controles, texto de ayuda opcional y mensajes de validación de formularios.
De forma predeterminada, solo se aplica
margin-bottom
, pero selecciona estilos adicionales
.form-inline
según sea necesario. Úselo con
<fieldset>
s,
<div>
s o casi cualquier otro elemento.
Cuadrícula de formulario
Se pueden construir formas más complejas usando nuestras clases de cuadrícula.
Úselos para diseños de formularios que requieren varias columnas, anchos variados y opciones de alineación adicionales.
Fila de formulario
También puede cambiar
.row
por
.form-row
una variación de nuestra fila de cuadrícula estándar que anula las canaletas de columna predeterminadas para diseños más ajustados y compactos.
También se pueden crear diseños más complejos con el sistema de cuadrícula.
Forma horizontal
Cree formas horizontales con la cuadrícula agregando la
.row
clase para formar grupos y usando las
.col-*-*
clases para especificar el ancho de sus etiquetas y controles. Asegúrese de agregar también
.col-form-labela sus
<label>
mensajes de correo electrónico para que estén centrados verticalmente con sus controles de formulario asociados.
A veces, es posible que necesite utilizar utilidades de margen o relleno para crear la alineación perfecta que necesita.
Por ejemplo, hemos eliminado la
padding-top
etiqueta de entradas de radio apiladas para alinear mejor la línea de base del texto.
Tamaño de etiqueta de forma horizontal
Asegúrese de usar
.col-form-label-sm
o
.col-form-label-lg
para sus
<label>o
<legend>
para seguir correctamente el tamaño de
.form-control-lgy
.form-control-sm.
Dimensionamiento de columna
Como se muestra en los ejemplos anteriores, nuestro sistema de cuadrícula le permite colocar cualquier número de
.col dentro de un
.row o
.form-row
. Dividirán el ancho disponible equitativamente entre ellos.
También puede elegir un subconjunto de sus columnas para ocupar más o menos espacio, mientras que los restantes
.col
dividen por igual el resto, con clases de columna específicas como
.col-7.
Tamaño automático
El siguiente ejemplo usa una utilidad flexbox para centrar verticalmente electrónico contenido y cambia
.cola
.col-auto
para que sus columnas solo ocupen el espacio necesario. Dicho de otra manera, el tamaño de la columna se basa en el contenido.
A continuación, puede volver a mezclarlo con clases de columna de tamaño específico.
Use la
.form-inline
clase para mostrar una serie de etiquetas, controles de formulario y botones en una sola fila horizontal.
Los controles de formulario dentro de los formularios en línea varían ligeramente de sus estados predeterminados.
Los controles
display: flex
contraen cualquier espacio en blanco HTML y le permiten proporcionar control de alineación con utilidades de
espaciadoy
caja flexible.
Los controles y los grupos de entrada reciben
width: auto
para anular el valor predeterminado de Bootstrap
width: 100%.
Los controles
solo aparecen en línea en las ventanas que tienen al menos 576 px de ancho
para tener en cuenta las ventanas estrechas en los dispositivos móviles.
Es posible que deba abordar manualmente el ancho y la alineación de los controles de formulario individuales con
utilidades de espaciado
(como se muestra a continuación).
Por último, asegúrese de incluir siempre un
<label>
con cada control de formulario, incluso si necesita ocultarlo a los
visitantes que no son lectores de pantalla con
.sr-only.
También se admiten controles y selecciones de formularios personalizados.
Alternativas a las etiquetas ocultas
Las tecnologías de asistencia, como los lectores de pantalla, tendrán
problemas con sus formularios si no incluye una etiqueta para cada entrada.
Para estos formularios en línea, puede ocultar las etiquetas usando la
.sr-only
clase. Existen otros métodos alternativos para proporcionar una etiqueta para
las tecnologías de asistencia, como el atributo
aria-label,
aria-labelledbyo
title.
Si ninguno de estos está presente, las tecnologías de asistencia pueden recurrir al uso del
placeholder
atributo, si está presente, pero tenga en cuenta que
placeholder
no se recomienda su uso como reemplazo de otros métodos de etiquetado.
Texto de ayuda
El texto de ayuda a nivel de bloque en formularios se puede crear usando
.form-text
(anteriormente conocido como
.help-block
en v3). El texto de ayuda en línea se puede implementar de manera flexible utilizando cualquier elemento HTML en línea y clases de utilidad como
.text-muted.
Asociación de texto de ayuda con controles de formulario
El texto de ayuda debe asociarse explícitamente con el control de formulario relacionado con el uso del
aria-describedby
atributo. Esto garantizará que las tecnologías de asistencia, como los lectores de
pantalla, anuncien este texto de ayuda cuando el usuario se enfoque o ingrese al control.
Se puede modificar el estilo del texto de ayuda debajo de las entradas
.form-text
. Esta clase incluye
display: block
y agrega un margen superior para facilitar el espaciado de las entradas anteriores.
Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
De texto en línea puede utilizar cualquier elemento típico HTML en línea (ya sea una
<small>,
<span>
o cualquier otra cosa) con nada más que una clase de utilidad.
Formas inhabilitadas
Agregue el
disabled
atributo booleano en una entrada para evitar interacciones del usuario y hacer que parezca más claro.
Agregue el
disabled
atributo a
<fieldset>
para deshabilitar todos los controles dentro.
Advertencia con anclas
Los navegadores tratan todos los controles de formulario nativos (
<input>,
<select>y
<button>
elementos) dentro de a
<fieldset disabled>
como deshabilitados, lo que evita las interacciones del teclado y el mouse en ellos.
Sin embargo, si su formulario también incluye elementos personalizados similares a botones como
<a ... class="btn btn-*">
, a estos solo se les dará un estilo de
pointer-events: none
. Como se indica en la sección sobre el
estado deshabilitado de los botones
(y específicamente en la subsección para los elementos de anclaje), esta
propiedad CSS aún no está estandarizada y no es totalmente compatible con Internet Explorer 10. Los controles
basados en anclajes también seguirán siendo enfocable y operable usando el teclado.
Debe modificar manualmente estos controles agregando
tabindex="-1"
para evitar que reciban el foco y
aria-disabled="disabled"
señalar su estado a las tecnologías de asistencia.
Compatibilidad entre navegadores
Aunque Bootstrap aplicará estos estilos en todos los navegadores, Internet Explorer 11 y versiones anteriores no son totalmente compatibles con el
disabled
atributo en un
<fieldset>
. Utilice JavaScript personalizado para deshabilitar el conjunto de campos en estos navegadores.
Validación
Proporcione comentarios valiosos y prácticos a sus usuarios con la validación de formularios HTML5,
disponible en todos nuestros navegadores compatibles
. Elija entre los comentarios de validación predeterminados del navegador o
implemente mensajes personalizados con nuestras clases integradas y JavaScript de inicio.
Somos conscientes de que actualmente los estilos de validación
personalizados del lado del cliente y la información sobre herramientas no son accesibles, ya que no están
expuestos a tecnologías de asistencia.
Mientras trabajamos en una solución, recomendamos usar la opción del lado
del servidor o el método de validación del navegador predeterminado.
Validación del grupo de entrada
Desafortunadamente, los grupos de entrada tienen dificultades con los
estilos de validación.
Nuestra recomendación es colocar los mensajes de retroalimentación como
elementos hermanos del
.input-group
que tiene
.is-{valid|invalid}
. Colocar mensajes de retroalimentación dentro de los grupos de entrada rompe el
border-radius.
Vea esta solución alternativa
.
Cómo funciona
Así es como funciona la validación de formularios con Bootstrap:
La validación de formularios HTML se aplica a través de las dos pseudoclases de CSS
:invalidy
:valid
. Se aplica a
<input>,
<select>y
<textarea>
elementos.
Bootstrap aplica los estilos
:invalidy
:valid
a la
.was-validated
clase principal , generalmente se aplica a
<form>
. De lo contrario, cualquier campo obligatorio sin un valor aparece como no
válido al cargar la página.
De esta forma, puede elegir cuándo activarlos (normalmente después de intentar enviar el formulario).
Para restablecer la apariencia del formulario (por ejemplo, en el caso de envíos de formularios dinámicos usando AJAX), elimine la
.was-validated
clase de la parte
<form>
posterior después del envío.
Como respaldo, se pueden usar clases
.is-invalid
y en
.is-valid
lugar de las pseudoclases para la
validación del lado del servidor
. No requieren una
.was-validated
clase para padres.
Debido a las limitaciones en el funcionamiento de CSS, no podemos (en la actualidad) aplicar estilos a un
<label>
control de formulario en el DOM sin la ayuda de JavaScript personalizado.
Todos los navegadores modernos admiten la
API de validación de restricciones
, una serie de métodos JavaScript para validar controles de formulario.
Los mensajes de comentarios pueden utilizar los
valores predeterminados
del
navegador
(diferentes para cada navegador, y no se pueden estilizar mediante CSS) o nuestros estilos de comentarios personalizados con HTML y CSS adicionales.
Puede proporcionar mensajes de validez personalizados
setCustomValidity
en JavaScript.
Con eso en mente, considere las siguientes demostraciones para nuestros
estilos de validación de formularios personalizados, clases opcionales del lado del servidor y valores predeterminados del navegador.
Estilos personalizados
Para los mensajes personalizados de validación de formularios Bootstrap, deberá agregar el
novalidate
atributo booleano a su
<form>
. Esto deshabilita la información sobre herramientas de comentarios predeterminada del navegador, pero aún proporciona acceso a las API de validación de formularios en JavaScript.
Intente enviar el formulario a continuación; nuestro JavaScript interceptará el botón de envío y le enviará comentarios.
Al intentar enviar, verá los estilos
:invalid
y
:valid
aplicados a sus controles de formulario.
Los estilos de comentarios personalizados aplican colores, bordes, estilos de enfoque e iconos de fondo personalizados para comunicar mejor los comentarios.
Los iconos de fondo para mensajes de correo electrónico
<select>
solo están disponibles con
.custom-select
, y no
.form-control.
Valores predeterminados del navegador
¿No le interesan los mensajes de retroalimentación de validación personalizados o escribir JavaScript para cambiar el comportamiento de los formularios?
Todo bien, puede usar los valores predeterminados del navegador.
Intente enviar el formulario a continuación. Dependiendo de su navegador y sistema operativo, verá un estilo de comentarios ligeramente diferente.
Si bien estos estilos de comentarios no se pueden diseñar con CSS, aún puede personalizar el texto de comentarios a través de JavaScript.
Lado del servidor
Recomendamos utilizar la validación del lado del cliente, pero en caso de
que necesite una validación del lado del servidor, puede indicar campos de formulario no válidos y no válidos con
.is-invalidy
.is-valid
. Tenga en cuenta que
.invalid-feedback
también es compatible con estas clases.
Para los campos no válidos, asegúrese de que el mensaje de error / comentario no válido esté asociado con el campo de formulario correspondiente utilizando
aria-describedby
. Este atributo permite que
id
se haga referencia a más de uno , en caso de que el campo ya apunte a texto de formulario adicional.
Elementos compatibles
Los estilos de validación están disponibles para los siguientes controles y componentes de formulario:
<input> y
<textarea> con
.form-control
<select> con
.form-control o
.custom-select
.form-check
.custom-checkboxy
.custom-radio
.custom-file
Información sobre herramientas
Si el diseño de su formulario lo permite, puede cambiar las
.{valid|invalid}-feedback
clases por
.{valid|invalid}-tooltip
clases para mostrar comentarios de validación en una descripción emergente con estilo.
Asegúrese de tener un padre con
position: relative
él para el posicionamiento de la información sobre herramientas.
En el siguiente ejemplo, nuestras clases de columna ya tienen esto, pero su proyecto puede requerir una configuración alternativa.
Personalización
Los estados de validación se pueden personalizar a través de Sass con el
$form-validation-states
mapa. Ubicado en nuestro
_variables.scss
archivo, este mapa Sass se repite para generar los estados predeterminados
valid
/ de
invalid
validación. Se incluye un mapa anidado para personalizar el color y el icono de cada estado.
Si bien los navegadores no admiten otros estados, aquellos que usan estilos personalizados pueden agregar fácilmente comentarios de formularios más complejos.
Tenga en cuenta que no recomendamos personalizar estos valores sin modificar también la
form-validation-state
mezcla.
Solución alternativa de validación del grupo de entrada
No podemos resolver la ruptura
border-radius
de los grupos de entrada con validación debido a las limitaciones del selector, por lo que se requieren anulaciones manuales.
Cuando esté utilizando un grupo de entrada estándar y no personalice los
valores predeterminados del radio del borde, agréguelo
.rounded-right
a los elementos con el roto
border-radius.
@
Please choose a username.
Cuando utilice un grupo de entrada pequeño o grande o personalice los
border-radius
valores predeterminados , agregue CSS personalizado al elemento con el archivo
border-radius.
@
Please choose a username.
Formularios personalizados
Para una mayor personalización y coherencia entre navegadores, utilice
nuestros elementos de formulario completamente personalizados para reemplazar los valores predeterminados del navegador.
Están construidos sobre el marcado semántico y accesible, por lo que son reemplazos sólidos para cualquier control de formulario predeterminado.
Casillas de verificación y radios
Cada casilla de verificación y radio
<input>y
<label>
emparejamiento están envueltos en un
<div>
para crear nuestro control personalizado. Estructuralmente, este es el mismo enfoque que nuestro predeterminado
.form-check.
Usamos el selector de hermanos (
~
) para todos nuestros
<input>
estados, como
:checked
para diseñar correctamente nuestro indicador de formulario personalizado.
Cuando se combina con la
.custom-control-label
clase, también podemos diseñar el texto de cada elemento en función del
<input>
estado de.
Ocultamos el valor predeterminado
<input>
con
opacity
y usamos
.custom-control-label
para construir un nuevo indicador de formulario personalizado en su lugar con
::beforey
::after
. Desafortunadamente, no podemos construir uno personalizado solo
<input>
porque los CSS
content
no funcionan en ese elemento.
En los estados marcados, usamos
iconos SVG incrustados en base64
de
Open Iconic
. Esto nos proporciona el mejor control para diseñar y posicionar entre navegadores y dispositivos.
Casillas de verificación
Las casillas de verificación personalizadas también pueden utilizar la
:indeterminate
pseudoclase cuando se configuran manualmente a través de JavaScript (no hay ningún atributo HTML disponible para especificarlo).
Si está utilizando jQuery, algo como esto debería ser suficiente:
Radios
En línea
Discapacitado
Las casillas de verificación personalizadas y las radios también se pueden desactivar. Agregue el
disabled
atributo booleano al
<input>
indicador personalizado y la descripción de la etiqueta se aplicará automáticamente.
Switches
Un interruptor tiene el marcado de una casilla de verificación personalizada, pero usa la
.custom-switch
clase para representar un interruptor de palanca. Los conmutadores también admiten el
disabled
atributo.
Seleccione el menú
Los
<select>
menús personalizados solo necesitan una clase personalizada
.custom-select
para activar los estilos personalizados. Los estilos personalizados se limitan a la
<select>
apariencia inicial de y no pueden modificar los
<option>
debido a las limitaciones del navegador.
También puede elegir entre selecciones personalizadas pequeñas y grandes para que coincidan con nuestras entradas de texto de tamaño similar.
El
multiple
atributo también es compatible:
Como es el
size
atributo:
Rango
Crea
<input type="range">
controles personalizados con
.custom-range
. La pista (el fondo) y el pulgar (el valor) tienen ambos estilos para que
parezcan iguales en todos los navegadores.
Como solo IE y Firefox admiten "completar" su pista desde la izquierda o la
derecha del pulgar como un medio para indicar visualmente el progreso, actualmente no lo admitimos.
Las entradas de rango tienen valores implícitos para
miny
max-
0y
100
, respectivamente. Puede especificar nuevos valores para aquellos que usan los atributos
miny
max.
De forma predeterminada, las entradas de rango se “ajustan” a valores enteros.
Para cambiar esto, puede especificar un
step
valor. En el siguiente ejemplo, duplicamos el número de pasos usando
step="0.5".
Explorador de archivos
El complemento recomendado para animar la entrada de archivos
personalizados:
bs-custom-file-input
, eso es lo que estamos usando actualmente aquí en nuestros documentos.
La entrada del archivo es la más retorcida del grupo y requiere JavaScript adicional si desea conectarlos con el
archivo
funcional
Choose file ...
y el texto del nombre del archivo seleccionado.
Ocultamos el archivo predeterminado
<input>
mediante
opacity
y, en su lugar, le aplicamos estilo
<label>
. El botón se genera y se posiciona con
::after
. Por último, se declara una
width
y
height
en el
<input>
espacio apropiado para rodear de contenido.
Traducir o personalizar las cadenas con SCSS
La
:lang()
pseudoclase
se utiliza para permitir la traducción del texto "Examinar" a otros idiomas.
Anule o agregue entradas a la
$custom-file-text
variable Sass con la
etiqueta de idioma
relevante y cadenas localizadas. Las cadenas en inglés se pueden personalizar de la misma manera.
Por ejemplo, así es como se puede agregar una traducción al español (el código de idioma español es
es):
Aquí está
lang(es)
en acción sobre la entrada del archivo personalizado para una traducción al español:
Deberá configurar el idioma de su documento (o subárbol del mismo) correctamente para que se muestre el texto correcto.
Esto se puede hacer usando
el
lang
atributo
en el
<html>
elemento o el
Content-Language
encabezado HTTP
, entre otros métodos.
Traducir o personalizar las cadenas con HTML
Bootstrap también proporciona una forma de traducir el texto "Examinar" en HTML con el
data-browse
atributo que se puede agregar a la etiqueta de entrada personalizada (ejemplo en holandés):
Input estilizado o customizado
Utilice esta clase div-file para poder estilizar un input de tipo file y que se vea como un boton
y utilice esta clase input-file para poder ocultar el input de tipo file y se pueda visualizar el div padre.
subir file
subir file
subir file
Eliminar el control de revelación de contraseña en navegador Edge que tiene por default
Puede eliminar por completo el botón de revelación de contraseña apuntando al ::-ms-reveal pseudo elemento.
Input sin icono "valid" o "invalid"
Para quitar el icono de verificacion en un input utiliza la siguiente clase:
Formulario con Helpers
Es posible tener un espacio fijo reservado para mostrar los Helpers.
Es necesario utilizar la clase
with-helper
atributo que debera estar de la siguiente forma
<className="form-group with-helper">
. Esto habilita un espacio fijo para el helper. Es decir cuando se muestre un mensaje en el helper.
El formulario no generara espacios adicionales para mostrar este contenido.