CSS
Configuración global de CSS, elementos HTML fundamentais estilizados e mellorados con clases extensibles e un sistema de cuadrícula avanzado.
Configuración global de CSS, elementos HTML fundamentais estilizados e mellorados con clases extensibles e un sistema de cuadrícula avanzado.
Obtén información sobre as pezas clave da infraestrutura de Bootstrap, incluíndo o noso enfoque para un desenvolvemento web mellor, máis rápido e máis forte.
Bootstrap fai uso de certos elementos HTML e propiedades CSS que requiren o uso do doctype HTML5. Inclúeo ao comezo de todos os teus proxectos.
Con Bootstrap 2, engadimos estilos opcionais compatibles con móbiles para aspectos clave do cadro. Con Bootstrap 3, reescribimos o proxecto para que sexa compatible con dispositivos móbiles desde o principio. En lugar de engadir estilos móbiles opcionais, están cocidos no núcleo. De feito, Bootstrap é primeiro móbil . Os primeiros estilos móbiles pódense atopar en toda a biblioteca en lugar de en ficheiros separados.
Para garantir a representación correcta e o zoom táctil, engade a metaetiqueta da ventana gráfica ao teu <head>
.
Podes desactivar as capacidades de zoom en dispositivos móbiles engadindo user-scalable=no
á metaetiqueta da vista. Isto desactiva o zoom, o que significa que os usuarios só poden desprazarse e fai que o teu sitio se sinta un pouco máis como unha aplicación nativa. En xeral, non recomendamos isto en todos os sitios, así que teña coidado!
Bootstrap establece estilos básicos de visualización global, tipografía e ligazón. En concreto, nós:
background-color: #fff;
nobody
@font-family-base
, @font-size-base
, e @line-height-base
como a nosa base tipográfica@link-color
e só aplica subliñado da ligazón:hover
Estes estilos pódense atopar en scaffolding.less
.
Para mellorar a representación entre navegadores, usamos Normalize.css , un proxecto de Nicolas Gallagher e Jonathan Neal .
Bootstrap require un elemento de contedor para envolver o contido do sitio e albergar o noso sistema de grella. Podes escoller un dos dous recipientes para usar nos teus proxectos. Teña en conta que, debido a padding
e máis, ningún dos dous recipientes é axustable.
Utilízase .container
para un contedor de ancho fixo sensible.
Utilízao .container-fluid
para un contedor de ancho completo, que abarque todo o ancho da túa ventana gráfica.
Bootstrap inclúe un primeiro sistema de reixa de fluídos móbiles sensibles que se escala adecuadamente ata 12 columnas a medida que aumenta o tamaño do dispositivo ou da ventana gráfica. Inclúe clases predefinidas para opcións de deseño sinxelas, así como mixins potentes para xerar deseños máis semánticos .
Os sistemas de cuadrícula úsanse para crear deseños de páxina a través dunha serie de filas e columnas que albergan o teu contido. Así é como funciona o sistema de reixa Bootstrap:
.container
(ancho fixo) ou .container-fluid
(ancho total) para o aliñamento e o recheo adecuados..row
e .col-xs-4
están dispoñibles para facer rapidamente deseños de grade. Tamén se poden usar menos mixins para deseños máis semánticos.padding
. Ese recheo desprázase en filas para a primeira e a última columna mediante unha marxe negativa en .row
s..col-xs-4
..col-md-*
clase a un elemento non só afectará o seu estilo en dispositivos medianos senón tamén en dispositivos grandes se unha .col-lg-*
clase non está presente.Consulta os exemplos para aplicar estes principios ao teu código.
Usamos as seguintes consultas multimedia nos nosos ficheiros Less para crear os puntos de interrupción clave no noso sistema de grella.
De cando en vez ampliamos estas consultas multimedia para incluír un max-width
para limitar CSS a un conxunto máis reducido de dispositivos.
Vexa como funcionan os aspectos do sistema de reixa Bootstrap en varios dispositivos cunha táboa útil.
Dispositivos extra pequenos Teléfonos (<768 px) | Dispositivos pequenos Tabletas (≥768 px) | Dispositivos medianos Escritorios (≥992 px) | Dispositivos grandes Escritorios (≥1200px) | |
---|---|---|---|---|
Comportamento da reixa | Horizontal en todo momento | Contraído para comezar, horizontal por riba dos puntos de interrupción | ||
Ancho do recipiente | Ningún (automático) | 750 píxeles | 970 píxeles | 1170 píxeles |
Prefixo de clase | .col-xs- |
.col-sm- |
.col-md- |
.col-lg- |
# de columnas | 12 | |||
Ancho da columna | Automático | ~62 píxeles | ~81 píxeles | ~97 píxeles |
Ancho de canalón | 30px (15px a cada lado dunha columna) | |||
Encaixable | Si | |||
Compensacións | Si | |||
Ordenación de columnas | Si |
Usando un único conxunto de .col-md-*
clases de cuadrícula, podes crear un sistema de cuadrícula básico que comeza apilado en dispositivos móbiles e tabletas (o rango extra pequeno ou pequeno) antes de converterse en horizontal en dispositivos de escritorio (medianos). Coloque columnas de grade en calquera .row
.
Converte calquera deseño de cuadrícula de ancho fixo nun deseño de ancho completo cambiando o máis externo .container
a .container-fluid
.
Non queres que as túas columnas simplemente se apilen en dispositivos máis pequenos? Use as clases de cuadrícula de dispositivos extra pequenas e medianas engadindo .col-xs-*
.col-md-*
ás súas columnas. Vexa o seguinte exemplo para ter unha mellor idea de como funciona todo.
Constrúe o exemplo anterior creando deseños aínda máis dinámicos e potentes con .col-sm-*
clases de tabletas.
Se se colocan máis de 12 columnas nunha soa fila, cada grupo de columnas adicionais envolverase, como unha unidade, nunha nova liña.
Cos catro niveis de cuadrículas dispoñibles, seguramente tes problemas nos que, en certos puntos de interrupción, as túas columnas non se borran ben xa que unha é máis alta que a outra. Para solucionalo, use unha combinación de a .clearfix
e as nosas clases de utilidade receptivas .
Ademais de borrar columnas nos puntos de interrupción sensibles, é posible que necesites restablecer as compensacións, os empuxóns ou os pulls . Vexa isto en acción no exemplo da grella .
Move as columnas cara á dereita usando .col-md-offset-*
clases. Estas clases aumentan a marxe esquerda dunha columna por *
columnas. Por exemplo, .col-md-offset-4
móvese .col-md-4
sobre catro columnas.
Tamén pode anular as compensacións dos niveis de grade inferiores con .col-*-offset-0
clases.
Para aniñar o teu contido coa grade predeterminada, engade unha nova .row
e un conxunto de columnas dentro dunha columna .col-sm-*
existente . .col-sm-*
As filas anidadas deben incluír un conxunto de columnas que suman ata 12 ou menos (non é necesario que use as 12 columnas dispoñibles).
Cambia facilmente a orde das nosas columnas de grade integradas con clases .col-md-push-*
e modificadores..col-md-pull-*
Ademais das clases de cuadrícula preconstruídas para deseños rápidos, Bootstrap inclúe Menos variables e mixins para xerar rapidamente os teus propios deseños semánticos sinxelos.
As variables determinan o número de columnas, o ancho do canal e o punto de consulta de medios no que comezar as columnas flotantes. Usamos estes para xerar as clases de cuadrícula predefinidas documentadas anteriormente, así como para as mesturas personalizadas listadas a continuación.
Os mixins úsanse xunto coas variables da grella para xerar CSS semántico para columnas de grella individuais.
Podes modificar as variables aos teus propios valores personalizados ou simplemente usar os mixins cos seus valores predeterminados. Aquí tes un exemplo de uso da configuración predeterminada para crear un deseño de dúas columnas cun espazo entre eles.
Todos os títulos HTML, <h1>
a través <h6>
de , están dispoñibles. .h1
a través .h6
de clases tamén están dispoñibles, para cando quere combinar o estilo de fonte dun título pero aínda así quere que o seu texto se amose en liña.
h1. Título de bootstrap |
Seminegrita 36px |
h2. Título de bootstrap |
Seminegrita 30px |
h3. Título de bootstrap |
Seminegrita 24px |
h4. Título de bootstrap |
Seminegrita 18px |
h5. Título de bootstrap |
Seminegrita 14px |
h6. Título de bootstrap |
Seminegrita 12px |
Crea un texto secundario máis claro en calquera título cunha <small>
etiqueta xenérica ou a .small
clase.
h1. Título de Bootstrap Texto secundario |
h2. Título de Bootstrap Texto secundario |
h3. Título de Bootstrap Texto secundario |
h4. Título de Bootstrap Texto secundario |
h5. Título de Bootstrap Texto secundario |
h6. Título de Bootstrap Texto secundario |
O valor predeterminado global de Bootstrap font-size
é 14px , cun valor line-height
de 1.428 . Isto aplícase a <body>
todos os parágrafos. Ademais, os <p>
(parágrafos) reciben unha marxe inferior da metade da súa altura de liña calculada (10px por defecto).
Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula.
Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, is not commodo luctus, ninsi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.
Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, is not commodo luctus, ninsi erat porttitor ligula, eget lacinia odio sem nec elit.
Fai que un parágrafo destaque engadindo .lead
.
Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.
A escala tipográfica baséase en dúas variables Menos en variables.less : @font-size-base
e @line-height-base
. O primeiro é o tamaño da fonte base empregado en todo e o segundo é a altura da liña base. Usamos esas variables e algunhas matemáticas sinxelas para crear as marxes, recheos e alturas de liña de todo o noso tipo e moito máis. Personalízaos e Bootstrap adáptase.
Para resaltar unha serie de texto debido á súa relevancia noutro contexto, use a <mark>
etiqueta.
Podes usar a etiqueta mark paradestacartexto.
Para indicar os bloques de texto que foron eliminados, use a <del>
etiqueta.
Esta liña de texto está destinada a ser tratada como texto eliminado.
Para indicar bloques de texto que xa non son relevantes use a <s>
etiqueta.
Esta liña de texto está destinada a ser tratada como xa non precisa.
Para indicar adicións ao documento use a <ins>
etiqueta.
Esta liña de texto está destinada a ser tratada como unha adición ao documento.
Para subliñar o texto use a <u>
etiqueta.
Esta liña de texto mostrarase como subliñada
Fai uso das etiquetas de énfase predeterminadas de HTML con estilos lixeiros.
Para quitar o énfase en liña ou en bloques de texto, usa a <small>
etiqueta para establecer o texto nun 85 % do tamaño do pai. Os elementos de título reciben os seus propios para os elementos font-size
aniñados .<small>
Alternativamente, pode usar un elemento en liña con .small
en lugar de calquera <small>
.
Esta liña de texto está destinada a ser tratada como letra pequena.
Para enfatizar un fragmento de texto cun grosor de letra máis pesado.
O seguinte fragmento de texto represéntase como texto en negra .
Para enfatizar un fragmento de texto con cursiva.
O seguinte fragmento de texto represéntase como texto en cursiva .
Non dubides en usar <b>
e <i>
en HTML5. <b>
está destinado a resaltar palabras ou frases sen transmitir importancia adicional, mentres que <i>
é principalmente para voz, termos técnicos, etc.
Realiñe facilmente o texto aos compoñentes con clases de aliñamento de texto.
Texto aliñado á esquerda.
Texto aliñado ao centro.
Texto aliñado á dereita.
Texto xustificado.
Sen texto axustado.
Transformar texto en compoñentes con clases de maiúsculas de texto.
Texto en minúscula.
Texto en maiúscula.
Texto en maiúscula.
Implementación estilizada do <abbr>
elemento HTML para abreviaturas e acrónimos para mostrar a versión ampliada ao pasar o cursor. As abreviaturas cun title
atributo teñen un bordo inferior de puntos claros e un cursor de axuda ao pasar o cursor, o que proporciona un contexto adicional ao pasar o cursor e aos usuarios de tecnoloxías de asistencia.
Unha abreviatura da palabra atributo é attr .
Engadir .initialism
a unha abreviatura para un tamaño de letra lixeiramente menor.
HTML é o mellor desde o pan rebanado.
Presenta a información de contacto do antepasado máis próximo ou de todo o traballo. Conserva o formato rematando todas as liñas con <br>
.
Para citar bloques de contido doutra fonte dentro do seu documento.
Envolve <blockquote>
calquera HTML como cita. Para as comiñas rectas, recomendamos un <p>
.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
Cambios de estilo e contido para variacións sinxelas dun estándar <blockquote>
.
Engade un <footer>
para identificar a fonte. Envolve o nome da obra de orixe en <cite>
.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
Engadir .blockquote-reverse
para unha cita de bloque con contido aliñado á dereita.
Unha lista de elementos nos que a orde non importa explícitamente.
Unha lista de elementos nos que a orde importa explícitamente.
list-style
Elimina a marxe predeterminada e esquerda dos elementos da lista (só fillos inmediatos). Isto só se aplica aos elementos de lista fillos inmediatos , o que significa que tamén terás que engadir a clase para calquera lista aniñada.
Coloca todos os elementos da lista nunha soa liña con display: inline-block;
algo de recheo.
Unha lista de termos coas súas descricións asociadas.
Fai termos e descricións en <dl>
liña xuntos. Comeza apilado como <dl>
s predeterminados, pero cando a barra de navegación se expande, tamén o fan.
As listas de descricións horizontais truncarán os termos que son demasiado longos para caber na columna da esquerda con text-overflow
. Nas vistas máis estreitas, cambiarán ao deseño apilado predeterminado.
Envolve fragmentos de código en liña con <code>
.
<section>
debería envolverse como en liña.
Use o <kbd>
para indicar a entrada que normalmente se introduce mediante o teclado.
Use <pre>
para varias liñas de código. Asegúrate de escapar de calquera corchete angular do código para unha representación correcta.
<p>Texto de mostra aquí...</p>
Opcionalmente, pode engadir a .pre-scrollable
clase, que establecerá unha altura máxima de 350 px e proporcionará unha barra de desprazamento no eixe Y.
Para indicar variables use a <var>
etiqueta.
y = m x + b
Para indicar a saída de mostra de bloques dun programa, use a <samp>
etiqueta.
Este texto está destinado a ser tratado como mostra de saída dun programa informático.
Para un estilo básico (recheo lixeiro e só divisores horizontais) engade a clase base .table
a calquera <table>
. Pode parecer super redundante, pero dado o uso xeneralizado de táboas para outros complementos como calendarios e selectores de datas, optamos por illar os nosos estilos de táboas personalizadas.
# | Nome | Apelido | Nome de usuario |
---|---|---|---|
1 | Marcos | Oto | @mdo |
2 | Xacobe | Thornton | @graxas |
3 | Larry | o paxaro |
Utilízao .table-striped
para engadir franxas de cebra a calquera fila da táboa dentro do <tbody>
.
As táboas con raias son estilizadas mediante o :nth-child
selector CSS, que non está dispoñible en Internet Explorer 8.
# | Nome | Apelido | Nome de usuario |
---|---|---|---|
1 | Marcos | Oto | @mdo |
2 | Xacobe | Thornton | @graxas |
3 | Larry | o paxaro |
Engade .table-bordered
os bordos en todos os lados da táboa e das celas.
# | Nome | Apelido | Nome de usuario |
---|---|---|---|
1 | Marcos | Oto | @mdo |
2 | Xacobe | Thornton | @graxas |
3 | Larry | o paxaro |
Engadir .table-hover
para activar un estado de paso nas filas da táboa dentro dun <tbody>
.
# | Nome | Apelido | Nome de usuario |
---|---|---|---|
1 | Marcos | Oto | @mdo |
2 | Xacobe | Thornton | @graxas |
3 | Larry | o paxaro |
Engade .table-condensed
para facer as táboas máis compactas cortando o recheo celular á metade.
# | Nome | Apelido | Nome de usuario |
---|---|---|---|
1 | Marcos | Oto | @mdo |
2 | Xacobe | Thornton | @graxas |
3 | Larry o paxaro |
Use clases contextuais para colorear filas de táboas ou celas individuais.
Clase | Descrición |
---|---|
.active |
Aplica a cor do rato a unha fila ou cela determinada |
.success |
Indica unha acción exitosa ou positiva |
.info |
Indica un cambio ou acción informativa neutral |
.warning |
Indica un aviso que pode necesitar atención |
.danger |
Indica unha acción perigosa ou potencialmente negativa |
# | Encabezado da columna | Encabezado da columna | Encabezado da columna |
---|---|---|---|
1 | Contido da columna | Contido da columna | Contido da columna |
2 | Contido da columna | Contido da columna | Contido da columna |
3 | Contido da columna | Contido da columna | Contido da columna |
4 | Contido da columna | Contido da columna | Contido da columna |
5 | Contido da columna | Contido da columna | Contido da columna |
6 | Contido da columna | Contido da columna | Contido da columna |
7 | Contido da columna | Contido da columna | Contido da columna |
8 | Contido da columna | Contido da columna | Contido da columna |
9 | Contido da columna | Contido da columna | Contido da columna |
Usar a cor para engadir significado a unha fila da táboa ou unha cela individual só proporciona unha indicación visual, que non se transmitirá aos usuarios de tecnoloxías auxiliares, como lectores de pantalla. Asegúrate de que a información indicada pola cor é obvia desde o propio contido (o texto visible na fila ou cela da táboa correspondente) ou está incluída a través de medios alternativos, como o texto adicional oculto coa .sr-only
clase.
Crea táboas receptivas envolvendo calquera .table
para .table-responsive
que se despracen horizontalmente en dispositivos pequenos (menos de 768 píxeles). Cando ves algo máis de 768 píxeles de ancho, non verás ningunha diferenza nestas táboas.
As táboas sensibles fan uso de overflow-y: hidden
, que recorta calquera contido que vaia máis aló dos bordos inferior ou superior da táboa. En particular, isto pode cortar os menús despregables e outros widgets de terceiros.
Firefox ten un estilo de conxunto de campos incómodo width
que interfire coa táboa de resposta. Isto non se pode anular sen un hack específico de Firefox que non proporcionamos en Bootstrap:
Para obter máis información, lea esta resposta de Stack Overflow .
# | Título da táboa | Título da táboa | Título da táboa | Título da táboa | Título da táboa | Título da táboa |
---|---|---|---|---|---|---|
1 | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa |
2 | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa |
3 | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa |
# | Título da táboa | Título da táboa | Título da táboa | Título da táboa | Título da táboa | Título da táboa |
---|---|---|---|---|---|---|
1 | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa |
2 | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa |
3 | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa | Cela da táboa |
Os controis de formularios individuais reciben automaticamente un estilo global. Todos os elementos textuais <input>
, <textarea>
, e <select>
con .form-control
están configurados como width: 100%;
predeterminados. Envolve as etiquetas e os controis .form-group
para un espazo óptimo.
Non mesture grupos de formularios directamente con grupos de entrada . Pola contra, aniñe o grupo de entrada dentro do grupo de formularios.
Engade .form-inline
ao teu formulario (que non ten que ser un <form>
) para os controis de bloques aliñados á esquerda e en liña. Isto só se aplica aos formularios dentro de ventanas gráficas que teñan polo menos 768 píxeles de ancho.
As entradas e seleccións width: 100%;
aplicáronse por defecto en Bootstrap. Dentro dos formularios en liña, restablecemos isto para width: auto;
que varios controis poidan residir na mesma liña. Dependendo do seu deseño, poden ser necesarios anchos personalizados adicionais.
Os lectores de pantalla terán problemas cos teus formularios se non inclúes unha etiqueta para cada entrada. Para estes formularios en liña, pode ocultar as etiquetas usando a .sr-only
clase. Existen outros métodos alternativos para proporcionar unha etiqueta para tecnoloxías de asistencia, como o atributo aria-label
, aria-labelledby
ou . title
Se ningún destes está presente, os lectores de pantalla poden recorrer ao uso do placeholder
atributo, se está presente, pero teña en conta que placeholder
non se recomenda o uso de como substituto doutros métodos de etiquetaxe.
Use as clases de grade predefinidas de Bootstrap para aliñar etiquetas e grupos de controis de formulario nun deseño horizontal engadindo .form-horizontal
ao formulario (que non ten que ser un <form>
). Ao facelo, cambia .form-group
s para comportarse como filas de grade, polo que non é necesario .row
.
Exemplos de controis de formulario estándar admitidos nun deseño de formulario de exemplo.
Control de formulario máis común, campos de entrada baseados en texto. Inclúe compatibilidade con todos os tipos HTML5: text
, password
, datetime
, datetime-local
, date
, month
, time
, week
, number
, email
, url
, search
, tel
, e color
.
As entradas só terán un estilo completo se type
se declaran correctamente.
Para engadir texto ou botóns integrados antes e/ou despois de calquera baseado en texto <input>
, consulta o compoñente do grupo de entrada .
Control de formulario que admite varias liñas de texto. Cambia rows
o atributo segundo sexa necesario.
As caixas de verificación son para seleccionar unha ou varias opcións nunha lista, mentres que as radios son para seleccionar unha opción de entre moitas.
Admítense as caixas de verificación e as radios desactivadas, pero para proporcionar un cursor "non permitido" ao pasar o cursor do pai <label>
, terás que engadir a .disabled
clase ao pai .radio
, .radio-inline
, .checkbox
ou .checkbox-inline
.
Use as clases .checkbox-inline
ou .radio-inline
nunha serie de caixas de verificación ou radios para os controis que aparecen na mesma liña.
Se non tes texto dentro do <label>
, a entrada sitúase como esperarías. Actualmente só funciona en caixas de verificación e radios non en liña. Lembra aínda fornecer algún tipo de etiqueta para as tecnoloxías de asistencia (por exemplo, usar aria-label
).
Teña en conta que moitos menús de selección nativos, especialmente en Safari e Chrome, teñen esquinas redondeadas que non se poden modificar mediante border-radius
propiedades.
Para <select>
os controis co multiple
atributo, móstranse varias opcións por defecto.
Cando necesites colocar texto sinxelo xunto a unha etiqueta de formulario dentro dun formulario, usa a .form-control-static
clase nun <p>
.
Eliminamos os outline
estilos predeterminados nalgúns controis de formulario e aplicamos un box-shadow
no seu lugar para :focus
.
:focus
Estado de demostraciónA entrada de exemplo anterior usa estilos personalizados na nosa documentación para demostrar o :focus
estado nun .form-control
.
Engade o disabled
atributo booleano nunha entrada para evitar as interaccións do usuario. As entradas desactivadas aparecen máis claras e engaden un not-allowed
cursor.
Engade o disabled
atributo a <fieldset>
para desactivar todos os controis <fieldset>
dunha soa vez.
<a>
De xeito predeterminado, os navegadores tratarán todos os controis de formularios nativos ( e <input>
elementos ) dentro dunha como desactivados, evitando as interaccións do teclado e do rato neles. Non obstante, se o teu formulario tamén inclúe elementos, só se lles dará un estilo . Como se indicou na sección sobre o estado desactivado dos botóns (e concretamente na subsección para os elementos de ancoraxe), esta propiedade CSS aínda non está estandarizada e non se admite totalmente en Opera 18 e posteriores, nin en Internet Explorer 11, e gañou non impide que os usuarios do teclado poidan enfocar ou activar estas ligazóns. Polo tanto, para estar seguro, usa JavaScript personalizado para desactivar tales ligazóns.<select>
<button>
<fieldset disabled>
<a ... class="btn btn-*">
pointer-events: none
Aínda que Bootstrap aplicará estes estilos en todos os navegadores, Internet Explorer 11 e anteriores non admiten totalmente o disabled
atributo nun ficheiro <fieldset>
. Use JavaScript personalizado para desactivar o conxunto de campos nestes navegadores.
Engade o readonly
atributo booleano nunha entrada para evitar a modificación do valor da entrada. As entradas de só lectura parecen máis claras (igual que as entradas desactivadas), pero conservan o cursor estándar.
Texto de axuda a nivel de bloque para controis de formulario.
O texto de axuda debe estar asociado explícitamente co control de formulario co que se relaciona usando o aria-describedby
atributo. Isto garantirá que as tecnoloxías de asistencia, como os lectores de pantalla, anunciarán este texto de axuda cando o usuario se concentre ou entre no control.
Bootstrap inclúe estilos de validación para os estados de erro, aviso e éxito nos controis de formulario. Para usar, engadir .has-warning
, .has-error
ou .has-success
ao elemento pai. Calquera .control-label
, .form-control
, e .help-block
dentro dese elemento recibirán os estilos de validación.
Usar estes estilos de validación para indicar o estado dun control de formulario só proporciona unha indicación visual baseada en cores, que non se transmitirá aos usuarios de tecnoloxías auxiliares, como lectores de pantalla, nin aos usuarios daltónicos.
Asegúrese de que tamén se proporciona unha indicación alternativa do estado. Por exemplo, pode incluír unha suxestión sobre o estado no <label>
propio texto do control de formulario (como é o caso no seguinte exemplo de código), incluír un Glyphicon (con texto alternativo apropiado usando a .sr-only
clase; consulte os exemplos de Glyphicon ) ou proporcionando un bloque de texto de axuda adicional . Específicamente para tecnoloxías de asistencia, tamén se pode asignar un aria-invalid="true"
atributo aos controis de formularios non válidos.
Tamén pode engadir iconas de comentarios opcionais coa adición de .has-feedback
e a icona dereita.
As iconas de comentarios só funcionan con <input class="form-control">
elementos textuais.
O posicionamento manual das iconas de comentarios é necesario para entradas sen etiqueta e para grupos de entrada cun complemento á dereita. Recoméndase encarecidamente que proporcione etiquetas para todas as entradas por motivos de accesibilidade. Se queres evitar que se mostren etiquetas, escóndeas coa .sr-only
clase. Se debes prescindir das etiquetas, axusta o top
valor da icona de comentarios. Para os grupos de entrada, axusta o right
valor a un valor de píxel adecuado dependendo do ancho do complemento.
Para garantir que as tecnoloxías de asistencia, como os lectores de pantalla, transmitan correctamente o significado dunha icona, débese incluír texto adicional oculto na .sr-only
clase e asociarse explícitamente ao control de formulario co que se relaciona usando aria-describedby
. Alternativamente, asegúrate de que o significado (por exemplo, o feito de que hai unha advertencia para un campo de entrada de texto en particular) se transmita noutra forma, como cambiar o texto do real <label>
asociado ao control do formulario.
Aínda que os seguintes exemplos xa mencionan o estado de validación dos seus respectivos controis de formulario no <label>
propio texto, a técnica anterior (usando .sr-only
texto e aria-describedby
) incluíuse con fins ilustrativos.
.sr-only
etiquetas ocultasSe usas a .sr-only
clase para ocultar un control de formulario <label>
(en lugar de usar outras opcións de etiquetaxe, como o aria-label
atributo), Bootstrap axustará automaticamente a posición da icona unha vez que se engade.
Establece alturas usando clases como .input-lg
, e establece anchos usando clases de columnas de grade como .col-lg-*
.
Crea controis de formulario máis altos ou máis curtos que coincidan co tamaño dos botóns.
Dimensiona rapidamente as etiquetas e os controis .form-horizontal
de formularios engadindo .form-group-lg
ou .form-group-sm
.
Envolve as entradas en columnas de grade ou en calquera elemento principal personalizado para aplicar facilmente os anchos desexados.
Use as clases de botón nun elemento <a>
, <button>
, ou <input>
.
Aínda que se poden usar clases de botón en <a>
e <button>
elementos, só <button>
os elementos son compatibles nos nosos compoñentes nav e navbar.
Se os <a>
elementos se usan para actuar como botóns, activando a funcionalidade na páxina, en lugar de navegar a outro documento ou sección da páxina actual, tamén se lles debería dar un role="button"
.
Como mellor práctica, recomendamos encarecidamente usar o <button>
elemento sempre que sexa posible para garantir a representación coincidente entre navegadores.
Entre outras cousas, hai un erro en Firefox <30 que nos impide configurar os botóns baseados line-height
en <input>
-o que fai que non coincidan exactamente coa altura doutros botóns de Firefox.
Use calquera das clases de botóns dispoñibles para crear rapidamente un botón con estilo.
Usar cor para engadir significado a un botón só proporciona unha indicación visual, que non se transmitirá aos usuarios de tecnoloxías de asistencia, como lectores de pantalla. Asegúrate de que a información indicada pola cor é obvia desde o propio contido (o texto visible do botón) ou está incluída a través de medios alternativos, como o texto adicional oculto coa .sr-only
clase.
Apetece botóns máis grandes ou pequenos? Engade .btn-lg
, .btn-sm
, ou .btn-xs
para tamaños adicionais.
Engadindo .btn-block
.
Os botóns aparecerán presionados (cun fondo máis escuro, bordo máis escuro e sombra inserida) cando estean activos. Para <button>
os elementos, isto faise mediante :active
. Para <a>
os elementos, faise con .active
. Non obstante, podes usar .active
en <button>
s (e incluír o aria-pressed="true"
atributo) se precisas replicar o estado activo mediante programación.
Non é necesario engadir :active
, xa que é unha pseudo-clase, pero se precisa forzar a mesma aparencia, vai adiante e engade .active
.
Engade a .active
clase aos <a>
botóns.
Fai que os botóns parezan incliquábeis desfacendoos de novo con opacity
.
Engade o disabled
atributo aos <button>
botóns.
Se engades o disabled
atributo a un <button>
, Internet Explorer 9 e as versións anteriores mostrarán o texto en gris cunha sombra de texto desagradable que non podemos solucionar.
Engade a .disabled
clase aos <a>
botóns.
Aquí usamos .disabled
como clase de utilidade, similar á .active
clase común, polo que non se require ningún prefixo.
Esta clase utilízase pointer-events: none
para tentar desactivar a función de ligazón de <a>
s, pero esa propiedade CSS aínda non está estandarizada e non se admite totalmente en Opera 18 e posteriores, nin en Internet Explorer 11. Ademais, mesmo en navegadores que admiten o pointer-events: none
teclado , a navegación non se ve afectada, o que significa que os usuarios de teclado videntes e os usuarios de tecnoloxías de asistencia aínda poderán activar estas ligazóns. Polo tanto, para estar seguro, usa JavaScript personalizado para desactivar tales ligazóns.
As imaxes de Bootstrap 3 pódense facer compatibles coa adición da .img-responsive
clase. Isto aplícase max-width: 100%;
, height: auto;
e display: block;
á imaxe para que se escala ben ao elemento pai.
Para centrar imaxes que usan a .img-responsive
clase, use .center-block
en lugar de .text-center
. Consulte a sección de clases auxiliares para obter máis detalles sobre o .center-block
seu uso.
En Internet Explorer 8-10, as imaxes SVG .img-responsive
teñen un tamaño desproporcionado. Para solucionar isto, engade width: 100% \9;
cando sexa necesario. Bootstrap non aplica isto automaticamente xa que provoca complicacións noutros formatos de imaxe.
Engade clases a un <img>
elemento para peinar facilmente as imaxes en calquera proxecto.
Teña en conta que Internet Explorer 8 carece de soporte para cantos redondeados.
Transmite significado a través da cor cun puñado de clases de utilidade de énfase. Tamén se poden aplicar ás ligazóns e escureceranse ao pasar o cursor do mesmo xeito que os nosos estilos de ligazóns predeterminados.
Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.
Nullam id dolor id nibh ultricies vehicula ut id elit.
Duis mollis, is non commodo luctus, nisi erat porttitor ligula.
Maecenas sed diam eget risus varius blandit sit amet non magna.
Etiam porta sem malesuada magna mollis euismod.
Donec ullamcorper nulla non metus auctor fringilla.
Ás veces non se poden aplicar clases de énfase debido á especificidade doutro selector. Na maioría dos casos, unha solución suficiente é envolver o texto nunha <span>
clase coa clase.
Usar cor para engadir significado só proporciona unha indicación visual, que non se transmitirá aos usuarios de tecnoloxías auxiliares, como lectores de pantalla. Asegúrese de que a información indicada pola cor sexa obvia desde o propio contido (as cores contextuais só se usan para reforzar o significado que xa está presente no texto/marcado) ou se inclúe a través de medios alternativos, como o texto adicional oculto coa .sr-only
clase. .
Semellante ás clases de cor de texto contextual, establece facilmente o fondo dun elemento para calquera clase contextual. Os compoñentes da ancoraxe escureceranse ao pasar o cursor, igual que as clases de texto.
Nullam id dolor id nibh ultricies vehicula ut id elit.
Duis mollis, is non commodo luctus, nisi erat porttitor ligula.
Maecenas sed diam eget risus varius blandit sit amet non magna.
Etiam porta sem malesuada magna mollis euismod.
Donec ullamcorper nulla non metus auctor fringilla.
Ás veces non se poden aplicar clases de fondo contextuais debido á especificidade doutro selector. Nalgúns casos, unha solución suficiente é envolver o contido do elemento nunha <div>
clase coa clase.
Do mesmo xeito que coas cores contextuais , asegúrate de que calquera significado transmitido a través da cor tamén se transmita nun formato que non sexa meramente de presentación.
Usa a icona de peche xenérico para descartar contido como modais e alertas.
Use os cursores para indicar a función e a dirección do menú despregable. Teña en conta que o cursor predeterminado invertirase automaticamente nos menús despregables .
Fai flotar un elemento á esquerda ou á dereita cunha clase. !important
inclúese para evitar problemas de especificidade. As clases tamén se poden usar como mixins.
Establece un elemento display: block
e centralo mediante margin
. Dispoñible como mixin e clase.
Borra s facilmente float
engadindo .clearfix
ao elemento principal . Utiliza o micro clearfix popularizado por Nicolas Gallagher. Tamén se pode usar como mestura.
Forzar un elemento a mostrarse ou ocultarse ( incluído para lectores de pantalla ) co uso de .show
e .hidden
clases. Estas clases úsanse !important
para evitar conflitos de especificidade, igual que os flotantes rápidos . Só están dispoñibles para cambiar o nivel de bloque. Tamén se poden usar como mixins.
.hide
está dispoñible, pero non sempre afecta aos lectores de pantalla e está en desuso a partir da v3.0.1. Use .hidden
ou .sr-only
no seu lugar.
Ademais, .invisible
pódese usar para cambiar só a visibilidade dun elemento, o que significa display
que non se modifica e que o elemento aínda pode afectar o fluxo do documento.
Ocultar un elemento a todos os dispositivos excepto aos lectores de pantalla con .sr-only
. Combínalo .sr-only
con .sr-only-focusable
para mostrar o elemento de novo cando estea enfocado (por exemplo, por un usuario só con teclado). Necesario para seguir as mellores prácticas de accesibilidade . Tamén se pode usar como mixins.
Use a .text-hide
clase ou mixin para axudar a substituír o contido do texto dun elemento por unha imaxe de fondo.
Para un desenvolvemento máis rápido para móbiles, utiliza estas clases de utilidade para mostrar e ocultar contido por dispositivo mediante consulta multimedia. Tamén se inclúen clases de utilidade para alternar o contido cando se imprime.
Tenta utilizalos de forma limitada e evita crear versións completamente diferentes do mesmo sitio. En cambio, utilízaos para complementar a presentación de cada dispositivo.
Use unha única ou unha combinación das clases dispoñibles para alternar o contido entre os puntos de interrupción das vistas.
Dispositivos extra pequenosTeléfonos (<768px) | Pequenos dispositivosTabletas (≥768 px) | Dispositivos medianosEscritorios (≥992 px) | Dispositivos grandesEscritorios (≥1200px) | |
---|---|---|---|---|
.visible-xs-* |
Visible | Oculto | Oculto | Oculto |
.visible-sm-* |
Oculto | Visible | Oculto | Oculto |
.visible-md-* |
Oculto | Oculto | Visible | Oculto |
.visible-lg-* |
Oculto | Oculto | Oculto | Visible |
.hidden-xs |
Oculto | Visible | Visible | Visible |
.hidden-sm |
Visible | Oculto | Visible | Visible |
.hidden-md |
Visible | Visible | Oculto | Visible |
.hidden-lg |
Visible | Visible | Visible | Oculto |
A partir da versión 3.2.0, as .visible-*-*
clases para cada punto de interrupción teñen tres variacións, unha para cada display
valor de propiedade CSS que se indica a continuación.
Grupo de clases | CSSdisplay |
---|---|
.visible-*-block |
display: block; |
.visible-*-inline |
display: inline; |
.visible-*-inline-block |
display: inline-block; |
Así, para as pantallas extra pequenas ( xs
), por exemplo, as .visible-*-*
clases dispoñibles son: .visible-xs-block
, .visible-xs-inline
, e .visible-xs-inline-block
.
As clases .visible-xs
, .visible-sm
, .visible-md
, e .visible-lg
tamén existen, pero están en desuso a partir da v3.2.0 . Son aproximadamente equivalentes a .visible-*-block
, excepto con casos especiais adicionais para os <table>
elementos relacionados con alternar.
Do mesmo xeito que as clases responsive habituais, úsaas para cambiar o contido para imprimir.
Clases | Navegador | Imprimir |
---|---|---|
.visible-print-block .visible-print-inline .visible-print-inline-block |
Oculto | Visible |
.hidden-print |
Visible | Oculto |
A clase .visible-print
tamén existe pero está obsoleta a partir da v3.2.0. É aproximadamente equivalente a .visible-print-block
, excepto con casos especiais adicionais para <table>
elementos relacionados.
Cambia o tamaño do teu navegador ou carga en diferentes dispositivos para probar as clases de utilidade receptivas.
As marcas de verificación verdes indican que o elemento está visible na túa ventana gráfica actual.
Aquí, as marcas de verificación verdes tamén indican que o elemento está oculto na túa ventana gráfica actual.
O CSS de Bootstrap está construído sobre Less, un preprocesador con funcionalidades adicionais como variables, mixins e funcións para compilar CSS. Aqueles que queiran usar os ficheiros de Less fonte en lugar dos nosos ficheiros CSS compilados poden facer uso das numerosas variables e mixins que usamos en todo o framework.
As variables de reixa e as mesturas están tratadas na sección Sistema de reixa .
Bootstrap pódese usar polo menos de dous xeitos: co CSS compilado ou cos ficheiros Less fonte. Para compilar os ficheiros Less, consulte a sección Introdución para saber como configurar o seu contorno de desenvolvemento para executar os comandos necesarios.
As ferramentas de compilación de terceiros poden funcionar con Bootstrap, pero o noso equipo principal non as admite.
As variables utilízanse ao longo de todo o proxecto como unha forma de centralizar e compartir valores de uso habitual como cores, espazos ou pilas de fontes. Para obter un desglose completo, consulta o Personalizador .
Use facilmente dous esquemas de cores: escala de grises e semántica. As cores en escala de grises proporcionan un acceso rápido aos tons de negro de uso habitual, mentres que as semánticas inclúen varias cores asignadas a valores contextuais significativos.
Usa algunha destas variables de cor tal e como son ou reasignalas a variables máis significativas para o teu proxecto.
Un puñado de variables para personalizar rapidamente os elementos clave do esqueleto do teu sitio.
Crea facilmente as túas ligazóns coa cor correcta cun só valor.
Teña en conta que @link-hover-color
usa unha función, outra ferramenta fantástica de Less, para crear automaticamente a cor correcta. Podes usar darken
, lighten
, saturate
e desaturate
.
Establece facilmente o tipo de letra, o tamaño do texto, o interlineado e moito máis con algunhas variables rápidas. Bootstrap tamén fai uso destes para proporcionar mesturas tipográficas sinxelas.
Dúas variables rápidas para personalizar a localización e o nome do ficheiro das túas iconas.
Os compoñentes de Bootstrap fan uso dalgunhas variables predeterminadas para establecer valores comúns. Aquí están os máis utilizados.
Os mixins de provedores son mixins para axudar a admitir varios navegadores incluíndo todos os prefixos de provedores relevantes no teu CSS compilado.
Restablece o modelo da caixa dos teus compoñentes cunha única mestura. Para obter contexto, consulta este útil artigo de Mozilla .
O mixin está obsoleto a partir da v3.2.0, coa introdución do Autoprefixer. Para preservar a compatibilidade con versións anteriores, Bootstrap continuará usando o mixin internamente ata Bootstrap v4.
Hoxe todos os navegadores modernos admiten a border-radius
propiedade sen prefixos. Polo tanto, non hai .border-radius()
mestura, pero Bootstrap inclúe atallos para redondear rapidamente dúas esquinas nun lado concreto dun obxecto.
Se o teu público obxectivo está a usar os navegadores e dispositivos máis recentes e mellores, asegúrate de usar só a box-shadow
propiedade. Se necesitas compatibilidade con dispositivos Android (anteriores á versión 4) e iOS (anteriores a iOS 5), utiliza o mixin obsoleto para recoller o -webkit
prefixo necesario.
O mixin está obsoleto a partir da versión 3.1.0, xa que Bootstrap non admite oficialmente as plataformas obsoletas que non admiten a propiedade estándar. Para preservar a compatibilidade con versións anteriores, Bootstrap continuará usando o mixin internamente ata Bootstrap v4.
Asegúrate de usar rgba()
cores nas sombras das túas caixas para que se combinen o máis perfectamente posible cos fondos.
Múltiples mixins para flexibilidade. Establece toda a información de transición cun único ou especifique un atraso e unha duración separados segundo sexa necesario.
Os mixins quedan obsoletos a partir da v3.2.0, coa introdución do Autoprefixer. Para preservar a compatibilidade con versións anteriores, Bootstrap continuará usando os mixins internamente ata Bootstrap v4.
Xira, escala, traduce (move) ou sesga calquera obxecto.
Os mixins quedan obsoletos a partir da v3.2.0, coa introdución do Autoprefixer. Para preservar a compatibilidade con versións anteriores, Bootstrap continuará usando os mixins internamente ata Bootstrap v4.
Un único mixin para usar todas as propiedades de animación de CSS3 nunha declaración e outros mixins para propiedades individuais.
Os mixins quedan obsoletos a partir da v3.2.0, coa introdución do Autoprefixer. Para preservar a compatibilidade con versións anteriores, Bootstrap continuará usando os mixins internamente ata Bootstrap v4.
Establece a opacidade para todos os navegadores e proporciona unha filter
alternativa para IE8.
Proporcione contexto para os controis de formulario dentro de cada campo.
Xera columnas mediante CSS dentro dun único elemento.
Converte facilmente dúas cores calquera nun degradado de fondo. Avanza e define unha dirección, usa tres cores ou usa un degradado radial. Cunha única mestura obterás todas as sintaxes prefixadas que necesitarás.
Tamén pode especificar o ángulo dun degradado lineal estándar de dúas cores:
Se necesitas un degradado de estilo barbeiro, tamén é sinxelo. Só ten que especificar unha única cor e superpoñeremos unha franxa branca translúcida.
Sube a aposta e usa tres cores no seu lugar. Establece a primeira cor, a segunda cor, a parada de cor da segunda cor (un valor porcentual como o 25 %) e a terceira cor con estas mesturas:
Aviso! Se algunha vez necesitas eliminar un degradado, asegúrate de eliminar calquera elemento específico de IE filter
que poidas engadir. Podes facelo usando o .reset-filter()
mixin xunto a background-image: none;
.
Os mixins de utilidade son mixins que combinan propiedades CSS non relacionadas para acadar un obxectivo ou tarefa específica.
Esqueza engadir class="clearfix"
a calquera elemento e, no seu lugar, engade o .clearfix()
mixin onde corresponda. Usa o micro clearfix de Nicolas Gallagher .
Centra rapidamente calquera elemento dentro do seu pai. Requírese width
ou max-width
a configurar.
Especifica máis facilmente as dimensións dun obxecto.
Configure facilmente as opcións de cambio de tamaño para calquera área de texto ou calquera outro elemento. O comportamento predeterminado do navegador é normal ( both
).
Trunca facilmente o texto cunha elipsis cunha única mestura. Require elemento para ser block
ou inline-block
nivel.
Especifique dúas rutas de imaxe e as dimensións da imaxe @1x, e Bootstrap proporcionará unha consulta multimedia @2x. Se tes moitas imaxes para publicar, considera escribir a túa imaxe CSS de retina manualmente nunha única consulta multimedia.
Aínda que Bootstrap está construído en Less, tamén ten un porto Sass oficial . Mantémolo nun repositorio GitHub separado e xestionamos as actualizacións cun script de conversión.
Dado que o porto de Sass ten un repositorio separado e atende a un público lixeiramente diferente, o contido do proxecto difire moito do proxecto principal de Bootstrap. Isto garante que o porto Sass sexa o máis compatible con tantos sistemas baseados en Sass como sexa posible.
Camiño | Descrición |
---|---|
lib/ |
Código de xema Ruby (configuración Sass, integracións Rails e Compass) |
tasks/ |
Scripts de conversión (conversión de Less a Sass) |
test/ |
Probas de compilación |
templates/ |
Manifesto do paquete de compás |
vendor/assets/ |
Sass, JavaScript e ficheiros de fontes |
Rakefile |
Tarefas internas, como rastrexar e converter |
Visita o repositorio de GitHub do porto Sass para ver estes ficheiros en acción.
Para obter información sobre como instalar e usar Bootstrap para Sass, consulte o readme do repositorio de GitHub . É a fonte máis actualizada e inclúe información para usar con Rails, Compass e proxectos estándar de Sass.