JavaScript

Hidupkan komponen Bootstrap—sekarang dengan 13 plugin jQuery khusus.

Perhatian! Dokumen ini untuk v2.3.2, yang tidak lagi didukung secara resmi. Lihat versi terbaru dari Bootstrap!

Individu atau dikompilasi

Plugin dapat dimasukkan satu per satu (meskipun beberapa memiliki ketergantungan yang diperlukan), atau sekaligus. Baik bootstrap.js dan bootstrap.min.js berisi semua plugin dalam satu file.

Atribut data

Anda dapat menggunakan semua plugin Bootstrap murni melalui API markup tanpa menulis satu baris JavaScript. Ini adalah API kelas pertama Bootstrap dan harus menjadi pertimbangan pertama Anda saat menggunakan plugin.

Meskipun demikian, dalam beberapa situasi mungkin diinginkan untuk menonaktifkan fungsi ini. Oleh karena itu, kami juga menyediakan kemampuan untuk menonaktifkan API atribut data dengan melepaskan semua peristiwa pada body namespaced dengan `'data-api'`. Ini terlihat seperti ini:

  1. $ ( 'tubuh' ). mati ( '.data-api' )

Atau, untuk menargetkan plugin tertentu, cukup sertakan nama plugin sebagai namespace bersama dengan namespace data-api seperti ini:

  1. $ ( 'tubuh' ). mati ( '.alert.data-api' )

API terprogram

Kami juga percaya Anda harus dapat menggunakan semua plugin Bootstrap murni melalui JavaScript API. Semua API publik adalah metode tunggal yang dapat dirantai, dan mengembalikan koleksi yang ditindaklanjuti.

  1. $ ( ".btn.bahaya" ). tombol ( "beralih" ). addClass ( "gemuk" )

Semua metode harus menerima objek opsi opsional, string yang menargetkan metode tertentu, atau tidak sama sekali (yang memulai plugin dengan perilaku default):

  1. $ ( "#Modalsaya" ). modal () // diinisialisasi dengan default
  2. $ ( "#Modalsaya" ). modal ({ keyboard : false }) // diinisialisasi tanpa keyboard
  3. $ ( "#Modalsaya" ). modal ( 'show' ) // menginisialisasi dan memanggil show segera

Setiap plugin juga mengekspos konstruktor mentahnya pada properti `Constructor`: $.fn.popover.Constructor. Jika Anda ingin mendapatkan instance plugin tertentu, ambil langsung dari elemen: $('[rel=popover]').data('popover').

Tidak Ada Konflik

Terkadang perlu menggunakan plugin Bootstrap dengan kerangka kerja UI lainnya. Dalam keadaan ini, tabrakan namespace kadang-kadang dapat terjadi. Jika ini terjadi, Anda dapat memanggil .noConflictplugin yang ingin Anda kembalikan nilainya.

  1. var bootstrapButton = $ . fn . tombol . noConflict () // mengembalikan $.fn.button ke nilai yang ditetapkan sebelumnya
  2. $ . fn . bootstrapBtn = bootstrapButton // berikan $().bootstrapBtn fungsionalitas bootstrap

Acara

Bootstrap menyediakan acara khusus untuk sebagian besar tindakan unik plugin. Umumnya, ini datang dalam bentuk infinitive dan past participle - di mana infinitive (ex. show) dipicu pada awal suatu peristiwa, dan bentuk past participle-nya (ex. shown) dipicu pada penyelesaian suatu tindakan.

Semua kejadian infinitif menyediakan fungsionalitas preventDefault. Ini memberikan kemampuan untuk menghentikan eksekusi suatu tindakan sebelum dimulai.

  1. $ ( '#Modalku' ). pada ( 'tampilkan' , fungsi ( e ) {
  2. jika (! data ) kembali e . preventDefault () // menghentikan modal agar tidak ditampilkan
  3. })

Tentang transisi

Untuk efek transisi sederhana, sertakan bootstrap-transition.js sekali di samping file JS lainnya. Jika Anda menggunakan bootstrap.js yang dikompilasi (atau diperkecil) , tidak perlu menyertakan ini—ini sudah ada di sana.

Gunakan kasus

Beberapa contoh plugin transisi:

  • Geser atau memudar di modals
  • Memudar tab
  • Peringatan memudar
  • Panel korsel geser

