Navs
Documentación e exemplos de como usar os compoñentes de navegación incluídos en Bootstrap.
Navegación base
A navegación dispoñible en Bootstrap comparte estilos e marcas xerais, desde a .nav
clase base ata os estados activo e desactivado. Cambia as clases modificadoras para cambiar entre cada estilo.
O .nav
compoñente base está construído con flexbox e proporciona unha base sólida para construír todo tipo de compoñentes de navegación. Inclúe algunhas substitucións de estilo (para traballar con listas), algúns recheos de ligazóns para áreas de acceso máis grandes e estilos básicos desactivados.
O .nav
compoñente base non inclúe ningún .active
estado. Os seguintes exemplos inclúen a clase, principalmente para demostrar que esta clase en particular non activa ningún estilo especial.
As clases úsanse en todas partes, polo que o teu marcado pode ser moi flexible. Usa <ul>
s como a anterior, <ol>
se a orde dos teus artigos é importante, ou tira o teu propio cun <nav>
elemento. Debido a que .nav
usa display: flex
, as ligazóns de navegación se comportan do mesmo xeito que os elementos de navegación, pero sen o marcado adicional.
Estilos dispoñibles
Cambia o estilo do .nav
compoñente s con modificadores e utilidades. Mestura e combina segundo sexa necesario ou crea o teu propio.
Aliñación horizontal
Cambia a aliñación horizontal do teu navegador coas utilidades flexbox . De xeito predeterminado, os navegadores están aliñados á esquerda, pero podes cambialos facilmente ao centro ou á dereita.
Centrado con .justify-content-center
:
Aliñado á dereita con .justify-content-end
:
Vertical
Empile a súa navegación cambiando a dirección do elemento flexible coa .flex-column
utilidade. Necesitas apilalos nalgunhas vistas pero non noutras? Use as versións sensibles (por exemplo, .flex-sm-column
).
Como sempre, a navegación vertical <ul>
tamén é posible sen s.
Fichas
Toma o navegador básico desde arriba e engade a .nav-tabs
clase para xerar unha interface con pestanas. Utilízaos para crear rexións tabulables co noso complemento JavaScript de pestanas .
Pastillas
Tome o mesmo HTML, pero use no seu .nav-pills
lugar:
Enche e xustifica
Forza o teu .nav
contido a estender o ancho total dispoñible nunha das dúas clases de modificadores. Para encher proporcionalmente todo o espazo dispoñible cos teus .nav-item
, usa .nav-fill
. Teña en conta que todo o espazo horizontal está ocupado, pero non todos os elementos de navegación teñen o mesmo ancho.
Ao usar unha <nav>
navegación baseada en -, pode omitir con seguridade .nav-item
xa que só .nav-link
é necesario para os elementos de estilo <a>
.
Para elementos de igual ancho, use .nav-justified
. Todo o espazo horizontal estará ocupado por ligazóns de navegación, pero a diferenza do .nav-fill
anterior, todos os elementos de navegación terán o mesmo ancho.
Similar ao .nav-fill
exemplo usando unha <nav>
navegación baseada en -.
Traballando con utilidades flexibles
Se necesitas variacións de navegación sensibles, considera usar unha serie de utilidades flexbox . Aínda que son máis detalladas, estas utilidades ofrecen unha maior personalización en puntos de interrupción sensibles. No seguinte exemplo, a nosa navegación apilarase no punto de interrupción máis baixo e, a continuación, adaptarase a un deseño horizontal que enche o ancho dispoñible a partir do punto de interrupción pequeno.
En canto á accesibilidade
Se estás a usar navs para proporcionar unha barra de navegación, asegúrate de engadir un role="navigation"
ao contenedor principal máis lóxico do <ul>
, ou envolver un <nav>
elemento ao redor de toda a navegación. Non engadas o papel ao <ul>
propio, xa que isto evitaría que sexa anunciado como unha lista real polas tecnoloxías de asistencia.
Teña en conta que as barras de navegación, aínda que teñan un estilo visual como pestanas coa .nav-tabs
clase, non se deben dar nin atributos. Estes só son apropiados para interfaces dinámicas con pestanas, como se describe nas prácticas de creación de WAI ARIA . Consulte o comportamento de JavaScript para interfaces con pestanas dinámicas nesta sección para obter un exemplo.role="tablist"
role="tab"
role="tabpanel"
Usando menú despregable
Engade menús despregables cun HTML extra e o complemento JavaScript para menús despregables .
Pestanas con menú despregable
Pastillas con menú despregable
Comportamento de JavaScript
Use o complemento de JavaScript de pestanas (inclúeo individualmente ou a través do bootstrap.js
ficheiro compilado) para ampliar as nosas pestanas e pílulas de navegación para crear paneis de contido local con pestanas, mesmo a través de menús despregábeis.
Se estás construíndo o noso JavaScript desde a orixe, requireutil.js
.
As interfaces dinámicas con pestanas, tal e como se describen nas prácticas de creación de WAI ARIA , requiren role="tablist"
, role="tab"
, role="tabpanel"
, e aria-
atributos adicionais para transmitir a súa estrutura, funcionalidade e estado actual aos usuarios de tecnoloxías de asistencia (como lectores de pantalla).
Teña en conta que as interfaces dinámicas con pestanas non deben conter menús despregables, xa que isto provoca problemas de usabilidade e accesibilidade. Desde a perspectiva da usabilidade, o feito de que o elemento activador da pestana que se amosa actualmente non estea inmediatamente visible (xa que está dentro do menú despregable pechado) pode causar confusión. Desde o punto de vista da accesibilidade, actualmente non hai unha forma sensata de asignar este tipo de construción a un patrón WAI ARIA estándar, o que significa que non se pode facer facilmente comprensible para os usuarios de tecnoloxías de asistencia.
Denim cru que probablemente non escoitou falar deles shorts de jeans Austin. Nesciunt tofu stumptown aliqua, sintetizador retro cleanse. Bigote cliché tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Para axudarche a atender ás túas necesidades, isto funciona con <ul>
marcas baseadas en -, como se mostra arriba, ou con calquera marcaxe arbitraria "roll your own". Teña en conta que se está a usar <nav>
, non debe engadir role="tablist"
directamente a el, xa que isto anularía o papel nativo do elemento como punto de referencia de navegación. En vez diso, cambia a un elemento alternativo (no exemplo de abaixo, un simple <div>
) e envolve o elemento <nav>
.
O complemento tabs tamén funciona con pílulas.
Consequat occaecat ullamco amet non eiusmod nostrud dolore irure incididunt est duis anim sunt officia. Fugiat velit proident aliquip nisi incididunt nostrud exercitation proident est nisi. Irure magna elit commodo anim ex veniam culpa eiusmod id nostrud sit cupidatat in veniam ad. Eiusmod consequat eu adipisicing minim anim aliquip cupidatat culpa excepteur quis. Occaecat sit eu exercitation irure Lorem incididunt nostrud.
Ad pariatur nostrud pariatur exercitation ipsum ipsum culpa mollit commodo mollit ex. Aute sunt incididunt amet commodo est sint nisi deserunt pariatur do. Aliquip ex eiusmod voluptate exercitation cillum id incididunt elit sunt. Qui minim sit magna Lorem id et dolore velit Lorem amet exercitation duis deserunt. Anim id labore elit adipisicing ut in id occaecat pariatur ut ullamco ea tempor duis.
Est quis nulla laborum officia ad nisi ex nostrud culpa Lorem excepteur aliquip dolor aliqua irure ex. Nulla ut duis ipsum nisi elit fugiat commodo sunt reprehenderit laborum veniam eu veniam. Eiusmod minim exercitation fugiat irure ex labore incididunt do fugiat commodo aliquip sit id deserunt reprehenderit aliquip nostrud. Amet ex cupidatat excepteur aute veniam incididunt mollit cupidatat esse irure officia elit do ipsum ullamco Lorem. Ullamco ut ad minim do mollit labore ipsum laboris ipsum commodo sunt tempor enim incididunt. Commodo quis sunt dolore aliquip aute tempor irure magna enim minim reprehenderit. Ullamco consectetur culpa veniam sint cillum aliqua incididunt velit ullamco sunt ullamco quis quis commodo voluptate. Mollit nulla nostrud adipisicing aliqua cupidatat aliqua pariatur mollit voluptate voluptate consequat non.
E con pastillas verticais.
Cillum ad ut irure tempor velit nostrud occaecat ullamco aliqua anim Lorem sint. Veniam sint duis incididunt do esse magna mollit excepteur laborum qui. Id id reprehenderit sit est eu aliqua occaecat quis et velit excepteur laborum mollit dolore eiusmod. Ipsum dolor in occaecat commodo e voluptate minim reprehenderit mollit pariatur. Deserunt non laborum enim et cillum eu deserunt excepteur ea incididunt minim occaecat.
Culpa dolor voluptate do laboris laboris irure reprehenderit id incididunt duis pariatur mollit aute magna pariatur consectetur. Eu veniam duis non ut dolor deserunt commodo et minim in quis laboris ipsum velit id veniam. Quis ut consectetur adipisicing officia excepteur non sit. Ut et elit aliquip labore Lorem enim eu. Ullamco mollit occaecat dolore ipsum id officia mollit qui esse anim eiusmod do sint minim consectetur qui.
Fugiat id quis dolor culpa eiusmod anim velit excepteur proident dolor aute qui magna. Ad proident laboris ullamco esse anim Lorem Lorem veniam quis Lorem irure occaecat velit nostrud magna nulla. Velit et et proident Lorem do ea tempor officia dolor. Reprehenderit Lorem aliquip labore est magna commodo est ea veniam consectetur.
Eu dolore ea ullamco dolore Lorem id cupidatat excepteur reprehenderit consectetur elit id dolor proident in cupidatat officia. Voluptate excepteur commodo labore nisi cillum duis aliqua do. Aliqua amet qui mollit consectetur nulla mollit velit aliqua veniam nisi id do Lorem deserunt amet. Culpa ullamco sit adipisicing labore officia magna elit nisi in aute tempor commodo eiusmod.
Usando atributos de datos
Podes activar unha navegación por pestanas ou pílulas sen escribir JavaScript simplemente especificando data-toggle="tab"
ou data-toggle="pill"
nun elemento. Use estes atributos de datos en .nav-tabs
ou .nav-pills
.
Vía JavaScript
Activa as pestanas con tabulacións a través de JavaScript (cada pestana debe activarse individualmente):
Podes activar pestanas individuais de varias maneiras:
Efecto de desvanecemento
Para que as pestanas se desvanezan, engade .fade
a cada unha .tab-pane
. O primeiro panel de pestanas tamén debe .show
facer visible o contido inicial.
Métodos
Métodos asíncronos e transicións
Todos os métodos da API son asíncronos e inician unha transición . Volven ao interlocutor en canto se inicia a transición pero antes de que remate . Ademais, ignorarase unha chamada de método nun compoñente en transición .
Consulte a nosa documentación de JavaScript para obter máis información .
$().tab
Activa un elemento de pestana e un contenedor de contido. A pestana debería ter un nodo de contedores data-target
ou un href
nodo de destino no DOM.
.tab('mostrar')
Selecciona a pestana indicada e mostra o seu panel asociado. Calquera outra pestana que se seleccionase anteriormente non se selecciona e o seu panel asociado queda oculto. Volve ao interlocutor antes de que se amosara o panel de pestanas (é dicir, antes de shown.bs.tab
que se produza o evento).
.tab('eliminar')
Destrúe a pestana dun elemento.
Eventos
Cando se mostra unha nova pestana, os eventos desenvólvense na seguinte orde:
hide.bs.tab
(na pestana activa actual)show.bs.tab
(na pestana por mostrar)hidden.bs.tab
(na pestana activa anterior, a mesma que para ohide.bs.tab
evento)shown.bs.tab
(na pestana que acaba de mostrarse activa, a mesma que para oshow.bs.tab
evento)
Se xa non estaba activa ningunha pestana, os eventos hide.bs.tab
e hidden.bs.tab
non se activarán.
Tipo de evento | Descrición |
---|---|
mostrar.bs.tab | Este evento desenvólvese na mostra de pestanas, pero antes de que se mostrase a nova pestana. Use event.target e event.relatedTarget para apuntar á pestana activa e á pestana activa anterior (se está dispoñible) respectivamente. |
mostrado.bs.tab | Este evento desenvólvese na mostra de pestanas despois de que se mostrase unha pestana. Use event.target e event.relatedTarget para apuntar á pestana activa e á pestana activa anterior (se está dispoñible) respectivamente. |
ocultar.bs.tab | Este evento desenvólvese cando se quere mostrar unha nova pestana (e, polo tanto, debe ocultarse a pestana activa anterior). Use event.target e event.relatedTarget para orientar a pestana activa actual e a nova pestana que estará activa en breve, respectivamente. |
hidden.bs.tab | Este evento desenvólvese despois de que se amose unha nova pestana (e polo tanto se oculta a pestana activa anterior). Use event.target e event.relatedTarget para apuntar á pestana activa anterior e á nova pestana activa, respectivamente. |