JavaScript

Ożyw komponenty Bootstrap — teraz dzięki 13 niestandardowym wtyczkom jQuery.

Heads-up! Te dokumenty dotyczą wersji 2.3.2, która nie jest już oficjalnie obsługiwana. Sprawdź najnowszą wersję Bootstrapa!

Indywidualne lub skompilowane

Wtyczki mogą być dołączane pojedynczo (chociaż niektóre mają wymagane zależności) lub wszystkie naraz. Zarówno bootstrap.js , jak i bootstrap.min.js zawierają wszystkie wtyczki w jednym pliku.

Atrybuty danych

Możesz używać wszystkich wtyczek Bootstrap wyłącznie poprzez API znaczników bez pisania ani jednej linii kodu JavaScript. Jest to interfejs API pierwszej klasy Bootstrap i powinien być Twoim pierwszym wyborem podczas korzystania z wtyczki.

To powiedziawszy, w niektórych sytuacjach może być pożądane wyłączenie tej funkcji. W związku z tym zapewniamy również możliwość wyłączenia API atrybutów danych poprzez rozłączenie wszystkich zdarzeń w ciele, które znajdują się w przestrzeni nazw za pomocą `'data-api'`. Wygląda to tak:

  1. $ ( 'ciało' ). wyłączone ( '.data-api' )

Alternatywnie, aby kierować reklamy na konkretną wtyczkę, po prostu uwzględnij nazwę wtyczki jako przestrzeń nazw wraz z przestrzenią nazw data-api w następujący sposób:

  1. $ ( 'ciało' ). wyłączone ( '.alert.data-api' )

Programowy interfejs API

Uważamy również, że powinieneś być w stanie korzystać ze wszystkich wtyczek Bootstrap wyłącznie poprzez API JavaScript. Wszystkie publiczne interfejsy API są pojedynczymi metodami, które można łączyć w łańcuchy, i zwracają kolekcję, na której wykonano działanie.

  1. $ ( ".btn.niebezpieczeństwo" ). przycisk ( "przełącz" ). addClass ( "gruby" )

Wszystkie metody powinny akceptować opcjonalny obiekt opcji, ciąg znaków, który jest skierowany do konkretnej metody lub nic (co inicjuje wtyczkę z zachowaniem domyślnym):

  1. $ ( "#myModal" ). modalne () // zainicjowane z domyślnymi
  2. $ ( "#myModal" ). modalny ({ keyboard : false }) // zainicjowany bez klawiatury
  3. $ ( "#myModal" ). modal ( 'show' ) // inicjuje i natychmiast wywołuje show

Każda wtyczka udostępnia również swój surowy konstruktor we właściwości `Constructor`: $.fn.popover.Constructor. Jeśli chcesz pobrać konkretną instancję wtyczki, pobierz ją bezpośrednio z elementu: $('[rel=popover]').data('popover').

Brak konfliktu

Czasami konieczne jest użycie wtyczek Bootstrap z innymi frameworkami UI. W takich okolicznościach czasami mogą wystąpić kolizje przestrzeni nazw. Jeśli tak się stanie, możesz wywołać .noConflictwtyczkę, której wartość chcesz przywrócić.

  1. var bootstrapButton = $ . fn . przycisk . noConflict () // powrót $.fn.button do wcześniej przypisanej wartości
  2. $ . fn . bootstrapBtn = bootstrapButton // daj $().bootstrapBtn funkcję ładowania początkowego

Wydarzenia

Bootstrap zapewnia niestandardowe zdarzenia dla większości unikalnych akcji wtyczki. Ogólnie rzecz biorąc, mają one formę bezokolicznika i imiesłowu przeszłego - gdzie bezokolicznik (np. show) jest wyzwalany na początku zdarzenia, a jego forma imiesłowu przeszłego (np. shown) jest wyzwalana po zakończeniu działania.

Wszystkie zdarzenia bezokolicznikowe zapewniają funkcjonalność PreventDefault. Daje to możliwość zatrzymania wykonywania akcji przed jej rozpoczęciem.

  1. $ ( '#mójModalny' ). on ( 'pokaż' , funkcja ( e ) {
  2. if (! dane ) zwróć e . PreventDefault () // zatrzymuje wyświetlanie modalne
  3. })

O przejściach

Aby uzyskać proste efekty przejścia, dołącz plik bootstrap-transition.js razem z innymi plikami JS. Jeśli używasz skompilowanego (lub zminimalizowanego) pliku bootstrap.js , nie ma potrzeby dołączania tego — już tam jest.

Przypadków użycia

Kilka przykładów wtyczki przejścia:

  • Przesuwanie się lub blaknięcie w modach
  • Zanikanie zakładek
  • Wygaszanie alertów
  • Przesuwne szyby karuzelowe