Contoh

Modals disederhanakan, tetapi fleksibel, permintaan dialog dengan fungsionalitas minimum yang diperlukan dan default cerdas.

Contoh statis

Modal yang dirender dengan header, body, dan set tindakan di footer.

  1. <div class = "modal sembunyikan fade" >
  2. <div class = "modal-header" >
  3. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </tombol>
  4. <h3> Judul modal </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> Satu tubuh yang bagus… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" > Tutup </a>
  11. <a href = "#" class = "btn btn-primary"> Simpan perubahan </a>
  12. </div>
  13. </div>

Demo langsung

Alihkan modal melalui JavaScript dengan mengklik tombol di bawah ini. Ini akan meluncur ke bawah dan memudar dari bagian atas halaman.

  1. <!-- Tombol untuk memicu modal -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Luncurkan modal demo </a>
  3.  
  4. <!-- Modal -->
  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" > Modal header </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> Satu tubuh yang bagus… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Tutup </button>
  15. <button class = "btn btn-primary" > Simpan perubahan </button>
  16. </div>
  17. </div>

Penggunaan

Melalui atribut data

Aktifkan modal tanpa menulis JavaScript. Setel data-toggle="modal"pada elemen pengontrol, seperti tombol, bersama dengan a data-target="#foo"atau href="#foo"untuk menargetkan modal tertentu untuk beralih.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > Luncurkan modal </button>

Melalui JavaScript

Panggil modal dengan id myModaldengan satu baris JavaScript:

  1. $ ( '#Modalku' ). modal ( opsi )

Pilihan

Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-, seperti pada data-backdrop="".

Nama Tipe bawaan keterangan
latar belakang boolean BENAR Termasuk elemen modal-backdrop. Atau, tentukan staticuntuk tampilan latar yang tidak menutup modal saat diklik.
papan ketik boolean BENAR Menutup modal saat tombol escape ditekan
menunjukkan boolean BENAR Menampilkan modal saat diinisialisasi.
terpencil jalur Salah

Jika url jarak jauh disediakan, konten akan dimuat melalui loadmetode jQuery dan disuntikkan ke file .modal-body. Jika Anda menggunakan api data, Anda dapat menggunakan hreftag sebagai alternatif untuk menentukan sumber jarak jauh. Contoh dari ini ditunjukkan di bawah ini:

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

Metode

.modal(opsi)

Mengaktifkan konten Anda sebagai modal. Menerima opsi opsional object.

  1. $ ( '#Modalku' ). modal ({
  2. keyboard : salah
  3. })

.modal('beralih')

Mengalihkan modal secara manual.

  1. $ ( '#Modalku' ). modal ( 'beralih' )

.modal('tampilkan')

Secara manual membuka modal.

  1. $ ( '#Modalku' ). modal ( 'tampilkan' )

.modal('sembunyikan')

Secara manual menyembunyikan modal.

  1. $ ( '#Modalku' ). modal ( 'sembunyikan' )

Acara

Kelas modal Bootstrap memperlihatkan beberapa peristiwa untuk menghubungkan ke fungsionalitas modal.

Peristiwa Keterangan
menunjukkan Acara ini langsung aktif ketika showmetode instance dipanggil.
ditampilkan Acara ini dipicu ketika modal telah dibuat terlihat oleh pengguna (akan menunggu transisi css selesai).
bersembunyi Acara ini dipecat segera ketika hidemetode instance telah dipanggil.
tersembunyi Acara ini dipicu ketika modal telah selesai disembunyikan dari pengguna (akan menunggu transisi css selesai).
  1. $ ( '#Modalku' ). pada ( 'tersembunyi' , fungsi () {
  2. // lakukan sesuatu…
  3. })

Contoh di navbar

Plugin ScrollSpy adalah untuk memperbarui target navigasi secara otomatis berdasarkan posisi gulir. Gulir area di bawah bilah navigasi dan perhatikan perubahan kelas yang aktif. Sub item dropdown akan disorot juga.

@gemuk

Legging iklan keytar, brunch id art party dolor labore. Pitchfork thn enim lo-fi sebelum mereka terjual habis qui. Hak sepeda pertanian-ke-meja Tumblr apa pun. Kardigan anim keffiyeh carles. velit seitan mcsweeney's photo booth 3 wolf moon irure. Sweater cosby celana pendek lomo jean, hoodie williamsburg minim qui Anda mungkin belum pernah mendengarnya dan cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

