JavaSkript
Bring Bootstrap ta libben mei ús opsjonele JavaScript-plugins boud op jQuery. Learje oer elke plugin, ús gegevens en programmatyske API-opsjes, en mear.
Ynstekkers kinne yndividueel opnommen wurde (mei it yndividu fan Bootstrap js/dist/*.js
), of allegear tagelyk mei bootstrap.js
of de minifisearre bootstrap.min.js
(befette beide net).
As jo in bondel brûke (Webpack, Rollup ...), kinne jo /js/dist/*.js
bestannen brûke dy't UMD klear binne.
Guon plugins en CSS-komponinten binne ôfhinklik fan oare plugins. As jo plugins yndividueel opnimme, soargje derfoar dat jo dizze ôfhinklikens kontrolearje yn 'e dokuminten. Tink derom ek dat alle plugins ôfhinklik binne fan jQuery (dit betsjut dat jQuery moat wurde opnommen foar de plugin-bestannen). Rieplachtsje úspackage.json
om te sjen hokker ferzjes fan jQuery wurde stipe.
Us dropdowns, popovers en tooltips binne ek ôfhinklik fan Popper.js .
Hast alle Bootstrap-plugins kinne wurde ynskeakele en konfigureare fia HTML allinich mei gegevensattributen (ús foarkommende manier om JavaScript-funksjonaliteit te brûken). Wês der wis fan dat jo mar ien set gegevensattributen brûke op ien elemint (jo kinne bygelyks gjin tooltip en modaal fan deselde knop oansette.)
Yn guon situaasjes kin it lykwols winsklik wêze om dizze funksjonaliteit út te skeakeljen. Om it data-attribút API út te skeakeljen, ûntbine alle eveneminten op it dokumint mei nammespaasje mei data-api
sa:
As alternatyf, om in spesifyk plugin te rjochtsjen, befetsje gewoan de namme fan 'e plugin as in nammeromte tegearre mei de data-api nammeromte sa:
Ûntsnapping selectors
As jo gebrûk meitsje fan spesjale selectors, bygelyks: collapse:Example
, wês wis te ûntkommen se, want se sille wurde trochjûn troch jQuery.
Bootstrap leveret oanpaste eveneminten foar de unike aksjes fan de measte plugins. Yn 't algemien komme dizze yn in ynfinityf en doedestiidsfoarm - wêrby't de ynfinityf (bgl. show
) oan it begjin fan in barren ynskeakele wurdt, en syn doetiidsfoarm (bgl. shown
) wurdt aktivearre by it foltôgjen fan in aksje.
Alle infinitive eveneminten jouwe preventDefault()
funksjonaliteit. Dit jout de mooglikheid om de útfiering fan in aksje te stopjen foardat it begjint. It werombringen fan falsk fan in evenemintehanneler sil ek automatysk oproppe preventDefault()
.
Wy leauwe ek dat jo alle Bootstrap-plugins moatte kinne brûke suver fia de JavaScript API. Alle iepenbiere APIs binne single, chainable metoaden, en werom de kolleksje hannele op.
Alle metoaden moatte in opsjoneel opsjeobjekt akseptearje, in tekenrige dy't in bepaalde metoade rjochtet, of neat (wat in plugin inisjearret mei standertgedrach):
Elke plugin bleatstelt ek syn rauwe konstruktor op in Constructor
eigendom $.fn.popover.Constructor
:. As jo in bepaalde plugin-eksimplaar wolle krije, helje it dan direkt fan in elemint op: $('[rel="popover"]').data('popover')
.
Alle programmatyske API-metoaden binne asyngroan en geane werom nei de beller as de oergong is begon, mar foardat it einiget .
Om in aksje út te fieren as de oergong foltôge is, kinne jo harkje nei it korrespondearjende evenemint.
Derneist sil in metoadeoprop op in oergongskomponint wurde negearre .
Jo kinne de standertynstellingen foar in plugin feroarje troch it Constructor.Default
objekt fan 'e plugin te feroarjen:
Soms is it nedich om Bootstrap-plugins te brûken mei oare UI-kaders. Yn dizze omstannichheden kinne nammeromte botsingen soms foarkomme. As dit bart, kinne jo .noConflict
de plugin oanroppe wêrfan jo de wearde weromsette wolle.
De ferzje fan elk fan Bootstrap's jQuery-plugins kin tagonklik wurde fia it VERSION
eigendom fan 'e plugin's konstruktor. Bygelyks foar de tooltip-plugin:
De plugins fan Bootstrap falle net bysûnder sierlik werom as JavaScript is útskeakele. As jo yn dit gefal soarch hawwe oer de brûkersûnderfining, brûk <noscript>
dan om de situaasje (en hoe't jo JavaScript opnij ynskeakelje kinne) oan jo brûkers út te lizzen, en/of jo eigen oanpaste fallbacks ta te foegjen.
Tredde bibleteken
Bootstrap stipet gjin offisjeel JavaScript-biblioteken fan tredden lykas Prototype of jQuery UI. Nettsjinsteande .noConflict
barrens mei nammen, kinne d'r kompatibiliteitsproblemen wêze dy't jo sels moatte reparearje.
Alle JavaScript-bestannen fan Bootstrap binne ôfhinklik fan util.js
en it moat wurde opnaam neist de oare JavaScript-bestannen. As jo de kompilearre (of minifisearre) brûke bootstrap.js
, is it net nedich om dit op te nimmen - it is der al.
util.js
omfettet nutsfunksjes en in basishelper foar transitionEnd
eveneminten, lykas ek in CSS-oergongemulator. It wurdt brûkt troch de oare plugins om te kontrolearjen op CSS-oergongsstipe en om hingjende oergongen te fangen.