navi
Documentazione ed esempi su come utilizzare i componenti di navigazione inclusi in Bootstrap.
nav di base
La navigazione disponibile in Bootstrap condivide il markup e gli stili generali, dalla .nav
classe base agli stati attivo e disabilitato. Scambia le classi di modificatori per passare da uno stile all'altro.
Il .nav
componente di base è costruito con flexbox e fornisce una solida base per la costruzione di tutti i tipi di componenti di navigazione. Include alcune sostituzioni di stile (per lavorare con gli elenchi), alcuni spazi di riempimento dei collegamenti per aree di successo più grandi e uno stile disabilitato di base.
Il .nav
componente di base non include alcuno .active
stato. Gli esempi seguenti includono la classe, principalmente per dimostrare che questa particolare classe non attiva alcuno stile speciale.
Le lezioni vengono utilizzate ovunque, quindi il tuo markup può essere super flessibile. Usa <ul>
s come sopra, <ol>
se l'ordine dei tuoi articoli è importante, o arrotola il tuo con un <nav>
elemento. Poiché .nav
utilizza display: flex
, i collegamenti di navigazione si comportano come farebbero gli elementi di navigazione, ma senza il markup aggiuntivo.
Stili disponibili
Cambia lo stile del .nav
componente s con modificatori e utilità. Mescola e abbina secondo necessità o creane uno tuo.
Allineamento orizzontale
Modifica l'allineamento orizzontale del tuo navigatore con le utility flexbox . Per impostazione predefinita, i nav sono allineati a sinistra, ma puoi facilmente cambiarli al centro o allineati a destra.
Centrato con .justify-content-center
:
Allineato a destra con .justify-content-end
:
Verticale
Impila la tua navigazione cambiando la direzione dell'elemento flessibile con l' .flex-column
utilità. Hai bisogno di impilarli su alcune finestre ma non su altre? Utilizzare le versioni reattive (ad es .flex-sm-column
. ).
Come sempre, la navigazione verticale è possibile <ul>
anche senza s.
Schede
Prende la navigazione di base dall'alto e aggiunge la .nav-tabs
classe per generare un'interfaccia a schede. Usali per creare regioni tabbable con il nostro plug-in JavaScript per schede .
Pillole
Prendi lo stesso HTML, ma usa .nav-pills
invece:
Riempi e giustifica
Forza il .nav
contenuto di ' per estendere l'intera larghezza disponibile di una delle due classi di modificatori. Per riempire proporzionalmente tutto lo spazio disponibile con .nav-item
i tuoi messaggi di posta elettronica, usa .nav-fill
. Si noti che tutto lo spazio orizzontale è occupato, ma non tutti gli elementi di navigazione hanno la stessa larghezza.
Quando si utilizza una <nav>
navigazione basata su, è possibile omettere in sicurezza .nav-item
poiché .nav-link
è richiesto solo per <a>
gli elementi di stile.
Per elementi di uguale larghezza, utilizzare .nav-justified
. Tutto lo spazio orizzontale sarà occupato dai collegamenti di navigazione, ma a differenza di quanto .nav-fill
sopra, ogni elemento di navigazione avrà la stessa larghezza.
Simile .nav-fill
all'esempio che utilizza una <nav>
navigazione basata su.
Lavorare con utility flessibili
Se hai bisogno di variazioni di navigazione reattive, prendi in considerazione l'utilizzo di una serie di utilità flexbox . Sebbene più dettagliate, queste utilità offrono una maggiore personalizzazione attraverso punti di interruzione reattivi. Nell'esempio seguente, il nostro nav sarà impilato sul punto di interruzione più basso, quindi si adatterà a un layout orizzontale che riempia la larghezza disponibile a partire dal punto di interruzione piccolo.
Per quanto riguarda l'accessibilità
Se stai usando navs per fornire una barra di navigazione, assicurati di aggiungere a role="navigation"
al contenitore padre più logico di <ul>
, o avvolgi un <nav>
elemento attorno all'intera navigazione. Non aggiungere il ruolo allo <ul>
stesso, in quanto ciò eviterebbe che venga annunciato come una vera e propria lista dalle tecnologie assistive.
Nota che le barre di navigazione, anche se visivamente stilizzate come schede con la .nav-tabs
classe, non devono essere fornite o attributi . Questi sono appropriati solo per le interfacce a schede dinamiche, come descritto in WAI ARIA Authoring Practices . Per un esempio, vedere il comportamento JavaScript per le interfacce a schede dinamiche in questa sezione.role="tablist"
role="tab"
role="tabpanel"
Utilizzo dei menu a discesa
Aggiungi menu a discesa con un po' di HTML in più e il plug-in JavaScript a discesa .
Schede con menu a discesa
Pillole con menu a discesa
Comportamento JavaScript
Usa il plug-in JavaScript delle schede, includilo individualmente o tramite il file compilato bootstrap.js
, per estendere le nostre schede di navigazione e pillole per creare riquadri tabbable di contenuto locale, anche tramite menu a discesa.
Se stai creando il nostro JavaScript dal sorgente, richiedeutil.js
.
Le interfacce a schede dinamiche, come descritte nelle Pratiche di creazione di WAI ARIA , richiedono role="tablist"
, role="tab"
, role="tabpanel"
e aria-
attributi aggiuntivi per trasmettere la loro struttura, funzionalità e stato corrente agli utenti di tecnologie assistive (come gli screen reader).
Tieni presente che le interfacce a schede dinamiche non devono contenere menu a discesa, poiché ciò causa problemi di usabilità e accessibilità. Dal punto di vista dell'usabilità, il fatto che l'elemento di attivazione della scheda attualmente visualizzata non sia immediatamente visibile (poiché si trova all'interno del menu a discesa chiuso) può causare confusione. Dal punto di vista dell'accessibilità, attualmente non esiste un modo sensato per mappare questo tipo di costrutto su un modello WAI ARIA standard, il che significa che non può essere facilmente reso comprensibile agli utenti di tecnologie assistive.
Denim grezzo probabilmente non hai sentito parlare di quei pantaloncini di jeans Austin. Nesciunt tofu stumptown aliqua, purificatore di synth retrò. Baffi cliché tempor, williamsburg carles vegan helvetica. Reprehenderit macellaio sintetizzatore acchiappasogni retrò kefiah. Maglione Cosby eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, macellaio 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 soddisfare le tue esigenze, questo funziona con <ul>
il markup basato su, come mostrato sopra, o con qualsiasi markup arbitrario "roll your own". Tieni presente che se stai utilizzando <nav>
, non dovresti aggiungere role="tablist"
direttamente ad esso, poiché ciò annullerebbe il ruolo nativo dell'elemento come punto di riferimento di navigazione. Invece, passa a un elemento alternativo (nell'esempio seguente, un semplice <div>
) e avvolgilo <nav>
attorno.
Il plugin delle schede funziona anche con le pillole.
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 exceptioneur 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 le pillole verticali.
Cillum ad ut irure tempor velit nostrud occaecat ullamco aliqua anim Lorem sint. Veniam sint duis incididunt do esse magna mollit exceptioneur laborum qui. Id id reprehenderit sit est eu aliqua occaecat quis et velit exceptioneur laborum mollit dolore eiusmod. Ipsum dolor in occaecat commodo et voluptate minim reprehenderit mollit pariatur. Deserunt non laborum enim et cillum eu deserunt eccettoeur 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.
Utilizzo degli attributi dei dati
Puoi attivare una navigazione con tab o pill senza scrivere JavaScript semplicemente specificando data-toggle="tab"
o data-toggle="pill"
su un elemento. Utilizzare questi attributi di dati su .nav-tabs
o .nav-pills
.
Tramite JavaScript
Abilita le schede tabb tramite JavaScript (ogni scheda deve essere attivata singolarmente):
Puoi attivare singole schede in diversi modi:
Effetto dissolvenza
Per far sfumare le schede, aggiungi .fade
a ciascuna .tab-pane
. Anche il primo riquadro delle schede deve .show
rendere visibile il contenuto iniziale.
Metodi
Metodi e transizioni asincrone
Tutti i metodi API sono asincroni e avviano una transizione . Ritornano al chiamante non appena la transizione è iniziata ma prima che termini . Inoltre, una chiamata al metodo su un componente in transizione verrà ignorata .
Consulta la nostra documentazione JavaScript per ulteriori informazioni .
$().tab
Attiva un elemento scheda e un contenitore di contenuto. La scheda dovrebbe avere a data-target
o un href
nodo di destinazione del contenitore nel DOM.
.tab('mostra')
Seleziona la scheda data e mostra il riquadro associato. Qualsiasi altra scheda precedentemente selezionata viene deselezionata e il riquadro associato viene nascosto. Ritorna al chiamante prima che il riquadro delle schede sia stato effettivamente mostrato (cioè prima shown.bs.tab
che si verifichi l'evento).
.tab('smaltire')
Distrugge la scheda di un elemento.
Eventi
Quando viene visualizzata una nuova scheda, gli eventi si attivano nel seguente ordine:
hide.bs.tab
(nella scheda attiva corrente)show.bs.tab
(nella scheda da mostrare)hidden.bs.tab
(nella scheda attiva precedente, la stessahide.bs.tab
dell'evento)shown.bs.tab
(nella scheda appena mostrata appena attiva, la stessashow.bs.tab
dell'evento)
Se nessuna scheda era già attiva, gli eventi hide.bs.tab
e hidden.bs.tab
non verranno attivati.
Tipo di evento | Descrizione |
---|---|
show.bs.tab | Questo evento si attiva alla visualizzazione della scheda, ma prima che venga mostrata la nuova scheda. Utilizzare event.target e event.relatedTarget per indirizzare rispettivamente la scheda attiva e la scheda attiva precedente (se disponibile). |
mostrato.bs.tab | Questo evento si attiva alla visualizzazione delle schede dopo che è stata mostrata una scheda. Utilizzare event.target e event.relatedTarget per indirizzare rispettivamente la scheda attiva e la scheda attiva precedente (se disponibile). |
nascondi.scheda.bs | Questo evento si attiva quando deve essere visualizzata una nuova scheda (e quindi la scheda attiva precedente deve essere nascosta). Utilizzare event.target e event.relatedTarget per scegliere come target rispettivamente la scheda attiva corrente e la nuova scheda che sarà presto attiva. |
scheda.bs.nascosta | Questo evento si attiva dopo che viene mostrata una nuova scheda (e quindi la scheda attiva precedente viene nascosta). Utilizzare event.target e event.relatedTarget per indirizzare rispettivamente la scheda attiva precedente e la nuova scheda attiva. |