JavaScript

Ажывіце кампаненты Bootstrap — цяпер з 13 карыстацкімі плагінамі jQuery.

Галаву ўверх! Гэтыя дакументы прызначаны для версіі 2.3.2, якая больш афіцыйна не падтрымліваецца. Праверце апошнюю версію Bootstrap!

Індывідуальныя або складзеныя

Убудовы можна ўключаць паасобку (хоць некаторыя з іх маюць неабходныя залежнасці) або ўсе адразу. І bootstrap.js , і bootstrap.min.js утрымліваюць усе плагіны ў адным файле.

Атрыбуты дадзеных

Вы можаце выкарыстоўваць усе плагіны Bootstrap выключна праз API разметкі, не напісаўшы ніводнага радка JavaScript. Гэта API першага класа Bootstrap, на які вы павінны звяртаць увагу пры выкарыстанні плагіна.

Тым не менш, у некаторых сітуацыях можа быць пажадана адключыць гэтую функцыю. Такім чынам, мы таксама даем магчымасць адключыць API атрыбутаў даных, адвязаўшы ўсе падзеі ў прасторы імёнаў цела з "data-api". Гэта выглядае так:

  1. $ ( 'цела' ). выключана ( '.data-api' )

У якасці альтэрнатывы, каб арыентавацца на пэўны плагін, проста ўключыце імя плагіна ў якасці прасторы імёнаў разам з прасторай імёнаў data-api, як гэта:

  1. $ ( 'цела' ). выключана ( '.alert.data-api' )

Праграмны API

Мы таксама лічым, што вы павінны мець магчымасць выкарыстоўваць усе плагіны Bootstrap выключна праз JavaScript API. Усе агульнадаступныя API з'яўляюцца адзінкавымі метадамі з ланцужком і вяртаюць калекцыю, на якую дзейнічаюць.

  1. $ ( ".btn.danger" ). кнопка ( "пераключальнік" ). addClass ( "тоўсты" )

Усе метады павінны прымаць неабавязковы аб'ект опцый, радок, які накіраваны на пэўны метад, або нічога (што ініцыюе плагін з паводзінамі па змаўчанні):

  1. $ ( "#myModal" ). мадальны () // ініцыялізаваны па змаўчанні
  2. $ ( "#myModal" ). мадальны ({ клавіятура : false }) // ініцыялізуецца без клавіятуры
  3. $ ( "#myModal" ). modal ( 'show' ) // ініцыялізуе і неадкладна выклікае show

Кожны плагін таксама паказвае свой неапрацаваны канструктар ва ўласцівасці Constructor: $.fn.popover.Constructor. Калі вы жадаеце атрымаць пэўны асобнік плагіна, атрымайце яго непасрэдна з элемента: $('[rel=popover]').data('popover').

Ніякага канфлікту

Часам неабходна выкарыстоўваць плагіны Bootstrap з іншымі структурамі карыстацкага інтэрфейсу. У такіх абставінах перыядычна могуць узнікаць сутыкненні прасторы імёнаў. Калі гэта адбудзецца, вы можаце выклікаць .noConflictплагін, значэнне якога хочаце вярнуць.

  1. var bootstrapButton = $ . fn . кнопка . noConflict () // вяртанне $.fn.button да раней прысвоенага значэння
  2. $ . fn . bootstrapBtn = bootstrapButton // даць $().bootstrapBtn функцыі загрузкі

Падзеі

Bootstrap забяспечвае карыстальніцкія падзеі для большасці унікальных дзеянняў плагіна. Як правіла, яны бываюць у форме інфінітыва і дзеепрыметніка прошлага часу - дзе інфінітыў (напр. show) спрацоўвае ў пачатку падзеі, а яго форма прошлага дзеепрыметніка (напр. shown) спрацоўвае пасля завяршэння дзеяння.

Усе бясконцыя падзеі забяспечваюць функцыянальнасць preventDefault. Гэта забяспечвае магчымасць спыніць выкананне дзеяння да яго пачатку.

  1. $ ( '#myModal' ). on ( 'паказаць' , функцыя ( e ) {
  2. if (! data ) return e . preventDefault () // спыняе паказ мадальнага
  3. })

Пра пераходы

Для простых эфектаў пераходу ўключыце bootstrap-transition.js адзін раз разам з іншымі файламі JS. Калі вы выкарыстоўваеце скампіляваны (або скарочаны) bootstrap.js , няма неабходнасці ўключаць яго — ён ужо ёсць.

Случаі выкарыстання

Некалькі прыкладаў плагіна пераходу:

  • Слізгаценне або знікненне ў мадальных
  • Згасанне ўкладак
  • Згасанне абвестак
  • Рассоўныя каруселі

Прыклады

