JavaScript

Gjør Bootstraps komponenter til live – nå med 13 tilpassede jQuery-plugins.

Individuell eller kompilert

Plugins kan inkluderes individuelt (selv om noen har nødvendige avhengigheter), eller alle på en gang. Både bootstrap.js og bootstrap.min.js inneholder alle plugins i en enkelt fil.

Dataattributter

Du kan bruke alle Bootstrap-plugins rent gjennom markup API uten å skrive en eneste linje med JavaScript. Dette er Bootstraps førsteklasses API og bør være din første vurdering når du bruker en plugin.

Når det er sagt, kan det i noen situasjoner være ønskelig å slå av denne funksjonaliteten. Derfor gir vi også muligheten til å deaktivere dataattributtet API ved å oppheve bindingen av alle hendelser på kroppen med navneavstand med `'data-api'`. Dette ser slik ut:

  1. $ ( 'kropp' ). av ( '.data-api' )

Alternativt, for å målrette mot et spesifikt plugin, inkluderer du bare pluginens navn som et navneområde sammen med data-api navneområdet slik:

  1. $ ( 'kropp' ). av ( '.alert.data-api' )

Programmatisk API

Vi mener også at du bør kunne bruke alle Bootstrap-plugins rent gjennom JavaScript API. Alle offentlige API-er er enkle, kjedebare metoder, og returnerer samlingen som ble utført.

  1. $ ( ".btn.danger" ). knapp ( "veksle" ). addClass ( "fett" )

Alle metoder bør godta et valgfritt alternativobjekt, en streng som retter seg mot en bestemt metode, eller ingenting (som starter en plugin med standard oppførsel):

  1. $ ( "#myModal" ). modal () // initialisert med standardverdier
  2. $ ( "#myModal" ). modal ({ keyboard : false }) // initialisert uten tastatur
  3. $ ( "#myModal" ). modal ( 'show' ) // initialiserer og påkaller show umiddelbart

Hvert plugin viser også sin råkonstruktør på en `Constructor`-egenskap: $.fn.popover.Constructor. Hvis du vil ha en bestemt plugin-forekomst, kan du hente den direkte fra et element: $('[rel=popover]').data('popover').

Ingen konflikt

Noen ganger er det nødvendig å bruke Bootstrap-plugins med andre UI-rammer. Under disse omstendighetene kan navneområdekollisjoner av og til forekomme. Hvis dette skjer, kan du ringe .noConflicttil plugin-en du ønsker å tilbakestille verdien av.

  1. var bootstrapButton = $ . fn . knappen . noConflict () // returner $.fn.button til tidligere tildelt verdi
  2. $ . fn . bootstrapBtn = bootstrapButton // gi $().bootstrapBtn bootstrap-funksjonaliteten

arrangementer

Bootstrap gir tilpassede hendelser for de fleste plugins unike handlinger. Vanligvis kommer disse i en infinitiv og partisippform - der infinitiv (eks. show) utløses ved starten av en hendelse, og partisippform (eks. shown) utløses ved fullføring av en handling.

Alle infinitive hendelser gir preventDefault-funksjonalitet. Dette gir muligheten til å stoppe utførelsen av en handling før den starter.

  1. $ ( '#myModal' ). ( 'vis' , funksjon ( e ) {
  2. hvis (! data ) returnerer e . preventDefault () // stopper modal fra å bli vist
  3. })

Om overganger

For enkle overgangseffekter, inkluderer bootstrap-transition.js én gang sammen med de andre JS-filene. Hvis du bruker den kompilerte (eller minifiserte) bootstrap.js , er det ikke nødvendig å inkludere dette – det er der allerede.

Brukssaker

Noen få eksempler på overgangsplugin:

  • Skyv eller falmer i modaler
  • Fading ut faner
  • Uttoningsvarsler
  • Skyvbare karusellruter

Eksempler

Modaler er strømlinjeformede, men fleksible, dialogmeldinger med minimum nødvendig funksjonalitet og smarte standardinnstillinger.

Statisk eksempel

En gjengitt modal med topptekst, brødtekst og sett med handlinger i bunnteksten.

  1. <div class = "modal hide fade" >
  2. <div class = "modal-header" >
  3. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  4. <h3> Modal overskrift </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> En fin kropp... </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" > Lukk </a>
  11. <a href = "#" class = "btn btn-primary" > Lagre endringer </a>
  12. </div>
  13. </div>