@mdo

Veniam marfa kumis skateboard, adipisicing fugiat velit jenggot garpu rumput. Freegan jenggot aliqua cupidatat mcsweeney's vero. Cupidatat empat loko nisi, ea helvetica nulla carles. Truk makanan sweter cosby bertato, vinil quis non freegan mcsweeney. Lo-fi wes anderson +1 busana. Carles latihan non estetika quis gentrify. Brooklyn adipisicing kerajinan bir wakil keytar deserunt.

satu

Occaecat commodo aliqua delectus. Fap kerajinan bir deserunt skateboard ea. Hak sepeda lomo adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Conectetur nisi DIY mini messenger bag. Cred ex in, berkelanjutan delectus conectetur fanny pack iphone.

dua

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 any delectus food truck. Sapiente synth id asumsinda. Locavore sed helvetica klise ironi, thundercats Anda mungkin belum pernah mendengar tentang mereka akibatnya hoodie bebas gluten lo-fi fap aliquip. Labore elit placeat sebelum sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan velit readymade. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.


Penggunaan

Melalui atribut data

Untuk dengan mudah menambahkan perilaku scrollspy ke navigasi bilah atas Anda, cukup tambahkan data-spy="scroll"ke elemen yang ingin Anda mata-matai (biasanya ini adalah badan) dan data-target=".navbar"untuk memilih navigasi mana yang akan digunakan. Anda ingin menggunakan scrollspy dengan sebuah .navkomponen.

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

Melalui JavaScript

Panggil scrollspy melalui JavaScript:

  1. $ ( '#bar' ). mata -mata ()
Perhatian! Tautan Navbar harus memiliki target id yang dapat diselesaikan. Misalnya, a <a href="#home">home</a>harus sesuai dengan sesuatu di dom seperti <div id="home"></div>.

Metode

.scrollspy('segarkan')

Saat menggunakan scrollspy bersamaan dengan menambahkan atau menghapus elemen dari DOM, Anda harus memanggil metode penyegaran seperti:

  1. $ ( '[data-spy="gulir"]' ). masing-masing ( fungsi () {
  2. var $spy = $ ( ini ). scrollspy ( 'segarkan' )
  3. });

Pilihan

Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-, seperti pada data-offset="".

Nama Tipe bawaan keterangan
mengimbangi nomor 10 Piksel untuk mengimbangi dari atas saat menghitung posisi gulir.

Acara

Peristiwa Keterangan
mengaktifkan Acara ini diaktifkan setiap kali item baru diaktifkan oleh scrollspy.

Contoh tab

Tambahkan fungsionalitas tab yang cepat dan dinamis untuk transisi melalui panel konten lokal, bahkan melalui menu tarik-turun.

Raw denim Anda mungkin belum pernah mendengar tentang celana pendek jean Austin. Nesciunt tofu stumptown aliqua, pembersih master synth retro. Kumis klise tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Sweater Cosby eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan pakaian amerika, butcher 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.


Penggunaan

Aktifkan tab yang dapat ditabulasi melalui JavaScript (setiap tab harus diaktifkan satu per satu):

  1. $ ( '#myTab a' ). klik ( fungsi ( e ) {
  2. e . preventDefault ();
  3. $ ( ini ). tab ( 'tampilkan' );
  4. })

Anda dapat mengaktifkan tab individual dengan beberapa cara:

  1. $ ( '#myTab a[href="#profile"]' ). tab ( 'tampilkan' ); // Pilih tab berdasarkan nama
  2. $ ( '#myTab a:first' ). tab ( 'tampilkan' ); // Pilih tab pertama
  3. $ ( '#myTab a:last' ). tab ( 'tampilkan' ); // Pilih tab terakhir
  4. $ ( '#myTab li:eq(2) a' ). tab ( 'tampilkan' ); // Pilih tab ketiga (0-diindeks)

Markup