Modals - гэта абцякальныя, але гнуткія дыялогавыя падказкі з мінімальнымі неабходнымі функцыянальнымі магчымасцямі і разумнымі наладамі па змаўчанні.

Статычны прыклад

Візуалізаваны мадальны з загалоўкам, тэкстам і наборам дзеянняў у ніжнім калонтытуле.

  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> Мадальны загаловак </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> Адно цудоўнае цела… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" > Зачыніць </a>
  11. <a href = "#" class = "btn btn-primary" > Захаваць змены </a>
  12. </div>
  13. </div>

Жывая дэманстрацыя

Пераключыце мадальны рэжым праз JavaScript, націснуўшы кнопку ніжэй. Ён будзе слізгаць уніз і знікаць з верхняй часткі старонкі.

  1. <!-- Кнопка для запуску мадальнага -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Запусціць дэма-мадальны </a>
  3.  
  4. <!-- Мадальны -->
  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" > Мадальны загаловак </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> Адно цудоўнае цела… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Зачыніць </button>
  15. <button class = "btn btn-primary" > Захаваць змены </button>
  16. </div>
  17. </div>

Выкарыстанне

Праз атрыбуты дадзеных

Актывуйце мадальнае без напісання JavaScript. Усталюйце data-toggle="modal"элемент кантролера, напрыклад кнопку, разам з data-target="#foo"або href="#foo", каб нацэліць на пэўны мадаль для пераключэння.

  1. <button type = "button" data-toggle = "modal " data-target = "#myModal" > Запусціць мадальны </button>

Праз JavaScript

Выклік мадальнага з ідэнтыфікатарам myModalз дапамогай аднаго радка JavaScript:

  1. $ ( '#myModal' ). мадальны ( варыянты )

Параметры

Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-backdrop="".

Імя тыпу па змаўчанні апісанне
заднік лагічны праўда Уключае элемент мадальнага фону. У якасці альтэрнатывы ўкажыце staticдля фону, які не закрывае мадальнае пры пстрычцы.
клавіятура лагічны праўда Закрывае мадальнае, калі націснута клавіша выхаду
паказаць лагічны праўда Паказвае мадальнае пры ініцыялізацыі.
аддалены шлях ілжывы

Калі аддалены URL-адрас, кантэнт будзе загружаны з дапамогай loadметаду jQuery і ўстаўлены ў .modal-body. Калі вы выкарыстоўваеце API даных, у якасці альтэрнатывы вы можаце выкарыстоўваць hrefтэг для ўказання аддаленай крыніцы. Прыклад гэтага паказаны ніжэй:

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

Метады

.modal (параметры)

Актывуе ваш кантэнт як мадальны. Прымае дадатковыя параметры object.

  1. $ ( '#myModal' ). мадальны ({
  2. клавіятура : ілжыва
  3. })

.modal('пераключыць')

Уручную пераключае мадальнае.

  1. $ ( '#myModal' ). мадальны ( 'пераключыць' )

.modal('паказаць')

Уручную адкрывае мадальнае.

  1. $ ( '#myModal' ). мадальны ( 'паказаць' )

.modal('схаваць')

Уручную хавае мадальнае.

  1. $ ( '#myModal' ). мадальны ( 'схаваць' )

Падзеі

Мадальны клас Bootstrap паказвае некалькі падзей для падключэння да мадальнай функцыянальнасці.

Падзея Апісанне
паказаць Гэта падзея запускаецца неадкладна пры showвыкліку метаду асобніка.
паказана Гэта падзея запускаецца, калі мадальны элемент становіцца бачным для карыстальніка (будзе чакаць завяршэння пераходаў CSS).
схаваць Гэта падзея запускаецца неадкладна, калі hideбыў выкліканы метад асобніка.
схаваны Гэта падзея запускаецца, калі мадаль скончыў быць схаваным ад карыстальніка (будзе чакаць завяршэння пераходаў CSS).
  1. $ ( '#myModal' ). on ( 'hidden' , function () {
  2. // зрабіць нешта...
  3. })

Прыклад у панэлі навігацыі

Плагін ScrollSpy прызначаны для аўтаматычнага абнаўлення мэт навігацыі на аснове пазіцыі пракруткі. Пракруціце вобласць пад панэллю навігацыі і паглядзіце, як змяняецца актыўны клас. Выпадальныя падпункты таксама будуць вылучаны.

@тоўсты

Рэкламныя легінсы кейтар, бранч ід арт вечарынка долар працы. Pitchfork yr enim lo-fi, перш чым яны раскупілі qui. Правы на веласіпеды Tumblr ад фермы да стала. Кардіган Anim keffiyeh Carles. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Швэдар Cosby, джынсавыя шорты ў стылі лома, талстоўка з капюшонам Williamsburg, мінімальная талстоўка, пра якую вы, напэўна, не чулі, і кардыган, траставы фонд, эстэтыка біядызеля Уэса Андэрсана. Nihil вытатуяваны акузамус, іронія біядызель keffiyeh рамеснік ullamco consequat.