Live demo

Veksle en modal via JavaScript ved å klikke på knappen nedenfor. Den vil gli ned og tone inn fra toppen av siden.

  1. <!-- Knapp for å utløse modal -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Start demomodal </a>
  3.  
  4. <!-- Modal -->
  5. <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
  6. <div class = "modal-header" >
  7. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  8. <h3 id = "myModalLabel" > Modal overskrift </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> En fin kropp... </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Lukk </button>
  15. <button class = "btn btn-primary" > Lagre endringer </button>
  16. </div>
  17. </div>

Bruk

Via dataattributter

Aktiver en modal uten å skrive JavaScript. Sett data-toggle="modal"på et kontrollerelement, som en knapp, sammen med en data-target="#foo"eller href="#foo"for å målrette en bestemt modal for å veksle.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > Start modal </button>

Via JavaScript

Ring en modal med id myModalmed en enkelt linje med JavaScript:

  1. $ ( '#myModal' ). modal ( alternativer )

Alternativer

Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-, som i data-backdrop="".

Navn type misligholde beskrivelse
bakteppe boolsk ekte Inkluderer et modalt bakteppeelement. Alternativt, spesifiser staticfor et bakteppe som ikke lukker modalen ved klikk.
tastatur boolsk ekte Lukker modalen når escape-tasten trykkes
forestilling boolsk ekte Viser modalen når initialisert.
fjernkontroll sti falsk

Hvis en ekstern url er oppgitt, vil innhold lastes inn via jQuerys loadmetode og injiseres i .modal-body. Hvis du bruker data-API, kan du alternativt bruke hreftaggen for å spesifisere den eksterne kilden. Et eksempel på dette er vist nedenfor:

  1. <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>

Metoder

.modal(alternativer)

Aktiverer innholdet ditt som en modal. Godtar et valgfritt alternativ object.

  1. $ ( '#myModal' ). modal ({
  2. tastatur : falsk
  3. })

.modal('toggle')

Bytter en modal manuelt.

  1. $ ( '#myModal' ). modal ( 'veksle' )

.modal('show')

Åpner en modal manuelt.

  1. $ ( '#myModal' ). modal ( 'vis' )

.modal('skjul')

Skjuler en modal manuelt.

  1. $ ( '#myModal' ). modal ( 'skjul' )

arrangementer

Bootstraps modalklasse avslører noen få hendelser for å koble til modal funksjonalitet.

Begivenhet Beskrivelse
forestilling Denne hendelsen utløses umiddelbart når showinstansmetoden kalles.
vist Denne hendelsen utløses når modalen er gjort synlig for brukeren (vil vente på at css-overgangene er fullført).
gjemme seg Denne hendelsen utløses umiddelbart når hideinstansmetoden er kalt.
skjult Denne hendelsen utløses når modalen er ferdig skjult for brukeren (vil vente på at css-overgangene er fullført).
  1. $ ( '#myModal' ). ( 'skjult' , funksjon () {
  2. // gjør noe…
  3. })

Eksempel i navbar

ScrollSpy-pluginen er for automatisk oppdatering av nav-mål basert på rulleposisjon. Rull området under navigasjonslinjen og se den aktive klassen endre seg. Underelementene i rullegardinmenyen vil også bli uthevet.

@fett

Annonse leggings keytar, brunsj id art party dolor labore. Pitchfork yr enim lo-fi før de solgte ut qui. Tumblr gård-til-bord sykkelrettigheter uansett. Anim keffiyeh carles cardigan. Velit seitan mcsweeneys fotoboks 3 wolf moon irure. Cosby genser lomo jean shorts, williamsburg hettegenser minim qui du sannsynligvis ikke har hørt om dem et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tatoverte accusamus, cred ironi biodiesel keffiyeh håndverker ullamco consequat.

@mdo

Veniam marfa bart skateboard, adipisicing fugiat velit høygaffelskjegg. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat fire loko nisi, ea helvetica nulla carles. Tatovert cosby genser food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles ikke estetisk trening quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.

en

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 er adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.

to

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.

three

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 sannsynligvis ikke har hørt om dem consequat hettegenser glutenfri lo-fi fap aliquip. Labore elit placeat før de solgte ut, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Bruk

Via dataattributter

