Navs
Documentació i exemples sobre com utilitzar els components de navegació inclosos de Bootstrap.
Navegació base
La navegació disponible a Bootstrap comparteix estils i marques generals, des de la .nav
classe base fins als estats actiu i desactivat. Canvia les classes modificadores per canviar entre cada estil.
El .nav
component base està construït amb flexbox i proporciona una base sòlida per construir tot tipus de components de navegació. Inclou algunes substitucions d'estil (per treballar amb llistes), algun farciment d'enllaços per a àrees de visita més grans i un estil bàsic desactivat.
El .nav
component base no inclou cap .active
estat. Els exemples següents inclouen la classe, principalment per demostrar que aquesta classe en particular no activa cap estil especial.
Les classes s'utilitzen a tot arreu, de manera que el vostre marcatge pot ser molt flexible. Utilitzeu <ul>
s com l'anterior, <ol>
si l'ordre dels vostres articles és important, o feu servir el vostre amb un <nav>
element. Com que .nav
s'utilitza display: flex
, els enllaços de navegació es comporten igual que els elements de navegació, però sense el marcatge addicional.
Estils disponibles
Canvieu l'estil del .nav
component s amb modificadors i utilitats. Barreja i combina segons sigui necessari, o crea el teu.
Alineació horitzontal
Canvieu l'alineació horitzontal del vostre navegador amb les utilitats flexbox . De manera predeterminada, els navegadors estan alineats a l'esquerra, però podeu canviar-los fàcilment al centre o a la dreta.
Centrat amb .justify-content-center
:
Alineat a la dreta amb .justify-content-end
:
Vertical
Apila la teva navegació canviant la direcció de l'element flexible amb la .flex-column
utilitat. Necessites apilar-los en algunes finestres, però no en altres? Utilitzeu les versions responsives (p. ex., .flex-sm-column
).
Com sempre, la navegació vertical també és possible sense <ul>
s.
Pestanyes
Agafa el navegador bàsic des de dalt i afegeix la .nav-tabs
classe per generar una interfície amb pestanyes. Utilitzeu-los per crear regions tabulables amb el nostre connector de JavaScript de pestanya .
Píndoles
Agafeu el mateix HTML, però feu servir .nav-pills
:
Omplir i justificar
Força el teu .nav
contingut a ampliar l'amplada total disponible una de les dues classes modificadores. Per omplir proporcionalment tot l'espai disponible amb els vostres .nav-item
, feu servir .nav-fill
. Observeu que tot l'espai horitzontal està ocupat, però no tots els elements de navegació tenen la mateixa amplada.
Quan utilitzeu una <nav>
navegació basada en -, assegureu-vos d'incloure .nav-item
a les àncores.
Per a elements d'amplada igual, utilitzeu .nav-justified
. Tot l'espai horitzontal estarà ocupat per enllaços de navegació, però a diferència de l' .nav-fill
anterior, tots els elements de navegació tindran la mateixa amplada.
De la mateixa manera que l' .nav-fill
exemple amb una <nav>
navegació basada en -, assegureu-vos d'incloure-hi .nav-item
als ancoratges.
Treballant amb utilitats flexibles
Si necessiteu variacions de navegació sensibles, penseu a utilitzar una sèrie d' utilitats de flexbox . Tot i que són més detallades, aquestes utilitats ofereixen una personalització més gran en els punts d'interrupció sensibles. A l'exemple següent, el nostre navegador s'apilarà al punt d'interrupció més baix, i després s'adaptarà a un disseny horitzontal que ompli l'amplada disponible a partir del punt d'interrupció petit.
Pel que fa a l'accessibilitat
Si utilitzeu navs per proporcionar una barra de navegació, assegureu-vos d'afegir una role="navigation"
al contenidor principal més lògic del fitxer <ul>
, o embolicar un <nav>
element al voltant de tota la navegació. No afegiu el paper al <ul>
mateix, ja que això evitaria que s'anunciés com una llista real per les tecnologies d'assistència.
Tingueu en compte que les barres de navegació, encara que tinguin un estil visual com a pestanyes amb la .nav-tabs
classe, norole="tablist"
s'han de donar role="tab"
ni role="tabpanel"
atributs. Aquests només són adequats per a interfícies de pestanyes dinàmiques, tal com es descriu a les Pràctiques d'autoria WAI ARIA . Vegeu el comportament de JavaScript per a interfícies de pestanyes dinàmiques en aquesta secció per obtenir un exemple.
Utilitzant menús desplegables
Afegiu menús desplegables amb una mica d'HTML addicional i el complement de JavaScript dels desplegables .
Pestanyes amb desplegables
Píndoles amb desplegables
Comportament de JavaScript
Utilitzeu el connector de JavaScript de la pestanya (incloeu-lo individualment o mitjançant el bootstrap.js
fitxer compilat) per ampliar les nostres pestanyes i píndoles de navegació per crear panells amb pestanyes de contingut local, fins i tot mitjançant menús desplegables.
Si esteu creant el nostre JavaScript des de la font, requereixutil.js
.
Les interfícies de pestanyes dinàmiques, tal com es descriuen a les Pràctiques d'autoria WAI ARIA , requereixen role="tablist"
, role="tab"
, role="tabpanel"
, i aria-
atributs addicionals per tal de transmetre la seva estructura, funcionalitat i estat actual als usuaris de tecnologies d'assistència (com ara lectors de pantalla).
Tingueu en compte que les interfícies de pestanyes dinàmiques no haurien de contenir menús desplegables, ja que això provoca problemes d'usabilitat i d'accessibilitat. Des d'una perspectiva d'usabilitat, el fet que l'element activador de la pestanya que es mostra actualment no sigui visible immediatament (ja que es troba dins del menú desplegable tancat) pot causar confusió. Des del punt de vista de l'accessibilitat, actualment no hi ha cap manera sensata de mapar aquest tipus de construcció amb un patró WAI ARIA estàndard, el que significa que no es pot fer fàcilment entenedor per als usuaris de tecnologies d'assistència.
Denim cru, probablement no has sentit parlar d'ells, Austin. Nesciunt tofu stumptown aliqua, neteja mestre de sintetitzadors retro. Mustache cliche tempor, williamsburg carles vegan helvetica. Rerehenderit 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.
Per ajudar-vos a adaptar-vos a les vostres necessitats, això funciona amb un <ul>
marcatge basat en -, com es mostra més amunt, o amb qualsevol marcatge arbitrari "roll your own". Tingueu en compte que si feu servir <nav>
, no hi hauríeu d'afegir-hi role="tablist"
directament, ja que això anul·laria la funció nativa de l'element com a punt de referència de navegació. En lloc d'això, canvieu a un element alternatiu (a l'exemple següent, un simple <div>
) i envolteu <nav>
-lo.
El connector de pestanyes també funciona amb píndoles.
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.
I amb pastilles verticals.
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 et 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.
Ús d'atributs de dades
Podeu activar una navegació de pestanyes o píndoles sense escriure cap JavaScript simplement especificant data-toggle="tab"
o data-toggle="pill"
en un element. Utilitzeu aquests atributs de dades a .nav-tabs
o .nav-pills
.
Mitjançant JavaScript
Activa les pestanyes amb tabulació mitjançant JavaScript (cada pestanya s'ha d'activar individualment):
Podeu activar pestanyes individuals de diverses maneres:
Efecte esvaït
Per fer que les pestanyes s'esvaeixin, afegiu .fade
-les a cadascuna .tab-pane
. El primer panell de pestanyes també ha .show
de fer visible el contingut inicial.
Mètodes
Mètodes asíncrons i transicions
Tots els mètodes de l'API són asíncrons i comencen una transició . Tornen a la persona que truca tan bon punt s'inicia la transició però abans que acabi . A més, s'ignorarà una trucada de mètode en un component en transició .
Consulteu la nostra documentació de JavaScript per obtenir més informació .
$().tab
Activa un element de pestanya i un contenidor. La pestanya hauria de tenir un node de contenidor data-target
o una href
orientació al DOM.
.tab('mostrar')
Selecciona la pestanya donada i mostra el seu panell associat. Qualsevol altra pestanya que s'hagi seleccionat anteriorment es desactiva i el seu panell associat s'amaga. Torna a la persona que truca abans que s'hagi mostrat realment el panell de pestanyes (és a dir, abans shown.bs.tab
que es produeixi l'esdeveniment).
.tab('eliminar')
Destrueix la pestanya d'un element.
Esdeveniments
Quan es mostra una pestanya nova, els esdeveniments es desencadenen en l'ordre següent:
hide.bs.tab
(a la pestanya activa actual)show.bs.tab
(a la pestanya per mostrar)hidden.bs.tab
(a la pestanya activa anterior, la mateixa que per a l'hide.bs.tab
esdeveniment)shown.bs.tab
(a la pestanya recentment activa que s'acaba de mostrar, la mateixa que per a l'show.bs.tab
esdeveniment)
Si no hi havia cap pestanya activa, els esdeveniments hide.bs.tab
i hidden.bs.tab
no s'activaran.
Tipus d'esdeveniment | Descripció |
---|---|
mostrar.bs.tab | Aquest esdeveniment s'activa a la pestanya mostra, però abans que s'hagi mostrat la nova pestanya. Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa i la pestanya activa anterior (si està disponible) respectivament. |
pestanya.bs.mostrada | Aquest esdeveniment s'activa a la mostra de pestanyes després que s'hagi mostrat una pestanya. Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa i la pestanya activa anterior (si està disponible) respectivament. |
ocultar.bs.tab | Aquest esdeveniment s'activa quan s'ha de mostrar una pestanya nova (i, per tant, s'ha d'amagar la pestanya activa anterior). Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa actual i la nova pestanya que s'activarà aviat, respectivament. |
hidden.bs.tab | Aquest esdeveniment s'activa després que es mostri una pestanya nova (i, per tant, s'amaga la pestanya activa anterior). Utilitzeu event.target i event.relatedTarget per orientar la pestanya activa anterior i la nova pestanya activa, respectivament. |