@mdo

Веніям марфа вусы скейтборд, адзіпісінг фугіат вяліт вілы барада. Барада Фрыгана, як купідатат Вера Максуіні. Cupidatat four loko nisi, ea helvetica nulla carles. Швэдар Косбі з татуіроўкамі, фуд-трак, вінілавая кружэлка mcsweeney's quis non freegan. Lo-fi Уэс Андэрсан +1 швейнае майстэрства. Carles неэстэтычнае практыкаванне quis gentrify. Brooklyn adipisicing vice beer vice keytar deserunt.

адзін

Occaecat commodo aliqua delectus. Fap крафтавае піва дэзерунт скейтборд ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin кава in magna veniam. High life id вініл, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi мініяцюрная сумка DIY. Cred ex in, sustainable 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.

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 blog, culpa messenger bag marfa whatever delectus food truck. Сапіентэ сінтэз ідэнтыфікатар мяркуецца. Locavore sed helvetica cliche іронія, thundercats, вы напэўна не чулі пра іх consequat талстоўка без глютена lo-fi fap aliquip. Labore elit placeat, перш чым яны былі распрададзеныя, Тэры Рычардсан праходзіў позні сняданак, не знайшоўшы косбі-швэдар, парыятур, кефію, або рамеснік. Кардіган крафтавы піва сейтан гатовы веліт. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Выкарыстанне

Праз атрыбуты дадзеных

Каб лёгка дадаць паводзіны шпіёна для пракруткі ў верхнюю панэль навігацыі, проста дадайце data-spy="scroll"элемент, за якім вы хочаце сачыць (часцей за ўсё гэта будзе цела), і data-target=".navbar"выберыце, якую навігацыю выкарыстоўваць. Вы захочаце выкарыстоўваць ScrollSpy з .navкампанентам.

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

Праз JavaScript

Выклік ScrollSpy праз JavaScript:

  1. $ ( '#navbar' ). ScrollSpy ()
Галаву ўверх! Спасылкі на панэлі навігацыі павінны мець дазвольныя ідэнтыфікатары. Напрыклад, <a href="#home">home</a>павінен адпавядаць чаму-то ў доме, як <div id="home"></div>.

Метады

.scrollspy('абнавіць')

Пры выкарыстанні scrollspy у спалучэнні з даданнем або выдаленнем элементаў з DOM вам трэба будзе выклікаць метад refresh так:

  1. $ ( '[data-spy="пракрутка"]' ). кожны ( функцыя () {
  2. var $spy = $ ( гэта ). scrollspy ( 'абнавіць' )
  3. });

Параметры

Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-offset="".

Імя тыпу па змаўчанні апісанне
зрушэнне лік 10 Пікселі для зрушэння ад верху пры разліку пазіцыі пракруткі.

Падзеі

Падзея Апісанне
актываваць Гэта падзея спрацоўвае кожны раз, калі новы элемент актывуецца ScrollSpy.

Прыклады ўкладак

Дадайце хуткую дынамічную функцыянальнасць укладак для пераходу паміж панэлямі лакальнага кантэнту, нават праз выпадальныя меню.

Неапрацаваны дэнім, вы напэўна не чулі пра іх джынсавыя шорты Осцін. Nesciunt tofu stumptown aliqua, рэтра-сінтэзатар майстар ачысткі. Moustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Швэдар Cosby eu banh mi, qui irure Тэры Рычардсан былы кальмар. Aliquip placeat salvia cillum iphone. Seitan aliquip quis кардыган амерыканскае адзенне, мяснік 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.


Выкарыстанне

Уключыць укладкі з дапамогай JavaScript (кожную ўкладку трэба актываваць асобна):

  1. $ ( '#myTab a' ). націсніце ( функцыя ( e ) {
  2. е . прадухіліць Па змаўчанні ();
  3. $ ( гэта ). ўкладка ( 'паказаць' );
  4. })

Вы можаце актываваць асобныя ўкладкі некалькімі спосабамі:

  1. $ ( '#myTab a[href="#profile"]' ). ўкладка ( 'паказаць' ); // Выберыце ўкладку па імені
  2. $ ( '#myTab a:first' ). ўкладка ( 'паказаць' ); // Выберыце першую ўкладку
  3. $ ( '#myTab a:last' ). ўкладка ( 'паказаць' ); // Выберыце апошнюю ўкладку
  4. $ ( '#myTab li:eq(2) a' ). ўкладка ( 'паказаць' ); // Выберыце трэцюю ўкладку (індэксавана 0)