For enkelt å legge til scrollspy-adferd til topplinjenavigasjonen, legg data-spy="scroll"til elementet du vil spionere på (vanligvis vil dette være kroppen) og data-target=".navbar"for å velge hvilken nav som skal brukes. Du vil bruke scrollspy med en .navkomponent.

  1. <body data-spy = "scroll" data-target = ".navbar" > ... </body>

Via JavaScript

Ring scrollspy via JavaScript:

  1. $ ( '#navbar' ). scrollspy ()
Vær oppmerksom! Navbar-lenker må ha løsbare id-mål. For eksempel, en <a href="#home">home</a>må svare til noe i dom som <div id="home"></div>.

Metoder

.scrollspy('refresh')

Når du bruker scrollspy i forbindelse med å legge til eller fjerne elementer fra DOM, må du kalle oppdateringsmetoden slik:

  1. $ ( '[data-spy="scroll"]' ). hver ( funksjon () {
  2. var $spy = $ ( dette ). scrollspy ( 'oppdater' )
  3. });

Alternativer

Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-, som i data-offset="".

Navn type misligholde beskrivelse
offset Antall 10 Piksler for å forskyve fra toppen ved beregning av rulleposisjon.

arrangementer

Begivenhet Beskrivelse
aktivere Denne hendelsen utløses når et nytt element blir aktivert av scrollspy.

Eksempelfaner

Legg til rask, dynamisk fanefunksjonalitet for overgang gjennom ruter med lokalt innhold, selv via rullegardinmenyer.

Rå denim du sannsynligvis ikke har hørt om dem jeanshorts Austin. Nesciunt tofu stumptown aliqua, retro synth master rens. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit slakter retro keffiyeh dreamcatcher synth. Cosby genser eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, slakter 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.


Bruk

Aktiver tabbare faner via JavaScript (hver fane må aktiveres individuelt):

  1. $ ( '#myTab a' ). klikk ( funksjon ( e ) {
  2. e . preventDefault ();
  3. $ ( dette ). tab ( 'vis' );
  4. })

Du kan aktivere individuelle faner på flere måter:

  1. $ ( '#myTab a[href="#profile"]' ). tab ( 'vis' ); // Velg fane etter navn
  2. $ ( '#myTab a:first' ). tab ( 'vis' ); // Velg første fane
  3. $ ( '#myTab a:last' ). tab ( 'vis' ); // Velg siste fane
  4. $ ( '#myTab li:eq(2) a' ). tab ( 'vis' ); // Velg tredje fane (0-indeksert)

Markup

Du kan aktivere en fane- eller pillenavigasjon uten å skrive noe JavaScript ved å spesifisere data-toggle="tab"eller data-toggle="pill"på et element. Hvis du legger til navog - nav-tabsklassene i fanen ul, brukes Bootstrap-fanestilen.

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab" > Hjem </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > Profil </a></li>
  4. <li><a href = "#messages" data-toggle = "tab" > Meldinger </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > Innstillinger </a></li>
  6. </ul>

Metoder

$().tab

Aktiverer et faneelement og innholdsbeholder. Tab skal ha enten en data-targeteller en hrefmålrettet beholdernode i DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" > Hjem </a></li>
  3. <li><a href = "#profile" > Profil </a></li>
  4. <li><a href = "#messages" > Meldinger </a></li>
  5. <li><a href = "#settings" > Innstillinger </a></li>
  6. </ul>
  7.  
  8. <div class = "tab-innhold" >
  9. <div class = "tab-pane active" id = "home" > ... </div>
  10. <div class = "tab-pane" id = "profile" > ... </div>
  11. <div class = "tab-pane" id = "meldinger" > ... </div>
  12. <div class = "tab-pane" id = "innstillinger" > ... </div>
  13. </div>
  14.  
  15. <script>
  16. $ ( funksjon () {
  17. $ ( '#myTab a:last' ). tab ( 'vis' );
  18. })
  19. </script>

arrangementer

Begivenhet Beskrivelse
forestilling Denne hendelsen utløses på fanevisning, men før den nye fanen har blitt vist. Bruk event.targetog event.relatedTargetfor å målrette henholdsvis den aktive fanen og den forrige aktive fanen (hvis tilgjengelig).
vist Denne hendelsen utløses på fanevisning etter at en fane er vist. Bruk event.targetog event.relatedTargetfor å målrette henholdsvis den aktive fanen og den forrige aktive fanen (hvis tilgjengelig).
  1. $ ( 'a[data-toggle="tab"]' ). ( 'vist' , funksjon ( e ) {
  2. e . mål // aktivert fane
  3. e . relatedTarget // forrige fane
  4. })