Anda dapat mengaktifkan navigasi tab atau pil tanpa menulis JavaScript apa pun hanya dengan menentukan data-toggle="tab"atau data-toggle="pill"pada suatu elemen. Menambahkan navdan nav-tabskelas ke tab ulakan menerapkan gaya tab Bootstrap.

  1. <ul class = "nav nav-tab" >
  2. <li><a href = "#home" data-toggle = "tab" > Beranda </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > Profil </a></li>
  4. <li><a href = "#messages" data-toggle = "tab" > Pesan </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > Setelan </a></li>
  6. </ul>

Metode

$().tab

Mengaktifkan elemen tab dan wadah konten. Tab harus memiliki a data-targetatau hrefpenargetan simpul penampung di DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "aktif" ><a href = "#home" > Beranda </a></li>
  3. <li><a href = "#profile"> Profil </a> </li>
  4. <li><a href = "#messages"> Pesan </a> </li>
  5. <li><a href = "#settings"> Setelan </a> </li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <div class = "tab-pane aktif" 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. <skrip>
  16. $ ( fungsi () {
  17. $ ( '#myTab a:last' ). tab ( 'tampilkan' );
  18. })
  19. </skrip>

Acara

Peristiwa Keterangan
menunjukkan Acara ini diaktifkan pada tampilan tab, tetapi sebelum tab baru ditampilkan. Gunakan event.targetdan event.relatedTargetuntuk menargetkan tab aktif dan tab aktif sebelumnya (jika tersedia).
ditampilkan Acara ini diaktifkan pada tampilan tab setelah tab ditampilkan. Gunakan event.targetdan event.relatedTargetuntuk menargetkan tab aktif dan tab aktif sebelumnya (jika tersedia).
  1. $ ( 'a[data-toggle="tab"]' ). pada ( 'ditampilkan' , fungsi ( e ) {
  2. e . target // tab yang diaktifkan
  3. e . target terkait // tab sebelumnya
  4. })

Contoh

Terinspirasi oleh plugin jQuery.tipsy yang luar biasa yang ditulis oleh Jason Frame; Tooltips adalah versi terbaru, yang tidak bergantung pada gambar, menggunakan CSS3 untuk animasi, dan atribut data untuk penyimpanan judul lokal.

Untuk alasan kinerja, tooltip dan popover data-apis disertakan, artinya Anda harus menginisialisasinya sendiri .

Arahkan kursor ke tautan di bawah untuk melihat tooltips:

Celana ketat keffiyeh tingkat berikutnya Anda mungkin belum pernah mendengarnya. Booth foto janggut raw denim letterpress tas kurir vegan stumptown. Seitan pertanian-ke-meja, pakaian amerika quinoa 8-bit mcsweeney's fixie berkelanjutan memiliki chambray vinil terry richardson. Beard stumptown, cardigans banh mi lomo thundercats. Tahu biodiesel williamsburg marfa, empat loko mcsweeney membersihkan chambray vegan. Seorang seniman yang benar-benar ironis keytar apa pun , scenester farm-to-table banky Austin twitter menangani freegan cred raw denim single-origin coffee viral.

Empat arah

Tooltips di grup input

Saat menggunakan tooltips dan popover dengan grup input Bootstrap, Anda harus mengatur opsi container(didokumentasikan di bawah) untuk menghindari efek samping yang tidak diinginkan.


Penggunaan

Picu tooltip melalui JavaScript:

  1. $ ( '#contoh' ). tooltip ( pilihan )

Pilihan

Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-, seperti pada data-animation="".

Nama Tipe bawaan keterangan
animasi boolean BENAR terapkan transisi fade css ke tooltip
html boolean Salah Masukkan html ke dalam tooltip. Jika salah, metode jquery textakan digunakan untuk memasukkan konten ke dalam dom. Gunakan teks jika Anda khawatir tentang serangan XSS.
penempatan string | fungsi 'atas' bagaimana memposisikan tooltip - atas | bawah | kiri | Baik
pemilih rangkaian Salah Jika pemilih disediakan, objek tooltip akan didelegasikan ke target yang ditentukan.
judul string | fungsi '' nilai judul default jika tag `title` tidak ada
pemicu rangkaian 'arahkan fokus' bagaimana tooltip dipicu - klik | melayang | fokus | manual. Perhatikan bahwa Anda melewati pemicu mutliple, dipisahkan oleh ruang, tipe pemicu.
menunda nomor | obyek 0

tunda menampilkan dan menyembunyikan tooltip (ms) - tidak berlaku untuk tipe pemicu manual