Разметка

Вы можаце актываваць навігацыю па ўкладках або таблетках без напісання JavaScript, проста ўказаўшы data-toggle="tab"або data-toggle="pill"на элеменце. Даданне класаў navі nav-tabsна ўкладку ulпрыменіць стыль укладкі Bootstrap.

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab" > Галоўная </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > Профіль </a></li>
  4. <li><a href = "#messages" data-toggle = "tab" > Паведамленні </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > Налады </a></li>
  6. </ul>

Метады

$().таб

Актывуе элемент укладкі і кантэйнер змесціва. На ўкладцы павінна быць альбо data-targetабо, hrefарыентаванае на вузел кантэйнера ў DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" > Галоўная </a></li>
  3. <li><a href = "#profile" > Профіль </a></li>
  4. <li><a href = "#messages" > Паведамленні </a></li>
  5. <li><a href = "#settings" > Налады </a></li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <div class = "актыўная панэль укладак" id = "home" > ... </div>
  10. <div class = "tab-pane" id = "profile" > ... </div>
  11. <div class = "tab-pane" id = "messages" > ... </div>
  12. <div class = "tab-pane" id = "settings" > ... </div>
  13. </div>
  14.  
  15. <скрыпт>
  16. $ ( функцыя () {
  17. $ ( '#myTab a:last' ). ўкладка ( 'паказаць' );
  18. })
  19. </script>

Падзеі

Падзея Апісанне
паказаць Гэта падзея запускаецца падчас паказу ўкладак, але да таго, як будзе паказана новая ўкладка. Выкарыстоўвайце event.targetі event.relatedTarget, каб нацэліць на актыўную ўкладку і папярэднюю актыўную ўкладку (калі ёсць) адпаведна.
паказана Гэта падзея спрацоўвае падчас паказу ўкладак пасля паказу ўкладкі. Выкарыстоўвайце event.targetі event.relatedTarget, каб нацэліць на актыўную ўкладку і папярэднюю актыўную ўкладку (калі ёсць) адпаведна.
  1. $ ( 'a[data-toggle="tab"]' ). on ( 'паказана' , функцыя ( e ) {
  2. е . мэта // актываваная таб
  3. е . relatedTarget // папярэдняя ўкладка
  4. })

Прыклады

Натхнёны выдатным убудовай jQuery.tipsy, напісаным Джэйсанам Фрэймам; Падказкі - гэта абноўленая версія, якая не абапіраецца на выявы, выкарыстоўвае CSS3 для анімацыі і атрыбуты даных для лакальнага захоўвання загалоўкаў.

У мэтах павышэння прадукцыйнасці ўсплывальная падказка і ўсплывальнае апісанне дадзеных даступныя, што азначае, што вы павінны ініцыялізаваць іх самастойна .

Навядзіце курсор на спасылкі ніжэй, каб убачыць падказкі:

Вузкія штаны новага ўзроўню кефія , вы напэўна не чулі пра іх. Photobooth beard raw denim highprint веганская сумка-мессенджер stumptown. Сейтан ад фермы да стала, 8-бітнае амерыканскае адзенне McSweeney's Sustainable quinoa мае вінілавае шамбрэ Тэры Рычардсана . Барада стамптаун, кардіганы banh mi lomo thundercats. Біядызельнае паліва тофу, уільямсбургская марфа, веганскі шамбре з чатырох лока Максвіні. Сапраўды іранічны рамеснік , незалежна ад кейтара , сцэнаграфіста ад фермы да стала, Бэнксі Осцін, твітэр, ручка з фрыганам, крэда, сырая джынсавая кава з аднаго паходжання, вірусная.

Чатыры кірункі

Падказкі ў групах уводу

Пры выкарыстанні ўсплывальных падказак і ўсплывальных паведамленняў з групамі ўводу Bootstrap вам трэба будзе ўсталяваць containerопцыю (дакументавана ніжэй), каб пазбегнуць непажаданых пабочных эфектаў.


Выкарыстанне

Запусціць падказку праз JavaScript:

  1. $ ( '#прыклад' ). падказка ( варыянты )

Параметры

Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-animation="".

Імя тыпу па змаўчанні апісанне
анімацыя лагічны праўда прымяніць пераход CSS Fade да падказкі
html лагічны ілжывы Устаўце html у падказку. textКалі false, для ўстаўкі кантэнту ў dom будзе выкарыстоўвацца метад jquery . Выкарыстоўвайце тэкст, калі вы турбуецеся аб атаках XSS.
размяшчэнне радок | функцыя "топ" як размясціць падказку - зверху | унізе | злева | справа
селектар радок ілжывы Калі прадастаўляецца селектар, аб'екты ўсплывальнай падказкі будуць дэлегаваны ўказаным мэтам.
назва радок | функцыя '' значэнне загалоўка па змаўчанні, калі тэг `title` адсутнічае
трыгер радок "фокус пры навядзенні" як спрацоўвае падказка - пстрычка | лунаць | фокус | кіраўніцтва. Звярніце ўвагу, што вы перадаеце некалькі трыгераў, падзеленыя прабеламі, тыпы трыгераў.
затрымка нумар | аб'ект 0

