JavaScript

Bréngt dem Bootstrap seng Komponenten zum Liewen - elo mat 13 personaliséierte jQuery Plugins.

Kapp erop! Dës Dokumenter si fir v2.3.2, déi net méi offiziell ënnerstëtzt gëtt. Préift déi lescht Versioun vu Bootstrap!

Individuell oder zesummegesat

Plugins kënnen individuell abegraff ginn (och wann e puer erfuerderlech Ofhängegkeeten hunn), oder all op eemol. Béid bootstrap.js an bootstrap.min.js enthalen all Plugins an enger eenzeger Datei.

Daten Attributer

Dir kënnt all Bootstrap Plugins reng duerch d'Markup API benotzen ouni eng eenzeg Zeil vu JavaScript ze schreiwen. Dëst ass Bootstrap's éischt Klass API a sollt Är éischt Iwwerleeung sinn wann Dir e Plugin benotzt.

Dat gesot, an e puer Situatiounen kann et wënschenswäert sinn dës Funktionalitéit auszeschalten. Dofir bidde mir och d'Fäegkeet fir d'Datenattributer API auszeschalten andeems Dir all Eventer um Kierper mam Numm "data-api" unbinden. Dëst gesäit esou aus:

$('body').off('.data-api')

Alternativ, fir e spezifesche Plugin ze zielen, gitt just den Numm vum Plugin als Nummraum zesumme mam Data-APi Nummraum wéi dëst:

$('body').off('.alert.data-api')

Programmatesch API

Mir gleewen och datt Dir sollt fäeg sinn all Bootstrap Plugins reng duerch d'JavaScript API ze benotzen. All ëffentlech APIen sinn eenzel, chainable Methoden, a gitt d'Kollektioun zréck.

$(".btn.danger").button("toggle").addClass("fat")

All Methode sollen en optionalen Optiounsobjekt akzeptéieren, eng String déi eng bestëmmte Method zielt, oder näischt (wat e Plugin mam Standardverhalen initiéiert):

$("#myModal").modal() // initialiséiert mat Defaults
$("#myModal").modal({ Keyboard: false }) // initialiséiert ouni Tastatur
$("#myModal").modal('show') // initialiséiert an rifft d'Show direkt op

All Plugin weist och säi roude Konstruktor op enger 'Constructor' Eegeschafte $.fn.popover.Constructor:. Wann Dir eng bestëmmte Plugin Instanz wëllt kréien, recuperéieren se direkt vun engem Element $('[rel=popover]').data('popover'):.

Kee Konflikt

Heiansdo ass et néideg Bootstrap Plugins mat anere UI Kaderen ze benotzen. An dësen Ëmstänn kënnen Nummraumkollisiounen heiansdo optrieden. Wann dat passéiert, kënnt Dir .noConflictde Plugin uruffen, deen Dir wëllt de Wäert zrécksetzen.

var bootstrapButton = $.fn.button.noConflict() // zréck $.fn.button op virdrun zougewisen Wäert
$.fn.bootstrapBtn = bootstrapButton // gitt $().bootstrapBtn d'Bootstrap Funktionalitéit

Evenementer

Bootstrap bitt personaliséiert Eventer fir déi meescht Plugin eenzegaarteg Aktiounen. Allgemeng kommen dës an enger Infinitiv- a Vergaangenheetsform - wou den Infinitiv (ex. show) am Ufank vun engem Event ausgeléist gëtt, a seng Partizipform (ex. shown) ausgeléist gëtt beim Ofschloss vun enger Handlung.

All infinitiv Eventer bidden PräventiounDefault Funktionalitéit. Dëst bitt d'Fäegkeet d'Ausféierung vun enger Aktioun ze stoppen ier se ufänkt.

$('#myModal').on('show', function (e) {
    wann (! Donnéeën) Retour e.preventDefault () // stoppt modal gewisen
})

Iwwer Iwwergäng

Fir einfach Iwwergangseffekter, bootstrap-transition.js eng Kéier niewent deenen anere JS Dateien. Wann Dir de kompiléierten (oder minifizéierten) bootstrap.js benotzt , ass et net néideg dëst matzemaachen - et ass schonn do.

Benotzen Fäll

E puer Beispiller vum Iwwergangsplugin:

  • Rutsch oder verschwannen a Modal
  • Tabs verschwannen
  • Verschwannen Alarmer
  • Rutsch Karussell Panelen

Beispiller

Modale si streamlined, awer flexibel, Dialogprompts mat der minimaler erfuerderter Funktionalitéit a Smart Defaults.

Statescht Beispill

E rendered Modal mat Header, Kierper a Set vun Aktiounen am Fousszeil.

<div class="modal hide fade">
  <div class="modal-header">
    <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button>
    <h3>Modal Header</h3>
  </div>
  <div class="modal-body">
    <p>Ee schéine Kierper...</p>
  </div>
  <div class="modal-footer">
    <a href="#" class="btn">Zoumaachen</a>
    <a href="#" class="btn btn-primary">Ännerunge späicheren</a>
  </div>