Jika nomor diberikan, penundaan diterapkan ke sembunyikan/tampilkan

Struktur objek adalah:delay: { show: 500, hide: 100 }

wadah string | Salah Salah

Menambahkan tooltip ke elemen tertentucontainer: 'body'

Perhatian! Pilihan untuk tooltips individu alternatif dapat ditentukan melalui penggunaan atribut data.

Markup

  1. <a href = "#" data-toggle = "tooltip" title = "first tooltip" > arahkan kursor ke atas saya </a>

Metode

$().tooltip(opsi)

Melampirkan penangan tooltip ke koleksi elemen.

.tooltip('tampilkan')

Mengungkapkan tooltip elemen.

  1. $ ( '#elemen' ). keterangan alat ( 'tampilkan' )

.tooltip('sembunyikan')

Menyembunyikan tooltip elemen.

  1. $ ( '#elemen' ). keterangan alat ( 'sembunyikan' )

.tooltip('beralih')

Mengalihkan tooltip elemen.

  1. $ ( '#elemen' ). tooltip ( 'beralih' )

.tooltip('hancurkan')

Menyembunyikan dan menghancurkan tooltip elemen.

  1. $ ( '#elemen' ). tooltip ( 'hancurkan' )

Contoh

Tambahkan lapisan konten kecil, seperti yang ada di iPad, ke elemen apa pun untuk menampung informasi sekunder. Arahkan kursor ke tombol untuk memicu popover. Membutuhkan Tooltip untuk disertakan.

Popover statis

Tersedia empat opsi: rata atas, kanan, bawah, dan kiri.

Atasan popover

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

Popover kanan

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

Popover bawah

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

Popover kiri

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

Tidak ada markup yang ditampilkan sebagai popover yang dihasilkan dari JavaScript dan konten dalam dataatribut.

Demo langsung

Empat arah


Penggunaan

Aktifkan popover melalui JavaScript:

  1. $ ( '#contoh' ). popover ( opsi )

Pilihan

Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-, seperti pada data-animation="".

Nama Tipe bawaan keterangan
animasi boolean BENAR terapkan transisi fade css ke tooltip
html boolean Salah Masukkan html ke popover. Jika salah, metode jquery textakan digunakan untuk memasukkan konten ke dalam dom. Gunakan teks jika Anda khawatir tentang serangan XSS.
penempatan string | fungsi 'Baik' bagaimana memposisikan popover - atas | bawah | kiri | Baik
pemilih rangkaian Salah jika pemilih disediakan, objek tooltip akan didelegasikan ke target yang ditentukan
pemicu rangkaian 'klik' bagaimana popover dipicu - klik | melayang | fokus | panduan
judul string | fungsi '' nilai judul default jika atribut `title` tidak ada
isi string | fungsi '' nilai konten default jika atribut `data-content` tidak ada
menunda nomor | obyek 0

tunda menampilkan dan menyembunyikan popover (ms) - tidak berlaku untuk tipe pemicu manual

Jika nomor diberikan, penundaan diterapkan ke sembunyikan/tampilkan

Struktur objek adalah:delay: { show: 500, hide: 100 }

wadah string | Salah Salah

Menambahkan popover ke elemen tertentucontainer: 'body'

Perhatian! Opsi untuk popover individual dapat ditentukan secara alternatif melalui penggunaan atribut data.

Markup

Untuk alasan kinerja, Tooltip dan Popover data-apis diikutsertakan. Jika Anda ingin menggunakannya cukup tentukan opsi pemilih.

Metode

$().popover(opsi)

Menginisialisasi popover untuk koleksi elemen.

.popover('tampilkan')

Mengungkapkan popover elemen.

  1. $ ( '#elemen' ). popover ( 'tampilkan' )

.popover('sembunyikan')

Menyembunyikan popover elemen.

  1. $ ( '#elemen' ). popover ( 'sembunyikan' )

.popover('beralih')

Mengalihkan popover elemen.

  1. $ ( '#elemen' ). popover ( 'beralih' )

.popover('hancurkan')

Menyembunyikan dan menghancurkan popover elemen.

  1. $ ( '#elemen' ). popover ( 'hancurkan' )

Contoh peringatan