Przykłady

Modals to uproszczone, ale elastyczne monity dialogowe z minimalną wymaganą funkcjonalnością i inteligentnymi ustawieniami domyślnymi.

Przykład statyczny

Renderowany modalny z nagłówkiem, treścią i zestawem akcji w stopce.

  1. <div class = "modalne ukrywanie zanikania" >
  2. <div class = "modal-header" >
  3. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  4. <h3> Nagłówek modalny </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> Jedno piękne ciało… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn"> Zamknij </a> _
  11. <a href = "#" class = "btn btn-primary"> Zapisz zmiany </a>
  12. </div>
  13. </div>

Demo na żywo

Przełącz modalny za pomocą JavaScript, klikając poniższy przycisk. Zsunie się i zniknie od góry strony.

  1. <!-- Przycisk wyzwalający modalne -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal"> Uruchom tryb demonstracyjny </a>
  3.  
  4. <!-- Modalne -->
  5. <div id = "myModal" class = "modalne ukrywanie zanikania" 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" > Modalny nagłówek </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> Jedno piękne ciało… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Zamknij </button>
  15. <button class = "btn btn-primary" > Zapisz zmiany </button>
  16. </div>
  17. </div>

Stosowanie

Poprzez atrybuty danych

Aktywuj modalny bez pisania JavaScript. Ustaw data-toggle="modal"na elemencie kontrolera, takim jak przycisk, wraz z data-target="#foo"lub href="#foo", aby wskazać określony mod do przełączania.

  1. <button type = "button" data-toggle = "modalny" data-target = "#myModal" > Uruchom modalne </button>

Przez JavaScript

Wywołaj modalne z id myModalz pojedynczą linią JavaScript:

  1. $ ( '#mójModalny' ). modalne ( opcje )

Opcje

Opcje można przekazywać za pomocą atrybutów danych lub kodu JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, jak w data-backdrop="".

Nazwa rodzaj domyślna opis
zasłona logiczne PRAWDA Zawiera modalny element tła. Możesz też określić statictło, które nie zamyka modalnego kliknięcia.
klawiatura logiczne PRAWDA Zamyka modalne po naciśnięciu klawisza Escape
pokazać logiczne PRAWDA Po inicjalizacji pokazuje modalny.
zdalny ścieżka fałszywy

Jeśli podany zostanie zdalny adres URL, zawartość zostanie załadowana za pomocą loadmetody jQuery i wstrzyknięta do .modal-body. Jeśli używasz interfejsu API danych, możesz alternatywnie użyć hreftagu do określenia zdalnego źródła. Przykład tego pokazano poniżej:

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

Metody

.modal(opcje)

Aktywuje treść jako modalną. Akceptuje opcjonalne opcje object.

  1. $ ( '#mójModalny' ). modalny ({
  2. klawiatura : fałsz
  3. })

.modal('przełącz')

Ręcznie przełącza modalny.

  1. $ ( '#mójModalny' ). modalny ( 'przełącz' )

.modal('pokaż')

Ręcznie otwiera modalne.

  1. $ ( '#mójModalny' ). modalne ( 'pokaż' )

.modal('ukryj')

Ręcznie ukrywa modalny.

  1. $ ( '#mójModalny' ). modalne ( 'ukryj' )

Wydarzenia

Klasa modalna Bootstrap udostępnia kilka zdarzeń do podłączenia do funkcji modalnej.

Wydarzenie Opis
pokazać To zdarzenie jest wyzwalane natychmiast po showwywołaniu metody wystąpienia.
pokazane To zdarzenie jest wywoływane, gdy modalny został udostępniony użytkownikowi (będzie czekał na zakończenie przejść css).
ukryć To zdarzenie jest wywoływane natychmiast po hidewywołaniu metody wystąpienia.
ukryty To zdarzenie jest wywoływane, gdy modalne zakończy się ukrywanie przed użytkownikiem (poczeka na zakończenie przejść css).
  1. $ ( '#mójModalny' ). on ( 'ukryty' , funkcja () {
  2. // Zrób coś…
  3. })

Przykład w pasku nawigacyjnym

Wtyczka ScrollSpy służy do automatycznej aktualizacji celów nawigacji na podstawie pozycji przewijania. Przewiń obszar poniżej paska nawigacyjnego i obserwuj aktywną zmianę klasy. Podpunkty rozwijane również zostaną podświetlone.

@tłuszcz

