JavaScript
Oživite Bootstrapove komponente s više od desetak prilagođenih jQuery dodataka. Jednostavno ih uključite sve ili jednu po jednu.
Oživite Bootstrapove komponente s više od desetak prilagođenih jQuery dodataka. Jednostavno ih uključite sve ili jednu po jednu.
Dodaci se mogu uključiti pojedinačno (koristeći Bootstrapove pojedinačne *.js
datoteke) ili sve odjednom (koristeći bootstrap.js
ili umanjeni bootstrap.min.js
).
Oba bootstrap.js
i bootstrap.min.js
sadrže sve dodatke u jednoj datoteci. Uključi samo jedan.
Neki dodaci i CSS komponente ovise o drugim dodacima. Ako dodate dodatke pojedinačno, svakako provjerite te ovisnosti u dokumentima. Također imajte na umu da svi dodaci ovise o jQueryju (to znači da jQuery mora biti uključen prije datoteka dodataka). Posavjetujte se s našimbower.json
da biste vidjeli koje su verzije jQueryja podržane.
Sve Bootstrap dodatke možete koristiti isključivo putem API-ja za označavanje bez pisanja ijednog retka JavaScripta. Ovo je Bootstrapov prvoklasni API i trebao bi vam biti na prvom mjestu pri korištenju dodatka.
Ipak, u nekim situacijama može biti poželjno isključiti ovu funkciju. Stoga također pružamo mogućnost onemogućavanja API-ja atributa podataka poništavanjem veza svih događaja na prostoru imena dokumenta s data-api
. Ovo izgleda ovako:
Alternativno, da ciljate određeni dodatak, samo uključite naziv dodatka kao prostor imena zajedno s prostorom imena data-api ovako:
Nemojte koristiti atribute podataka iz više dodataka na istom elementu. Na primjer, gumb ne može istovremeno imati opis alata i mijenjati modal. Da biste to postigli, upotrijebite element za omatanje.
Također vjerujemo da biste trebali moći koristiti sve Bootstrap dodatke isključivo putem JavaScript API-ja. Svi javni API-ji su pojedinačne metode koje se mogu ulančati i vraćaju zbirku na koju se djeluje.
Sve metode trebaju prihvatiti opcijski objekt opcija, niz koji cilja na određenu metodu ili ništa (što pokreće dodatak sa zadanim ponašanjem):
Svaki dodatak također izlaže svoj neobrađeni konstruktor na Constructor
svojstvu: $.fn.popover.Constructor
. Ako želite dobiti određenu instancu dodatka, dohvatite je izravno iz elementa: $('[rel="popover"]').data('popover')
.
Možete promijeniti zadane postavke dodatka izmjenom Constructor.DEFAULTS
objekta dodatka:
Ponekad je potrebno koristiti Bootstrap dodatke s drugim UI okvirima. U tim okolnostima povremeno može doći do sukoba prostora imena. Ako se to dogodi, možete pozvati .noConflict
dodatak kojem želite vratiti vrijednost.
Bootstrap pruža prilagođene događaje za većinu jedinstvenih radnji dodataka. Općenito, oni dolaze u obliku infinitiva i participa prošlosti - gdje se infinitiv (npr. show
) pokreće na početku događaja, a njegov oblik participa prošlosti (npr. shown
) se pokreće nakon završetka radnje.
Od verzije 3.0.0, svi Bootstrap događaji imaju prostor imena.
Svi infinitivni događaji pružaju preventDefault
funkcionalnost. Ovo pruža mogućnost zaustavljanja izvršenja radnje prije nego što započne.
Tooltips i Popovers koriste naš ugrađeni sanitizer za čišćenje opcija koje prihvaćaju HTML.
Zadana whiteList
vrijednost je sljedeća:
Ako želite dodati nove vrijednosti ovoj zadanoj postavci whiteList
, možete učiniti sljedeće:
Ako želite zaobići naš sanitizer jer više volite koristiti namjensku biblioteku, na primjer DOMPurify , trebali biste učiniti sljedeće:
document.implementation.createHTMLDocument
U slučaju preglednika koji ne podržavaju document.implementation.createHTMLDocument
, kao što je Internet Explorer 8, ugrađena funkcija saniranja vraća HTML kakav jest.
Ako u ovom slučaju želite izvršiti dezinfekciju, navedite sanitizeFn
i koristite vanjsku biblioteku kao što je DOMPurify .
Verziji svakog Bootstrapovog jQuery dodatka može se pristupiti putem VERSION
svojstva konstruktora dodatka. Na primjer, za dodatak s opisom alata:
Bootstrapovi dodaci ne vraćaju se osobito graciozno kada je JavaScript onemogućen. Ako vam je stalo do korisničkog iskustva u ovom slučaju, upotrijebite <noscript>
kako biste svojim korisnicima objasnili situaciju (i kako ponovno omogućiti JavaScript) i/ili dodajte vlastite prilagođene zamjene.
Bootstrap službeno ne podržava JavaScript biblioteke trećih strana kao što su Prototype ili jQuery UI. Unatoč .noConflict
događajima u prostoru imena, može doći do problema s kompatibilnošću koje morate sami riješiti.
Za jednostavne efekte prijelaza, uključite transition.js
jednom uz druge JS datoteke. Ako koristite kompilirani (ili umanjeni) bootstrap.js
, nema potrebe uključivati ovo—već je tu.
Transition.js je osnovni pomoćnik za transitionEnd
događaje kao i CSS emulator prijelaza. Koriste ga drugi dodaci za provjeru podrške za CSS prijelaze i za hvatanje visećih prijelaza.
Prijelazi se mogu globalno onemogućiti pomoću sljedećeg JavaScript isječka, koji mora doći nakon transition.js
(ili bootstrap.js
ili bootstrap.min.js
, ovisno o slučaju) učitavanja:
Modali su pojednostavljeni, ali fleksibilni dijaloški upitnici s minimalnom potrebnom funkcionalnošću i pametnim zadanim postavkama.
Pazite da ne otvorite modal dok je drugi još vidljiv. Prikazivanje više od jednog modala istovremeno zahtijeva prilagođeni kod.
Uvijek pokušajte postaviti HTML kod modala na poziciju najviše razine u svom dokumentu kako biste izbjegli da druge komponente utječu na izgled i/ili funkcionalnost modala.
Postoje neka upozorenja u vezi s korištenjem modala na mobilnim uređajima. Pogledajte našu dokumentaciju za podršku preglednika za detalje.
Zbog načina na koji HTML5 definira svoju semantiku, autofocus
HTML atribut nema učinka u Bootstrap modalima. Da biste postigli isti učinak, upotrijebite prilagođeni JavaScript:
Prikazani modal sa zaglavljem, tijelom i skupom radnji u podnožju.
Uključite modal putem JavaScripta klikom na gumb ispod. Kliznit će prema dolje i izblijedjeti s vrha stranice.
Obavezno dodajte role="dialog"
i aria-labelledby="..."
, pozivajući se na modalni naslov, na .modal
i role="document"
na samoga .modal-dialog
sebe.
Osim toga, možete dati opis svog modalnog dijaloga s aria-describedby
na .modal
.
Ugrađivanje YouTube videozapisa u modale zahtijeva dodatni JavaScript koji nije u Bootstrapu za automatsko zaustavljanje reprodukcije i više. Za više informacija pogledajte ovaj korisni post Stack Overflowa .
Modali imaju dvije izborne veličine, dostupne putem modifikatorskih klasa koje se postavljaju na .modal-dialog
.
Za modale koji se jednostavno pojavljuju umjesto da blijede u prikazu, uklonite .fade
klasu iz svoje modalne oznake.
Da biste iskoristili prednosti Bootstrapovog mrežnog sustava unutar modalnog, samo ugniježdite .row
s unutar .modal-body
i zatim upotrijebite normalne klase mrežnog sustava.
Imate hrpu gumba koji svi pokreću isti modal, samo s malo drugačijim sadržajem? Upotrijebite HTML atributeevent.relatedTarget
i (moguće putem jQueryja ) za mijenjanje sadržaja modala ovisno o tome koji je gumb kliknut. Pogledajte dokumente o modalnim događajima za detalje o ,data-*
relatedTarget
Modalni dodatak prebacuje vaš skriveni sadržaj na zahtjev, putem atributa podataka ili JavaScripta. Također dodaje .modal-open
za <body>
nadjačavanje zadanog ponašanja pomicanja i generira .modal-backdrop
za pružanje područja klika za odbacivanje prikazanih modala kada se klikne izvan modala.
Aktivirajte modal bez pisanja JavaScripta. Postavite data-toggle="modal"
na element kontrolera, poput gumba, zajedno s data-target="#foo"
ili href="#foo"
za ciljanje određenog modala za prebacivanje.
Pozovite modal s ID -om myModal
s jednim redom JavaScripta:
Opcije se mogu proslijediti putem atributa podataka ili JavaScripta. Za atribute podataka, dodajte naziv opcije u data-
, kao u data-backdrop=""
.
Ime | tip | zadano | opis |
---|---|---|---|
pozadina | booleov ili niz'static' |
pravi | Uključuje element modalne pozadine. Alternativno, navedite static za pozadinu koja ne zatvara modal na klik. |
tipkovnica | Booleov | pravi | Zatvara modal kada se pritisne tipka za izlaz |
pokazati | Booleov | pravi | Prikazuje modal kada se inicijalizira. |
daljinski | staza | lažno | Ova je opcija zastarjela od verzije 3.3.0 i uklonjena je u verziji 4. Umjesto toga preporučamo korištenje predložaka na strani klijenta ili okvir za vezanje podataka ili sami pozovite jQuery.load . Ako je naveden udaljeni URL, sadržaj će se učitati jednom putem jQuery |
.modal(options)
Aktivira vaš sadržaj kao modal. Prihvaća izborne opcije object
.
.modal('toggle')
Ručno mijenja modal. Vraća se pozivatelju prije nego što se modal stvarno prikaže ili sakrije (tj. prije nego što se dogodi događaj shown.bs.modal
ili ).hidden.bs.modal
.modal('show')
Ručno otvara modal. Vraća se pozivatelju prije nego što se modal stvarno prikaže (tj. prije nego što se shown.bs.modal
događaj dogodi).
.modal('hide')
Ručno skriva modal. Vraća se pozivatelju prije nego što je modal zapravo skriven (tj. prije nego što se hidden.bs.modal
događaj dogodi).
.modal('handleUpdate')
Ponovno prilagođava pozicioniranje modala kako bi spriječio traku za pomicanje u slučaju da se pojavi, što bi dovelo do skoka modala ulijevo.
Potrebno samo kada se visina modala mijenja dok je otvoren.
Bootstrapova modalna klasa izlaže nekoliko događaja za spajanje na modalnu funkcionalnost.
Svi modalni događaji pokreću se na samom modalu (tj. na <div class="modal">
).
Vrsta događaja | Opis |
---|---|
pokazati.bs.modalni | Ovaj događaj aktivira se odmah kada show se pozove metoda instance. Ako je uzrokovan klikom, kliknuti element dostupan je kao relatedTarget svojstvo događaja. |
prikazano.bs.modalno | Ovaj se događaj pokreće kada je modal postao vidljiv korisniku (pričekat će da se CSS prijelazi završe). Ako je uzrokovan klikom, kliknuti element dostupan je kao relatedTarget svojstvo događaja. |
sakriti.bs.modalan | Ovaj događaj se aktivira odmah nakon hide pozivanja metode instance. |
skriven.bs.modalan | Ovaj se događaj pokreće kada se modal više ne skriva od korisnika (pričekat će se da se CSS prijelazi završe). |
učitano.bs.modalno | Ovaj se događaj aktivira kada modal učita sadržaj pomoću remote opcije. |
Dodajte padajuće izbornike gotovo svemu s ovim jednostavnim dodatkom, uključujući navigacijsku traku, kartice i pilule.
Putem atributa podataka ili JavaScripta, padajući dodatak uključuje i isključuje skriveni sadržaj (padajući izbornici) mijenjanjem .open
klase na nadređenoj stavci popisa.
Na mobilnim uređajima otvaranje padajućeg izbornika dodaje .dropdown-backdrop
područje za dodirivanje za zatvaranje padajućih izbornika kada dodirnete izvan izbornika, što je preduvjet za odgovarajuću podršku za iOS. To znači da prebacivanje s otvorenog padajućeg izbornika na drugi padajući izbornik zahtijeva dodatni dodir na mobilnom telefonu.
Napomena: data-toggle="dropdown"
atribut se oslanja na zatvaranje padajućih izbornika na razini aplikacije, stoga je dobra ideja uvijek ga koristiti.
Dodajte data-toggle="dropdown"
na vezu ili gumb za prebacivanje padajućeg izbornika.
Kako bi URL-ovi ostali netaknuti s gumbima veza, upotrijebite data-target
atribut umjesto href="#"
.
Pozovite padajuće izbornike putem JavaScripta:
data-toggle="dropdown"
još uvijek potrebnoBez obzira na to pozivate li svoj padajući izbornik putem JavaScripta ili umjesto toga koristite data-api, data-toggle="dropdown"
uvijek je potrebno biti prisutan na elementu okidača padajućeg izbornika.
Nijedan
$().dropdown('toggle')
Prebacuje padajući izbornik određene navigacijske trake ili navigacije s karticama.
Svi padajući događaji pokreću se na .dropdown-menu
roditeljskom elementu.
Svi padajući događaji imaju relatedTarget
svojstvo čija je vrijednost element sidra za prebacivanje.
Vrsta događaja | Opis |
---|---|
show.bs.dropdown | Ovaj događaj aktivira se odmah kada se pozove metoda show instance. |
prikazano.bs.padajući izbornik | Ovaj se događaj pokreće kada je padajući izbornik učinjen vidljivim korisniku (pričekat će CSS prijelaze da dovrše). |
hide.bs.dropdown | Ovaj se događaj aktivira odmah nakon pozivanja metode hide instance. |
skriven.bs.padajući | Ovaj se događaj pokreće kada se padajući izbornik više ne skriva od korisnika (pričekat će se da CSS prijelazi dovrše). |
Dodatak ScrollSpy služi za automatsko ažuriranje navigacijskih ciljeva na temelju položaja pomicanja. Pomičite područje ispod navigacijske trake i promatrajte promjenu aktivne klase. Podstavke padajućeg izbornika također će biti istaknute.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi prije nego što su rasprodali qui. Tumblr prava za bicikle od farme do stola. Anim keffiyeh carles kardigan. Velit seitan mcsweeney's photo booth 3 vuk mjesec irure. Cosby pulover lomo jean kratke hlače, williamsburg hoodie minim qui vjerojatno niste čuli za njih i kardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tetovirani akuzamus, cred ironija biodizel keffiyeh artisan ullamco consequat.
Veniam marfa brkovi skateboard, adipisicing fugiat velit vile brada. Freeganova brada aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tetovirani cosby pulover s hranom, mcsweeneyjev quis non freegan vinil. Lo-fi wes anderson +1 krojački. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft pivo deserunt skateboard ea. Lomo biciklistička prava adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinil, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minimalna kurirska torba. Cred ex in, održivi 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.
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. Sapiente synth id pretpostavlja se. Locavore sed helvetica kliše ironija, thundercats vjerojatno niste čuli za njih consequat hoodie bez glutena lo-fi fap aliquip. Labore elit placeat prije nego što su rasprodani, terry richardson proident brunch nesciunt quis cosby džemper pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan gotovi velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Veze na navigacijskoj traci moraju imati razrješive ID ciljeve. Na primjer, <a href="#home">home</a>
mora odgovarati nečemu u DOM-u kao što je <div id="home"></div>
.
:visible
ciljani zanemareniCiljani elementi koji nisu :visible
u skladu s jQueryjem bit će zanemareni i njihove odgovarajuće navigacijske stavke nikada neće biti istaknute.
Bez obzira na metodu implementacije, scrollspy zahtijeva korištenje position: relative;
na elementu koji špijunirate. U većini slučajeva ovo je <body>
. Kada špijunirate na elementima koji nisu <body>
, svakako imate height
postavljen i overflow-y: scroll;
primijenjen.
Da biste jednostavno dodali scrollspy ponašanje svojoj navigaciji gornje trake, dodajte data-spy="scroll"
elementu koji želite špijunirati (najčešće bi to bio <body>
). Zatim dodajte data-target
atribut s ID-om ili klasom nadređenog elementa bilo koje Bootstrap .nav
komponente.
Nakon dodavanja position: relative;
vašeg CSS-a, pozovite scrollspy putem JavaScripta:
.scrollspy('refresh')
Kada koristite scrollspy u kombinaciji s dodavanjem ili uklanjanjem elemenata iz DOM-a, morat ćete pozvati metodu osvježavanja na sljedeći način:
Opcije se mogu proslijediti putem atributa podataka ili JavaScripta. Za atribute podataka, dodajte naziv opcije u data-
, kao u data-offset=""
.
Ime | tip | zadano | opis |
---|---|---|---|
pomaknuti | broj | 10 | Pikseli za pomak od vrha pri izračunavanju položaja pomicanja. |
Vrsta događaja | Opis |
---|---|
aktivirati.bs.scrollspy | Ovaj događaj se aktivira kad god se nova stavka aktivira od strane ScrollSpy. |
Dodajte brzu, dinamičnu funkcionalnost kartica za prijelaz kroz okna lokalnog sadržaja, čak i putem padajućih izbornika. Ugniježđene kartice nisu podržane.
Sirovi traper za koji vjerojatno niste čuli za jeans kratke hlače Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Moustache cliche tempor, williamsburg carles veganska helvetica. Reprehenderit mesar retro keffiyeh dreamcatcher synth. Cosby pulover eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis kardigan američka odjeća, mesar 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.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Ovaj dodatak proširuje komponentu navigacije s karticama za dodavanje područja s karticama.
Omogućite tabbable kartice putem JavaScripta (svaku karticu potrebno je zasebno aktivirati):
Pojedinačne kartice možete aktivirati na nekoliko načina:
Možete aktivirati karticu ili navigaciju pilulom bez pisanja bilo kakvog JavaScripta jednostavnim navođenjem data-toggle="tab"
ili data-toggle="pill"
na elementu. Dodavanjem klasa nav
i nav-tabs
na karticu primijenit će se stil karticeul
Bootstrap , dok će dodavanjem klasa i primijeniti stil tablete .nav
nav-pills
Da bi kartice blijedjele, dodajte .fade
svakoj .tab-pane
. Prvo okno kartice također mora .in
učiniti početni sadržaj vidljivim.
$().tab
Aktivira element kartice i spremnik sadržaja. Kartica bi trebala imati data-target
ili href
ciljanje čvora spremnika u DOM-u. U gornjim primjerima, kartice su <a>
s s data-toggle="tab"
atributima.
.tab('show')
Odabire zadanu karticu i prikazuje pridruženi sadržaj. Bilo koja druga kartica koja je prethodno bila odabrana postaje neodabrana, a pridruženi sadržaj skriven. Vraća se pozivatelju prije nego što se okno kartice stvarno prikaže (tj. prije nego što se shown.bs.tab
događaj dogodi).
Kada se prikazuje nova kartica, događaji se aktiviraju sljedećim redoslijedom:
hide.bs.tab
(na trenutno aktivnoj kartici)show.bs.tab
(na kartici koje će biti prikazano)hidden.bs.tab
(na prethodnoj aktivnoj kartici, ista kao za hide.bs.tab
događaj)shown.bs.tab
(na novoaktivnoj upravo prikazanoj kartici, ista kao i za show.bs.tab
događaj)Ako nijedna kartica već nije bila aktivna, tada se događaji hide.bs.tab
i hidden.bs.tab
neće pokrenuti.
Vrsta događaja | Opis |
---|---|
pokazati.bs.tab | Ovaj se događaj aktivira prilikom prikaza kartice, ali prije nego što se prikaže nova kartica. Koristite event.target i event.relatedTarget za ciljanje aktivne kartice i prethodne aktivne kartice (ako je dostupna). |
prikazano.bs.tab | Ovaj se događaj pokreće na prikazu kartice nakon što je kartica prikazana. Koristite event.target i event.relatedTarget za ciljanje aktivne kartice i prethodne aktivne kartice (ako je dostupna). |
sakriti.bs.tab | Ovaj se događaj pokreće kada se treba prikazati nova kartica (i stoga se prethodna aktivna kartica treba sakriti). Koristite event.target i event.relatedTarget za ciljanje trenutno aktivne kartice i nove kartice koja će uskoro biti aktivna. |
skriven.bs.tab | Ovaj se događaj pokreće nakon što se prikaže nova kartica (i stoga je prethodna aktivna kartica skrivena). Koristite event.target i event.relatedTarget za ciljanje prethodne aktivne kartice odnosno nove aktivne kartice. |
Nadahnut izvrsnim dodatkom jQuery.tipsy koji je napisao Jason Frame; Opisi alata ažurirana su verzija koja se ne oslanja na slike, koristi CSS3 za animacije i atribute podataka za lokalnu pohranu naslova.
Opisi s naslovima nulte duljine nikad se ne prikazuju.
Zadržite pokazivač iznad donjih veza da biste vidjeli savjete:
Uske hlače sljedeće razine keffiyeh za koje vjerojatno niste čuli. Photo booth beard raw denim letterpress veganska kurirska torba stumptown. Seitan od farme do stola, mcsweeneyjeva fiksna održiva quinoa 8-bitna američka odjeća ima frotir richardson vinil chambray. Beard stumptown, kardigani banh mi lomo thundercats. Tofu biodizel williamsburg marfa, four loko mcsweeney's cleanse veganski chambray. A stvarno ironic artisan whatever keytar , scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.
Dostupne su četiri opcije: gore, desno, dolje i lijevo poravnato.
Zbog performansi, Tooltip i Popover data-apis su opt-in, što znači da ih morate sami inicijalizirati .
Jedan od načina da inicijalizirate sve opise alata na stranici bio bi da ih odaberete prema njihovim data-toggle
atributima:
Dodatak s opisom alata generira sadržaj i oznake na zahtjev i prema zadanim postavkama postavlja opise alata nakon elementa pokretača.
Pokreni opis alata putem JavaScripta:
Potrebna oznaka za opis alata samo je data
atribut, a title
na HTML elementu želite imati opis alata. Generirano označavanje opisa alata je prilično jednostavno, iako zahtijeva poziciju (prema zadanim postavkama, postavljena top
od strane dodatka).
Ponekad želite dodati opis alata hipervezi koja prelama više redaka. Zadano ponašanje dodatka za opis alata je njegovo centriranje vodoravno i okomito. Dodajte white-space: nowrap;
svojim sidrima kako biste to izbjegli.
Kada koristite opise alata na elementima unutar .btn-group
ili .input-group
, ili na elementima povezanim s tablicom ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), morat ćete navesti opciju container: 'body'
(dokumentirano u nastavku) kako biste izbjegli neželjene nuspojave (kao što je širenje elementa i/ ili gubitak zaobljenih kutova kada se aktivira opis alata).
Za korisnike koji se kreću pomoću tipkovnice, a posebno za korisnike pomoćnih tehnologija, savjete alata trebali biste dodati samo elementima koji se mogu fokusirati na tipkovnici kao što su veze, kontrole obrazaca ili bilo koji proizvoljni element s tabindex="0"
atributom.
Da biste dodali opis alata elementu disabled
ili .disabled
, stavite element unutar a i umjesto toga <div>
na njega primijenite opis alata .<div>
Opcije se mogu proslijediti putem atributa podataka ili JavaScripta. Za atribute podataka, dodajte naziv opcije u data-
, kao u data-animation=""
.
Imajte na umu da se iz sigurnosnih razloga opcije sanitize
, sanitizeFn
i whiteList
ne mogu isporučiti pomoću atributa podataka.
Ime | Tip | Zadano | Opis |
---|---|---|---|
animacija | Booleov | pravi | Primijenite CSS fade prijelaz na tooltip |
spremnik | niz | lažno | lažno | Dodaje opis alata određenom elementu. Primjer: |
odgoditi | broj | objekt | 0 | Odgoda prikazivanja i skrivanja opisa alata (ms) - ne odnosi se na vrstu ručnog okidača Ako je naveden broj, odgoda se primjenjuje na skrivanje/prikazivanje Struktura objekta je: |
html | Booleov | lažno | Umetnite HTML u opis alata. Ako je false, jQueryjeva text metoda koristit će se za umetanje sadržaja u DOM. Upotrijebite tekst ako ste zabrinuti zbog XSS napada. |
plasman | niz | funkcija | 'vrh' | Kako postaviti opis alata - vrh | dno | lijevo | desno | auto. Kada se funkcija koristi za određivanje položaja, poziva se s DOM čvorom alata kao prvim argumentom i DOM čvorom pokretačkog elementa kao drugim. Kontekst |
selektor | niz | lažno | Ako je selektor naveden, objekti opisa alata bit će delegirani navedenim ciljevima. U praksi se ovo također koristi za primjenu opisa alata na dinamički dodane DOM elemente ( jQuery.on podrška). Pogledajte ovo i informativan primjer . |
šablona | niz | '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' |
Osnovni HTML za korištenje pri izradi opisa alata. Opis alata
Najudaljeniji element omotača trebao bi imati |
titula | niz | funkcija | '' | Zadana vrijednost naslova ako Ako je dana funkcija, bit će pozvana s |
okidač | niz | 'hover focus' | Kako se aktivira opis alata - kliknite | lebdjeti | fokus | priručnik. Možete proći više okidača; odvojite ih razmakom. manual ne može se kombinirati ni s jednim drugim okidačem. |
prozor za prikaz | niz | objekt | funkcija | { selektor: 'body', padding: 0 } | Zadržava opis alata unutar granica ovog elementa. Primjer: Ako je funkcija dana, ona se poziva s elementom pokretanja DOM čvorom kao jedinim argumentom. Kontekst |
dezinficirati | Booleov | pravi | Omogućite ili onemogućite dezinfekciju. Ako je aktivirano 'template' , 'content' i 'title' opcije će biti očišćene. |
bijeliList | objekt | Zadana vrijednost | Objekt koji sadrži dopuštene atribute i oznake |
dezinficiratiFn | nula | funkcija | ništavan | Ovdje možete ponuditi vlastitu funkciju dezinfekcije. Ovo može biti korisno ako radije koristite namjensku knjižnicu za izvođenje dezinfekcije. |
Opcije za pojedinačne opise alata mogu se alternativno odrediti korištenjem atributa podataka, kao što je gore objašnjeno.
$().tooltip(options)
Priključuje rukovatelj opisom alata kolekciji elemenata.
.tooltip('show')
Otkriva opis elementa. Vraća se pozivatelju prije nego što se alatni opis stvarno prikaže (tj. prije nego što se shown.bs.tooltip
događaj dogodi). To se smatra "ručnim" pokretanjem opisa alata. Opisi s naslovima nulte duljine nikad se ne prikazuju.
.tooltip('hide')
Skriva opis elementa. Vraća se pozivatelju prije nego što je opis alata zapravo skriven (tj. prije nego što se hidden.bs.tooltip
događaj dogodi). To se smatra "ručnim" pokretanjem opisa alata.
.tooltip('toggle')
Prebacuje opis elementa. Vraća se pozivatelju prije nego što se opis alata zapravo prikaže ili sakrije (tj. prije nego što se dogodi događaj shown.bs.tooltip
ili ). hidden.bs.tooltip
To se smatra "ručnim" pokretanjem opisa alata.
.tooltip('destroy')
Skriva i uništava opis elementa. Opisi alata koji koriste delegiranje (koji se stvaraju pomoću opcije selector
) ne mogu se pojedinačno uništiti na elementima okidača potomaka.
Vrsta događaja | Opis |
---|---|
show.bs.tooltip | Ovaj događaj aktivira se odmah kada show se pozove metoda instance. |
prikazano.bs.tooltip | Ovaj se događaj pokreće kada je opis alata vidljiv korisniku (pričekat će se da se CSS prijelazi završe). |
hide.bs.tooltip | Ovaj događaj se aktivira odmah nakon hide pozivanja metode instance. |
skriven.bs.tooltip | Ovaj se događaj pokreće kada se opis alata više ne skriva od korisnika (pričekat će se da se CSS prijelazi završe). |
umetnuto.bs.tooltip | Ovaj se događaj pokreće nakon show.bs.tooltip događaja kada je predložak opisa alata dodan u DOM. |
Dodajte male slojeve sadržaja, poput onih na iPadu, bilo kojem elementu za smještaj sekundarnih informacija.
Skočni prozori čiji su i naslov i sadržaj nulte duljine nikad se ne prikazuju.
Popovers zahtijevaju da plugin tooltip bude uključen u vašu verziju Bootstrapa.
Zbog performansi, Tooltip i Popover data-apis su opt-in, što znači da ih morate sami inicijalizirati .
Jedan od načina da inicijalizirate sve skočne prozore na stranici bio bi da ih odaberete prema njihovom data-toggle
atributu:
Kada koristite skočne prozore na elementima unutar .btn-group
ili .input-group
, ili na elementima povezanim s tablicom ( <td>
, <th>
, <tr>
, <thead>
, <tbody>
, <tfoot>
), morat ćete navesti opciju container: 'body'
(dokumentirano u nastavku) kako biste izbjegli neželjene nuspojave (kao što je širenje elementa i/ ili gubitak zaobljenih uglova kada se aktivira popover).
Da biste dodali popover elementu disabled
ili .disabled
, stavite element unutar a <div>
i primijenite popover na to <div>
umjesto toga.
Ponekad želite dodati skočni prozor hipervezi koja prelama više redaka. Zadano ponašanje popover dodatka je njegovo centriranje vodoravno i okomito. Dodajte white-space: nowrap;
svojim sidrima kako biste to izbjegli.
Dostupne su četiri opcije: gore, desno, dolje i lijevo poravnato.
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.
Koristite focus
okidač za odbacivanje skočnih prozora pri sljedećem korisnikovom kliku.
Za ispravno ponašanje između preglednika i platformi, morate koristiti <a>
oznaku, a ne oznaku <button>
, a također morate uključiti atribute role="button"
i .tabindex
Omogući skočne prozore putem JavaScripta:
Opcije se mogu proslijediti putem atributa podataka ili JavaScripta. Za atribute podataka, dodajte naziv opcije u data-
, kao u data-animation=""
.
Imajte na umu da se iz sigurnosnih razloga opcije sanitize
, sanitizeFn
i whiteList
ne mogu isporučiti pomoću atributa podataka.
Ime | Tip | Zadano | Opis |
---|---|---|---|
animacija | Booleov | pravi | Primijenite CSS fade prijelaz na skočni prozor |
spremnik | niz | lažno | lažno | Dodaje skočni prozor određenom elementu. Primjer: |
sadržaj | niz | funkcija | '' | Zadana vrijednost sadržaja ako Ako je dana funkcija, bit će pozvana s |
odgoditi | broj | objekt | 0 | Odgoda prikazivanja i skrivanja skočnog prozora (ms) - ne odnosi se na vrstu ručnog okidača Ako je naveden broj, odgoda se primjenjuje na skrivanje/prikazivanje Struktura objekta je: |
html | Booleov | lažno | Umetnite HTML u skočni prozor. Ako je false, jQueryjeva text metoda koristit će se za umetanje sadržaja u DOM. Upotrijebite tekst ako ste zabrinuti zbog XSS napada. |
plasman | niz | funkcija | 'pravo' | Kako postaviti popover - vrh | dno | lijevo | desno | auto. Kada se funkcija koristi za određivanje položaja, poziva se s skočnim DOM čvorom kao prvim argumentom i DOM čvorom pokretačkog elementa kao drugim. Kontekst |
selektor | niz | lažno | Ako je selektor osiguran, skočni objekti bit će delegirani navedenim ciljevima. U praksi se to koristi za omogućavanje dodavanja skočnih prozora za dinamički HTML sadržaj. Pogledajte ovo i informativan primjer . |
šablona | niz | '<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-title"></h3><div class="popover-content"></div></div>' |
Osnovni HTML za korištenje pri stvaranju skočnog prozora. Popover Popover
Najudaljeniji element omotača trebao bi imati |
titula | niz | funkcija | '' | Zadana vrijednost naslova ako Ako je dana funkcija, bit će pozvana s |
okidač | niz | 'klik' | Kako se pokreće popover - kliknite | lebdjeti | fokus | priručnik. Možete proći više okidača; odvojite ih razmakom. manual ne može se kombinirati ni s jednim drugim okidačem. |
prozor za prikaz | niz | objekt | funkcija | { selektor: 'body', padding: 0 } | Zadržava popover unutar granica ovog elementa. Primjer: Ako je funkcija dana, ona se poziva s elementom pokretanja DOM čvorom kao jedinim argumentom. Kontekst |
dezinficirati | Booleov | pravi | Omogućite ili onemogućite dezinfekciju. Ako je aktivirano 'template' , 'content' i 'title' opcije će biti očišćene. |
bijeliList | objekt | Zadana vrijednost | Objekt koji sadrži dopuštene atribute i oznake |
dezinficiratiFn | nula | funkcija | ništavan | Ovdje možete ponuditi vlastitu funkciju dezinfekcije. Ovo može biti korisno ako radije koristite namjensku knjižnicu za izvođenje dezinfekcije. |
Opcije za pojedinačne skočne prozore mogu se alternativno specificirati upotrebom atributa podataka, kao što je gore objašnjeno.
$().popover(options)
Inicijalizira skočne prozore za zbirku elemenata.
.popover('show')
Otkriva popover elementa. Vraća se pozivatelju prije nego što se popover stvarno prikaže (tj. prije nego što se shown.bs.popover
događaj dogodi). Ovo se smatra "ručnim" pokretanjem popover-a. Skočni prozori čiji su i naslov i sadržaj nulte duljine nikad se ne prikazuju.
.popover('hide')
Skriva skočni prozor elementa. Vraća se pozivatelju prije nego što je popover zapravo skriven (tj. prije nego što se hidden.bs.popover
događaj dogodi). Ovo se smatra "ručnim" pokretanjem popover-a.
.popover('toggle')
Isključuje skočni prozor elementa. Vraća se pozivatelju prije nego što se popover stvarno prikaže ili sakrije (tj. prije nego što se dogodi događaj shown.bs.popover
ili ). hidden.bs.popover
Ovo se smatra "ručnim" pokretanjem popover-a.
.popover('destroy')
Skriva i uništava popover elementa. Popoveri koji koriste delegiranje (koji se stvaraju pomoću opcije selector
) ne mogu se pojedinačno uništiti na okidačkim elementima potomcima.
Vrsta događaja | Opis |
---|---|
pokazati.bs.popover | Ovaj događaj aktivira se odmah kada show se pozove metoda instance. |
prikazano.bs.popover | Ovaj se događaj pokreće kada je popover vidljiv korisniku (pričekat će se da se CSS prijelazi završe). |
sakriti.bs.popover | Ovaj događaj se aktivira odmah nakon hide pozivanja metode instance. |
skriven.bs.popover | Ovaj se događaj pokreće kada popover više nije skriven od korisnika (pričekat će se da se dovrše CSS prijelazi). |
umetnuto.bs.popover | Ovaj se događaj pokreće nakon show.bs.popover događaja kada je skočni predložak dodan u DOM. |
Dodajte funkciju odbacivanja svim porukama upozorenja pomoću ovog dodatka.
Kada koristite .close
gumb, on mora biti prvi podređeni gumb .alert-dismissible
i nijedan tekstualni sadržaj ne smije biti prije njega u označavanju.
Promijenite ovo i ono i pokušajte ponovno. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Samo dodajte data-dismiss="alert"
gumbu za zatvaranje kako biste automatski dali funkciju zatvaranja upozorenja. Zatvaranje upozorenja uklanja ga iz DOM-a.
Da bi vaša upozorenja koristila animaciju pri zatvaranju, provjerite jesu li na njih već primijenjene klase i .fade
..in
$().alert()
Osluškuje upozorenje za događaje klikova na elementima potomcima koji imaju data-dismiss="alert"
atribut. (Nije potrebno kada se koristi auto-inicijalizacija data-api-ja.)
$().alert('close')
Zatvara upozorenje uklanjanjem iz DOM-a. Ako su klase .fade
i .in
prisutne na elementu, upozorenje će nestati prije nego što se ukloni.
Bootstrapov dodatak za upozorenja otkriva nekoliko događaja za povezivanje s funkcijom upozorenja.
Vrsta događaja | Opis |
---|---|
zatvoriti.bs.upozorenje | Ovaj događaj aktivira se odmah kada close se pozove metoda instance. |
zatvoreno.bs.upozorenje | Ovaj se događaj pokreće kada se upozorenje zatvori (pričekat će se da se CSS prijelazi završe). |
Učinite više s gumbima. Stanja gumba za kontrolu ili stvaranje grupa gumba za više komponenti poput alatnih traka.
Firefox održava stanja kontrole obrasca (onemogućenost i provjerenost) tijekom učitavanja stranice . Zaobilazno rješenje za ovo je korištenje autocomplete="off"
. Pogledajte Mozilla bug #654072 .
Dodajte data-loading-text="Loading..."
za korištenje stanja učitavanja na gumbu.
Ova je značajka zastarjela od verzije 3.3.5 i uklonjena je u verziji 4.
Za potrebe ove demonstracije koristimo data-loading-text
i $().button('loading')
, ali to nije jedino stanje koje možete koristiti. Više o tome pogledajte u nastavku u $().button(string)
dokumentaciji .
Dodajte data-toggle="button"
za aktiviranje prebacivanja na jednom gumbu.
.active
iaria-pressed="true"
Za unaprijed uključene gumbe, morate dodati .active
klasu i aria-pressed="true"
atribut button
sebi.
Dodajte potvrdni okvir data-toggle="buttons"
koji .btn-group
sadrži ili radio ulaze kako biste omogućili prebacivanje u njihovim stilovima.
.active
Za unaprijed odabrane opcije morate sami dodati .active
klasu u unos label
.
Ako se označeno stanje gumba okvira za potvrdu ažurira bez pokretanja click
događaja na gumbu (npr. putem <input type="reset">
ili putem postavljanja checked
svojstva unosa), morat ćete sami promijeniti .active
klasu na unosu label
.
$().button('toggle')
Prebacuje stanje guranja. Daje gumbu izgled da je aktiviran.
$().button('reset')
Ponovno postavlja stanje gumba - mijenja tekst u izvorni tekst. Ova metoda je asinkrona i vraća se prije nego što je resetiranje stvarno dovršeno.
$().button(string)
Mijenja tekst u bilo koje stanje teksta definiranog podacima.
Fleksibilni dodatak koji koristi pregršt klasa za jednostavno prebacivanje.
Sažimanje zahtijeva da dodatak za prijelaze bude uključen u vašu verziju Bootstrapa.
Pritisnite donje gumbe za prikaz ili skrivanje drugog elementa putem promjena klase:
.collapse
skriva sadržaj.collapsing
primjenjuje se tijekom prijelaza.collapse.in
prikazuje sadržajMožete koristiti vezu s href
atributom ili gumb s data-target
atributom. U oba slučaja data-toggle="collapse"
potrebno je.
Proširite zadano ponašanje sažimanja da biste stvorili harmoniku s komponentom ploče.
Također je moguće zamijeniti .panel-body
s sa .list-group
s.
Obavezno dodajte aria-expanded
u kontrolni element. Ovaj atribut eksplicitno definira trenutačno stanje sklopivog elementa za čitače zaslona i slične pomoćne tehnologije. Ako je sklopivi element zatvoren prema zadanim postavkama, trebao bi imati vrijednost aria-expanded="false"
. Ako ste sklopivi element postavili da bude otvoren prema zadanim postavkama pomoću in
klase, aria-expanded="true"
umjesto toga postavite na kontrolu. Dodatak će automatski promijeniti ovaj atribut ovisno o tome je li sklopivi element otvoren ili zatvoren.
Osim toga, ako vaš kontrolni element cilja jedan sklopivi element – tj. data-target
atribut pokazuje na id
selektor – možete dodati dodatni aria-controls
atribut kontrolnom elementu koji sadrži id
sklopivi element. Moderni čitači zaslona i slične pomoćne tehnologije koriste ovaj atribut kako bi korisnicima pružili dodatne prečace za izravnu navigaciju do samog sklopivog elementa.
Dodatak za kolapsiranje koristi nekoliko klasa za rukovanje teškim dizanjem:
.collapse
skriva sadržaj.collapse.in
prikazuje sadržaj.collapsing
dodaje se kada prijelaz započne, a uklanja kada završiOve se klase mogu pronaći u component-animations.less
.
Samo dodajte data-toggle="collapse"
i data-target
elementu da biste automatski dodijelili kontrolu nad sklopivim elementom. Atribut data-target
prihvaća CSS birač na koji se primjenjuje sažimanje. Obavezno dodajte klasu collapse
sklopivom elementu. Ako želite da se prema zadanim postavkama otvori, dodajte dodatnu klasu in
.
Da biste sklopivoj kontroli dodali grupno upravljanje poput harmonike, dodajte atribut podataka data-parent="#selector"
. Pogledajte demo kako biste vidjeli ovo na djelu.
Omogućite ručno pomoću:
Opcije se mogu proslijediti putem atributa podataka ili JavaScripta. Za atribute podataka, dodajte naziv opcije u data-
, kao u data-parent=""
.
Ime | tip | zadano | opis |
---|---|---|---|
roditelj | selektor | lažno | Ako je selektor naveden, tada će svi sklopivi elementi pod navedenim roditeljem biti zatvoreni kada se prikaže ova sklopiva stavka. (slično tradicionalnom ponašanju harmonike - ovo ovisi o panel klasi) |
prebaciti | Booleov | pravi | Prebacuje sklopivi element na poziv |
.collapse(options)
Aktivira vaš sadržaj kao sklopivi element. Prihvaća izborne opcije object
.
.collapse('toggle')
Prebacuje sklopivi element na prikazan ili skriven. Vraća se pozivatelju prije nego što se sklopivi element stvarno prikaže ili sakrije (tj. prije nego što se dogodi događaj shown.bs.collapse
ili ).hidden.bs.collapse
.collapse('show')
Prikazuje sklopivi element. Vraća se pozivatelju prije nego što se sklopivi element stvarno prikaže (tj. prije nego što se shown.bs.collapse
događaj dogodi).
.collapse('hide')
Skriva sklopivi element. Vraća se pozivatelju prije nego što je sklopivi element zapravo skriven (tj. prije nego što se hidden.bs.collapse
događaj dogodi).
Bootstrapova kolaps klasa izlaže nekoliko događaja za spajanje na kolaps funkcionalnost.
Vrsta događaja | Opis |
---|---|
pokazati.bs.srušiti | Ovaj događaj aktivira se odmah kada show se pozove metoda instance. |
prikazano.bs.srušiti | Ovaj se događaj pokreće kada se element sažimanja učini vidljivim korisniku (pričekat će da se CSS prijelazi završe). |
sakriti.bs.srušiti | Ovaj događaj se pokreće odmah nakon hide poziva metode. |
skriven.bs.srušiti | Ovaj se događaj pokreće kada je element sažimanja skriven od korisnika (pričekat će da se CSS prijelazi završe). |
Komponenta dijaprojekcije za kruženje kroz elemente, poput vrtuljka. Ugniježđeni karuseli nisu podržani.
Komponenta vrtuljka općenito nije u skladu sa standardima pristupačnosti. Ako trebate biti usklađeni, razmotrite druge opcije za predstavljanje svog sadržaja.
Bootstrap isključivo koristi CSS3 za svoje animacije, ali Internet Explorer 8 i 9 ne podržavaju potrebna CSS svojstva. Stoga nema animacija prijelaza slajdova kada koristite ove preglednike. Namjerno smo odlučili ne uključiti zamjenske opcije temeljene na jQueryju za prijelaze.
Klasu .active
je potrebno dodati na jedan od slajdova. Inače, vrtuljak neće biti vidljiv.
Klase .glyphicon .glyphicon-chevron-left
i .glyphicon .glyphicon-chevron-right
nisu nužno potrebne za kontrole. Bootstrap nudi .icon-prev
i .icon-next
kao obične unicode alternative.
Lako dodajte opise svojim slajdovima pomoću .carousel-caption
elementa unutar bilo kojeg .item
. Tamo stavite bilo koji izborni HTML i on će se automatski poravnati i formatirati.
Vrtuljci zahtijevaju upotrebu id
na krajnjem vanjskom spremniku ( .carousel
) kako bi kontrole vrtuljka ispravno funkcionirale. Kada dodajete više karusela ili kada mijenjate karusele id
, svakako ažurirajte relevantne kontrole.
Koristite atribute podataka za jednostavnu kontrolu položaja vrtuljka. data-slide
prihvaća ključne riječi prev
ili next
, koje mijenjaju položaj slajda u odnosu na trenutni položaj. Alternativno, koristite data-slide-to
za prosljeđivanje sirovog indeksa slajda na vrtuljak data-slide-to="2"
, koji pomiče položaj slajda na određeni indeks koji počinje s 0
.
Atribut data-ride="carousel"
se koristi za označavanje vrtuljka kao animiranog koji počinje pri učitavanju stranice. Ne može se koristiti u kombinaciji sa (suvišnom i nepotrebnom) eksplicitnom JavaScript inicijalizacijom istog vrtuljka.
Pozovite karusel ručno pomoću:
Opcije se mogu proslijediti putem atributa podataka ili JavaScripta. Za atribute podataka, dodajte naziv opcije u data-
, kao u data-interval=""
.
Ime | tip | zadano | opis |
---|---|---|---|
interval | broj | 5000 | Količina vremena za odgodu između automatskog mijenjanja stavke. Ako je netočno, vrtuljak se neće automatski kretati. |
pauza | niz | ništavan | "lebdjeti" | Ako je postavljeno na "hover" , pauzira kruženje vrtuljka na mouseenter i nastavlja kruženje vrtuljka na mouseleave . Ako je postavljeno na null , lebdeći pokazivač iznad vrtuljka neće ga pauzirati. |
omotati | Booleov | pravi | Treba li vrtuljak kružiti kontinuirano ili se oštro zaustavljati. |
tipkovnica | Booleov | pravi | Treba li vrtuljak reagirati na događaje tipkovnice. |
.carousel(options)
Inicijalizira vrtuljak s neobaveznim opcijama object
i počinje kružiti kroz stavke.
.carousel('cycle')
Kruži kroz stavke vrtuljka slijeva nadesno.
.carousel('pause')
Zaustavlja vrtuljak da kruži kroz stavke.
.carousel(number)
Vrti vrtuljak na određeni okvir (na temelju 0, slično nizu).
.carousel('prev')
Ciklusi na prethodnu stavku.
.carousel('next')
Prelazak na sljedeću stavku.
Bootstrapova klasa vrtuljka izlaže dva događaja za spajanje na funkciju vrtuljka.
Oba događaja imaju sljedeća dodatna svojstva:
direction
: Smjer u kojem vrtuljak klizi (ili "left"
ili "right"
).relatedTarget
: DOM element koji se stavlja na mjesto kao aktivna stavka.Svi događaji na vrtuljku pokreću se na samom vrtuljku (tj. na <div class="carousel">
).
Vrsta događaja | Opis |
---|---|
tobogan.bs.vrtuljak | Ovaj događaj aktivira se odmah kada slide se pozove metoda instance. |
slid.bs.vrtuljak | Ovaj događaj se pokreće kada vrtuljak završi prijelaz slajdova. |
Dodatak za afiks uključuje position: fixed;
se i isključuje, oponašajući učinak pronađen s position: sticky;
. Podnavigacija s desne strane je demonstracija dodatka afiksa uživo.
Upotrijebite dodatak za afiks putem atributa podataka ili ručno s vlastitim JavaScriptom. U obje situacije morate navesti CSS za pozicioniranje i širinu vašeg pričvršćenog sadržaja.
Napomena: Nemojte koristiti dodatak za pričvršćivanje na elementu koji se nalazi u relativno pozicioniranom elementu, kao što je povučeni ili gurnuti stupac, zbog greške u prikazivanju Safarija .
Dodatak afiksa mijenja se između tri klase, od kojih svaka predstavlja određeno stanje: .affix
, .affix-top
i .affix-bottom
. Morate sami osigurati stilove, s iznimkom position: fixed;
na .affix
, za te klase (neovisno o ovom dodatku) kako biste rukovali stvarnim pozicijama.
Evo kako radi dodatak afiksa:
.affix-top
kako bi označio da je element na svom najvišem položaju. U ovom trenutku nije potrebno CSS pozicioniranje..affix
zamjenjuje .affix-top
i postavlja position: fixed;
(omogućuje Bootstrapov CSS)..affix
s .affix-bottom
. Budući da su pomaci izborni, njihovo postavljanje zahtijeva da postavite odgovarajući CSS. U tom slučaju dodajte position: absolute;
po potrebi. Dodatak koristi atribut podataka ili JavaScript opciju kako bi odredio gdje pozicionirati element od tamo.Slijedite gore navedene korake kako biste postavili svoj CSS za bilo koju od opcija upotrebe u nastavku.
Da biste jednostavno dodali ponašanje pričvršćivanja bilo kojem elementu, samo dodajte data-spy="affix"
elementu koji želite špijunirati. Upotrijebite pomake kako biste definirali kada promijeniti prikvačivanje elementa.
Pozovite affix dodatak putem JavaScripta:
Opcije se mogu proslijediti putem atributa podataka ili JavaScripta. Za atribute podataka, dodajte naziv opcije u data-
, kao u data-offset-top="200"
.
Ime | tip | zadano | opis |
---|---|---|---|
pomaknuti | broj | funkcija | objekt | 10 | Pikseli za odmak od zaslona pri izračunavanju položaja pomicanja. Ako je naveden jedan broj, pomak će se primijeniti u smjeru vrha i dna. Da biste osigurali jedinstveni, donji i gornji pomak samo navedite objekt offset: { top: 10 } ili offset: { top: 10, bottom: 5 } . Koristite funkciju kada trebate dinamički izračunati pomak. |
cilj | selektor | čvor | jQuery element | window objekt _ |
Određuje ciljni element afiksa. |
.affix(options)
Aktivira vaš sadržaj kao pričvršćeni sadržaj. Prihvaća izborne opcije object
.
.affix('checkPosition')
Ponovno izračunava stanje afiksa na temelju dimenzija, položaja i položaja pomicanja relevantnih elemenata. Klase .affix
, .affix-top
, i .affix-bottom
dodaju se ili uklanjaju iz pričvršćenog sadržaja u skladu s novim stanjem. Ovu metodu treba pozvati kad god se promijene dimenzije pričvršćenog sadržaja ili ciljnog elementa, kako bi se osiguralo ispravno pozicioniranje pričvršćenog sadržaja.
Bootstrapov dodatak za afiks otkriva nekoliko događaja za spajanje na funkciju afiksa.
Vrsta događaja | Opis |
---|---|
pričvrstiti.bs.pričvrstiti | Ovaj se događaj aktivira neposredno prije nego što je element pričvršćen. |
pričvršćen.bs.pričvrstiti | Ovaj događaj se pokreće nakon što je element pričvršćen. |
affix-top.bs.affix | Ovaj se događaj aktivira neposredno prije nego što je element pričvršćen na vrh. |
pričvršćen-vrh.bs.pričvrstiti | Ovaj događaj se pokreće nakon što je element pričvršćen na vrh. |
afiks-donji dio.bs.afiks | Ovaj se događaj aktivira neposredno prije nego što je element pričvršćen na dno. |
pričvršćeno-dno.bs.pričvrstiti | Ovaj se događaj pokreće nakon što je element pričvršćen na dno. |