Tambahkan fungsionalitas abaikan ke semua pesan peringatan dengan plugin ini.

Guacamole suci! Sebaiknya periksa diri Anda sendiri, Anda tidak terlihat terlalu baik.

Oh jepret! Anda mendapat kesalahan!

Ubah ini dan itu dan coba lagi. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Ambil tindakan ini Atau lakukan ini


Penggunaan

Aktifkan penghentian lansiran melalui JavaScript:

  1. $ ( ".peringatan" ). waspada ()

Markup

Cukup tambahkan data-dismiss="alert"ke tombol tutup Anda untuk secara otomatis memberikan fungsi tutup peringatan.

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

Metode

$().peringatan()

Membungkus semua peringatan dengan fungsionalitas yang dekat. Agar lansiran Anda bernyawa saat ditutup, pastikan lansiran .fadedan .inkelas sudah diterapkan padanya.

.alert('tutup')

Menutup peringatan.

  1. $ ( ".peringatan" ). waspada ( 'tutup' )

Acara

Kelas peringatan Bootstrap memperlihatkan beberapa peristiwa untuk menghubungkan ke fungsi peringatan.

Peristiwa Keterangan
menutup Acara ini langsung aktif ketika closemetode instance dipanggil.
tertutup Acara ini dipicu ketika peringatan telah ditutup (akan menunggu transisi css selesai).
  1. $ ( '#peringatan-saya' ). mengikat ( 'tertutup' , fungsi () {
  2. // lakukan sesuatu…
  3. })

Contoh penggunaan

Lakukan lebih banyak dengan tombol. Kontrol status tombol atau buat grup tombol untuk lebih banyak komponen seperti bilah alat.

Stateful

Tambahkan data-loading-text="Loading..."untuk menggunakan status pemuatan pada tombol.

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

Beralih tunggal

Tambahkan data-toggle="button"untuk mengaktifkan toggling pada satu tombol.

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

Kotak centang

Tambahkan data-toggle="buttons-checkbox"untuk beralih gaya kotak centang pada btn-group.

  1. <div class = "btn-group" data-toggle = "tombol-kotak centang" >
  2. <button type = "button" class = "btn btn-primary" > Kiri </button>
  3. <button type = "button" class = "btn btn-primary" > Tengah </button>
  4. <button type = "button" class = "btn btn-primary" > Kanan </button>
  5. </div>

Radio

Tambahkan data-toggle="buttons-radio"untuk beralih gaya radio di btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" > Kiri </button>
  3. <button type = "button" class = "btn btn-primary" > Tengah </button>
  4. <button type = "button" class = "btn btn-primary" > Kanan </button>
  5. </div>

Penggunaan

Aktifkan tombol melalui JavaScript:

  1. $ ( '.nav-tab' ). tombol ()

Markup

Atribut data merupakan bagian integral dari plugin tombol. Lihat contoh kode di bawah ini untuk berbagai jenis markup.

Pilihan

Tidak ada

Metode

$().button('beralih')

Mengalihkan status push. Memberikan tampilan tombol yang telah diaktifkan.

Perhatian! Anda dapat mengaktifkan tombol beralih otomatis dengan menggunakan data-toggleatribut.
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

$().button('memuat')

Mengatur status tombol untuk memuat - menonaktifkan tombol dan menukar teks untuk memuat teks. Memuat teks harus ditentukan pada elemen tombol menggunakan atribut data data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "memuat barang..." > ... </button>
Perhatian! Firefox mempertahankan status dinonaktifkan di seluruh pemuatan halaman . Solusi untuk ini adalah dengan menggunakan autocomplete="off".

$().button('setel ulang')

Mengatur ulang status tombol - menukar teks ke teks asli.

$().button(string)

Mereset status tombol - menukar teks ke status teks yang ditentukan data.

  1. < jenis tombol = "tombol" class = "btn" data-complete-text = "selesai!" > ... </tombol>
  2. <skrip>
  3. $ ( '.btn' ). tombol ( 'selesai' )
  4. </skrip>

Tentang

Dapatkan gaya dasar dan dukungan fleksibel untuk komponen yang dapat dilipat seperti akordeon dan navigasi.

* Membutuhkan plugin Transitions untuk disertakan.

Contoh akordeon