Reklamowe legginsy keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi, zanim sprzedali qui. Prawa rowerowe Tumblr od farmy do stołu, cokolwiek. Kardigan Anim keffiyeh carles. Fotobudka Velit seitan mcsweeney 3 wolf moon irure. Cosby sweter lomo jean szorty, bluza williamsburg minim qui, o której prawdopodobnie nie słyszałeś i kardigan powierniczy culpa biodiesel wes anderson estetyka. Nihil wytatuowany accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

@mdo

Deskorolka Veniam marfa wąsy, adipisicing broda fugiat velit z widłami. Freegan broda aliqua cupidatat mcsweeney's vero. Cupidatat cztery loko nisi, ea helvetica nulla carles. Food truck z wytatuowanym swetrem w stylu cosby, winyl Mcsweeneya quis non freegan. Lo-fi wes anderson +1 krawiec. Carles nieestetyczne ćwiczenia quis gentrify. Brooklyn adipisicing piwo rzemieślnicze zastępca keytar deserunt.

jeden

Occaecat commodo aliqua delectus. Fap craft beer deserunt deskorolka ea. Prawa rowerowe Lomo adipisicing banh mi, velit ea sunt next level kawa locavore single-origin w magna veniam. Wysokiej jakości winyl id, echo park consequat quis aliquip banh mi widły. Vero VHS est adipisicing. Consectetur nisi DIY minim listonoszka. Cred ex in, zrównoważony delectus consectetur saszetka na iphone'a.

dwa

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, cokolwiek delectus food truck. Sapiente syntezator id zakładanda. Locavore sed helvetica cliche ironia, thundercats, o których prawdopodobnie nie słyszałeś, consequat bezglutenowa bluza z kapturem lo-fi fap aliquip. Elitarne miejsce Labore przed wyprzedaniem, Terry Richardson proident brunch nesciunt quis cosby sweter pariatur keffiyeh ut helvetica artisan. Kardiganowe piwo rzemieślnicze seitan gotowe velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Stosowanie

Poprzez atrybuty danych

Aby łatwo dodać zachowanie scrollspy do nawigacji w górnym pasku, po prostu dodaj data-spy="scroll"do elementu, który chcesz szpiegować (najczęściej jest to treść) i data-target=".navbar"wybierz nawigację, której chcesz użyć. Będziesz chciał użyć scrollspy z .navkomponentem.

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

Przez JavaScript

Wywołaj scrollspy przez JavaScript:

  1. $ ( '#pasek nawigacyjny' ). scrollszpieg ()
Heads-up! Linki paska nawigacyjnego muszą mieć rozpoznawalne cele id. Na przykład a <a href="#home">home</a>musi odpowiadać czemuś w dom jak <div id="home"></div>.

Metody

.scrollspy('odśwież')

Używając scrollspy w połączeniu z dodawaniem lub usuwaniem elementów z DOM, musisz wywołać metodę refresh w następujący sposób:

  1. $ ( '[data-spy="scroll"]' ). każdy ( funkcja () {
  2. var $szpieg = $ ( to ). scrollspy ( 'odśwież' )
  3. });

Opcje

Opcje można przekazywać za pomocą atrybutów danych lub kodu JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, jak w data-offset="".

Nazwa rodzaj domyślna opis
zrównoważyć numer 10 Piksele do przesunięcia od góry podczas obliczania pozycji przewijania.

Wydarzenia

Wydarzenie Opis
Aktywuj Zdarzenie to uruchamia się za każdym razem, gdy scrollspy aktywuje nowy przedmiot.

Przykładowe zakładki

Dodaj szybką, dynamiczną funkcję kart, aby przechodzić przez panele zawartości lokalnej, nawet za pomocą menu rozwijanych.

Surowy denim, o którym prawdopodobnie nie słyszałeś, dżinsowe szorty Austin. Nesciunt tofu stumptown aliqua, oczyszczanie mistrza syntezatorów w stylu retro. Wąsy cliche tempor, williamsburg carles wegańska helvetica. Reprehenderit rzeźnik retro kefija łapacz snów syntezator. Cosby sweter eu banh mi, qui irure terry richardson ex kałamarnica. Aliquip placeat salvia cillum iphone. Seitan aliquip quis kardigan amerykański odzież, rzeźnik 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.


Stosowanie

Włącz karty z zakładkami za pomocą JavaScript (każda karta musi być aktywowana osobno):

  1. $ ( '#myTab a' ). kliknij ( funkcja ( e ) {
  2. mi . zapobiecDefault ();
  3. $ ( to ). zakładka ( 'pokaż' );
  4. })