</div>

Live Demo

Wiesselt e Modal iwwer JavaScript andeems Dir op de Knäppchen hei drënner klickt. Et rutscht erof a verschwannen vun uewen op der Säit.

<!-- Knäppchen fir Modal auszeléisen -->
<a href="#myModal" role="button" class="btn" data-toggle="modal">Demo Modal starten</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>Ee schéine Kierper...</p>
  </div>
  <div class="modal-footer">
    <button class="btn" data-dismiss="modal" aria-hidden="true">Zoumaachen</button>
    <button class="btn btn-primary">Ännerunge späicheren</button>
  </div>
</div>

Benotzung

Via daten Attributer

Aktivéiert e Modal ouni JavaScript ze schreiwen. Setzt data-toggle="modal"op e Controllerelement, wéi e Knäppchen, zesumme mat engem data-target="#foo"oder href="#foo"fir e spezifesche Modal ze zielen fir ze wiesselen.

<button type="button" data-toggle="modal" data-target="#myModal">Modal starten</button>

Iwwer JavaScript

Rufft e Modal mat ID myModalmat enger eenzeger Zeil vu JavaScript:

$('#myModal').modal(Options)

Optiounen

Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-, wéi an data-backdrop="".

Numm Typ Default Beschreiwung
Kuliss boolesch wouer Ëmfaasst e modal-Kulisse-Element. Alternativ, spezifizéiert staticfir eng Kuliss déi de Modal net op Klick zoumaacht.
Tastatur boolesch wouer Maacht de Modal zou wann d'Escape-Taste gedréckt gëtt
weisen boolesch wouer Weist de Modal wann initialiséiert.
Fernbedienung Wee falsch

Wann eng Remote-URL geliwwert gëtt, gëtt den Inhalt iwwer d'JQuery loadMethod gelueden an an d' .modal-body. Wann Dir den Date-API benotzt, kënnt Dir alternativ den hrefTag benotze fir d'Fernquell ze spezifizéieren. E Beispill vun dësem gëtt ënnendrënner gewisen:

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

Methoden

.modal (Optiounen)

Aktivéiert Ären Inhalt als Modal. Akzeptéiert eng fakultativ Optiounen object.

$('#myModal').modal({
  Keyboard: falsch
})

.modal('toggle')

Manuell wiesselt e Modal.

$('#myModal').modal('toggle')

.modal('show')

Manuell mécht e Modal op.

$('#myModal').modal('show')

.modal('verstoppen')

Manuell verstoppt e Modal.

$('#myModal').modal('hide')

Evenementer

Dem Bootstrap seng modal Klass weist e puer Eventer fir an d'modal Funktionalitéit unzehaken.