Menggunakan plugin collapse, kami membuat widget gaya akordeon sederhana:

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Truk makanan quinoa nesciunt laborum eiusmod. Brunch 3 serigala bulan tempor, sunt aliqua menaruh burung di atasnya cumi-cumi kopi single-origin nulla asumsinda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Iklan vegan kecuali tukang daging wakil lomo. Legging occaecat craft beer farm-to-table, raw denim estetik synth nesciunt Anda mungkin belum pernah mendengarnya accusamus labore VHS berkelanjutan.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Truk makanan quinoa nesciunt laborum eiusmod. Brunch 3 serigala bulan tempor, sunt aliqua menaruh burung di atasnya cumi-cumi kopi single-origin nulla asumsinda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Iklan vegan kecuali tukang daging wakil lomo. Legging occaecat craft beer farm-to-table, raw denim estetik synth nesciunt Anda mungkin belum pernah mendengarnya accusamus labore VHS berkelanjutan.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Truk makanan quinoa nesciunt laborum eiusmod. Brunch 3 serigala bulan tempor, sunt aliqua menaruh burung di atasnya cumi-cumi kopi single-origin nulla asumsinda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Iklan vegan kecuali tukang daging wakil lomo. Legging occaecat craft beer farm-to-table, raw denim estetik synth nesciunt Anda mungkin belum pernah mendengarnya accusamus labore VHS berkelanjutan.
  1. <div class = "akordeon" id = "akordeon2" >
  2. <div class = "grup akordeon" >
  3. <div class = "tajuk akordeon" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. Item Grup yang Dapat Dilipat #1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "tubuh akordeon runtuh" ​​>
  9. <div class = "akordeon-dalam" >
  10. Anim pariatur klise...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "grup akordeon" >
  15. <div class = "tajuk akordeon" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Item Grup yang Dapat Dilipat #2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "accordion-body collapse" >
  21. <div class = "akordeon-dalam" >
  22. Anim pariatur klise...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

Anda juga dapat menggunakan plugin tanpa markup akordeon. Buat tombol untuk mengaktifkan perluasan dan penciutan elemen lain.

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. sederhana yang bisa dilipat
  3. </tombol>
  4.  
  5. <div id = "demo" class = "collapse in" > </div>

Penggunaan

Melalui atribut data

Cukup tambahkan data-toggle="collapse"dan a data-targetke elemen untuk secara otomatis menetapkan kontrol elemen yang dapat dilipat. Atribut data-targetmenerima pemilih css untuk menerapkan penciutan. Pastikan untuk menambahkan kelas collapseke elemen yang dapat diciutkan. Jika Anda ingin default terbuka, tambahkan kelas tambahan in.

Untuk menambahkan manajemen grup seperti akordeon ke kontrol yang dapat diciutkan, tambahkan atribut data data-parent="#selector". Lihat demo untuk melihat ini beraksi.

Melalui JavaScript

Aktifkan secara manual dengan:

  1. $ ( ".runtuh" ​​). runtuh ()

Pilihan

Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-, seperti pada data-parent="".

Nama Tipe bawaan keterangan
induk pemilih Salah Jika pemilih maka semua elemen yang dapat dilipat di bawah induk yang ditentukan akan ditutup ketika item yang dapat dilipat ini ditampilkan. (mirip dengan perilaku akordeon tradisional)
beralih boolean BENAR Mengaktifkan elemen yang dapat diciutkan pada doa

Metode

.collapse(opsi)

Mengaktifkan konten Anda sebagai elemen yang dapat diciutkan. Menerima opsi opsional object.

  1. $ ( '#myCollapsible' ). runtuh ({
  2. beralih : salah
  3. })

.collapse('beralih')

Mengalihkan elemen yang dapat diciutkan ke ditampilkan atau disembunyikan.

.collapse('tampilkan')

Menampilkan elemen yang dapat dilipat.

.collapse('sembunyikan')

Menyembunyikan elemen yang dapat dilipat.

Acara

Kelas keruntuhan Bootstrap memperlihatkan beberapa peristiwa untuk menghubungkan ke fungsionalitas keruntuhan.