затрымка паказу і схавання ўсплываючай падказкі (мс) - не адносіцца да ручнога тыпу запуску

Калі ўказана лічба, затрымка прымяняецца як для схавання, так і для паказу

Структура аб'екта:delay: { show: 500, hide: 100 }

кантэйнер радок | ілжывы ілжывы

Дадае падказку да пэўнага элементаcontainer: 'body'

Галаву ўверх! Параметры для асобных усплывальных падказак можна таксама задаць з дапамогай атрыбутаў даных.

Разметка

  1. <a href = "#" data-toggle = "tooltip" title = "first tooltip" > навядзіце курсор на мяне </a>

Метады

$().tooltip(параметры)

Далучае апрацоўшчык падказкі да калекцыі элементаў.

.tooltip('паказаць')

Адкрывае падказку элемента.

  1. $ ( '#элемент' ). падказка ( 'паказаць' )

.tooltip('схаваць')

Хавае падказку элемента.

  1. $ ( '#элемент' ). падказка ( 'схаваць' )

.tooltip('пераключыць')

Пераключае падказку элемента.

  1. $ ( '#элемент' ). падказка ( 'пераключэнне' )

.tooltip('знішчыць')

Хавае і знішчае падказку элемента.

  1. $ ( '#элемент' ). падказка ( 'знішчыць' )

Прыклады

Дадайце невялікія накладкі змесціва, напрыклад, на iPad, да любога элемента для размяшчэння другаснай інфармацыі. Навядзіце курсор на кнопку, каб выклікаць усплывальнае акно. Патрабуецца ўключыць падказку .

Статычны повер

Даступныя чатыры варыянты: выраўноўванне паверсе, справа, унізе і па левым краі.

Поповер топ

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.

Разметка не паказваецца, бо ўсплывальныя вокны ствараюцца з JavaScript і змесціва dataатрыбута.

Жывая дэманстрацыя

Чатыры кірункі


Выкарыстанне

Уключыць усплывальныя вокны праз JavaScript:

  1. $ ( '#прыклад' ). повер ( варыянты )

Параметры

Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-animation="".

Імя тыпу па змаўчанні апісанне
анімацыя лагічны праўда прымяніць пераход CSS Fade да падказкі
html лагічны ілжывы Устаўце html ва ўсплывальнае акно. textКалі false, для ўстаўкі кантэнту ў dom будзе выкарыстоўвацца метад jquery . Выкарыстоўвайце тэкст, калі вы турбуецеся аб атаках XSS.
размяшчэнне радок | функцыя "права" як размясціць поповер - зверху | унізе | злева | справа
селектар радок ілжывы калі прадастаўляецца селектар, аб'екты ўсплывальнай падказкі будуць дэлегаваны ўказаным мэтам
трыгер радок "клік" як спрацоўвае ўсплывальнае акно - націсніце | лунаць | фокус | кіраўніцтва
назва радок | функцыя '' значэнне загалоўка па змаўчанні, калі атрыбут `title` адсутнічае
змест радок | функцыя '' значэнне кантэнту па змаўчанні, калі атрыбут `data-content` адсутнічае
затрымка нумар | аб'ект 0

затрымка паказу і схавання ўсплываючага акна (мс) - не адносіцца да тыпу ручнога запуску

Калі ўказана лічба, затрымка прымяняецца як для схавання, так і для паказу

Структура аб'екта:delay: { show: 500, hide: 100 }

кантэйнер радок | ілжывы ілжывы

Дадае ўсплывальнае акно да пэўнага элементаcontainer: 'body'

Галаву ўверх! Варыянты для асобных усплываючых вобразаў можна ў якасці альтэрнатывы задаць з дапамогай атрыбутаў даных.

Разметка

З меркаванняў прадукцыйнасці, Tooltip і Popover data-apis даступныя. Калі вы жадаеце іх выкарыстоўваць, проста ўкажыце параметр выбару.

Метады

$().popover(параметры)

Ініцыялізуе ўсплывальныя вокны для калекцыі элементаў.

.popover('паказаць')

Адкрывае ўсплывальнае акно элементаў.

  1. $ ( '#элемент' ). popover ( 'паказаць' )

.popover('схаваць')

Хавае ўсплывальнае акно элементаў.

  1. $ ( '#элемент' ). popover ( 'схаваць' )

.popover('пераключыць')