Poszczególne zakładki możesz aktywować na kilka sposobów:

  1. $ ( '#myTab a[href="#profile"]' ). zakładka ( 'pokaż' ); // Wybierz kartę według nazwy
  2. $ ( '#myTab a:pierwszy' ). zakładka ( 'pokaż' ); // Wybierz pierwszą kartę
  3. $ ( '#myTab a:ostatni' ). zakładka ( 'pokaż' ); // Wybierz ostatnią kartę
  4. $ ( '#myTab li:eq(2) a' ). zakładka ( 'pokaż' ); // Wybierz trzecią kartę (0-indeksowana)

Narzut

Możesz aktywować nawigację po karcie lub pigułce bez pisania kodu JavaScript, po prostu określając data-toggle="tab"lub data-toggle="pill"na elemencie. Dodanie klas navi nav-tabsdo zakładki ulspowoduje zastosowanie stylu zakładki Bootstrap.

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab"> Strona główna </a> </li>
  3. <li><a href = "#profile" data-toggle = "tab"> Profil </a></li >
  4. <li><a href = "#messages" data-toggle = "tab"> Wiadomości </a></li >
  5. <li><a href = "#settings" data-toggle = "tab"> Ustawienia </a></li >
  6. </ul>

Metody

$().tab

Aktywuje element tab i kontener treści. Karta powinna mieć węzeł kontenera data-targetlub docelowy w DOM.href

  1. <ul class = „nav nav-tabs” id = „myTab” >
  2. <li class = "active" ><a href = "#home"> Strona główna </a> </li>
  3. <li><a href = "#profile"> Profil </a> </li>
  4. <li><a href = "#messages"> Wiadomości </a> </li>
  5. <li><a href = "#settings"> Ustawienia </a> </li>
  6. </ul>
  7.  
  8. <div class = "zawartość karty" >
  9. <div class = „aktywne okienko kart” id = „home” > ... </div>
  10. <div class = „tab-pane” id = „profil” > ... </div>
  11. <div class = „tab-pane” id = „wiadomości” > ... </div>
  12. <div class = "tab-pane" id = "ustawienia" > ... </div>
  13. </div>
  14.  
  15. <skrypt>
  16. $ ( funkcja () {
  17. $ ( '#myTab a:ostatni' ). zakładka ( 'pokaż' );
  18. })
  19. </script>

Wydarzenia

Wydarzenie Opis
pokazać To zdarzenie jest uruchamiane na pokazie zakładek, ale przed pokazaniem nowej zakładki. Użyj event.targeti event.relatedTarget, aby wybrać odpowiednio aktywną kartę i poprzednią aktywną kartę (jeśli jest dostępna).
pokazane To zdarzenie jest uruchamiane na pokazie kart po wyświetleniu karty. Użyj event.targeti event.relatedTarget, aby wybrać odpowiednio aktywną kartę i poprzednią aktywną kartę (jeśli jest dostępna).
  1. $ ( 'a[data-toggle="tab"]' ). on ( 'pokazano' , funkcja ( e ) {
  2. mi . cel // aktywowana karta
  3. mi . relatedTarget // poprzednia karta
  4. })

Przykłady

Zainspirowany doskonałą wtyczką jQuery.tipsy napisaną przez Jasona Frame; Etykietki narzędzi to zaktualizowana wersja, która nie opiera się na obrazach, używa CSS3 do animacji i atrybutów danych do lokalnego przechowywania tytułów.

Ze względu na wydajność etykietka narzędzi i interfejsy danych popover są włączone, co oznacza, że ​​musisz je zainicjować samodzielnie .

Najedź na poniższe linki, aby zobaczyć podpowiedzi:

Obcisłe spodnie następnego poziomu kefija prawdopodobnie o nich nie słyszałeś. Fotobudka broda surowy denim typografia wegańska torba listonoszka stumptown. 8-bitowa amerykańska odzież z komosy ryżowej firmy Mcsweeney firmy Mcsweeney w wersji fixie ma winylowy chambray frotte richardson. Beard Stumptown, swetry rozpinane banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, cztery loko mcsweeney's oczyszczający wegański chambray. Naprawdę ironiczny rzemieślnik , niezależnie od tego , jaka jest kluczowa , scenarzysta od farmy do stołu banksy Austin twitter obsługuje freegan cred surowy denim, wirus kawy jednego pochodzenia.

Cztery kierunki

Podpowiedzi w grupach wejściowych

Używając podpowiedzi i okienek popover z grupami wejściowymi Bootstrap, musisz ustawić containeropcję (udokumentowaną poniżej), aby uniknąć niepożądanych efektów ubocznych.


Stosowanie

Uruchom podpowiedź za pomocą JavaScript:

  1. $ ( '#przykład' ). podpowiedź ( opcje )

Opcje

Opcje można przekazywać za pomocą atrybutów danych lub kodu JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, jak w data-animation="".