Peristiwa Keterangan
menunjukkan Acara ini langsung aktif ketika showmetode instance dipanggil.
ditampilkan Peristiwa ini dipicu ketika elemen penciutan telah dibuat terlihat oleh pengguna (akan menunggu transisi css selesai).
bersembunyi Acara ini dipecat segera ketika hidemetode telah dipanggil.
tersembunyi Peristiwa ini dipicu ketika elemen runtuh telah disembunyikan dari pengguna (akan menunggu transisi css selesai).
  1. $ ( '#myCollapsible' ). pada ( 'tersembunyi' , fungsi () {
  2. // lakukan sesuatu…
  3. })

Contoh

Plugin dasar yang mudah diperluas untuk membuat tipografi elegan dengan cepat dengan input teks formulir apa pun.

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

Anda ingin mengatur autocomplete="off"untuk mencegah menu browser default muncul di dropdown Bootstrap typeahead.


Penggunaan

Melalui atribut data

Tambahkan atribut data untuk mendaftarkan elemen dengan fungsionalitas typeahead seperti yang ditunjukkan pada contoh di atas.

Melalui JavaScript

Panggil typeahead secara manual dengan:

  1. $ ( '.typeahead' ). jenis huruf ()

Pilihan

Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-, seperti pada data-source="".

Nama Tipe bawaan keterangan
sumber susunan, fungsi [ ] Sumber data untuk kueri. Mungkin array string atau fungsi. Fungsi dilewatkan dua argumen, querynilai di bidang input dan processpanggilan balik. Fungsi tersebut dapat digunakan secara sinkron dengan mengembalikan sumber data secara langsung atau secara asinkron melalui processargumen tunggal callback.
item nomor 8 Jumlah maksimum item yang akan ditampilkan di dropdown.
minPanjang nomor 1 Panjang karakter minimum yang diperlukan sebelum memicu saran pelengkapan otomatis
korek api fungsi peka huruf besar/kecil Metode yang digunakan untuk menentukan apakah kueri cocok dengan item. Menerima satu argumen, itemyang digunakan untuk menguji kueri. Akses kueri saat ini dengan this.query. Kembalikan boolean truejika kueri cocok.
tukang sortir fungsi pencocokan tepat,
peka huruf besar/kecil,
tidak peka huruf besar -kecil
Metode yang digunakan untuk mengurutkan hasil pelengkapan otomatis. Menerima satu argumen itemsdan memiliki cakupan instance typeahead. Referensi kueri saat ini dengan this.query.
pembaru fungsi mengembalikan item yang dipilih Metode yang digunakan untuk mengembalikan item yang dipilih. Menerima argumen tunggal, itemdan memiliki cakupan instance typeahead.
stabilo fungsi menyoroti semua pertandingan default Metode yang digunakan untuk menyorot hasil pelengkapan otomatis. Menerima satu argumen itemdan memiliki cakupan instance typeahead. Harus mengembalikan html.

Metode

.typeahead(opsi)

Menginisialisasi input dengan typeahead.

Contoh

Subnavigasi di sebelah kiri adalah demo langsung dari plugin affix.


Penggunaan

Melalui atribut data

Untuk menambahkan perilaku afiks dengan mudah ke elemen apa pun, cukup tambahkan data-spy="affix"ke elemen yang ingin Anda intai. Kemudian gunakan offset untuk menentukan kapan harus mengaktifkan dan menonaktifkan penyematan elemen.

  1. <div data-spy = "imbuhan" data-offset-top = "200" > ... </div>
Perhatian! Anda harus mengelola posisi elemen yang disematkan dan perilaku induk langsungnya. Posisi dikendalikan oleh affix, affix-top, dan affix-bottom . Ingatlah untuk memeriksa induk yang berpotensi diciutkan saat afiks muncul karena menghapus konten dari aliran normal halaman.

Melalui JavaScript

Panggil plugin affix melalui JavaScript:

  1. $ ( '#bar' ). afiks ()

Pilihan

Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-, seperti pada data-offset-top="200".

Nama Tipe bawaan keterangan
mengimbangi nomor | fungsi | obyek 10 Piksel untuk diimbangi dari layar saat menghitung posisi gulir. Jika satu nomor diberikan, offset akan diterapkan di kedua arah atas dan kiri. Untuk mendengarkan satu arah, atau beberapa offset unik, cukup sediakan sebuah objek offset: { x: 10 }. Gunakan fungsi saat Anda perlu memberikan offset secara dinamis (berguna untuk beberapa desain responsif).