Уключае ўсплывальнае акно элементаў.

  1. $ ( '#элемент' ). popover ( 'пераключыць' )

.popover('знішчыць')

Хавае і знішчае ўсплывальнае акно элемента.

  1. $ ( '#элемент' ). popover ( 'знішчыць' )

Прыклады абвестак

Дадайце функцыю адхілення да ўсіх папярэджанняў з дапамогай гэтага плагіна.

Святое гуакамоле! Лепш праверце сябе, вы не занадта добра выглядаеце.

О, ну! У вас памылка!

Змяніце гэта і тое і паспрабуйце яшчэ раз. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Прыміце гэтае дзеянне Або зрабіць гэта


Выкарыстанне

Уключыць адхіленне абвесткі праз JavaScript:

  1. $ ( ".alert" ). абвестка ()

Разметка

Проста дадайце data-dismiss="alert"да кнопкі закрыцця, каб аўтаматычна даць функцыю закрыцця папярэджання.

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

Метады

$().апавяшчэнне()

Абгортвае ўсе абвесткі з блізкай функцыянальнасцю. Каб вашы абвесткі аніміраваліся пры закрыцці, пераканайцеся, што да іх ужо прыменены клас .fadeі ..in

.alert('зачыніць')

Закрывае абвестку.

  1. $ ( ".alert" ). абвестка ( 'блізка' )

Падзеі

Клас папярэджання Bootstrap паказвае некалькі падзей для падключэння да функцыі папярэджання.

Падзея Апісанне
блізка Гэта падзея запускаецца неадкладна пры closeвыкліку метаду асобніка.
закрытыя Гэта падзея запускаецца, калі абвестка была закрыта (будзе чакаць завяршэння пераходаў CSS).
  1. $ ( '#my-alert' ). bind ( 'закрыты' , функцыя () {
  2. // зрабіць нешта...
  3. })

Прыклад выкарыстання

Рабіце больш з кнопкамі. Станы кнопак кіравання або стварэнне груп кнопак для дадатковых кампанентаў, такіх як панэлі інструментаў.

Дзяржаўны

Дадаць data-loading-text="Loading...", каб выкарыстоўваць стан загрузкі на кно��цы.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Загрузка..." > Стан загрузкі </button>

Адзіночны перамыкач

Дадаць data-toggle="button", каб актываваць пераключэнне адной кнопкай.

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" > Адзіночны пераключальнік </button>

Сцяжок

Дадаць data-toggle="buttons-checkbox"для пераключэння стылю сцяжка ў btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > Левы </button>
  3. <button type = "button" class = "btn btn-primary" > Сярэдні </button>
  4. <button type = "button" class = "btn btn-primary" > Справа </button>
  5. </div>

радыё

Дадаць data-toggle="buttons-radio"для пераключэння стылю радыё ў btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" > Левы </button>
  3. <button type = "button" class = "btn btn-primary" > Сярэдні </button>
  4. <button type = "button" class = "btn btn-primary" > Справа </button>
  5. </div>

Выкарыстанне

Уключыць кнопкі праз JavaScript:

  1. $ ( '.nav-ўкладкі' ). кнопка ()

Разметка

Атрыбуты дадзеных з'яўляюцца неад'емнай часткай плагіна кнопкі. Праверце прыклад кода ніжэй для розных тыпаў разметкі.

Параметры

Няма

Метады

$().button('пераключыць')

Пераключае стан націскання. Дае кнопцы выгляд, што яна была актываваная.

Галаву ўверх! Вы можаце ўключыць аўтаматычнае пераключэнне кнопкі з дапамогай data-toggleатрыбуту.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

$().button('загрузка')

Устанаўлівае стан кнопкі для загрузкі - адключае кнопку і мяняе тэкст на тэкст для загрузкі. Тэкст загрузкі павінен быць вызначаны на элеменце кнопкі з дапамогай атрыбуту data data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "loading stuff..." > ... </button>
Галаву ўверх! Firefox захоўвае адключаны стан падчас загрузкі старонкі . Абыходным шляхам для гэтага з'яўляецца выкарыстанне autocomplete="off".

$().button('скід')

Скідае стан кнопкі - мяняе тэкст на зыходны тэкст.

$().кнопка(радок)

Скідае стан кнопкі - мяняе тэкст на любы тэкст, вызначаны дадзенымі.

  1. <button type = "button" class = "btn" data-complete-text = "finished!" > ... </button>
  2. <скрыпт>
  3. $ ( '.btn' ). кнопка ( 'завяршыць' )
  4. </script>

Аб

Атрымайце базавыя стылі і гнуткую падтрымку складаных кампанентаў, такіх як акардэоны і навігацыя.

* Патрабуецца ўключэнне плагіна Transitions.

Прыклад акардэон