Nazwa rodzaj domyślna opis
animacja logiczne PRAWDA zastosować do podpowiedzi przejścia zanikania CSS
html logiczne fałszywy Wstaw html do podpowiedzi. Jeśli false, metoda jquery textzostanie użyta do wstawienia treści do dom. Użyj tekstu, jeśli martwisz się atakami XSS.
umieszczenie ciąg | funkcjonować 'Top' jak ustawić podpowiedź - góra | dół | lewo | prawo
selektor strunowy fałszywy Jeśli podano selektor, obiekty etykietek narzędzi zostaną delegowane do określonych celów.
tytuł ciąg | funkcjonować '' domyślna wartość tytułu, jeśli tag `title` nie jest obecny
cyngiel strunowy „skup się na najechaniu” jak uruchamia się podpowiedź - kliknij | najedź | skupić | podręcznik. Zauważ, że wielkość wyzwalacza jest wielokrotna, oddzielona spacjami, typy wyzwalaczy.
opóźnienie numer | obiekt 0

opóźnienie pokazywania i ukrywania podpowiedzi (ms) - nie dotyczy wyzwalania ręcznego

Jeśli podano numer, opóźnienie jest stosowane zarówno do ukrywania, jak i pokazywania

Struktura obiektu to:delay: { show: 500, hide: 100 }

pojemnik ciąg | fałszywy fałszywy

Dołącza podpowiedź do określonego elementucontainer: 'body'

Heads-up! Opcje dla poszczególnych podpowiedzi można alternatywnie określić za pomocą atrybutów danych.

Narzut

  1. <a href = "#" data-toggle = "tooltip" title = "pierwszy tooltip"> najedź na mnie </a>

Metody

$().tooltip(opcje)

Dołącza obsługę podpowiedzi do kolekcji elementów.

.tooltip('pokaż')

Odsłania opis elementu.

  1. $ ( '#element' ). podpowiedź ( 'pokaż' )

.podpowiedź('ukryj')

Ukrywa podpowiedź elementu.

  1. $ ( '#element' ). podpowiedź ( 'ukryj' )

.tooltip('przełącz')

Przełącza podpowiedź elementu.

  1. $ ( '#element' ). podpowiedź ( 'przełącz' )

.tooltip('zniszcz')

Ukrywa i niszczy opis elementu.

  1. $ ( '#element' ). podpowiedź ( 'zniszcz' )

Przykłady

Dodaj małe nakładki treści, takie jak te na iPadzie, do dowolnego elementu, aby pomieścić dodatkowe informacje. Najedź na przycisk, aby uruchomić popover. Wymaga dołączenia podpowiedzi .

Popover statyczny

Dostępne są cztery opcje: wyrównanie do góry, do prawej, do dołu i do lewej.

Popover top

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

Popover w prawo

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

Popover na dole

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

Popover w lewo

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

Żadne znaczniki wyświetlane jako popovery nie są generowane z JavaScript i treści w dataatrybucie.

Demo na żywo

Cztery kierunki


Stosowanie

Włącz popovery przez JavaScript:

  1. $ ( '#przykład' ). popover ( opcje )

Opcje

Opcje można przekazywać za pomocą atrybutów danych lub kodu JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, jak w data-animation="".

Nazwa rodzaj domyślna opis
animacja logiczne PRAWDA zastosować do podpowiedzi przejścia zanikania CSS
html logiczne fałszywy Wstaw html do popovera. Jeśli false, metoda jquery textzostanie użyta do wstawienia treści do dom. Użyj tekstu, jeśli martwisz się atakami XSS.
umieszczenie ciąg | funkcjonować 'prawo' jak ustawić popover - góra | dół | lewo | prawo
selektor strunowy fałszywy jeśli podano selektor, obiekty podpowiedzi zostaną delegowane do określonych celów
cyngiel strunowy 'Kliknij' jak uruchamia się popover - kliknij | najedź | skupić | podręcznik
tytuł ciąg | funkcjonować '' domyślna wartość tytułu, jeśli atrybut „title” nie jest obecny
zawartość ciąg | funkcjonować '' domyślna wartość treści, jeśli atrybut „data-content” nie jest obecny
opóźnienie numer | obiekt 0

opóźnienie pokazywania i ukrywania popovera (ms) - nie dotyczy wyzwalania ręcznego

Jeśli podano numer, opóźnienie jest stosowane zarówno do ukrywania, jak i pokazywania

Struktura obiektu to:delay: { show: 500, hide: 100 }

pojemnik ciąg | fałszywy fałszywy

Dołącza okienko popover do określonego elementucontainer: 'body'

Heads-up! Opcje dla poszczególnych okienek popover można alternatywnie określić za pomocą atrybutów danych.