Eksempler

Inspirert av den utmerkede jQuery.tipsy-pluginen skrevet av Jason Frame; Verktøytips er en oppdatert versjon som ikke er avhengig av bilder, bruker CSS3 for animasjoner og dataattributter for lokal tittellagring.

Av ytelsesgrunner er verktøytipset og popover-dataapi-ene valgt inn, noe som betyr at du må initialisere dem selv .

Hold markøren over koblingene nedenfor for å se verktøytips:

Trange bukser neste nivå keffiyeh du har sannsynligvis ikke hørt om dem. Fotoboks skjegg rå denim boktrykk vegansk messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie bærekraftig quinoa 8-bits amerikanske klær har en frotté richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, fire loko mcsweeney's cleanse vegan chambray. En virkelig ironisk håndverker uansett keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.

Fire retninger

Verktøytips i inndatagrupper

Når du bruker verktøytips og popovers med Bootstrap-inndatagruppene, må du angi alternativet container(dokumentert nedenfor) for å unngå uønskede bivirkninger.


Bruk

Utløs verktøytipset via JavaScript:

  1. $ ( '#eksempel' ). verktøytips ( alternativer )

Alternativer

Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-, som i data-animation="".

Navn type misligholde beskrivelse
animasjon boolsk ekte bruk en css-fade-overgang på verktøytipset
html boolsk falsk Sett inn html i verktøytipset. Hvis falsk, vil jquerys textmetode bli brukt til å sette inn innhold i domen. Bruk tekst hvis du er bekymret for XSS-angrep.
plassering streng | funksjon 'topp' hvordan plassere verktøytipset - topp | nederst | venstre | Ikke sant
velger streng falsk Hvis en velger er angitt, vil verktøytipsobjekter bli delegert til de angitte målene.
tittel streng | funksjon '' standard tittelverdi hvis "title"-taggen ikke er til stede
avtrekker streng "hover fokus" hvordan verktøytips utløses - klikk | sveve | fokus | Håndbok. Legg merke til at sakspass trigger multiple, space seperated, trigger typer.
forsinkelse nummer | gjenstand 0

forsinkelse ved å vise og skjule verktøytipset (ms) - gjelder ikke for manuell utløsertype

Hvis et nummer er oppgitt, brukes forsinkelse på både skjul/show

Objektstrukturen er:delay: { show: 500, hide: 100 }

container streng | falsk falsk

Legger til verktøytipset til et spesifikt elementcontainer: 'body'

Vær oppmerksom! Alternativer for individuelle verktøytips kan alternativt spesifiseres ved bruk av dataattributter.

Markup

  1. <a href = "#" data-toggle = "verktøytips" title = "første verktøytips" > hold markøren over meg </a>

Metoder

$().tooltip(opsjoner)

Legger en verktøytipsbehandler til en elementsamling.

.tooltip('vis')

Avslører et elements verktøytips.

  1. $ ( '#element' ). verktøytips ( 'vis' )

.tooltip('skjul')

Skjuler et elements verktøytips.

  1. $ ( '#element' ). verktøytips ( 'skjul' )

.tooltip('toggle')

Veksler på verktøytipset til et element.

  1. $ ( '#element' ). verktøytips ( 'veksle' )

.tooltip('destroy')

Skjuler og ødelegger et elements verktøytips.

  1. $ ( '#element' ). verktøytips ( 'ødelegge' )

Eksempler

Legg til små overlegg av innhold, som de på iPad, til et hvilket som helst element for å inneholde sekundær informasjon. Hold musepekeren over knappen for å utløse popover. Krever at verktøytips er inkludert.

Statisk popover

Fire alternativer er tilgjengelige: topp-, høyre-, bunn- og venstrejustert.

Popover-topp

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover høyre

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover bunn

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover venstre

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Ingen markeringer som vises som popovers genereres fra JavaScript og innhold i et dataattributt.

Live demo

Fire retninger


Bruk

Aktiver popovers via JavaScript:

  1. $ ( '#eksempel' ). popover ( alternativer )

Alternativer

Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-, som i data-animation="".

