Ejemplos y pautas de uso para estilos de control de formulario, opciones de diseño y componentes personalizados para crear una amplia variedad de formularios.
Visión general
Los controles de formulario de Bootstrap amplían nuestros estilos de formulario reiniciados con clases. Use 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 typeatributo apropiado en todas las entradas (p. ej., emailpara la dirección de correo electrónico o numberpara la 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, tienen estilo con la .form-controlclase. Se incluyen estilos para apariencia general, estado de enfoque, tamaño y más.
Para entradas de archivos, cambie el .form-controlpor .form-control-file.
Dimensionamiento
Establece alturas usando clases como .form-control-lgy .form-control-sm.
Solo lectura
Agregue el readonlyatributo 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 deshabilitadas), pero conservan el cursor estándar.
Texto sin formato de solo lectura
Si desea tener <input readonly>elementos en su formulario con estilo como texto sin formato, use la .form-control-plaintextclase para eliminar el estilo de campo de formulario predeterminado y conservar el margen y el relleno correctos.
Entradas de rango
Establezca entradas de rango desplazables horizontalmente usando .form-control-range.
Casillas de verificación y radios
Las casillas de verificación y los radios predeterminados se han mejorado con la ayuda de .form-checkuna única clase para ambos tipos de entrada que mejora el diseño 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 de muchas.
Se admiten casillas de verificación y radios deshabilitadas. El disabledatributo 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>s y <label>s son elementos hermanos a diferencia de an <input>dentro de a <label>. Esto es un poco más detallado ya que debe especificar idy foratributos para relacionar el <input>y <label>.
Predeterminado (apilado)
De forma predeterminada, cualquier cantidad de casillas de verificación y radios que sean hermanos inmediatos se apilarán verticalmente y se espaciarán adecuadamente con .form-check.
En línea
Agrupe casillas de verificación o radios en la misma fila horizontal agregando .form-check-inlinea cualquier archivo .form-check.
sin etiquetas
Agregue .position-statica las entradas dentro .form-checkque no tienen ningún texto de etiqueta. Recuerde proporcionar algún tipo de etiqueta para las tecnologías de asistencia (por ejemplo, usando aria-label).
Diseño
Dado que Bootstrap se aplica display: blocka width: 100%casi todos nuestros controles de formulario, los formularios se apilarán verticalmente de forma predeterminada. Se pueden usar clases adicionales para variar este diseño según el formulario.
Formar grupos
La .form-groupclase 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 recoge estilos adicionales .form-inlinesegún sea necesario. Úselo con <fieldset>s, <div>s o casi cualquier otro elemento.
Cuadrícula de formulario
Se pueden construir formularios más complejos utilizando nuestras clases de cuadrícula. Utilícelos para diseños de formularios que requieran varias columnas, anchos variados y opciones de alineación adicionales.
Fila de formulario
También puede cambiar .rowpor .form-row, una variación de nuestra fila de cuadrícula estándar que anula los canales de columna predeterminados 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 formularios horizontales con la cuadrícula agregando la .rowclase 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>correos electrónicos 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-topetiqueta de nuestras 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-smo .col-form-label-lghasta su <label>s o <legend>s para seguir correctamente el tamaño de .form-control-lgy .form-control-sm.
Tamaño de columna
Como se muestra en los ejemplos anteriores, nuestro sistema de cuadrícula le permite colocar cualquier número de .cols dentro de a .rowo .form-row. Dividirán el ancho disponible en partes iguales entre ellos. También puede elegir un subconjunto de sus columnas para que ocupe más o menos espacio, mientras que los restantes .coldividen el resto por igual, con clases de columnas específicas como .col-7.
Tamaño automático
El siguiente ejemplo usa una utilidad flexbox para centrar verticalmente el contenido y los cambios .colpara .col-autoque sus columnas solo ocupen tanto espacio como sea necesario. Dicho de otra manera, la columna se dimensiona a sí misma en función del contenido.
Luego puede mezclar eso una vez más con clases de columna de tamaño específico.
Use la .form-inlineclase 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 son display: flex, colapsan cualquier espacio en blanco HTML y le permiten proporcionar control de alineación con utilidades de espaciado y flexbox .
Los controles y los grupos de entrada reciben width: autopara anular el valor predeterminado de Bootstrap width: 100%.
Los controles solo aparecen en línea en las ventanas gráficas 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 de los visitantes que no son lectores de pantalla con .sr-only.
También se admiten selecciones y controles de formulario 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-onlyclase. Existen otros métodos alternativos para proporcionar una etiqueta para las tecnologías de asistencia, como el aria-labelatributo o aria-labelledby. titleSi ninguno de estos está presente, las tecnologías de asistencia pueden recurrir al uso del placeholderatributo, si está presente, pero tenga en cuenta que placeholderno se recomienda el uso de como reemplazo de otros métodos de etiquetado.
Texto de ayuda
El texto de ayuda a nivel de bloque en los formularios se puede crear usando .form-text(anteriormente conocido como .help-blocken 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 con el que se relaciona el uso del aria-describedbyatributo. Esto garantizará que las tecnologías de asistencia, como los lectores de pantalla, anuncien este texto de ayuda cuando el usuario enfoca o ingresa el control.
El texto de ayuda debajo de las entradas se puede diseñar con .form-text. Esta clase incluye display: blocky agrega un margen superior para facilitar el espaciado de las entradas anteriores.
Su contraseña debe tener entre 8 y 20 caracteres, contener letras y números, y no debe contener espacios, caracteres especiales ni emoji.
El texto en línea puede usar cualquier elemento HTML en línea típico (ya sea un <small>, <span>o cualquier otro) con nada más que una clase de utilidad.
formularios deshabilitados
Agregue el disabledatributo booleano en una entrada para evitar las interacciones del usuario y hacer que parezca más claro.
Agregue el disabledatributo a <fieldset>para deshabilitar todos los controles dentro.
Advertencia con anclas
De manera predeterminada, los navegadores tratarán todos los controles <input>de formulario nativos ( <select>y <button>elementos) dentro de un <fieldset disabled>como deshabilitados, lo que evitará las interacciones del teclado y el mouse en ellos. Sin embargo, si su formulario también incluye <a ... class="btn btn-*">elementos, estos solo tendrán un estilo de pointer-events: none. Como se indicó en la sección sobre el estado deshabilitado de los botones (y específicamente en la subsección de los elementos de anclaje), esta propiedad CSS aún no está estandarizada y no es totalmente compatible con Internet Explorer 10, y no evitará que los usuarios de teclados sean capaz de enfocar o activar estos enlaces. Entonces, para estar seguro, use JavaScript personalizado para deshabilitar dichos enlaces.
Compatibilidad entre navegadores
Si bien Bootstrap aplicará estos estilos en todos los navegadores, Internet Explorer 11 y versiones anteriores no admiten completamente el disabledatributo en un archivo <fieldset>. Use JavaScript personalizado para deshabilitar el conjunto de campos en estos navegadores.
Validación
Proporcione comentarios valiosos y procesables 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.
Actualmente, recomendamos usar estilos de validación personalizados, ya que los mensajes de validación predeterminados del navegador nativo no se exponen constantemente a las tecnologías de asistencia en todos los navegadores (sobre todo, Chrome en computadoras de escritorio y dispositivos móviles).
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 dos pseudoclases de CSS :invalidy :valid. Se aplica a los elementos <input>, <select>y <textarea>.
Bootstrap aplica el ámbito :invalidy los :validestilos a la .was-validatedclase principal, que generalmente se aplica a <form>. De lo contrario, cualquier campo obligatorio sin valor aparecerá como no válido al cargar la página. De esta forma, puede elegir cuándo activarlos (por lo general, 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 mediante AJAX), elimine la .was-validatedclase de <form>nuevo después del envío.
Como respaldo, .is-invalidse .is-validpueden usar clases en lugar de las pseudoclases para la validación del lado del servidor . No requieren una .was-validatedclase principal.
Debido a las limitaciones en el funcionamiento de CSS, no podemos (en la actualidad) aplicar estilos a un <label>control de formulario anterior al DOM sin la ayuda de JavaScript personalizado.
Todos los navegadores modernos admiten la API de validación de restricciones , una serie de métodos de JavaScript para validar controles de formulario.
Los mensajes de comentarios pueden utilizar los valores predeterminados del navegador (diferentes para cada navegador y sin estilo a través de CSS) o nuestros estilos de comentarios personalizados con HTML y CSS adicionales.
Puede proporcionar mensajes de validez personalizados setCustomValidityen 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 de validación de formulario Bootstrap personalizados, deberá agregar el novalidateatributo booleano a su archivo <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 siguiente formulario; nuestro JavaScript interceptará el botón de enviar y le transmitirá sus comentarios. Cuando intente enviar, verá los estilos :invalidy :validaplicados a los controles de su formulario.
Los estilos de comentarios personalizados aplican colores, bordes, estilos de enfoque e iconos de fondo personalizados para comunicar mejor los comentarios. Los íconos de fondo para <select>s solo están disponibles con .custom-select, y no .form-control.
Valores predeterminados del navegador
¿No le interesan los mensajes de comentarios de validación personalizados o escribir JavaScript para cambiar los comportamientos de los formularios? Todo bien, puedes usar los valores predeterminados del navegador. Intente enviar el formulario a continuación. Dependiendo de su navegador y sistema operativo, verá un estilo de retroalimentación 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 requiera la validación del lado del servidor, puede indicar campos de formulario válidos y no válidos con .is-invalidy .is-valid. Tenga en cuenta que .invalid-feedbacktambién es compatible con estas clases.
Elementos compatibles
Los estilos de validación están disponibles para los siguientes controles y componentes de formulario:
<input>s y <textarea>s con .form-control(incluyendo hasta uno .form-controlen grupos de entrada)
<select>es con .form-controlo.custom-select
.form-checks
.custom-checkboxs y .custom-radios
.custom-file
Información sobre herramientas
Si el diseño de su formulario lo permite, puede cambiar las .{valid|invalid}-feedbackclases por .{valid|invalid}-tooltipclases para mostrar comentarios de validación en una información sobre herramientas 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 columnas 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-statesmapa. Ubicado en nuestro _variables.scssarchivo, este mapa de Sass se repite para generar los estados predeterminados valid/ de invalidvalidació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 el form-validation-statemixin.
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á envuelto 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, :checkedpara diseñar correctamente nuestro indicador de formulario personalizado. Cuando se combina con la .custom-control-labelclase, también podemos diseñar el texto de cada elemento en función del <input>estado de .
Ocultamos el valor predeterminado <input>con opacityy usamos .custom-control-labelpara crear un nuevo indicador de formulario personalizado en su lugar con ::beforey ::after. Desafortunadamente, no podemos crear uno personalizado solo <input>porque el CSS contentno funciona en ese elemento.
En los estados marcados, usamos iconos SVG incrustados base64 de Open Iconic . Esto nos brinda el mejor control para diseñar y posicionar en todos los navegadores y dispositivos.
Casillas de verificación
Las casillas de verificación personalizadas también pueden utilizar la :indeterminatepseudoclase cuando se configuran manualmente a través de JavaScript (no hay un atributo HTML disponible para especificarlo).
Si está utilizando jQuery, algo como esto debería ser suficiente:
Radios
En línea
Desactivado
Las casillas de verificación y las radios personalizadas también se pueden desactivar. Agregue el disabledatributo booleano a <input>y el indicador personalizado y la descripción de la etiqueta se diseñarán automáticamente.
Interruptores
Un interruptor tiene el marcado de una casilla de verificación personalizada, pero usa la .custom-switchclase para representar un interruptor de palanca. Los conmutadores también admiten el disabledatributo.
Seleccione el menú
Los menús personalizados <select>solo necesitan una clase personalizada .custom-selectpara activar los estilos personalizados. Los estilos personalizados se limitan a la <select>apariencia inicial del correo electrónico y no pueden modificar el correo <option>electrónico 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 multipleatributo también es compatible:
Como es el sizeatributo:
Rango
Cree <input type="range">controles personalizados con .custom-range. La pista (el fondo) y el pulgar (el valor) están diseñados para que aparezcan iguales en todos los navegadores. Como solo IE y Firefox admiten "llenar" 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 stepvalor. 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 de archivo es la más retorcida del grupo y requiere JavaScript adicional si desea conectarlos con Elegir archivo funcional... y texto de nombre de archivo seleccionado.
Ocultamos el archivo predeterminado <input>a través de opacityy, en su lugar, diseñamos el archivo <label>. El botón se genera y posiciona con ::after. Por último, declaramos a widthy heighten el <input>espacio adecuado para el contenido circundante.
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-textvariable Sass con la etiqueta de idioma relevante y las cadenas localizadas. Las cadenas en inglés se pueden personalizar de la misma manera. Por ejemplo, así es como se podría agregar una traducción al español (el código de idioma del español es es):
Aquí está lang(es)en acción la entrada del archivo personalizado para una traducción al español:
Deberá configurar correctamente el idioma de su documento (o subárbol del mismo) para que se muestre el texto correcto. Esto se puede hacer usando el langatributo en el <html>elemento o el Content-Languageencabezado 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-browseatributo que se puede agregar a la etiqueta de entrada personalizada (ejemplo en holandés):