Narzut

Ze względu na wydajność, Tooltip i Popover data-apis są włączone. Jeśli chcesz ich użyć, po prostu określ opcję selektora.

Metody

$().popover(opcje)

Inicjuje popovery dla kolekcji elementów.

.popover('pokaż')

Odsłania okienko z elementami.

  1. $ ( '#element' ). popover ( 'pokaż' )

.popover('ukryj')

Ukrywa okienko z elementami.

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

.popover('przełącz')

Przełącza popover elementów.

  1. $ ( '#element' ). popover ( 'przełącz' )

.popover('zniszcz')

Ukrywa i niszczy popover elementu.

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

Przykładowe alerty

Dodaj funkcję odrzucania do wszystkich komunikatów ostrzegawczych za pomocą tej wtyczki.

Święty guacamole! Najlepiej sprawdź sam, nie wyglądasz zbyt dobrze.

Och, pstryk! Masz błąd!

Zmień to i tamto i spróbuj ponownie. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Podejmij tę akcję Albo zrób to


Stosowanie

Włącz odrzucanie alertu przez JavaScript:

  1. $ ( ".alert" ). ostrzeżenie ()

Narzut

Po prostu dodaj data-dismiss="alert"do przycisku zamknięcia, aby automatycznie włączyć funkcję zamknięcia alertu.

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

Metody

$().alert()

Zawija wszystkie alerty z bliską funkcjonalnością. Aby Twoje alerty były animowane po zamknięciu, upewnij się, że mają już do nich przypisane klasy .fadei ..in

.alert('zamknij')

Zamyka alert.

  1. $ ( ".alert" ). alert ( 'zamknij' )

Wydarzenia

Klasa alertu Bootstrap udostępnia kilka zdarzeń do podłączenia do funkcji alertów.

Wydarzenie Opis
blisko To zdarzenie jest wyzwalane natychmiast po closewywołaniu metody wystąpienia.
Zamknięte To zdarzenie jest wywoływane po zamknięciu alertu (poczeka na zakończenie przejść css).
  1. $ ( '#mój-alert' ). bind ( 'zamknięte' , funkcja () {
  2. // Zrób coś…
  3. })

Przykładowe zastosowania

Zrób więcej za pomocą przycisków. Kontroluj stany przycisków lub twórz grupy przycisków dla większej liczby komponentów, takich jak paski narzędzi.

Stanowy

Dodaj data-loading-text="Loading...", aby użyć stanu ładowania przycisku.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Ładowanie..." > Stan ładowania </button>

Pojedynczy przełącznik

Dodaj data-toggle="button", aby aktywować przełączanie jednym przyciskiem.

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" > Pojedynczy przełącznik </button>

Pole wyboru

Dodaj data-toggle="buttons-checkbox"do przełączania stylu pola wyboru w grupie btn.

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. <button type = "button" class = "btn btn-primary" > Lewo </button>
  3. <button type = „button” class = „btn btn-primary” > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Prawo </button>
  5. </div>

Radio

Dodaj data-toggle="buttons-radio"do przełączania stylu radia w grupie btn.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" > Lewo </button>
  3. <button type = „button” class = „btn btn-primary” > Middle </button>
  4. <button type = "button" class = "btn btn-primary" > Prawo </button>
  5. </div>

Stosowanie

Włącz przyciski przez JavaScript:

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

Narzut

Atrybuty danych są integralną częścią wtyczki przycisku. Sprawdź poniższy przykładowy kod dla różnych typów znaczników.

Opcje

Nic

Metody

$().button('przełącz')

Przełącza stan wypychania. Nadaje przyciskowi wygląd, w którym został aktywowany.

Heads-up! Możesz włączyć automatyczne przełączanie przycisku za pomocą data-toggleatrybutu.
  1. <button type = „button” class = „btn” data-toggle = „button” > </button>

$().button('ładowanie')

Ustawia stan przycisku na ładowanie - wyłącza przycisk i zamienia tekst na tekst wczytujący. Ładowanie tekstu należy zdefiniować na elemencie przycisku za pomocą atrybutu data data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "ładowanie rzeczy..." > ... </button>
Heads-up! Firefox utrzymuje stan wyłączenia podczas wczytywania strony . Obejściem tego jest użycie autocomplete="off".

$().button('reset')

Resetuje stan przycisku — zamienia tekst na tekst oryginalny.

$().button(ciąg)

Resetuje stan przycisku — zamienia tekst na dowolny stan tekstowy zdefiniowany w danych.

  1. <button type = "button" class = "btn" data-complete-text = "gotowe!" > ... </button>
  2. <skrypt>
  3. $ ( '.btn' ). przycisk ( 'zakończ' )
  4. </script>