Event Beschreiwung
weisen Dëst Event brennt direkt wann d' showInstanzmethod genannt gëtt.
gewisen Dëst Evenement gëtt ausgeléist wann de Modal fir de Benotzer siichtbar gemaach gouf (waart op d'CSS Iwwergäng fir ze kompletéieren).
verstoppen Dëst Evenement gëtt direkt gebrannt wann d' hideInstanzmethod genannt gouf.
verstoppt Dëst Evenement gëtt ausgeléist wann de Modal fäerdeg ass vum Benotzer verstoppt ze ginn (waart op d'CSS Iwwergäng fir ze kompletéieren).
$('#myModal').on('hidden', function () {
  // maach eppes…
})

Beispill an navbar

De ScrollSpy Plugin ass fir automatesch Aktualiséierung vun Nav Ziler baséiert op Scroll Positioun. Scroll d'Gebitt ënner der Navbar a kuckt d'aktiv Klass änneren. D'Dropdown Ënnerartikele ginn och markéiert.

@fett

Ad Leggings Keytar, Brunch ID Art Party Dolor Laboure. Pitchfork yr enim lo-fi ier se ausverkaaft qui. Tumblr Bauerenhaff-zu-Dësch Vëlo Rechter egal. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's Photo Stand 3 Wolf Moon irure. Cosby Pullover Lomo Jean Shorts, Williamsburg Hoodie minim qui Dir hutt wahrscheinlech net vun hinnen héieren et Cardigan Trust Fund culpa Biodiesel Wes Anderson Aesthetic. Nihil tattooed accusamus, cred Ironie Biodiesel keffiyeh Handwierker ullamco consequat.

@mdo

Veniam Marfa Moustache Skateboard, adipising Fugiat Velit Pitchfork Baart. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat véier loko nisi, ea helvetica nulla carles. Tattooed Cosby Sweater Food Truck, Mcsweeney's quis non freegan Vinyl. Lo-fi wes anderson +1 sartorial. Carles net ästhetesch Übung quis gentrify. Brooklyn adipisicing Handwierksbetrieb Vice Keytar deserunt.

eent

Occaecat commodo aliqua delectus. Fap craft beer deserunt Skateboard ea. Lomo Vëlo Rechter adipisicing banh mi, velit ea sunt nächsten Niveau locavore Single-Origine Kaffi zu Magna Veniam. High Life ID Vinyl, Echo Park consequat quis aliquip banh mi pitchfork. Vero VHS ass adipisicing. Consectetur nisi DIY minim Messenger Bag. Cred ex in, nohalteg Delectus Consectetur Fanny Pack iPhone.

zwee

Am Incididunt Echo Park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS Elit, Proident Shoreditch +1 Biodiesel Laborum Handwierksbier. Single-Origine Kaffi Wayfarers irure véier Loko, Cupidatat Terry Richardson Meeschtesch Botzen. Assumenda Dir hutt wahrscheinlech net vun hinnen héieren Konscht Partei Fanny Pack, tattooed Nulla Cardigan temporär Annonce. Proident Wollef nesciunt sartorial keffiyeh eu banh mi nohalteg. Elit Wollef voluptate, lo-fi ea portland ier si verkaf véier Loko. Locavore enim nostrud mlkshk brooklyn nesciunt.

dräi

Ad Leggings Keytar, Brunch ID Art Party Dolor Laboure. Pitchfork yr enim lo-fi ier se ausverkaaft qui. Tumblr Bauerenhaff-zu-Dësch Vëlo Rechter egal. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's Photo Stand 3 Wolf Moon irure. Cosby Pullover Lomo Jean Shorts, Williamsburg Hoodie minim qui Dir hutt wahrscheinlech net vun hinnen héieren et Cardigan Trust Fund culpa Biodiesel Wes Anderson Aesthetic. Nihil tattooed accusamus, cred Ironie Biodiesel keffiyeh Handwierker ullamco consequat.

Keytar twee Blog, culpa Messenger Bag marfa wat och ëmmer delectus Food Truck. Sapiente synth id assumenda. Locavore sed helvetica cliche ironie, thundercats Dir wahrscheinlech net vun hinnen héieren hunn consequat Hoodie gluten-gratis lo-fi fap aliquip. Labore Elit Placeat ier se ausverkaaft hunn, Terry Richardson proident Brunch nesciunt quis Cosby Pullover pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Benotzung

Via daten Attributer

Fir einfach Scrollspy Verhalen op Är Topbar Navigatioun ze addéieren, füügt just data-spy="scroll"un d'Element un op deen Dir wëllt spionéieren (meeschtens wier dëst de Kierper) a data-target=".navbar"wielt wéi eng Navigatioun ze benotzen. Dir wëllt Scrollspy mat engem .navKomponent benotzen.

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

Iwwer JavaScript

Rufft de Scrollspy iwwer JavaScript un:

$('#navbar').scrollspy()
Kapp erop! Navbar Linken mussen opléisbar ID Ziler hunn. Zum Beispill, e <a href="#home">home</a>Must entspriechen eppes am Dom wéi <div id="home"></div>.

Methoden

.scrollspy('refresh')

Wann Dir Scrollspy benotzt a Verbindung mat der Zousatz oder Ewechhuele vun Elementer aus der DOM, musst Dir d'Erfrëschungsmethod sou nennen:

$('[data-spy="scroll"]').each(function () {
  var $spy = $(this).scrollspy('refresh')
});

Optiounen

Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-, wéi an data-offset="".

Numm Typ Default Beschreiwung
offset Zuel 10 Pixel fir vun uewen ze kompenséieren wann Dir d'Positioun vun der Scroll berechnen.

Evenementer

Event Beschreiwung
aktivéieren Dëst Event brennt wann en neit Element vum Scrollspy aktivéiert gëtt.

Beispill Tabs

Füügt séier, dynamesch Tab Funktionalitéit fir den Iwwergank duerch Paneele vum lokalen Inhalt, och iwwer Dropdown-Menüen.

Raw Denim Dir hutt wahrscheinlech net vun hinnen héieren Jean Shorts Austin. Nesciunt Tofu Stumptown Aliqua, Retro Synth Master Cleanse. Moustache Cliche Temper, Williamsburg Carles Vegan Helvetica. Reprehenderit Metzler Retro Keffiyeh Dreamcatcher Synth. Cosby Pullover eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan Aliquip quis Cardigan American Apparel, Metzler voluptate nisi qui.

Food Truck Fixie Locavore, Accusamus Mcsweeney's Marfa Nulla Single-Origin Coffee Squid. Ausübung +1 labore velit, Blog sartorial PBR Leggings nächste Niveau Wes Anderson Handwierker véier Loko Bauerenhaff-ze-Dësch Handwierksbetrieb Béier twee. Qui Photo Booth Letterpress, Commodo enim Handwierksbier mlkshk aliquip Jean Shorts ullamco ad Vinyl cillum PBR. Homo nostrud organesch, 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, nohalteg Jeans Shorts Baart aus DIY ethesch culpa Terry Richardson Biodiesel. Art Party scenester stumptown, tumblr Metzler vero sint qui sapiente accusamus tattooed Echo Park.


Benotzung

Aktivéiert Tabbar Tabs iwwer JavaScript (all Tab muss individuell aktivéiert ginn):

$('#myTab a').click(function (e) {
  e.preventDefault();
  $(dës).tab('weisen');
})

Dir kënnt eenzel Tabs op verschidde Manéieren aktivéieren:

$('#myTab a[href="#profil"]').tab('weisen'); // Wielt Tab mam Numm
$('#myTab a:first').tab('weisen'); // Wielt éischt Tab
$('#myTab a:lescht').tab('weisen'); // Wielt lescht Tab
$('#myTab li:eq(2) a').tab('show'); // Wielt drëtt Tab (0-indexéiert)

Markup

Dir kënnt eng Tab oder Pille Navigatioun aktivéieren ouni JavaScript ze schreiwen andeems Dir einfach spezifizéiert data-toggle="tab"oder data-toggle="pill"op en Element. D'Addéieren vun den nava nav-tabsKlassen op d'Tab ulwäert de Bootstrap Tab Styling uwenden.

<ul class="nav nav-tabs">
  <li><a href="#home" data-toggle="tab">Home</a></li>
  <li><a href="#profile" data-toggle="tab">Profil</a></li>
  <li><a href="#messages" data-toggle="tab">Messagen</a></li>
  <li><a href="#settings" data-toggle="tab">Astellungen</a></li>
</ul>

Methoden

$().tab

Aktivéiert e Tabelement an Inhaltsbehälter. Tab soll entweder en data-targetoder e hrefgezielt e Container Node am DOM hunn.

<ul class="nav nav-tabs" id="myTab">
  <li class="active"><a href="#home">Doheem</a></li>
  <li><a href="#profile">Profil</a></li>
  <li><a href="#messages">Messagen</a></li>
  <li><a href="#settings">Astellungen</a></li>
</ul>

<div class="tab-content">
  <div class="tab-pane active" id="home">...</div>
  <div class="tab-pane" id="profile">...</div>
  <div class="tab-pane" id="messages">...</div>
  <div class="tab-pane" id="settings">...</div>
</div>

<script>
  $(Funktioun () {
    $('#myTab a:lescht').tab('weisen');
  })
</script>

Evenementer

Event Beschreiwung
weisen Dëst Event brennt op Tab Show, awer ier déi nei Tab gewisen gouf. Benotzt event.targeta event.relatedTargetfir den aktiven Tab an déi viregt aktive Tab (wann verfügbar) respektiv ze zielen.
gewisen Dëst Event brennt op Tab Show nodeems eng Tab gewisen gouf. Benotzt event.targeta event.relatedTargetfir den aktiven Tab an déi viregt aktive Tab (wann verfügbar) respektiv ze zielen.
$('a[data-toggle="tab"]').on('gewise', Funktioun (e) {
  e.target // aktivéiert Tab
  e.relatedTarget // virdrun Tab
})

Beispiller

Inspiréiert vum exzellente jQuery.tipsy Plugin geschriwwen vum Jason Frame; Tooltips sinn eng aktualiséiert Versioun, déi net op Biller vertrauen, CSS3 fir Animatiounen benotzen, an Datenattributer fir lokal Titellagerung.

Aus Leeschtungsgrënn sinn d'Tooltip an d'Popover Data-Apis optéiert, dat heescht datt Dir se selwer initialiséiere musst .

Hover iwwer d'Links hei drënner fir Tooltipps ze gesinn:

Knapp Hosen nächste Level keffiyeh Dir hutt wahrscheinlech net vun hinnen héieren. Photo Stand Baart Raw Denim Letterpress Vegan Messenger Bag Stumptown. Farm-to-Table Seitan, Mcsweeney's Fixie nohalteg Quinoa 8-Bit amerikanesch Kleedung hunn e Terry Richardson Vinyl Chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu Biodiesel Williamsburg Marfa, véier Loko Mcsweeney's botzen vegan Chambray. Eng wierklech ironesch Handwierker egal Keytar , scenester Bauerenhaff-ze-Dësch banksy Austin Twitter Handle freegan cred rau Denim Single-Origine Kaffi viral.

Véier Richtungen

Tooltips an Inputgruppen

Wann Dir Tooltips a Popovers mat de Bootstrap Input Gruppen benotzt, musst Dir d' container(dokumentéiert ënnendrënner) Optioun setzen fir ongewollt Nebenwirkungen ze vermeiden.


Benotzung

Ausléiser den Tooltip iwwer JavaScript:

$('#example').tooltip(optiounen)

Optiounen

Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-, wéi an data-animation="".

Numm Typ Default Beschreiwung
Animatioun boolesch wouer gëllen eng css Fade Iwwergank op den Tooltip
html boolesch falsch Füügt HTML an den Tooltip un. Wann falsch, gëtt d' textMethode vun jquery benotzt fir Inhalt an d'Dom ze setzen. Benotzt Text wann Dir Iech Suergen iwwer XSS Attacken hutt.
Placement streng | Funktioun 'top' wéi de Tooltip ze positionéieren - Top | ënnen | lénks | riets
selector String falsch Wann e Selektor zur Verfügung gestallt gëtt, ginn Tooltip-Objeten op déi spezifizéiert Ziler delegéiert.
Titel streng | Funktioun '' Standard Titelwäert wann den 'Titel' Tag net präsent ass
ausléisen String 'Hover focus' wéi Tooltip ausgeléist gëtt - klickt | huel | konzentréieren | manuell. Notéiert Iech Fall Passe Ausléiser multiple, Raum getrennt, Ausléisertypen.
Retard Zuel | Objet 0

Verzögerung fir den Tooltip (ms) ze weisen an ze verstoppen - gëllt net fir manuell Ausléisertyp

Wann eng Zuel geliwwert gëtt, gëtt Verspéidung fir béid verstoppen / weisen applizéiert

Objektstruktur ass:delay: { show: 500, hide: 100 }

Container streng | falsch falsch

Fügt den Tooltip un e spezifescht Element uncontainer: 'body'

Kapp erop! Optiounen fir eenzel Tooltips kënnen alternativ duerch d'Benotzung vun Datenattributer spezifizéiert ginn.

Markup

<a href="#" data-toggle="tooltip" title="first tooltip">hief iwwer mech</a>

Methoden

$().tooltip(optiounen)

Befestegt e Tooltip-Handler op eng Elementsammlung.

.tooltip('weisen')

Entdeckt den Tooltip vun engem Element.

$('#element').tooltip('weisen')

.tooltip('verstoppen')

Verstoppt den Tooltip vun engem Element.

$('#element').tooltip('hide')

.tooltip('toggle')

Wiesselt den Tooltip vun engem Element.

$('#element').tooltip('toggle')

.tooltip('zerstéieren')

Verstoppt an zerstéiert den Tooltip vun engem Element.

$('#element').tooltip('zerstéieren')

Beispiller

Füügt kleng Iwwerlagerunge vum Inhalt, wéi déi um iPad, un all Element fir sekundär Informatioun ze wunnen. Hover iwwer de Knäppchen fir de Popover auszeléisen. Verlaangt Tooltip abegraff.

Statesch Popover

Véier Optiounen sinn verfügbar: uewen, riets, ënnen a lénks ausgeriicht.

Popover erop

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

Popover richteg

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

Popover ënnen

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

Popover lénks

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

Kee Markup, déi als Popovers gewise gëtt, ginn aus JavaScript an Inhalt an engem dataAttribut generéiert.

Live Demo

Véier Richtungen


Benotzung

Aktivéiert Popovers iwwer JavaScript:

$('#example').popover(optiounen)

Optiounen

Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-, wéi an data-animation="".

Numm Typ Default Beschreiwung
Animatioun boolesch wouer gëllen eng css Fade Iwwergank op den Tooltip
html boolesch falsch Setzt HTML an de Popover. Wann falsch, gëtt d' textMethode vun jquery benotzt fir Inhalt an d'Dom ze setzen. Benotzt Text wann Dir Iech Suergen iwwer XSS Attacken hutt.
Placement streng | Funktioun 'riets' wéi de Popover ze positionéieren - Top | ënnen | lénks | riets
selector String falsch wann e selector gëtt, Tooltip Objete ginn un déi spezifizéiert Ziler delegéiert
ausléisen String 'klickt' wéi Popover ausgeléist gëtt - klickt | huel | konzentréieren | manuell
Titel streng | Funktioun '' Standard Titelwäert wann den 'Titel' Attribut net präsent ass
Inhalt streng | Funktioun '' Standardinhaltswäert wann den Attribut "Dateninhalt" net präsent ass
Retard Zuel | Objet 0

Verspéidung weist a verstoppt de Popover (ms) - gëllt net fir manuell Ausléisertyp

Wann eng Zuel geliwwert gëtt, gëtt Verspéidung fir béid verstoppen / weisen applizéiert

Objektstruktur ass:delay: { show: 500, hide: 100 }

Container streng | falsch falsch

Fügt de Popover op e spezifescht Elementcontainer: 'body'

Kapp erop! Optiounen fir eenzel Popovers kënnen alternativ duerch d'Benotzung vun Datenattributer spezifizéiert ginn.

Markup

Aus Leeschtungsgrënn sinn d'Tooltip an d'Popover Data-Apis optéiert. Wann Dir se benotze wëllt, gitt einfach eng Selektiounsoptioun un.

Methoden

$().popover(optiounen)

Initializes Popovers fir eng Element Kollektioun.

.popover('weisen')

Entdeckt en Elementer Popover.

$('#element').popover('weisen')

.popover('verstoppen')

Verstoppt eng Elementer Popover.

$('#element').popover('hide')

.popover('toggle')

Wiesselt en Element Popover.

$('#element').popover('toggle')

.popover('zerstéieren')

Verstoppt an zerstéiert de Popover vun engem Element.

$('#element').popover('zerstéieren')

Beispill Alarmer

Füügt d'Entloossfunktioun un all Alarmmeldung mat dësem Plugin.

Hellege guacamole! Beschte kontrolléiert Iech selwer, Dir sicht net ze gutt.

Oh snap! Dir hutt e Feeler!

Ännert dat an dat a probéiert nach eng Kéier. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Huelt dës Aktioun Oder maacht dëst


Benotzung

Aktivéiert d'Entloossung vun enger Alarm iwwer JavaScript:

$(".alert").alert()

Markup

Füügt just data-dismiss="alert"un Äre Zoumaache Knäppchen fir automatesch eng Alarm Zoumaache Funktionalitéit ze ginn.

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

Methoden

$().alert()

Wraps all Alarmer mat enker Funktionalitéit. Fir Är Alarmer ze animéieren wann se zougemaach sinn, gitt sécher datt se d' Klass .fadean d' .inKlasse scho fir si applizéiert hunn.

.alert('close')

Maacht eng Alarm zou.

$(".alert").alert('close')

Evenementer

Dem Bootstrap seng Alarmklasse weist e puer Eventer aus fir an d'Alarmfunktionalitéit unzekoppelen.

Event Beschreiwung
zoumaachen Dëst Event brennt direkt wann d' closeInstanzmethod genannt gëtt.
zougemaach Dëst Evenement gëtt ausgeléist wann d'Alarm zougemaach gouf (waart op d'CSS Iwwergäng fir fäerdeg ze sinn).
$('#my-alert').bind('closed', function () {
  // maach eppes…
})

Beispill benotzt

Maacht méi mat Knäppercher. Kontroll Knäppchen Staaten oder Gruppe vu Knäppercher erstellen fir méi Komponenten wéi Toolbaren.

Staatlech

Füügt data-loading-text="Loading..."fir e Luedezoustand op engem Knäppchen ze benotzen.

<button type="button" class="btn btn-primary" data-loading-text="Loading...">Ladenstatus</button>

Eenzel Këscht

Füügt data-toggle="button"fir den Toggling op engem eenzege Knäppchen z'aktivéieren.

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

Checkbox

Füügt data-toggle="buttons-checkbox"fir d'Checkbox-Stil ze wiesselen op btn-Grupp.

<div class="btn-group" data-toggle="buttons-checkbox">
  <button type="button" class="btn btn-primary">Lénks</button>
  <button type="button" class="btn btn-primary">Mëtt</button>
  <button type="button" class="btn btn-primary">Recht</button>
</div>

Radio

Füügt data-toggle="buttons-radio"fir Radiostil ze wiesselen op btn-Grupp.

<div class="btn-group" data-toggle="buttons-radio">
  <button type="button" class="btn btn-primary">Lénks</button>
  <button type="button" class="btn btn-primary">Mëtt</button>
  <button type="button" class="btn btn-primary">Recht</button>
</div>

Benotzung

Knäppercher iwwer JavaScript aktivéieren:

$('.nav-tabs').button()

Markup

Donnéeën Attributer sinn integral un de Knäppchen Plugin. Kuckt de Beispillcode hei ënnen fir déi verschidde Markuptypen.

Optiounen

Keen

Methoden

$().button('toggle')

Wiesselt Push Staat. Gëtt de Knäppchen d'Erscheinung datt et aktivéiert gouf.

Kapp erop! Dir kënnt den automateschen Toggling vun engem Knäppchen aktivéieren andeems Dir den data-toggleAttribut benotzt.
<button type="button" class="btn" data-toggle="button" >...</button>

$().button('loading')

Setzt de Knäppchenzoustand fir d'Luede ze setzen - deaktivéiert de Knäppchen an wiesselt Text op d'Luede vum Text. Luede Text soll op de Knäppchen Element definéiert ginn mat der Daten Attribut data-loading-text.

<button type="button" class="btn" data-loading-text="loading stuff..." >...</button>
Kapp erop! Firefox behält den behënnerte Staat iwwer d'Säitladungen . Eng Léisung fir dëst ass ze benotzen autocomplete="off".

$().button('reset')

Reset Knäppchen Staat - wiesselt Text op Originaltext.

$().button(string)

Reset Knäppchen Staat - tauscht Text an all Daten definéiert Text Staat.

<button type = "button" class = "btn" data-complete-text = "fäerdeg!" >...</button>
<script>
  $('.btn').button('komplett')
</script>

Iwwer

Kritt Basisstiler a flexibel Ënnerstëtzung fir zesummeklappbare Komponenten wéi Akkordeonen a Navigatioun.

* Verlaangt datt den Transitions Plugin abegraff ass.

Beispill Akkordeon

Mat dem Zesummebroch Plugin hu mir en einfachen Akkordeonstil Widget gebaut:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 Wolf Mound Officia Aute, Non Cupidatat Skateboard Dolor Brunch. Food Truck Quinoa nesciunt laborum eiusmod. Brunch 3 Wollef Mound temporär, sunt aliqua e Vugel op et squid Single-Origine Kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan Excepteur Metzler Vice Lomo. Leggings occaecat Handwierksbier Bauerenhaff-zu-Dësch, Matière Denim ästheteschen Synth nesciunt Dir wahrscheinlech net vun hinnen héieren hunn accusamus labore nohalteg VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 Wolf Mound Officia Aute, Non Cupidatat Skateboard Dolor Brunch. Food Truck Quinoa nesciunt laborum eiusmod. Brunch 3 Wollef Mound temporär, sunt aliqua e Vugel op et squid Single-Origine Kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan Excepteur Metzler Vice Lomo. Leggings occaecat Handwierksbier Bauerenhaff-zu-Dësch, Matière Denim ästheteschen Synth nesciunt Dir wahrscheinlech net vun hinnen héieren hunn accusamus labore nohalteg VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 Wolf Mound Officia Aute, Non Cupidatat Skateboard Dolor Brunch. Food Truck Quinoa nesciunt laborum eiusmod. Brunch 3 Wollef Mound temporär, sunt aliqua e Vugel op et squid Single-Origine Kaffi nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan Excepteur Metzler Vice Lomo. Leggings occaecat Handwierksbier Bauerenhaff-zu-Dësch, Matière Denim ästheteschen Synth nesciunt Dir wahrscheinlech net vun hinnen héieren hunn accusamus labore nohalteg VHS.
<div class="Accordeon" id="Accordeon2">
  <div class="accordion-group">
    <div class="accordion-heading">
      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseOne">
        Zesummeklappbar Grupp Element #1
      </a>
    </div>
    <div id = "collapseOne" class = "Accordeon-Kierper Zesummebroch an">
      <div class="accordion-inner">
        Anim pariatur cliche...
      </div>
    </div>
  </div>
  <div class="accordion-group">
    <div class="accordion-heading">
      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseTwo">
        Zesummeklappbar Grupp Element #2
      </a>
    </div>
    <div id = "collapseTwo" class = "accordion-body collapse">
      <div class="accordion-inner">
        Anim pariatur cliche...
      </div>
    </div>
  </div>
</div>
...

Dir kënnt och de Plugin ouni Akkordeon Markup benotzen. Maacht e Knäppchen wiesselt d'Erweiderung an Zesummebroch vun engem aneren Element.

<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
  einfach zesummeklappbar
</button>

<div id="demo" class="collapse in"> … </div>

Benotzung

Via daten Attributer

Füügt einfach data-toggle="collapse"an en data-targetElement fir automatesch d'Kontroll vun engem zesummeklappbare Element ze zouzeschreiwen. Den data-targetAttribut akzeptéiert e css Selector fir den Zesummebroch anzebezéien. Vergewëssert Iech d'Klass collapsezum zesummeklappbare Element ze addéieren. Wann Dir wëllt datt et als Standard opmaacht, füügt déi zousätzlech Klass in.

Fir Akkordeonähnlech Gruppemanagement zu enger zesummeklappbarer Kontroll ze addéieren, füügt d'Datenattribut data-parent="#selector". Kuckt d'Demo fir dëst an Aktioun ze gesinn.

Iwwer JavaScript

Aktivéiert manuell mat:

$(".collapse").collapse()

Optiounen

Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-, wéi an data-parent="".

Numm Typ Default Beschreiwung
Elterendeel selector falsch Wann selector dann all zesummeklappbare Elementer ënner dem spezifizéierten Elterendeel zougemaach ginn wann dëst zesummeklappbare Element gewise gëtt. (ähnlech wéi traditionell Akkordeonverhalen)
wiesselen boolesch wouer Wiesselt dat zesummeklappbare Element op Uruff

Methoden

.collapse (Optiounen)

Aktivéiert Ären Inhalt als zesummeklappbar Element. Akzeptéiert eng fakultativ Optiounen object.

$('#myCollapsible').collapse({
  toggle: falsch
})

.collapse('toggle')

Wiesselt en zesummeklappbare Element fir ze weisen oder verstoppt.

.collapse('weisen')

Weist en zesummeklappbare Element.

.collapse('verstoppen')

Verstoppt en zesummeklappbare Element.

Evenementer

Dem Bootstrap seng Zesummebroch Klass weist e puer Eventer fir an d'Zesummefunktionalitéit unzehaken.

Event Beschreiwung
weisen Dëst Event brennt direkt wann d' showInstanzmethod genannt gëtt.
gewisen Dëst Evenement gëtt ausgeléist wann e Zesummebroch Element fir de Benotzer siichtbar gemaach gouf (waart op d'CSS Iwwergäng fir ze kompletéieren).
verstoppen Dëst Evenement gëtt direkt gebrannt wann d' hideMethod genannt gouf.
verstoppt Dëst Evenement gëtt ausgeléist wann en Zesummebroch Element vum Benotzer verstoppt ass (waart op d'CSS Iwwergäng fir fäerdeg ze sinn).
$('#myCollapsible').on('hidden', function () {
  // maach eppes…
})

Beispill

E Basis, liicht erweiderten Plugin fir séier elegant Schreifweis mat all Form Textinput ze kreéieren.

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

Dir wëllt setzen autocomplete="off"fir ze verhënneren datt Standardbrowsermenüen iwwer de Bootstrap Typeahead Dropdown erschéngen.


Benotzung

Via daten Attributer

Füügt Donnéeën Attributer fir en Element mat Typeahead Funktionalitéit ze registréieren wéi am Beispill hei uewen gewisen.

Iwwer JavaScript

Rufft den Typahead manuell mat:

$('.typeahead').typeahead()

Optiounen

Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-, wéi an data-source="".

Numm Typ Default Beschreiwung
Quell array, Funktioun [ ] D'Datenquell fir ze froen géint. Kann eng Array vu Saiten oder eng Funktioun sinn. D'Funktioun gëtt zwee Argumenter iwwerginn, de queryWäert am Inputfeld an den processCallback. D'Funktioun kann synchron benotzt ginn andeems d'Datenquell direkt oder asynchron iwwer dat processeenzegt Argument vum Callback zréckgeet.
Artikelen Zuel 8 Déi maximal Unzuel vun Elementer fir am Dropdown-Menü ze weisen.
min Längt Zuel 1 Déi minimum Zeechelängt néideg ier Dir Autocomplete Suggestioune ausléist
matcher Funktioun Fall sensibel D'Method déi benotzt gëtt fir ze bestëmmen ob eng Ufro mat engem Artikel entsprécht. Akzeptéiert een eenzegt Argument, itemgéint deen d'Ufro getest gëtt. Zougrëff op déi aktuell Ufro mat this.query. Gitt e Boolean zréck truewann d'Ufro e Match ass.
sorter Funktioun genee Match,
Fall sensibel,
Fall onsensibel
Method benotzt fir Autocomplete Resultater ze sortéieren. Akzeptéiert en eenzegt Argument itemsan huet den Ëmfang vun der Typeahead Instanz. Referenzéiert déi aktuell Ufro mat this.query.
updater Funktioun gëtt ausgewielt Element zréck D'Method déi benotzt gëtt fir ausgewielten Artikel zréckzekommen. Akzeptéiert en eenzegt Argument, den iteman huet den Ëmfang vun der Typeahead Instanz.
highlighter Funktioun Héichpunkter all Default Matcher Method benotzt fir Autocomplete Resultater ze markéieren. Akzeptéiert en eenzegt Argument iteman huet den Ëmfang vun der Typeahead Instanz. Sollt HTML zréckginn.

Methoden

.typeahead(Optiounen)

Initialiséiert en Input mat engem Typahead.

Beispill

D'Subnavigatioun op der lénker Säit ass eng Live Demo vum Affix Plugin.


Benotzung

Via daten Attributer

Fir einfach Affix Verhalen op all Element ze addéieren, füügt just data-spy="affix"un dat Element op deen Dir wëllt spionéieren. Benotzt dann Offsets fir ze definéieren wéini de Pinning vun engem Element un an ausgeschalt gëtt.

<div data-spy="affix" data-offset-top="200">...</div>
Kapp erop! Dir musst d'Positioun vun engem festen Element an d'Behuele vu sengem direkten Elterendeel managen. Positioun gëtt kontrolléiert duerch affix, affix-top, an affix-bottom. Vergiesst net fir e potenziell zesummegeklappte Elterendeel ze kontrolléieren wann d'Affix erakënnt wéi et Inhalt aus dem normale Floss vun der Säit läscht.

Iwwer JavaScript

Rufft den Affix Plugin iwwer JavaScript un:

$('#navbar').affix()

Optiounen

Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-, wéi an data-offset-top="200".

Numm Typ Default Beschreiwung
offset Zuel | Funktioun | Objet 10 Pixel fir vum Écran ze kompenséieren wann Dir d'Positioun vun der Scroll berechnen. Wann eng eenzeg Nummer geliwwert gëtt, gëtt de Offset souwuel uewe wéi lénks Richtung applizéiert. Fir no enger eenzeger Richtung ze lauschteren, oder verschidde eenzegaarteg Offsets, gitt just en Objet offset: { x: 10 }. Benotzt eng Funktioun wann Dir dynamesch en Offset muss ubidden (nëtzlech fir e puer reaktiounsfäeg Designen).