Navn type misligholde beskrivelse
animasjon boolsk ekte bruk en css-fade-overgang på verktøytipset
html boolsk falsk Sett inn html i popover-vinduet. Hvis falsk, vil jquerys textmetode bli brukt til å sette inn innhold i domen. Bruk tekst hvis du er bekymret for XSS-angrep.
plassering streng | funksjon 'Ikke sant' hvordan plassere popover - toppen | nederst | venstre | Ikke sant
velger streng falsk hvis en velger er angitt, vil verktøytipsobjekter bli delegert til de angitte målene
avtrekker streng 'klikk' hvordan popover utløses - klikk | sveve | fokus | Håndbok
tittel streng | funksjon '' standard tittelverdi hvis «title»-attributtet ikke er til stede
innhold streng | funksjon '' standard innholdsverdi hvis «data-content»-attributtet ikke er til stede
forsinkelse nummer | gjenstand 0

forsinkelse ved å vise og skjule popover (ms) - gjelder ikke for manuell utløsertype

Hvis et nummer er oppgitt, brukes forsinkelse på både skjul/show

Objektstrukturen er:delay: { show: 500, hide: 100 }

container streng | falsk falsk

Legger popover til et bestemt elementcontainer: 'body'

Vær oppmerksom!Alternativer for individuelle popovers kan alternativt spesifiseres ved bruk av dataattributter.

Markup

Av ytelsesgrunner er Tooltip og Popover-dataapi-ene valgt inn. Hvis du vil bruke dem, spesifiser bare et velgeralternativ.

Metoder

$().popover(alternativer)

Initialiserer popovers for en elementsamling.

.popover('show')

Avslører en popover for elementer.

  1. $ ( '#element' ). popover ( 'vis' )

.popover('skjul')

Skjuler en popover for elementer.

  1. $ ( '#element' ). popover ( 'skjul' )

.popover('toggle')

Slår av på en popover for elementer.

  1. $ ( '#element' ). popover ( 'veksle' )

.popover('destroy')

Skjuler og ødelegger et elements popover.

  1. $ ( '#element' ). popover ( 'ødelegge' )

Eksempler på varsler

Legg til avvisningsfunksjonalitet til alle varselmeldinger med denne plugin-modulen.

Hellige guacamole! Best sjekk deg selv, du ser ikke så bra ut.

Oh Snap! Du har en feil!

Endre dette og hint og prøv igjen. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Ta denne handlingen Eller gjør dette


Bruk

Aktiver avvisning av et varsel via JavaScript:

  1. $ ( ".alert" ). varsel ()

Markup

Bare legg data-dismiss="alert"til lukkeknappen for automatisk å gi et varsel om lukkefunksjonalitet.

  1. <a class = "close" data-dismiss = "alert" href = "#" > × </a>

Metoder

$().alert()

Dekker alle varsler med nærfunksjonalitet. For å få varslene dine til å animere når de er lukket, sørg for at de har .fadeog .inklassen allerede brukt på dem.

.alert('close')

Lukker et varsel.

  1. $ ( ".alert" ). varsel ( 'lukke' )

arrangementer

Bootstraps varslingsklasse avslører noen få hendelser for å koble til varslingsfunksjonalitet.

Begivenhet Beskrivelse
Lukk Denne hendelsen utløses umiddelbart når closeinstansmetoden kalles.
lukket Denne hendelsen utløses når varselet er lukket (vil vente på at css-overgangene er fullført).
  1. $ ( '#my-alert' ). bind ( 'lukket' , funksjon () {
  2. // gjør noe…
  3. })

Eksempelbruk

Gjør mer med knapper. Kontroller knappstatuser eller lag grupper med knapper for flere komponenter som verktøylinjer.

Stateful

Legg data-loading-text="Loading..."til for å bruke en lastetilstand på en knapp.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Laster ..." > Laster tilstand </button>

Enkel bryter

Legg data-toggle="button"til for å aktivere veksling på en enkelt knapp.

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" > Single Toggle </button>

Avmerkingsboks

Legg data-toggle="buttons-checkbox"til for veksling av avkrysningsboksstil på btn-gruppe.

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > Venstre </button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Høyre </button>
  5. </div>

Radio

Legg data-toggle="buttons-radio"til for å veksle mellom radiostil på btn-gruppe.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" > Venstre </button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Høyre </button>
  5. </div>

Bruk

Aktiver knapper via JavaScript:

  1. $ ( '.nav-tabs' ). knapp ()

Markup

Dataattributter er integrert i knappen-plugin. Sjekk ut eksempelkoden nedenfor for de ulike markup-typene.

Alternativer

Ingen

Metoder