O

Uzyskaj podstawowe style i elastyczną obsługę składanych komponentów, takich jak akordeony i nawigacja.

* Wymaga dołączenia wtyczki Transitions.

Przykładowy akordeon

Korzystając z wtyczki zwijania, zbudowaliśmy prosty widżet w stylu akordeonu:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat deskorolka dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua połóż na nim ptaka kalmary kawa jednorodna nulla zakładanda Shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad wegański wyjątek rzeźnik vice lomo. Legginsy occaecat rzemieślnicze z farmy na stół, surowy denim, estetyczny synth nesciunt, o którym prawdopodobnie nie słyszałeś accusamus labore zrównoważony VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat deskorolka dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua połóż na nim ptaka kalmary kawa jednorodna nulla zakładanda Shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad wegański wyjątek rzeźnik vice lomo. Legginsy occaecat rzemieślnicze z farmy na stół, surowy denim, estetyczny synth nesciunt, o którym prawdopodobnie nie słyszałeś accusamus labore zrównoważony VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat deskorolka dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua połóż na nim ptaka kalmary kawa jednorodna nulla zakładanda Shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad wegański wyjątek rzeźnik vice lomo. Legginsy occaecat rzemieślnicze z farmy na stół, surowy denim, estetyczny synth nesciunt, o którym prawdopodobnie nie słyszałeś accusamus labore zrównoważony VHS.
  1. <div class = "accordion" id = "accordion2" >
  2. <div class = "akordeon-group" >
  3. <div class = "accordion-heading" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne"> >
  5. Składany element grupowy nr 1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "zwinięcie ciała akordeonu" >
  9. <div class = "akordeon-inner" >
  10. Animowany frazes pariatur...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "akordeon-group" >
  15. <div class = "accordion-heading" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Składany element grupowy nr 2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "zwinięcie akordeonu" >
  21. <div class = "akordeon-inner" >
  22. Animowany frazes pariatur...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

Możesz także użyć wtyczki bez znaczników akordeonu. Stwórz przycisk, aby przełączać rozwijanie i zwijanie innego elementu.

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. prosty składany
  3. </button>
  4.  
  5. <div id = „demo” class = „zwiń w” > </div>

Stosowanie

Poprzez atrybuty danych

Wystarczy dodać data-toggle="collapse"i data-targetdo elementu, aby automatycznie przypisać kontrolę nad zwijanym elementem. data-targetAtrybut akceptuje selektor css, do którego ma zostać zastosowane zwinięcie . Pamiętaj, aby dodać klasę collapsedo zwijanego elementu. Jeśli chcesz, aby była domyślnie otwarta, dodaj dodatkowe zajęcia in.

Aby dodać zarządzanie grupami w stylu akordeonu do zwijanej kontrolki, dodaj atrybut data data-parent="#selector". Zapoznaj się z demo, aby zobaczyć to w akcji.

Przez JavaScript

Włącz ręcznie za pomocą:

  1. $ ( ".zwiń" ). zwiń ()

Opcje

Opcje można przekazywać za pomocą atrybutów danych lub kodu JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, jak w data-parent="".

Nazwa rodzaj domyślna opis
rodzic selektor fałszywy Jeśli selektor to wszystkie zwijalne elementy pod określonym rodzicem zostaną zamknięte, gdy ten zwijalny element zostanie wyświetlony. (podobne do tradycyjnego zachowania akordeonu)
przełącznik logiczne PRAWDA Przełącza zwijany element przy wywołaniu

Metody

.zwiń(opcje)

Aktywuje zawartość jako zwijany element. Akceptuje opcjonalne opcje object.

  1. $ ( '#myCollapsible' ). zwiń ({
  2. przełącz : fałszywy
  3. })

.zwiń('przełącz')

Przełącza zwijany element na pokazany lub ukryty.

.zwiń('pokaż')

Pokazuje składany element.

.zwiń('ukryj')

Ukrywa składany element.

Wydarzenia

Klasa zwijania Bootstrap udostępnia kilka zdarzeń umożliwiających podłączenie do funkcji zwijania.

Wydarzenie Opis
pokazać To zdarzenie jest wyzwalane natychmiast po showwywołaniu metody wystąpienia.
pokazane To zdarzenie jest wywoływane, gdy element zwinięcia jest widoczny dla użytkownika (poczeka na zakończenie przejść CSS).
ukryć To zdarzenie jest wywoływane natychmiast po hidewywołaniu metody.
ukryty To zdarzenie jest wywoływane, gdy element zwinięcia zostanie ukryty przed użytkownikiem (poczeka na zakończenie przejścia CSS).
  1. $ ( '#myCollapsible' ). on ( 'ukryty' , funkcja () {
  2. // Zrób coś…
  3. })