Выкарыстоўваючы плагін згортвання, мы стварылі просты віджэт у стылі акардэона:

Анімацыйны клішэ асуджаны, аніміраваны светскага жыцця абвінавачаны Тэры Рычардсан і кальмар. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Сняданак 3 воўчы месяц, час, сонца, алеква, паклала птушку на гэта, кальмары, кава адзінага паходжання, нулла, прыпускаецца, шорэдыч і інш. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Аб'яву вегана, акрамя віцэ-мясніка. Легінсы occaecat крафтавае піва з фермы да стала, неапрацаваны дэнім, эстэтычны сінтэз, вы, напэўна, не чулі пра іх, акузамус, устойлівы VHS.
Анімацыйны клішэ асуджаны, аніміраваны светскага жыцця абвінавачаны Тэры Рычардсан і кальмар. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Сняданак 3 воўчы месяц, час, сонца, алеква, паклала птушку на гэта, кальмары, кава адзінага паходжання, нулла, прыпускаецца, шорэдыч і інш. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Аб'яву вегана, акрамя віцэ-мясніка. Легінсы occaecat крафтавае піва з фермы да стала, неапрацаваны дэнім, эстэтычны сінтэз, вы, напэўна, не чулі пра іх, акузамус, устойлівы VHS.
Анімацыйны клішэ асуджаны, аніміраваны светскага жыцця абвінавачаны Тэры Рычардсан і кальмар. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Сняданак 3 воўчы месяц, час, сонца, алеква, паклала птушку на гэта, кальмары, кава адзінага паходжання, нулла, прыпускаецца, шорэдыч і інш. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Аб'яву вегана, акрамя віцэ-мясніка. Легінсы occaecat крафтавае піва з фермы да стала, неапрацаваны дэнім, эстэтычны сінтэз, вы, напэўна, не чулі пра іх, акузамус, устойлівы VHS.
  1. <div class = "accordion" id = "accordion2" >
  2. <div class = "accordion-group" >
  3. <div class = "accordion-heading" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. Разборная група элемент № 1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "accordion-body collapse in" >
  9. <div class = "accordion-inner" >
  10. Анімацыйны парыятур клішэ...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "accordion-group" >
  15. <div class = "accordion-heading" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Элемент разборнай групы №2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "collapse accordion-body" >
  21. <div class = "accordion-inner" >
  22. Анімацыйны парыятур клішэ...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

Вы таксама можаце выкарыстоўваць убудову без разметкі акардэона. Зрабіце кнопку, якая пераключае разгортванне і згортванне іншага элемента.

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. простыя разборныя
  3. </button>
  4.  
  5. <div id = "demo" class = "collapse in" > </div>

Выкарыстанне

Праз атрыбуты дадзеных

Проста дадайце data-toggle="collapse"і data-targetда элемента, каб аўтаматычна прызначыць кантроль над складаным элементам. Атрыбут data-targetпрымае селектар CSS для прымянення згортвання. Абавязкова дадайце клас collapseда разборнага элемента. Калі вы хочаце, каб ён быў адкрыты па змаўчанні, дадайце дадатковы клас in.

Каб дадаць кіраванне групамі ў стылі акардэона да згортваемага элемента кіравання, дадайце атрыбут data data-parent="#selector". Звярніцеся да дэманстрацыі, каб убачыць гэта ў дзеянні.

Праз JavaScript

Уключыць уручную з дапамогай:

  1. $ ( ".collapse" ). згарнуць ()

Параметры

Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-parent="".

Імя тыпу па змаўчанні апісанне
бацька селектар ілжывы Калі селектар, то ўсе згортваемыя элементы пад названым бацькам будуць зачыненыя, калі гэты згортваемы элемент будзе паказаны. (падобна на традыцыйныя паводзіны акардэона)
пераключаць лагічны праўда Пераключае складны элемент пры выкліку

Метады

.collapse(параметры)

Актывуе ваш кантэнт як складны элемент. Прымае дадатковыя параметры object.

  1. $ ( '#myCollapsible' ). згарнуць ({
  2. пераключыць : ілжыва
  3. })

.collapse('пераключыць')

Пераключае складны элемент на паказны або схаваны.

.collapse('паказаць')

Паказвае разборны элемент.

.collapse('схаваць')

Хавае разборны элемент.

Падзеі

Клас згортвання Bootstrap паказвае некалькі падзей для падключэння да функцыянальнасці згортвання.

Падзея Апісанне
паказаць Гэта падзея запускаецца неадкладна пры showвыкліку метаду асобніка.
паказана Гэта падзея запускаецца, калі элемент згортвання робіцца бачным для карыстальніка (будзе чакаць завяршэння пераходаў CSS).
схаваць Гэта падзея запускаецца адразу пасля hideвыкліку метаду.
схаваны Гэта падзея запускаецца, калі элемент згортвання быў схаваны ад карыстальніка (будзе чакаць завяршэння пераходаў CSS).
  1. $ ( '#myCollapsible' ). on ( 'hidden' , function () {
  2. // зрабіць нешта...
  3. })