$().button('toggle')

Bytter push-tilstand. Gir knappen det utseendet at den er aktivert.

Vær oppmerksom! Du kan aktivere automatisk veksling av en knapp ved å bruke data-toggleattributtet.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

$().button('laster')

Angir knappstatus til lasting - deaktiverer knapp og bytter tekst til lasting av tekst. Lastetekst skal defineres på knappeelementet ved hjelp av dataattributtet data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "laster ting..." > ... </button>
Vær oppmerksom! Firefox vedvarer den deaktiverte tilstanden på tvers av sideinnlastinger . En løsning for dette er å bruke autocomplete="off".

$().button('reset')

Tilbakestiller knappens tilstand - bytter tekst til originaltekst.

$().knapp(streng)

Tilbakestiller knappens tilstand - bytter tekst til hvilken som helst datadefinert teksttilstand.

  1. <button type = "button" class = "btn" data-complete-text = "ferdig!" > ... </knapp>
  2. <script>
  3. $ ( '.btn' ). knapp ( 'fullfør' )
  4. </script>

Om

Få basisstiler og fleksibel støtte for sammenleggbare komponenter som trekkspill og navigasjon.

* Krever at Transitions-pluginen er inkludert.

Eksempel trekkspill

Ved å bruke kollaps-pluginen bygde vi en enkel trekkspillstil-widget:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunsj. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Annonse vegansk unntatt slakter vice lomo. Leggings occaecat craft beer farm-to-table, rå denim estetisk synth nesciunt du sannsynligvis ikke har hørt om dem accusamus labore bærekraftig VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunsj. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Annonse vegansk unntatt slakter vice lomo. Leggings occaecat craft beer farm-to-table, rå denim estetisk synth nesciunt du sannsynligvis ikke har hørt om dem accusamus labore bærekraftig VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunsj. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Annonse vegansk unntatt slakter vice lomo. Leggings occaecat craft beer farm-to-table, rå denim estetisk synth nesciunt du sannsynligvis ikke har hørt om dem accusamus labore bærekraftig VHS.
  1. <div class = "trekkspill" id = "trekkspill2" >
  2. <div class = "trekkspill-gruppe" >
  3. <div class = "trekkspill-overskrift" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. Sammenleggbart gruppeelement #1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "trekkspill-kropp kollapser inn" >
  9. <div class = "trekkspill-inner" >
  10. Anim pariatur klisje...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "trekkspill-gruppe" >
  15. <div class = "trekkspill-overskrift" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Sammenleggbar gruppeelement #2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "trekkspill-kroppskollaps" >
  21. <div class = "trekkspill-inner" >
  22. Anim pariatur klisje...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

Du kan også bruke programtillegget uten trekkspilloppmerkingen. Få en knapp til å veksle mellom å utvide og kollapse et annet element.

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. enkel sammenleggbar
  3. </button>
  4.  
  5. <div id = "demo" class = "kollaps inn" > </div>

Bruk

Via dataattributter

Bare legg til data-toggle="collapse"og et data-targettil-element for å automatisk tildele kontroll over et sammenleggbart element. Attributtet data-targetgodtar en css-velger å bruke sammenbruddet på. Sørg for å legge klassen collapsetil det sammenleggbare elementet. Hvis du vil at den skal åpnes som standard, legger du til den ekstra klassen in.

For å legge til trekkspilllignende gruppestyring til en sammenleggbar kontroll, legg til dataattributtet data-parent="#selector". Se demoen for å se dette i aksjon.

Via JavaScript

Aktiver manuelt med:

  1. $ ( ".kollapse" ). kollapse ()

Alternativer

Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-, som i data-parent="".

Navn type misligholde beskrivelse
forelder velger falsk Hvis velgeren vil alle sammenleggbare elementer under den angitte overordnede bli lukket når dette sammenleggbare elementet vises. (ligner på tradisjonell trekkspilladferd)
veksle boolsk ekte Veksler på det sammenleggbare elementet ved påkalling

Metoder

.collapse(alternativer)

Aktiverer innholdet ditt som et sammenleggbart element. Godtar et valgfritt alternativ object.

  1. $ ( '#myCollapsible' ). kollaps ({
  2. veksle : usant
  3. })

.collapse('toggle')

Bytter et sammenleggbart element til vist eller skjult.

.collapse('show')

Viser et sammenleggbart element.

.collapse('hide')

Skjuler et sammenleggbart element.

