Väck Bootstraps komponenter till liv – nu med 13 anpassade jQuery-plugins.
Plugins kan inkluderas individuellt (även om vissa har nödvändiga beroenden), eller alla på en gång. Både bootstrap.js och bootstrap.min.js innehåller alla plugins i en enda fil.
Du kan använda alla Bootstrap-plugins enbart genom markup-API:et utan att skriva en enda rad JavaScript. Detta är Bootstraps första klassens API och bör vara ditt första övervägande när du använder ett plugin.
Som sagt, i vissa situationer kan det vara önskvärt att stänga av den här funktionen. Därför tillhandahåller vi också möjligheten att inaktivera dataattributet API genom att avbinda alla händelser på kroppen med namnintervall med `'data-api'`. Det här ser ut så här:
- $ ( 'kropp' ). av ( '.data-api' )
Alternativt, för att rikta in sig på ett specifikt plugin, inkludera bara pluginens namn som ett namnområde tillsammans med data-api-namnområdet så här:
- $ ( 'kropp' ). av ( '.alert.data-api' )
Vi tror också att du bör kunna använda alla Bootstrap-plugins enbart genom JavaScript API. Alla offentliga API:er är enkla, kedjabara metoder och returnerar den samling som åtgärdats.
- $ ( ".btn.danger" ). knappen ( "växla" ). addClass ( "fett" )
Alla metoder bör acceptera ett valfritt alternativobjekt, en sträng som riktar sig mot en viss metod, eller ingenting (som initierar en plugin med standardbeteende):
- $ ( "#myModal" ). modal () // initierad med standardvärden
- $ ( "#myModal" ). modal ({ keyboard : false }) // initierad utan tangentbord
- $ ( "#myModal" ). modal ( 'show' ) // initierar och anropar show omedelbart
Varje plugin exponerar också sin råkonstruktor på en `Constructor`-egenskap: $.fn.popover.Constructor
. Om du vill skaffa en viss plugin-instans, hämta den direkt från ett element: $('[rel=popover]').data('popover')
.
Ibland är det nödvändigt att använda Bootstrap-plugins med andra UI-ramverk. Under dessa omständigheter kan namnutrymmeskollisioner ibland inträffa. Om detta händer kan du anropa .noConflict
plugin-programmet du vill återställa värdet på.
- var bootstrapButton = $ . fn . knappen . noConflict () // returnera $.fn.button till tidigare tilldelat värde
- $ . fn . bootstrapBtn = bootstrapButton // ge $().bootstrapBtn bootstrap-funktionen
Bootstrap tillhandahåller anpassade händelser för de flesta plugins unika åtgärder. I allmänhet kommer dessa i en infinitiv och participform - där infinitiv (ex. show
) utlöses i början av en händelse, och dess participform (ex. shown
) utlöses vid fullbordandet av en handling.
Alla infinitiva händelser tillhandahåller preventDefault-funktionalitet. Detta ger möjlighet att stoppa utförandet av en åtgärd innan den startar.
- $ ( '#myModal' ). on ( 'show' , function ( e ) {
- om (! data ) returnerar e . preventDefault () // stoppar modal från att visas
- })
För enkla övergångseffekter, inkludera bootstrap-transition.js en gång tillsammans med de andra JS-filerna. Om du använder den kompilerade (eller minifierade) bootstrap.js behöver du inte inkludera detta – det finns redan där.
Några exempel på övergångsplugin:
Modalerna är strömlinjeformade men flexibla dialogrutiner med minsta möjliga funktionalitet och smarta standardinställningar.
En renderad modal med sidhuvud, brödtext och uppsättning åtgärder i sidfoten.
En fin kropp...
- <div class = "modal hide fade" >
- <div class = "modal-header" >
- <button type = "button" class = "stäng" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3> Modal rubrik </h3>
- </div>
- <div class = "modal-body" >
- <p> En fin kropp... </p>
- </div>
- <div class = "modal-footer" >
- <a href = "#" class = "btn" > Stäng </a>
- <a href = "#" class = "btn btn-primary" > Spara ändringar </a>
- </div>
- </div>
Växla en modal via JavaScript genom att klicka på knappen nedan. Den kommer att glida ned och tona in från toppen av sidan.
- <!-- Knapp för att utlösa modal -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Starta demomodal </a>
- <!-- Modal -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- <div class = "modal-header" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > Modal header </h3>
- </div>
- <div class = "modal-body" >
- <p> En fin kropp... </p>
- </div>
- <div class = "modal-footer" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Stäng </button>
- <button class = "btn btn-primary" > Spara ändringar </button>
- </div>
- </div>
Aktivera en modal utan att skriva JavaScript. Ställ in data-toggle="modal"
på ett kontrollelement, som en knapp, tillsammans med en data-target="#foo"
eller href="#foo"
för att rikta in en specifik modal att växla.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Starta modal </button>
Anropa en modal med id myModal
med en enda rad JavaScript:
- $ ( '#myModal' ). modal ( alternativ )
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-backdrop=""
.
namn | typ | standard | beskrivning |
---|---|---|---|
bakgrund | booleskt | Sann | Inkluderar ett modal-bakgrundselement. Alternativt, ange static för en bakgrund som inte stänger modalen vid klick. |
tangentbord | booleskt | Sann | Stänger modalen när escape-tangenten trycks ned |
show | booleskt | Sann | Visar modalen när den initieras. |
avlägsen | väg | falsk | Om en fjärr-url tillhandahålls kommer innehållet att laddas via jQuerys
|
Aktiverar ditt innehåll som en modal. Accepterar ett valfritt alternativ object
.
- $ ( '#myModal' ). modal ({
- tangentbord : falskt
- })
Växlar manuellt en modal.
- $ ( '#myModal' ). modal ( 'växla' )
Öppnar en modal manuellt.
- $ ( '#myModal' ). modal ( 'visa' )
Döljer en modal manuellt.
- $ ( '#myModal' ). modal ( 'gömma' )
Bootstraps modalklass avslöjar några händelser för att koppla in modal funktionalitet.
Händelse | Beskrivning |
---|---|
show | Denna händelse aktiveras omedelbart när show instansmetoden anropas. |
visad | Den här händelsen aktiveras när modalen har gjorts synlig för användaren (väntar på att css-övergångar ska slutföras). |
Dölj | Denna händelse aktiveras omedelbart när hide instansmetoden har anropats. |
dold | Den här händelsen aktiveras när modalen har döljts för användaren (väntar på att css-övergångar ska slutföras). |
- $ ( '#myModal' ). on ( 'dold' , function () {
- // göra någonting…
- })
Lägg till rullgardinsmenyer till nästan vad som helst med detta enkla plugin, inklusive navigeringsfältet, flikar och piller.
Lägg data-toggle="dropdown"
till en länk eller knapp för att växla en rullgardinsmeny.
- <div class = "rullgardinsmeny" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Dropdown-utlösare </a>
- <ul class = "dropdown-menu" role = "meny" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
För att hålla webbadresser intakta, använd data-target
attributet istället för href="#"
.
- <div class = "rullgardinsmeny" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Falla ner
- <b class = "caret" ></b>
- </a>
- <ul class = "dropdown-menu" role = "meny" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Ring rullgardinsmenyn via JavaScript:
- $ ( '.dropdown-toggle' ). dropdown ()
Ingen
Ett programmatiskt api för att växla menyer för ett givet navigeringsfält eller navigering med flikar.
ScrollSpy-pluginen är till för att automatiskt uppdatera nav-mål baserat på rullningsposition. Bläddra i området under navigeringsfältet och se hur den aktiva klassen ändras. Underposterna i rullgardinsmenyn kommer också att markeras.
Annonsleggings keytar, brunch-id art party dolor labore. Pitchfork yr enim lo-fi innan de sålde slut qui. Tumblr från jord till bord cykelrättigheter oavsett. Anim keffiyeh carles kofta. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jeans shorts, williamsburg hoodie minim qui du förmodligen inte har hört talas om dem et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tatuerade accusamus, cred ironi biodiesel keffiyeh hantverkare ullamco consequat.
Veniam marfa mustasch skateboard, adipisicing fugiat velit höggaffelskägg. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat fyra loko nisi, ea helvetica nulla carles. Tatuerad cosbytröja food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles icke estetisk övning quis gentrify. Brooklyn adipisicing hantverksöl vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS är adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, hållbar delectus consectetur fanny pack 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 blogg, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche ironi, thundercats du förmodligen inte har hört talas om dem consequat hoodie glutenfri lo-fi fap aliquip. Labore elit placeat innan de sålde slut, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan hantverksöl seitan färdiggjord velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
För att enkelt lägga till scrollspy-beteende till din toppfältsnavigering, lägg bara data-spy="scroll"
till elementet du vill spionera på (vanligtvis är detta kroppen) och data-target=".navbar"
för att välja vilken nav som ska användas. Du vill använda scrollspy med en .nav
komponent.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Ring scrollspy via JavaScript:
- $ ( '#navbar' ). scrollspy ()
<a href="#home">home</a>
måste motsvara något i dom som
<div id="home"></div>
.
När du använder scrollspy i kombination med att lägga till eller ta bort element från DOM, måste du anropa uppdateringsmetoden så här:
- $ ( '[data-spy="scroll"]' ). varje ( funktion () {
- var $spy = $ ( detta ). scrollspy ( 'uppdatera' )
- });
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-offset=""
.
namn | typ | standard | beskrivning |
---|---|---|---|
offset | siffra | 10 | Pixlar att förskjuta från toppen vid beräkning av rullningsposition. |
Händelse | Beskrivning |
---|---|
Aktivera | Denna händelse aktiveras när ett nytt objekt aktiveras av scrollspy. |
Lägg till snabb, dynamisk flikfunktion för övergång genom paneler med lokalt innehåll, även via rullgardinsmenyer.
Raw denim du förmodligen inte har hört talas om dem jeans shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustasch cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby tröja eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan amerikanska kläder, slaktare 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.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Aktivera flikar med flikar via JavaScript (varje flik måste aktiveras individuellt):
- $ ( '#myTab a' ). klicka ( funktion ( e ) {
- e . preventDefault ();
- $ ( detta ). tab ( 'visa' );
- })
Du kan aktivera enskilda flikar på flera sätt:
- $ ( '#myTab a[href="#profile"]' ). tab ( 'visa' ); // Välj flik efter namn
- $ ( '#myTab a:first' ). tab ( 'visa' ); // Välj första fliken
- $ ( '#myTab a:last' ). tab ( 'visa' ); // Välj sista fliken
- $ ( '#myTab li:eq(2) a' ). tab ( 'visa' ); // Välj tredje flik (0-indexerad)
Du kan aktivera en navigering med flikar eller piller utan att skriva något JavaScript genom att helt enkelt ange data-toggle="tab"
eller data-toggle="pill"
på ett element. Om du lägger till nav
klasserna nav-tabs
och på fliken ul
tillämpas Bootstrap-flikens stil.
- <ul class = "nav nav-tabs" >
- <li><a href = "#home" data-toggle = "tab" > Hem </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Profil </a></li>
- <li><a href = "#messages" data-toggle = "tab" > Meddelanden </a></li>
- <li><a href = "#settings" data-toggle = "tab" > Inställningar </a></li>
- </ul>
Aktiverar ett flikelement och innehållsbehållare. Tab ska ha antingen en data-target
eller en href
inriktning på en containernod i DOM.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "active" ><a href = "#home" > Hem </a></li>
- <li><a href = "#profile" > Profil </a></li>
- <li><a href = "#messages" > Meddelanden </a></li>
- <li><a href = "#settings" > Inställningar </a></li>
- </ul>
- <div class = "tab-innehåll" >
- <div class = "tab-pane active" id = "home" > ... </div>
- <div class = "tab-pane" id = "profile" > ... </div>
- <div class = "tab-pane" id = "meddelanden" > ... </div>
- <div class = "tab-pane" id = "inställningar" > ... </div>
- </div>
- <script>
- $ ( function () {
- $ ( '#myTab a:last' ). tab ( 'visa' );
- })
- </script>
Händelse | Beskrivning |
---|---|
show | Den här händelsen aktiveras vid flikvisning, men innan den nya fliken har visats. Använd event.target och event.relatedTarget för att rikta in den aktiva fliken respektive den föregående aktiva fliken (om tillgänglig). |
visad | Den här händelsen aktiveras vid flikvisning efter att en flik har visats. Använd event.target och event.relatedTarget för att rikta in den aktiva fliken respektive den föregående aktiva fliken (om tillgänglig). |
- $ ( 'a[data-toggle="tab"]' ). on ( 'visas' , funktion ( e ) {
- e . mål // aktiverad flik
- e . relatedTarget // föregående flik
- })
Inspirerad av det utmärkta plugin-programmet jQuery.tipsy skrivet av Jason Frame; Verktygstips är en uppdaterad version som inte förlitar sig på bilder, använder CSS3 för animationer och dataattribut för lokal titellagring.
Av prestandaskäl är verktygstipset och popover-data-apierna opt-in, vilket innebär att du måste initiera dem själv .
Håll muspekaren över länkarna nedan för att se verktygstips:
Tighta byxor nästa nivå keffiyeh du har förmodligen inte hört talas om dem. Photo booth skägg rå denim boktryck vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie hållbara quinoa 8-bitars amerikanska kläder har en frotté richardson vinyl chambray. Beard stumptown, koftor banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, fyra loko mcsweeney's cleanse vegan chambray. En riktigt ironisk hantverkare oavsett keytar , scenester farm-to-table banksy Austin twitter handtag freegan cred raw denim enkaffe viral.
När du använder verktygstips och popovers med Bootstrap-inmatningsgrupperna måste du ställa in container
alternativet (dokumenterat nedan) för att undvika oönskade biverkningar.
Aktivera verktygstipset via JavaScript:
- $ ( '#exempel' ). verktygstips ( alternativ )
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-animation=""
.
namn | typ | standard | beskrivning |
---|---|---|---|
animation | booleskt | Sann | tillämpa en css-tonningsövergång på verktygstipset |
html | booleskt | falsk | Infoga html i verktygstipset. Om det är falskt kommer jquerys text metod att användas för att infoga innehåll i domen. Använd text om du är orolig för XSS-attacker. |
placering | sträng | fungera | 'topp' | hur man placerar verktygstipset - topp | botten | vänster | höger |
väljare | sträng | falsk | Om en väljare tillhandahålls kommer verktygstipsobjekt att delegeras till de angivna målen. |
titel | sträng | fungera | '' | standardvärde för titel om "title"-taggen inte finns |
utlösare | sträng | "sväva fokus" | hur verktygstips triggas - klicka på | sväva | fokus | manuell. Notera att du passerar trigger multiple, space seperated, trigger typer. |
dröjsmål | nummer | objekt | 0 | fördröjning av att visa och dölja verktygstipset (ms) - gäller inte manuell triggertyp Om ett nummer tillhandahålls, tillämpas fördröjning på både hide/show Objektstrukturen är: |
behållare | sträng | falsk | falsk | Lägger till verktygstipset till ett specifikt element |
- <a href = "#" data-toggle = "tooltip" title = "första verktygstips" > håll muspekaren över mig </a>
Bifogar en verktygstipshanterare till en elementsamling.
Visar ett elements verktygstips.
- $ ( '#element' ). verktygstips ( 'visa' )
Döljer ett elements verktygstips.
- $ ( '#element' ). verktygstips ( 'dölj' )
Växlar ett elements verktygstips.
- $ ( '#element' ). verktygstips ( 'växla' )
Döljer och förstör ett elements verktygstips.
- $ ( '#element' ). verktygstips ( 'förstör' )
Lägg till små överlagringar av innehåll, som de på iPad, till valfritt element för att hysa sekundär information. Håll muspekaren över knappen för att utlösa popover. Kräver verktygstips för att vara med.
Fyra alternativ är tillgängliga: topp-, höger-, botten- och vänsterjusterad.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Ingen uppmärkning som visas som popovers genereras från JavaScript och innehåll inom endata
attribut.
Aktivera popovers via JavaScript:
- $ ( '#exempel' ). popover ( alternativ )
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-animation=""
.
namn | typ | standard | beskrivning |
---|---|---|---|
animation | booleskt | Sann | tillämpa en css-tonningsövergång på verktygstipset |
html | booleskt | falsk | Infoga html i popover. Om det är falskt kommer jquerys text metod att användas för att infoga innehåll i domen. Använd text om du är orolig för XSS-attacker. |
placering | sträng | fungera | 'höger' | hur man placerar popover - toppen | botten | vänster | höger |
väljare | sträng | falsk | om en väljare tillhandahålls kommer verktygstipsobjekt att delegeras till de angivna målen |
utlösare | sträng | 'klick' | hur popover utlöses - klicka på | sväva | fokus | manuell |
titel | sträng | fungera | '' | standardvärde för titel om "title"-attributet inte finns |
innehåll | sträng | fungera | '' | standardvärde för innehåll om "data-content"-attributet inte finns |
dröjsmål | nummer | objekt | 0 | fördröjning av att visa och dölja popover (ms) - gäller inte manuell triggertyp Om ett nummer tillhandahålls, tillämpas fördröjning på både hide/show Objektstrukturen är: |
behållare | sträng | falsk | falsk | Lägger till popover till ett specifikt element |
Av prestandaskäl är verktygstips och Popover-data-apis aktiverade. Om du vill använda dem anger du bara ett väljaralternativ.
Initierar popovers för en elementsamling.
Avslöjar en popover för element.
- $ ( '#element' ). popover ( 'visa' )
Döljer en popover för element.
- $ ( '#element' ). popover ( 'gömma' )
Växlar en popover för element.
- $ ( '#element' ). popover ( 'växla' )
Döljer och förstör ett elements popover.
- $ ( '#element' ). popover ( 'förstöra' )
Lägg till avvisningsfunktion i alla varningsmeddelanden med detta plugin.
Ändra det och det och försök igen. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Aktivera avvisande av en varning via JavaScript:
- $ ( ".alert" ). varning ()
Lägg bara data-dismiss="alert"
till i din stängningsknapp för att automatiskt ge en aviseringsfunktion.
- <a class = "stäng" data-dismiss = "alert" href = "#" > × </a>
Omsluter alla varningar med nära funktionalitet. För att dina varningar ska animeras när de är stängda, se till att klassen och redan har .fade
tillämpats .in
på dem.
Stänger en varning.
- $ ( ".alert" ). varning ( 'stäng' )
Bootstraps varningsklass avslöjar några händelser för att koppla in varningsfunktioner.
Händelse | Beskrivning |
---|---|
stänga | Denna händelse aktiveras omedelbart när close instansmetoden anropas. |
stängd | Den här händelsen utlöses när varningen har stängts (väntar på att css-övergångar ska slutföras). |
- $ ( '#my-alert' ). bind ( 'stängd' , funktion () {
- // göra någonting…
- })
Få basstilar och flexibelt stöd för hopfällbara komponenter som dragspel och navigering.
* Kräver att plugin-programmet Transitions ingår.
Med hjälp av kollaps-pluginen byggde vi en enkel dragspelstil-widget:
- <div class = "dragspel" id = "dragspel2" >
- <div class = "dragspelsgrupp" >
- <div class = "accordion-heading" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- Hopfällbar gruppartikel #1
- </a>
- </div>
- <div id = "collapseOne" class = "dragspel-kropp kollapsa in" >
- <div class = "dragspel-inre" >
- Anim pariatur cliche...
- </div>
- </div>
- </div>
- <div class = "dragspelsgrupp" >
- <div class = "accordion-heading" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
- Hopfällbar gruppobjekt #2
- </a>
- </div>
- <div id = "collapseTwo" class = "dragspel-kropp kollaps" >
- <div class = "dragspel-inre" >
- Anim pariatur cliche...
- </div>
- </div>
- </div>
- </div>
- ...
Du kan också använda plugin utan dragspelsmärkning. Få en knapp att växla mellan att expandera och kollapsa ett annat element.
- <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
- enkel hopfällbar
- </button>
- <div id = "demo" class = "kollaps in" > … </div>
Lägg bara till data-toggle="collapse"
och ett data-target
till-element för att automatiskt tilldela kontroll över ett hopfällbart element. Attributet data-target
accepterar en css-väljare att tillämpa komprimeringen på. Se till att lägga till klassen collapse
i det hopfällbara elementet. Om du vill att den ska öppnas som standard lägger du till den extra klassen in
.
Lägg till dataattributet för att lägga till dragspelsliknande grupphantering till en hopfällbar kontroll data-parent="#selector"
. Se demon för att se detta i aktion.
Aktivera manuellt med:
- $ ( ".kollapse" ). kollapsa ()
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-parent=""
.
namn | typ | standard | beskrivning |
---|---|---|---|
förälder | väljare | falsk | Om väljaren kommer alla hopfällbara element under den angivna överordnade att stängas när detta hopfällbara objekt visas. (liknar traditionellt dragspelsbeteende) |
växla | booleskt | Sann | Växlar det hopfällbara elementet vid anrop |
Aktiverar ditt innehåll som ett hopfällbart element. Accepterar ett valfritt alternativ object
.
- $ ( '#myCollapsible' ). kollapsa ({
- växla : falskt
- })
Växlar ett hopfällbart element till att visas eller döljas.
Visar ett hopfällbart element.
Döljer ett hopfällbart element.
Bootstraps kollapsklass avslöjar några händelser för att koppla in kollapsfunktionalitet.
Händelse | Beskrivning |
---|---|
show | Denna händelse aktiveras omedelbart när show instansmetoden anropas. |
visad | Den här händelsen utlöses när ett kollapselement har gjorts synligt för användaren (väntar på att css-övergångar ska slutföras). |
Dölj | Denna händelse aktiveras omedelbart när hide metoden har anropats. |
dold | Den här händelsen utlöses när ett kollapselement har dolts för användaren (väntar på att css-övergångar ska slutföras). |
- $ ( '#myCollapsible' ). on ( 'dold' , function () {
- // göra någonting…
- })
Bildspelet nedan visar ett generiskt plugin och en komponent för att cykla genom element som en karusell.
- <div id = "myCarousel" class = "karusellbild" >
- <ol class = "karusell-indikatorer" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "aktiv" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Karusellartiklar -->
- <div class = "karusell-inner" >
- <div class = "aktivt objekt" > … </div>
- <div class = "item" > … </div>
- <div class = "item" > … </div>
- </div>
- <!-- Karusell nav -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "prev" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "nästa" > › </a>
- </div>
Använd dataattribut för att enkelt styra karusellens position. data-slide
accepterar nyckelorden prev
eller next
, vilket ändrar bildens position i förhållande till dess nuvarande position. Alternativt kan du använda data-slide-to
för att skicka ett obearbetat diabildsindex till karusellen data-slide-to="2"
, vilket hoppar är bildpositionen till ett visst index som börjar med 0
.
Ring karusellen manuellt med:
- $ ( '.carousel' ). karusell ()
Alternativ kan skickas via dataattribut eller JavaScriptz. För dataattribut, lägg till alternativnamnet till data-
, som i data-interval=""
.
namn | typ | standard | beskrivning |
---|---|---|---|
intervall | siffra | 5 000 | Hur lång tid det tar mellan att automatiskt cykla ett objekt. Om det är falskt, kommer karusellen inte att cykla automatiskt. |
paus | sträng | "sväva" | Pausar cyklingen av karusellen på mouseenter och återupptar cyklingen av karusellen på mouseave. |
Initierar karusellen med ett valfritt alternativ object
och börjar cykla igenom föremål.
- $ ( '.carousel' ). karusell ({
- intervall : 2000
- })
Cyklar genom karusellföremålen från vänster till höger.
Stoppar karusellen från att cykla genom föremål.
Cyklar karusellen till en viss bildruta (0-baserad, liknande en array).
Går till föregående post.
Går till nästa objekt.
Bootstraps karusellklass avslöjar två händelser för att koppla in karusellfunktionalitet.
Händelse | Beskrivning |
---|---|
glida | Denna händelse aktiveras omedelbart när slide instansmetoden anropas. |
gled | Denna händelse aktiveras när karusellen har slutfört sin bildövergång. |
Ett enkelt, enkelt utökat plugin för att snabbt skapa eleganta skrivhuvuden med vilken form som helst.
- <input type = "text" data-provide = "typeahead" >
Du vill ställa in autocomplete="off"
för att förhindra att standardwebbläsarmenyer visas över rullgardinsmenyn Bootstrap typahead.
Lägg till dataattribut för att registrera ett element med typahead-funktion som visas i exemplet ovan.
Ring skrivhuvudet manuellt med:
- $ ( '.typeahead' ). typahead ()
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-source=""
.
namn | typ | standard | beskrivning |
---|---|---|---|
källa | array, funktion | [ ] | Datakällan att fråga mot. Kan vara en array av strängar eller en funktion. Funktionen skickas två argument, query värdet i inmatningsfältet och process återuppringningen. Funktionen kan användas synkront genom att returnera datakällan direkt eller asynkront via process återuppringningens enda argument. |
föremål | siffra | 8 | Det maximala antalet objekt som ska visas i rullgardinsmenyn. |
minLängd | siffra | 1 | Den minsta teckenlängden som krävs innan förslag på autoslutförande utlöses |
matchare | fungera | fallet okänslig | Metoden som används för att avgöra om en fråga matchar ett objekt. Accepterar ett enda argument, item mot vilket frågan ska testas. Öppna den aktuella frågan med this.query . Returnera ett booleskt värde true om frågan är en matchning. |
sorterare | fungera | exakt matchning, skiftlägeskänslig, skiftlägesokänslig |
Metod som används för att sortera resultat för autoslutförande. Accepterar ett enda argument items och har omfattningen av typahead-instansen. Referera till den aktuella frågan med this.query . |
uppdaterare | fungera | returnerar vald artikel | Metoden som används för att returnera vald artikel. Accepterar ett enda argument, item och har omfattningen av typahead-instansen. |
överstrykningspenna | fungera | markerar alla standardmatchningar | Metod som används för att markera resultat för autoslutförande. Accepterar ett enda argument item och har omfattningen av typahead-instansen. Bör returnera html. |
Initierar en indata med ett skrivhuvud.
Undernavigeringen till vänster är en livedemo av affix-plugin.
För att enkelt lägga till affixbeteende till ett element, lägg bara data-spy="affix"
till elementet du vill spionera på. Använd sedan förskjutningar för att definiera när du ska koppla på och av fästningen av ett element.
- <div data-spy = "affix" data-offset-top = "200" > ... </div>
affix
,
affix-top
, och
affix-bottom
. Kom ihåg att leta efter en potentiellt kollapsad förälder när affixet startar eftersom det tar bort innehåll från sidans normala flöde.
Anropa affix-plugin via JavaScript:
- $ ( '#navbar' ). fästa ()
Alternativ kan skickas via dataattribut eller JavaScript. För dataattribut, lägg till alternativnamnet till data-
, som i data-offset-top="200"
.
namn | typ | standard | beskrivning |
---|---|---|---|
offset | nummer | funktion | objekt | 10 | Pixlar att förskjuta från skärmen vid beräkning av rullningsposition. Om ett enda nummer anges, kommer offset att tillämpas i både övre och vänster riktning. För att lyssna efter en enskild riktning, eller flera unika förskjutningar, ange bara ett objekt offset: { x: 10 } . Använd en funktion när du dynamiskt behöver tillhandahålla en offset (användbart för vissa responsiva designs). |