Прыклад

Базавы плагін, які лёгка пашыраецца, для хуткага стварэння элегантных уводных тэкстаў з любой формай уводу тэксту.

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

Вы захочаце наладзіць autocomplete="off", каб меню браўзера па змаўчанні не з'яўляліся над выпадальным меню Bootstrap.


Выкарыстанне

Праз атрыбуты дадзеных

Дадайце атрыбуты дадзеных, каб зарэгістраваць элемент з функцыяй аператыўнага ўводу, як паказана ў прыкладзе вышэй.

Праз JavaScript

Выклік уручную з дапамогай:

  1. $ ( '.typeahead' ). уперад ()

Параметры

Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-source="".

Імя тыпу па змаўчанні апісанне
крыніца масіў, функцыя [ ] Крыніца даных для запыту. Можа быць масівам радкоў або функцыяй. Функцыі перадаюцца два аргументы: queryзначэнне ў полі ўводу і processзваротны выклік. Функцыя можа выкарыстоўвацца сінхронна, вяртаючы крыніцу даных непасрэдна або асінхронна праз processадзін аргумент зваротнага выкліку.
элементы лік 8 Максімальная колькасць элементаў для адлюстравання ў выпадальным меню.
minLength лік 1 Мінімальная даўжыня сімвалаў, неабходная для запуску прапаноў аўтазапаўнення
супадзенне функцыя неадчувальны да рэгістра Метад, які выкарыстоўваецца для вызначэння, ці адпавядае запыт элементу. Прымае адзіны аргумент, itemадносна якога тэстуецца запыт. Доступ да бягучага запыту з дапамогай this.query. Вяртае лагічнае значэнне true, калі запыт супадае.
сартавальнік функцыя дакладнае супадзенне,
адчувальны да рэгістра,
неадчувальны да рэгістра
Метад, які выкарыстоўваецца для сартавання вынікаў аўтазапаўнення. Прымае адзін аргумент itemsі мае вобласць дзеяння асобніка з апераджальным наборам. Спасылайцеся на бягучы запыт з дапамогай this.query.
абнаўляльнік функцыя вяртае выбраны элемент Метад, які выкарыстоўваецца для вяртання выбранага элемента. Прымае адзіны аргумент, itemі мае вобласць дзеяння асобніка з апярэджаннем.
хайлайтер функцыя вылучае ўсе супадзенні па змаўчанні Метад, які выкарыстоўваецца для вылучэння вынікаў аўтазапаўнення. Прымае адзін аргумент itemі мае вобласць дзеяння асобніка з апераджальным наборам. Павінен вяртаць html.

Метады

.typeahead(параметры)

Ініцыялізуе ўвод з апярэджаннем.

Прыклад

Паднавігацыя злева - гэта жывая дэманстрацыя плагіна афіксаў.


Выкарыстанне

Праз атрыбуты дадзеных

Каб лёгка дадаць паводзіны афіксаў да любога элемента, проста дадайце data-spy="affix"да элемента, за якім вы хочаце сачыць. Затым выкарыстоўвайце зрухі, каб вызначыць, калі ўключаць і выключаць замацаванне элемента.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
Галаву ўверх! Вы павінны кіраваць становішчам замацаванага элемента і паводзінамі яго непасрэднага бацькі. Палажэннем кіруюць affix, affix-top, і affix-bottom. Не забывайце правяраць патэнцыйна згорнуты бацькоўскі элемент, калі афікс уключаецца, бо ён выдаляе змесціва са звычайнага ходу старонкі.

Праз JavaScript

Выклік плагіна афіксаў праз JavaScript:

  1. $ ( '#navbar' ). афікс ()

Параметры

Параметры могуць быць перададзены праз атрыбуты дадзеных або JavaScript. Для атрыбутаў дадзеных дадайце назву опцыі да data-, як у data-offset-top="200".

Імя тыпу па змаўчанні апісанне
зрушэнне нумар | функцыя | аб'ект 10 Пікселі для зрушэння з экрана пры разліку пазіцыі прагорткі. Калі ўказана адна лічба, зрушэнне будзе прымяняцца як у верхнім, так і ў левым напрамках. Каб праслухаць адзін кірунак або некалькі унікальных зрушэнняў, проста ўвядзіце аб'ект offset: { x: 10 }. Выкарыстоўвайце функцыю, калі вам трэба дынамічна забяспечыць зрушэнне (карысна для некаторых адаптыўных дызайнаў).