arrangementer

Bootstraps kollapsklasse avslører noen få hendelser for å koble seg til kollapsfunksjonalitet.

Begivenhet Beskrivelse
forestilling Denne hendelsen utløses umiddelbart når showinstansmetoden kalles.
vist Denne hendelsen utløses når et kollapselement er gjort synlig for brukeren (vil vente på at css-overganger er fullført).
gjemme seg Denne hendelsen utløses umiddelbart når hidemetoden har blitt kalt.
skjult Denne hendelsen utløses når et kollapselement har blitt skjult for brukeren (vil vente på at css-overgangene er fullført).
  1. $ ( '#myCollapsible' ). ( 'skjult' , funksjon () {
  2. // gjør noe…
  3. })

Eksempel

En enkel, enkelt utvidet plugin for raskt å lage elegante skrivehoder med hvilken som helst form for tekstinndata.

  1. <input type = "text" data-provide = "typeahead" >

Du vil stille inn autocomplete="off"for å forhindre at standard nettlesermenyer vises over rullegardinmenyen Bootstrap typeahead.


Bruk

Via dataattributter

Legg til dataattributter for å registrere et element med typeahead-funksjonalitet som vist i eksempelet ovenfor.

Via JavaScript

Ring opp skrivingen manuelt med:

  1. $ ( '.typeahead' ). typeahead ()

Alternativer

Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-, som i data-source="".

Navn type misligholde beskrivelse
kilde array, funksjon [ ] Datakilden å spørre mot. Kan være en rekke strenger eller en funksjon. Funksjonen sendes to argumenter, queryverdien i inndatafeltet og processtilbakekallingen. Funksjonen kan brukes synkront ved å returnere datakilden direkte eller asynkront via processtilbakeringingens enkeltargument.
gjenstander Antall 8 Maksimalt antall elementer som skal vises i rullegardinmenyen.
minLengde Antall 1 Minimum tegnlengde som kreves før autofullføringsforslag utløses
matcher funksjon ufølsom for store og små bokstaver Metoden som brukes til å finne ut om et søk samsvarer med et element. Godtar et enkelt argument, itemmot hvilket spørringen skal testes. Få tilgang til gjeldende spørring med this.query. Returner en boolsk truehvis søket samsvarer.
sorterer funksjon eksakt samsvar,
skiller mellom store og små bokstaver, skiller mellom store og
små bokstaver
Metode som brukes til å sortere resultater for autofullføring. Godtar et enkelt argument itemsog har omfanget av typeahead-forekomsten. Referer til gjeldende spørring med this.query.
oppdatering funksjon returnerer valgt vare Metoden som brukes for å returnere valgt vare. Godtar et enkelt argument, itemog har omfanget av typeahead-forekomsten.
highlighter funksjon uthever alle standardtreff Metode som brukes til å fremheve autofullføringsresultater. Godtar et enkelt argument itemog har omfanget av typeahead-forekomsten. Skal returnere html.

Metoder

.typeahead(alternativer)

Initialiserer en inndata med en skriving.

Eksempel

Undernavigasjonen til venstre er en live demo av affix-plugin.


Bruk

Via dataattributter

For enkelt å legge til atferd til ethvert element, legg data-spy="affix"til elementet du vil spionere på. Bruk deretter forskyvninger for å definere når du skal slå festingen av et element av og på.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
Vær oppmerksom! Du må administrere posisjonen til et festet element og oppførselen til dets umiddelbare forelder. Posisjonen kontrolleres av affix, affix-top, og affix-bottom. Husk å se etter en potensielt kollapset forelder når affikset starter ettersom det fjerner innhold fra den normale flyten på siden.

Via JavaScript

Ring affix-plugin-modulen via JavaScript:

  1. $ ( '#navbar' ). feste ()

Alternativer

Alternativer kan sendes via dataattributter eller JavaScript. For dataattributter, legg til alternativnavnet til data-, som i data-offset-top="200".

Navn type misligholde beskrivelse
offset nummer | funksjon | gjenstand 10 Piksler for å forskyve fra skjermen ved beregning av rulleposisjon. Hvis et enkelt tall er oppgitt, vil forskyvningen bli brukt i både topp- og venstreretning. For å lytte etter en enkelt retning, eller flere unike forskyvninger, bare oppgi et objekt offset: { x: 10 }. Bruk en funksjon når du dynamisk skal gi en offset (nyttig for enkelte responsive design).