Dai vita ai componenti di Bootstrap, ora con 13 plugin jQuery personalizzati.
I plugin possono essere inclusi singolarmente (sebbene alcuni abbiano delle dipendenze richieste) o tutti in una volta. Sia bootstrap.js che bootstrap.min.js contengono tutti i plugin in un unico file.
Puoi utilizzare tutti i plug-in Bootstrap esclusivamente tramite l'API di markup senza scrivere una singola riga di JavaScript. Questa è l'API di prima classe di Bootstrap e dovrebbe essere la tua prima considerazione quando usi un plugin.
Detto questo, in alcune situazioni potrebbe essere desiderabile disattivare questa funzionalità. Pertanto, forniamo anche la possibilità di disabilitare l'API degli attributi dei dati svincolando tutti gli eventi sullo spazio dei nomi del corpo con `'data-api'`. Questo assomiglia a questo:
- $ ( "corpo" ). spento ( '.data-api' )
In alternativa, per indirizzare un plug-in specifico, includi semplicemente il nome del plug-in come spazio dei nomi insieme allo spazio dei nomi data-api in questo modo:
- $ ( "corpo" ). disattivato ( '.alert.data-api' )
Riteniamo inoltre che dovresti essere in grado di utilizzare tutti i plug-in Bootstrap esclusivamente tramite l'API JavaScript. Tutte le API pubbliche sono metodi singoli, concatenabili e restituiscono la raccolta su cui si è agito.
- $ ( ".btn.pericolo" ). pulsante ( "commuta" ). addClass ( "grasso" )
Tutti i metodi dovrebbero accettare un oggetto opzioni opzionale, una stringa che ha come target un metodo particolare o niente (che avvia un plug-in con un comportamento predefinito):
- $ ( "#myModal" ). modal () // inizializzato con i valori predefiniti
- $ ( "#myModal" ). modal ({ keyboard : false }) // inizializzato senza tastiera
- $ ( "#myModal" ). modal ( 'show' ) // inizializza e richiama show immediatamente
Ogni plugin espone anche il suo costruttore grezzo su una proprietà `Constructor`: $.fn.popover.Constructor
. Se desideri ottenere una particolare istanza di plugin, recuperala direttamente da un elemento: $('[rel=popover]').data('popover')
.
A volte è necessario utilizzare i plug-in Bootstrap con altri framework dell'interfaccia utente. In queste circostanze, possono verificarsi occasionalmente collisioni nello spazio dei nomi. Se ciò accade, puoi richiamare .noConflict
il plugin di cui desideri ripristinare il valore.
- var bootstrapButton = $ . fn . pulsante . noConflict () // restituisce $.fn.button al valore assegnato in precedenza
- $ . fn . bootstrapBtn = bootstrapButton // fornisce a $().bootstrapBtn la funzionalità bootstrap
Bootstrap fornisce eventi personalizzati per la maggior parte delle azioni uniche del plugin. Generalmente, questi si presentano in una forma di participio passato e infinito, in cui l'infinito (es. show
) viene attivato all'inizio di un evento e la sua forma participio passato (es. shown
) viene attivato al completamento di un'azione.
Tutti gli eventi infiniti forniscono la funzionalità preventDefault. Ciò fornisce la possibilità di interrompere l'esecuzione di un'azione prima che inizi.
- $ ( '#myModal' ). on ( 'mostra' , funzione ( e ) {
- se (! data ) restituisce e . preventDefault () // interrompe la visualizzazione del modale
- })
Per effetti di transizione semplici, includi bootstrap-transition.js insieme agli altri file JS. Se stai usando bootstrap.js compilato (o minimizzato) , non è necessario includerlo: è già lì.
Alcuni esempi del plugin di transizione:
I modali sono prompt di dialogo semplificati, ma flessibili, con la funzionalità minima richiesta e impostazioni predefinite intelligenti.
Un rendering modale con intestazione, corpo e serie di azioni nel piè di pagina.
Un bel corpo...
- < classe div = "dissolvenza nascosta modale" >
- < classe div = "intestazione modale" >
- < tipo di pulsante = "pulsante" class = "chiudi" data-dismiss = "modale" aria-hidden = "vero" > × </pulsante>
- <h3> Intestazione modale </h3>
- </div>
- < classe div = "corpo modale" >
- <p> Un bel corpo... </p>
- </div>
- < classe div = "piè di pagina modale" >
- <a href = "#" class = "btn" > Chiudi </a>
- <a href = "#" class = "btn btn-primary" > Salva le modifiche </a>
- </div>
- </div>
Attiva o disattiva una modale tramite JavaScript facendo clic sul pulsante in basso. Scorrerà verso il basso e svanirà dalla parte superiore della pagina.
- <!-- Pulsante per attivare il modale -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Avvia demo modale </a>
- <!-- Modale -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- < classe div = "intestazione modale" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > Intestazione modale </h3>
- </div>
- < classe div = "corpo modale" >
- <p> Un bel corpo... </p>
- </div>
- < classe div = "piè di pagina modale" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Chiudi </button>
- <button class = "btn btn-primary" > Salva le modifiche </button>
- </div>
- </div>
Attiva un modale senza scrivere JavaScript. Impostato data-toggle="modal"
su un elemento del controller, come un pulsante, insieme a data-target="#foo"
o href="#foo"
per scegliere come target una modale specifica da attivare.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Avvia modale </button>
Chiama un modale con id myModal
con una singola riga di JavaScript:
- $ ( '#myModal' ). modale ( opzioni )
Le opzioni possono essere passate tramite attributi di dati o JavaScript. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-backdrop=""
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
sfondo | booleano | VERO | Include un elemento di sfondo modale. In alternativa, specificare static uno sfondo che non chiude il modale al clic. |
tastiera del computer | booleano | VERO | Chiude il modale quando viene premuto il tasto Esc |
mostrare | booleano | VERO | Mostra il modale quando inizializzato. |
a distanza | sentiero | falso | Se viene fornito un URL remoto, il contenuto verrà caricato tramite il
|
Attiva il tuo contenuto come modale. Accetta opzioni opzionali object
.
- $ ( '#myModal' ). modale ({
- tastiera : falso
- })
Alterna manualmente un modale.
- $ ( '#myModal' ). modale ( 'attiva/disattiva' )
Apre manualmente un modale.
- $ ( '#myModal' ). modale ( 'mostra' )
Nasconde manualmente un modale.
- $ ( '#myModal' ). modale ( 'nascondi' )
La classe modale di Bootstrap espone alcuni eventi per l'aggancio alla funzionalità modale.
Evento | Descrizione |
---|---|
mostrare | Questo evento viene attivato immediatamente quando show viene chiamato il metodo dell'istanza. |
mostrato | Questo evento viene generato quando il modale è stato reso visibile all'utente (attenderà il completamento delle transizioni CSS). |
nascondere | Questo evento viene generato immediatamente quando hide viene chiamato il metodo dell'istanza. |
nascosto | Questo evento viene generato quando il modale ha finito di essere nascosto all'utente (attenderà il completamento delle transizioni CSS). |
- $ ( '#myModal' ). on ( 'nascosto' , funzione () {
- // fare qualcosa…
- })
Aggiungi menu a discesa a quasi tutto con questo semplice plugin, inclusa la barra di navigazione, le schede e le pillole.
Aggiungi data-toggle="dropdown"
a un link o un pulsante per attivare un menu a discesa.
- < classe div = "menu a discesa" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Attivatore a discesa </a>
- <ul class = "menu a discesa" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Per mantenere intatti gli URL, utilizza l' data-target
attributo invece di href="#"
.
- < classe div = "menu a discesa" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Cadere in picchiata
- <b classe = "accento circonflesso" ></b>
- </a>
- <ul class = "menu a discesa" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Chiama i menu a discesa tramite JavaScript:
- $ ( '.dropdown-toggle' ). menu a discesa ()
Nessuno
Un'API programmatica per alternare i menu per una determinata barra di navigazione o per la navigazione a schede.
Il plug-in ScrollSpy consente di aggiornare automaticamente i target di navigazione in base alla posizione di scorrimento. Scorri l'area sotto la barra di navigazione e osserva il cambio di classe attivo. Verranno evidenziati anche gli elementi secondari a discesa.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi prima che si esaurissero qui. Tumblr diritto alla bicicletta da fattoria a tavola qualunque cosa. Cardigan Anim Kefiah Carles. Cabina fotografica di Velit seitan mcsweeney 3 wolf moon irure. Cosby maglione lomo jean pantaloncini, williamsburg felpa con cappuccio minimo qui probabilmente non ne hai sentito parlare et cardigan fondo fiduciario culpa biodiesel wes anderson estetica. Nihil tatuato accusamus, cred ironia biodiesel kefiah artigiano ullamco consequat.
Veniam marfa baffi skateboard, adipisicing barba fugiat velit forcone. Freegan barba aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Camion di cibo in maglione cosby tatuato, vinile quis non freegan di mcsweeney. Lo-fi wes anderson +1 sartoriale. Esercitazione non estetica di Carles quis gentrify. Brooklyn adipisicing birra artigianale vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap birra artigianale deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore monorigine caffè in magna veniam. High life id vinile, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi Borsa messenger minimal fai da te. Cred ex in, marsupio sostenibile delectus consectetur iphone.
In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee blog, culpa messenger bag marfa qualunque delectus food truck. Sapiente synth id presupposto. Locavore sed helvetica cliché ironia, thundercats probabilmente non ne hai sentito parlare consequat hoodie senza glutine lo-fi fap aliquip. Labore elit placeat prima che si esaurissero, terry richardson proident brunch nesciunt quis cosby maglione pariatur kefiyeh ut helvetica artigiano. Cardigan birra artigianale seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minimo commodo ullamco thundercats.
Per aggiungere facilmente il comportamento scrollspy alla tua navigazione nella barra in alto, aggiungi semplicemente data-spy="scroll"
l'elemento che vuoi spiare (in genere questo sarebbe il corpo) e data-target=".navbar"
selezionare quale nav usare. Ti consigliamo di utilizzare scrollspy con un .nav
componente.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Chiama lo scrollspy tramite JavaScript:
- $ ( '#barra di navigazione' ). spia pergamena ()
<a href="#home">home</a>
must corrisponde a qualcosa nel dom come
<div id="home"></div>
.
Quando usi scrollspy insieme all'aggiunta o alla rimozione di elementi dal DOM, dovrai chiamare il metodo di aggiornamento in questo modo:
- $ ( '[data-spy="scorri"]' ). ciascuno ( funzione () {
- var $spia = $ ( questo ). scrollspy ( 'aggiorna' )
- });
Le opzioni possono essere passate tramite attributi di dati o JavaScript. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-offset=""
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
compensare | numero | 10 | Pixel da compensare dall'alto durante il calcolo della posizione di scorrimento. |
Evento | Descrizione |
---|---|
attivare | Questo evento si attiva ogni volta che un nuovo oggetto viene attivato da Scrollspy. |
Aggiungi funzionalità di schede rapide e dinamiche per passare da un riquadro di contenuto locale all'altro, anche tramite menu a discesa.
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.
Fondo fiduciario seitan tipografia, keytar raw denim kefiah etsy art party prima che esaurissero il tutto esaurito master cleanse senza glutine scenester calamari maglione cosby freegan. Marsupio portland seitan fai da te, arte festa locavore lupo cliché vita alta eco parco Austin. Cred vinile kefiah Salvia fai-da-te PBR, banh mi prima che esaurissero il maglione cosby locavore virale VHS da fattoria a tavola. Lomo lupo virale, baffi readymade thundercats kefiah birra artigianale marfa etica. Wolf salvia freegan, sartoriale kefiah eco park vegan.
Abilita le schede tabb tramite JavaScript (ogni scheda deve essere attivata singolarmente):
- $ ( '#myTab a' ). fare clic su ( funzione ( e ) {
- e . preventDefault ();
- $ ( questo ). scheda ( "mostra" );
- })
Puoi attivare singole schede in diversi modi:
- $ ( '#myTab a[href="#profile"]' ). scheda ( "mostra" ); // Seleziona la scheda per nome
- $ ( '#myTab a:first' ). scheda ( "mostra" ); // Seleziona la prima scheda
- $ ( '#myTab a:last' ). scheda ( "mostra" ); // Seleziona l'ultima scheda
- $ ( '#myTab li:eq(2) a' ). scheda ( "mostra" ); // Seleziona la terza scheda (0-indicizzata)
Puoi attivare una navigazione con tab o pill senza scrivere JavaScript semplicemente specificando data-toggle="tab"
o data-toggle="pill"
su un elemento. L'aggiunta delle classi nav
e nav-tabs
alla scheda ul
applicherà lo stile della scheda Bootstrap.
- <ul class = "nav nav-schede" >
- <li><a href = "#home" data-toggle = "tab" > Home </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Profilo </a></li>
- <li><a href = "#messages" data-toggle = "tab" > Messaggi </a></li>
- <li><a href = "#impostazioni" data-toggle = "scheda" > Impostazioni </a></li>
- </ul>
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.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "attivo" ><a href = "#home" > Home </a></li>
- <li><a href = "#profile" > Profilo </a></li>
- <li><a href = "#messages" > Messaggi </a></li>
- <li><a href = "#impostazioni" > Impostazioni </a></li>
- </ul>
- < classe div = "contenuto della scheda" >
- <div class = "riquadro schede attivo" id = "home" > ... </div>
- <div class = "tab-pannello" id = "profilo" > ... </div>
- <div class = "tab-pannello" id = "messaggi" > ... </div>
- <div class = "riquadro schede" id = "impostazioni" > ... </div>
- </div>
- <script>
- $ ( funzione () {
- $ ( '#myTab a:last' ). scheda ( "mostra" );
- })
- </script>
Evento | Descrizione |
---|---|
mostrare | 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 | 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). |
- $ ( 'a[data-toggle="tab"]' ). on ( 'mostrato' , funzione ( e ) {
- e . destinazione // scheda attivata
- e . relatedTarget // scheda precedente
- })
Ispirato all'eccellente plugin jQuery.tipsy scritto da Jason Frame; Le descrizioni comandi sono una versione aggiornata, che non si basa sulle immagini, utilizza CSS3 per le animazioni e gli attributi dei dati per l'archiviazione del titolo locale.
Per motivi di prestazioni, il tooltip e il popover data-apis sono attivati, il che significa che devi inizializzarli tu stesso .
Passa il mouse sui link sottostanti per vedere i suggerimenti:
Pantaloni attillati kefiah di livello successivo probabilmente non ne hai sentito parlare. Photo Booth barba denim grezzo letterpress borsa messenger vegana stumptown. Il seitan da fattoria a tavola, l'abbigliamento americano a 8 bit con quinoa sostenibile di mcsweeney's ha un chambray in vinile di spugna di richardson. Beard Stumptown, cardigan banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, quattro loko mcsweeney's cleanse vegan chambray. Un artigiano davvero ironico qualunque sia il keytar , il cinguettio di Banksy Austin, sceneggiatore da fattoria a tavola, gestisce il virale del caffè single-origine freegan cred denim grezzo.
Quando utilizzi descrizioni comandi e popover con i gruppi di input Bootstrap, dovrai impostare l' container
opzione (documentata di seguito) per evitare effetti collaterali indesiderati.
Attiva il suggerimento tramite JavaScript:
- $ ( '#esempio' ). descrizione comando ( opzioni )
Le opzioni possono essere passate tramite attributi di dati o JavaScript. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-animation=""
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
animazione | booleano | VERO | applica una transizione di dissolvenza CSS al suggerimento |
html | booleano | falso | Inserisci l'html nel suggerimento. Se false, il text metodo di jquery verrà utilizzato per inserire il contenuto nel dom. Usa il testo se sei preoccupato per gli attacchi XSS. |
posizionamento | stringa | funzione | 'superiore' | come posizionare la descrizione comando - in alto | in basso | sinistra | Giusto |
selettore | corda | falso | Se viene fornito un selettore, gli oggetti tooltip verranno delegati alle destinazioni specificate. |
titolo | stringa | funzione | '' | valore predefinito del titolo se il tag `title` non è presente |
grilletto | corda | "messa a fuoco al passaggio del mouse" | come viene attivata la descrizione comando - fare clic su | passa il mouse | messa a fuoco | Manuale. Nota che il caso passa trigger più tipi di trigger, separati da uno spazio. |
ritardo | numero | oggetto | 0 | ritardo che mostra e nasconde la descrizione comando (ms) - non si applica al tipo di trigger manuale Se viene fornito un numero, il ritardo viene applicato a entrambi nascondi/mostra La struttura dell'oggetto è: |
contenitore | stringa | falso | falso | Aggiunge la descrizione comando a un elemento specifico |
- <a href = "#" data-toggle = "tooltip" title = "first tooltip" > passa il mouse sopra di me </a>
Allega un gestore di descrizione comando a una raccolta di elementi.
Rivela il suggerimento di un elemento.
- $ ( '#elemento' ). descrizione comando ( 'mostra' )
Nasconde la descrizione comando di un elemento.
- $ ( '#elemento' ). descrizione comando ( 'nascondi' )
Attiva o disattiva la descrizione comando di un elemento.
- $ ( '#elemento' ). descrizione comando ( 'attiva/disattiva' )
Nasconde e distrugge il suggerimento di un elemento.
- $ ( '#elemento' ). descrizione comando ( 'distruggi' )
Aggiungi piccole sovrapposizioni di contenuto, come quelle dell'iPad, a qualsiasi elemento per ospitare informazioni secondarie. Passa il mouse sopra il pulsante per attivare il popover. Richiede l'inclusione di una descrizione comando .
Sono disponibili quattro opzioni: allineato in alto, a destra, in basso e a sinistra.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesco ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesco ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesco ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesco ornare sem lacinia quam venenatis vestibulum.
Nessun markup mostrato poiché i popover vengono generati da JavaScript e dal contenuto all'interno di un data
attributo.
Abilita i popover tramite JavaScript:
- $ ( '#esempio' ). popover ( opzioni )
Le opzioni possono essere passate tramite attributi di dati o JavaScript. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-animation=""
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
animazione | booleano | VERO | applica una transizione di dissolvenza CSS al suggerimento |
html | booleano | falso | Inserisci html nel popover. Se false, il text metodo di jquery verrà utilizzato per inserire il contenuto nel dom. Usa il testo se sei preoccupato per gli attacchi XSS. |
posizionamento | stringa | funzione | 'Giusto' | come posizionare il popover - top | in basso | sinistra | Giusto |
selettore | corda | falso | se viene fornito un selettore, gli oggetti tooltip verranno delegati alle destinazioni specificate |
grilletto | corda | 'clic' | come viene attivato il popover - fare clic su | passa il mouse | messa a fuoco | Manuale |
titolo | stringa | funzione | '' | valore del titolo predefinito se l'attributo `title` non è presente |
contenuto | stringa | funzione | '' | valore di contenuto predefinito se l'attributo `data-content` non è presente |
ritardo | numero | oggetto | 0 | ritardo che mostra e nasconde il popover (ms) - non si applica al tipo di trigger manuale Se viene fornito un numero, il ritardo viene applicato a entrambi nascondi/mostra La struttura dell'oggetto è: |
contenitore | stringa | falso | falso | Aggiunge il popover a un elemento specifico |
Per motivi di prestazioni, le API di dati Tooltip e Popover sono attivate. Se desideri utilizzarle, specifica un'opzione di selezione.
Inizializza i popover per una raccolta di elementi.
Rivela un popover di elementi.
- $ ( '#elemento' ). popover ( 'mostra' )
Nasconde un popover di elementi.
- $ ( '#elemento' ). popover ( "nascondi" )
Attiva o disattiva un popover di elementi.
- $ ( '#elemento' ). popover ( 'attiva/disattiva' )
Nasconde e distrugge il popover di un elemento.
- $ ( '#elemento' ). popover ( 'distruggi' )
Aggiungi la funzionalità di eliminazione a tutti i messaggi di avviso con questo plugin.
Cambia questo e quello e riprova. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Abilita l'eliminazione di un avviso tramite JavaScript:
- $ ( ".avviso" ). avviso ()
Basta aggiungere data-dismiss="alert"
al pulsante di chiusura per fornire automaticamente una funzionalità di chiusura dell'avviso.
- <a class = "chiudi" data-dismiss = "alert" href = "#" > × </a>
Avvolge tutti gli avvisi con funzionalità di chiusura. Per fare in modo che i tuoi avvisi si attivino quando sono chiusi, assicurati che la classe .fade
e sia .in
già applicata.
Chiude un avviso.
- $ ( ".avviso" ). avviso ( "chiudi" )
La classe di avviso di Bootstrap espone alcuni eventi per l'aggancio alla funzionalità di avviso.
Evento | Descrizione |
---|---|
chiudere | Questo evento viene attivato immediatamente quando close viene chiamato il metodo dell'istanza. |
Chiuso | Questo evento viene generato quando l'avviso è stato chiuso (attende il completamento delle transizioni CSS). |
- $ ( '#mio-avviso' ). bind ( 'chiuso' , funzione () {
- // fare qualcosa…
- })
Ottieni stili di base e supporto flessibile per componenti pieghevoli come fisarmoniche e navigazione.
* Richiede l'inclusione del plug-in Transizioni.
Usando il plugin di compressione, abbiamo creato un semplice widget in stile fisarmonica:
- <div class = "fisarmonica" id = "fisarmonica2" >
- < classe div = "gruppo di fisarmoniche" >
- < classe div = "titolo a fisarmonica" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- Elemento pieghevole del gruppo n. 1
- </a>
- </div>
- <div id = "collapseOne" class = "collasso corpo-fisarmonica in" >
- <div class = "fisarmonica interna" >
- Anim pariatur cliché...
- </div>
- </div>
- </div>
- < classe div = "gruppo di fisarmoniche" >
- < classe div = "titolo a fisarmonica" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
- Elemento pieghevole del gruppo n. 2
- </a>
- </div>
- <div id = "collapseTwo" class = "collasso del corpo della fisarmonica" >
- <div class = "fisarmonica interna" >
- Anim pariatur cliché...
- </div>
- </div>
- </div>
- </div>
- ...
Puoi anche utilizzare il plugin senza il markup della fisarmonica. Crea un pulsante per alternare l'espansione e la compressione di un altro elemento.
- < tipo di pulsante = "pulsante" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
- semplice pieghevole
- </pulsante>
- <div id = "demo" class = "comprimi in" > … </div>
Basta aggiungere data-toggle="collapse"
e un data-target
elemento per assegnare automaticamente il controllo di un elemento comprimibile. L' data-target
attributo accetta un selettore CSS a cui applicare la compressione. Assicurati di aggiungere la classe collapse
all'elemento comprimibile. Se desideri che sia aperto di default, aggiungi la classe aggiuntiva in
.
Per aggiungere la gestione dei gruppi a fisarmonica a un controllo comprimibile, aggiungi l'attributo data data-parent="#selector"
. Fare riferimento alla demo per vederlo in azione.
Abilita manualmente con:
- $ ( ".comprimi" ). collassare ()
Le opzioni possono essere passate tramite attributi di dati o JavaScript. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-parent=""
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
genitore | selettore | falso | Se selettore, tutti gli elementi comprimibili sotto il genitore specificato verranno chiusi quando viene mostrato questo elemento comprimibile. (simile al comportamento della fisarmonica tradizionale) |
alternare | booleano | VERO | Attiva o disattiva l'elemento comprimibile durante l'invocazione |
Attiva il tuo contenuto come elemento comprimibile. Accetta opzioni opzionali object
.
- $ ( '#mioComprimibile' ). collasso ({
- alterna : falso
- })
Attiva o disattiva un elemento comprimibile in mostrato o nascosto.
Mostra un elemento comprimibile.
Nasconde un elemento comprimibile.
La classe di compressione di Bootstrap espone alcuni eventi per l'aggancio alla funzionalità di compressione.
Evento | Descrizione |
---|---|
mostrare | Questo evento viene attivato immediatamente quando show viene chiamato il metodo dell'istanza. |
mostrato | Questo evento viene attivato quando un elemento di compressione è stato reso visibile all'utente (attenderà il completamento delle transizioni CSS). |
nascondere | Questo evento viene generato immediatamente quando il hide metodo è stato chiamato. |
nascosto | Questo evento viene generato quando un elemento di compressione è stato nascosto all'utente (attenderà il completamento delle transizioni CSS). |
- $ ( '#mioComprimibile' ). on ( 'nascosto' , funzione () {
- // fare qualcosa…
- })
La presentazione seguente mostra un plug-in generico e un componente per scorrere gli elementi come un carosello.
- <div id = "myCarousel" class = "carousel slide" >
- <ol class = "indicatori a carosello" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "attivo" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Elementi del carosello -->
- < classe div = "carousel-inner" >
- <div class = "elemento attivo" > … </div>
- <div class = "item" > … </div>
- <div class = "item" > … </div>
- </div>
- <!-- Navigazione a carosello -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "prev" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "next" > › </a>
- </div>
Usa gli attributi dei dati per controllare facilmente la posizione del carosello. data-slide
accetta le parole chiave prev
o next
, che altera la posizione della diapositiva rispetto alla sua posizione corrente. In alternativa, utilizzare data-slide-to
per passare un indice di diapositiva non elaborato al carosello data-slide-to="2"
, che salta la posizione della diapositiva a un indice particolare che inizia con 0
.
Chiama il carosello manualmente con:
- $ ( '.carosello' ). giostra ()
Le opzioni possono essere passate tramite attributi di dati o JavaScriptz. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-interval=""
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
intervallo | numero | 5000 | La quantità di tempo di ritardo tra il ciclo automatico di un elemento. Se è falso, il carosello non scorrerà automaticamente. |
pausa | corda | "volare" | Sospende il ciclo della giostra su mouseenter e riprende il ciclo della giostra su mouseleave. |
Inizializza il carosello con un'opzione opzionale object
e inizia a scorrere gli elementi.
- $ ( '.carosello' ). carosello ({
- intervallo : 2000
- })
Scorre gli elementi del carosello da sinistra a destra.
Impedisce al carosello di scorrere gli oggetti.
Fa scorrere il carosello su un fotogramma particolare (basato su 0, simile a una matrice).
Passa all'elemento precedente.
Passa all'elemento successivo.
La classe del carosello di Bootstrap espone due eventi per l'aggancio alla funzionalità del carosello.
Evento | Descrizione |
---|---|
diapositiva | Questo evento viene attivato immediatamente quando slide viene richiamato il metodo dell'istanza. |
scivolato | Questo evento viene attivato quando il carosello ha completato la transizione della diapositiva. |
Un plug-in di base facilmente estendibile per creare rapidamente eleganti intestazioni di testo con qualsiasi input di testo di moduli.
- < tipo di input = "testo" data-fornite = "typeahead" >
Ti consigliamo di impostare autocomplete="off"
per impedire la visualizzazione dei menu predefiniti del browser sul menu a discesa Bootstrap typeahead.
Aggiungi attributi di dati per registrare un elemento con funzionalità typeahead come mostrato nell'esempio sopra.
Chiama il typeahead manualmente con:
- $ ( '.typeahead' ). dattilografare ()
Le opzioni possono essere passate tramite attributi di dati o JavaScript. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-source=""
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
fonte | matrice, funzione | [ ] | L'origine dati su cui eseguire query. Può essere una matrice di stringhe o una funzione. Alla funzione vengono passati due argomenti, il query valore nel campo di input e il process callback. La funzione può essere utilizzata in modo sincrono restituendo l'origine dati direttamente o in modo asincrono tramite il process singolo argomento del callback. |
Oggetti | numero | 8 | Il numero massimo di elementi da visualizzare nell'elenco a discesa. |
minLength | numero | 1 | La lunghezza minima dei caratteri necessaria prima di attivare i suggerimenti di completamento automatico |
abbinatore | funzione | senza distinzione tra maiuscole e minuscole | Il metodo utilizzato per determinare se una query corrisponde a un elemento. Accetta un singolo argomento, item rispetto al quale testare la query. Accedi alla query corrente con this.query . Restituisce un valore booleano true se la query è una corrispondenza. |
selezionatore | funzione | corrispondenza esatta, distinzione tra maiuscole e minuscole, senza distinzione tra maiuscole e minuscole |
Metodo utilizzato per ordinare i risultati del completamento automatico. Accetta un singolo argomento items e ha l'ambito dell'istanza typeahead. Fare riferimento alla query corrente con this.query . |
aggiornatore | funzione | restituisce l'articolo selezionato | Il metodo utilizzato per restituire l'articolo selezionato. Accetta un singolo argomento, item e ha l'ambito dell'istanza typeahead. |
evidenziatore | funzione | evidenzia tutte le corrispondenze predefinite | Metodo utilizzato per evidenziare i risultati del completamento automatico. Accetta un singolo argomento item e ha l'ambito dell'istanza typeahead. Dovrebbe restituire html. |
Inizializza un input con un typeahead.
La sottonavigazione a sinistra è una demo live del plug-in affix.
Per aggiungere facilmente il comportamento dell'affisso a qualsiasi elemento, basta aggiungere data-spy="affix"
all'elemento che vuoi spiare. Quindi usa gli offset per definire quando attivare e disattivare il blocco di un elemento.
- <div data-spy = "affix" data-offset-top = "200" > ... </div>
affix
,
affix-top
, e
affix-bottom
. Ricorda di verificare la presenza di un genitore potenzialmente compresso quando l'affisso si attiva poiché rimuove il contenuto dal normale flusso della pagina.
Chiama il plug-in affix tramite JavaScript:
- $ ( '#barra di navigazione' ). apporre ()
Le opzioni possono essere passate tramite attributi di dati o JavaScript. Per gli attributi dei dati, aggiungere il nome dell'opzione a data-
, come in data-offset-top="200"
.
Nome | genere | predefinito | descrizione |
---|---|---|---|
compensare | numero | funzione | oggetto | 10 | Pixel da scostare dallo schermo durante il calcolo della posizione di scorrimento. Se viene fornito un solo numero, l'offset verrà applicato in entrambe le direzioni in alto ea sinistra. Per ascoltare una singola direzione o più offset univoci, basta fornire un oggetto offset: { x: 10 } . Utilizzare una funzione quando è necessario fornire dinamicamente un offset (utile per alcuni progetti reattivi). |