Przykład

Podstawowa, łatwo rozszerzalna wtyczka do szybkiego tworzenia eleganckich krojów pisma z dowolnym wprowadzaniem tekstu w formularzu.

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

Będziesz chciał ustawić autocomplete="off", aby zapobiec wyświetlaniu domyślnych menu przeglądarki w menu rozwijanym Bootstrap.


Stosowanie

Poprzez atrybuty danych

Dodaj atrybuty danych, aby zarejestrować element z funkcją wyprzedzenia, jak pokazano w powyższym przykładzie.

Przez JavaScript

Wywołaj czcionkę ręcznie za pomocą:

  1. $ ( '.typeahead' ). pisać z wyprzedzeniem ()

Opcje

Opcje można przekazywać za pomocą atrybutów danych lub kodu JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, jak w data-source="".

Nazwa rodzaj domyślna opis
źródło tablica, funkcja [ ] Źródło danych do zapytania. Może być tablicą ciągów lub funkcją. Do funkcji przekazywane są dwa argumenty, querywartość w polu wejściowym i processwywołanie zwrotne. Funkcja może być używana synchronicznie, zwracając źródło danych bezpośrednio lub asynchronicznie za pomocą processpojedynczego argumentu wywołania zwrotnego.
przedmiotów numer 8 Maksymalna liczba elementów do wyświetlenia w menu.
minimalna długość numer 1 Minimalna długość znaków wymagana przed uruchomieniem sugestii autouzupełniania
dopasowanie funkcjonować wielkość liter nie jest rozróżniana Metoda używana do określenia, czy zapytanie pasuje do elementu. Akceptuje pojedynczy argument, itemwzględem którego ma zostać przetestowane zapytanie. Uzyskaj dostęp do bieżącego zapytania za pomocą this.query. Zwraca wartość logiczną true, jeśli zapytanie jest zgodne.
sorter funkcjonować dokładne dopasowanie, wielkość liter
,
wielkość liter bez rozróżniania
Metoda używana do sortowania wyników autouzupełniania. Akceptuje pojedynczy argument itemsi ma zakres wystąpienia Typeahead. Odwołaj się do bieżącego zapytania za pomocą this.query.
aktualizator funkcjonować zwraca wybrany przedmiot Metoda użyta do zwrotu wybranej pozycji. Akceptuje pojedynczy argument, itemi ma zakres instancji typeahead.
Zakreślacz funkcjonować podświetla wszystkie domyślne dopasowania Metoda używana do wyróżnienia wyników autouzupełniania. Akceptuje pojedynczy argument itemi ma zakres wystąpienia Typeahead. Powinien zwrócić html.

Metody

.typeahead(opcje)

Inicjuje dane wejściowe z wyprzedzeniem.

Przykład

Podnawigacja po lewej stronie to demo wtyczki afiksu na żywo.


Stosowanie

Poprzez atrybuty danych

Aby łatwo dodać zachowanie afiksu do dowolnego elementu, po prostu dodaj data-spy="affix"do elementu, który chcesz szpiegować. Następnie użyj przesunięć, aby zdefiniować, kiedy włączać i wyłączać przypinanie elementu.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
Heads-up! Musisz zarządzać pozycją przypiętego elementu i zachowaniem jego bezpośredniego rodzica. Pozycja jest kontrolowana przez affix, affix-top, i affix-bottom. Pamiętaj, aby sprawdzić potencjalnie zwinięty element nadrzędny, gdy pojawi się afiks, ponieważ usuwa on zawartość z normalnego przepływu strony.

Przez JavaScript

Wywołaj wtyczkę afiksu przez JavaScript:

  1. $ ( '#pasek nawigacyjny' ). przyrostek ()

Opcje

Opcje można przekazywać za pomocą atrybutów danych lub kodu JavaScript. W przypadku atrybutów danych dołącz nazwę opcji do data-, jak w data-offset-top="200".

Nazwa rodzaj domyślna opis
zrównoważyć numer | funkcja | obiekt 10 Piksele do przesunięcia względem ekranu podczas obliczania pozycji przewijania. W przypadku podania pojedynczej liczby przesunięcie zostanie zastosowane zarówno w górę, jak i w lewo. Aby nasłuchiwać pojedynczego kierunku lub wielu unikalnych odsunięć, po prostu podaj obiekt offset: { x: 10 }. Użyj funkcji, gdy musisz dynamicznie wprowadzić przesunięcie (przydatne w przypadku niektórych responsywnych projektów).