Korsel
Komponen tayangan slide untuk menelusuri elemen—gambar atau slide teks—seperti korsel.
Bagaimana itu bekerja
Korsel adalah tayangan slide untuk bersepeda melalui serangkaian konten, dibuat dengan transformasi 3D CSS dan sedikit JavaScript. Ia bekerja dengan serangkaian gambar, teks, atau markup kustom. Ini juga mencakup dukungan untuk kontrol dan indikator sebelumnya/berikutnya.
Di browser yang mendukung API Visibilitas Halaman , carousel akan menghindari geser saat halaman web tidak terlihat oleh pengguna (seperti saat tab browser tidak aktif, jendela browser diminimalkan, dll.).
prefers-reduced-motion
kueri media. Lihat bagian
pengurangan gerakan pada dokumentasi aksesibilitas kami .
Perlu diketahui bahwa carousel bersarang tidak didukung, dan carousel umumnya tidak sesuai dengan standar aksesibilitas.
Terakhir, jika Anda membuat JavaScript kami dari sumber, itu memerlukanutil.js
.
Contoh
Korsel tidak secara otomatis menormalkan dimensi slide. Dengan demikian, Anda mungkin perlu menggunakan utilitas tambahan atau gaya kustom untuk menyesuaikan ukuran konten. Meskipun carousel mendukung kontrol dan indikator sebelumnya/berikutnya, mereka tidak secara eksplisit diperlukan. Tambahkan dan sesuaikan sesuai keinginan Anda.
Kelas .active
perlu ditambahkan ke salah satu slide jika tidak, korsel tidak akan terlihat. Pastikan juga untuk mengatur unik id
pada .carousel
untuk kontrol opsional, terutama jika Anda menggunakan beberapa carousel pada satu halaman. Elemen kontrol dan indikator harus memiliki data-target
atribut (atau href
untuk tautan) yang cocok id
dengan .carousel
elemen tersebut.
Hanya slide
Berikut adalah korsel dengan slide saja. Perhatikan keberadaan .d-block
dan .w-100
pada gambar carousel untuk mencegah perataan gambar default browser.
<div id="carouselExampleSlidesOnly" class="carousel slide" data-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
</div>
</div>
Dengan kontrol
Menambahkan kontrol sebelumnya dan berikutnya. Sebaiknya gunakan <button>
elemen, tetapi Anda juga dapat menggunakan <a>
elemen dengan role="button"
.
<div id="carouselExampleControls" class="carousel slide" data-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
</div>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleControls" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleControls" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Dengan indikator
Anda juga dapat menambahkan indikator ke carousel, di samping kontrol juga.
<div id="carouselExampleIndicators" class="carousel slide" data-ride="carousel">
<ol class="carousel-indicators">
<li data-target="#carouselExampleIndicators" data-slide-to="0" class="active"></li>
<li data-target="#carouselExampleIndicators" data-slide-to="1"></li>
<li data-target="#carouselExampleIndicators" data-slide-to="2"></li>
</ol>
<div class="carousel-inner">
<div class="carousel-item active">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
</div>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleIndicators" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleIndicators" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Dengan keterangan
Tambahkan teks ke slide Anda dengan mudah dengan .carousel-caption
elemen di dalam file .carousel-item
. Mereka dapat dengan mudah disembunyikan di area pandang yang lebih kecil, seperti yang ditunjukkan di bawah ini, dengan utilitas tampilan opsional . Kami menyembunyikannya pada awalnya dengan .d-none
dan mengembalikannya ke perangkat berukuran sedang dengan .d-md-block
.
<div id="carouselExampleCaptions" class="carousel slide" data-ride="carousel">
<ol class="carousel-indicators">
<li data-target="#carouselExampleCaptions" data-slide-to="0" class="active"></li>
<li data-target="#carouselExampleCaptions" data-slide-to="1"></li>
<li data-target="#carouselExampleCaptions" data-slide-to="2"></li>
</ol>
<div class="carousel-inner">
<div class="carousel-item active">
<img src="..." class="d-block w-100" alt="...">
<div class="carousel-caption d-none d-md-block">
<h5>First slide label</h5>
<p>Some representative placeholder content for the first slide.</p>
</div>
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
<div class="carousel-caption d-none d-md-block">
<h5>Second slide label</h5>
<p>Some representative placeholder content for the second slide.</p>
</div>
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
<div class="carousel-caption d-none d-md-block">
<h5>Third slide label</h5>
<p>Some representative placeholder content for the third slide.</p>
</div>
</div>
</div>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleCaptions" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleCaptions" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Crossfade
Tambahkan .carousel-fade
ke carousel Anda untuk menganimasikan slide dengan transisi fade, bukan slide. Bergantung pada konten carousel Anda (misalnya, slide hanya teks), Anda mungkin ingin menambahkan .bg-body
atau beberapa CSS khusus ke .carousel-item
s untuk crossfading yang tepat.
<div id="carouselExampleFade" class="carousel slide carousel-fade" data-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
</div>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleFade" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleFade" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
.carousel-item
Interval individu
Tambahkan data-interval=""
ke a .carousel-item
untuk mengubah jumlah waktu tunda antara siklus otomatis ke item berikutnya.
<div id="carouselExampleInterval" class="carousel slide" data-ride="carousel">
<div class="carousel-inner">
<div class="carousel-item active" data-interval="10000">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item" data-interval="2000">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
</div>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleInterval" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleInterval" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Nonaktifkan sentuhan menggesek
Carousel mendukung penggesekan ke kiri/kanan pada perangkat layar sentuh untuk berpindah antar slide. Ini dapat dinonaktifkan menggunakan data-touch
atribut. Contoh di bawah ini juga tidak menyertakan data-ride
atribut dan memiliki data-interval="false"
sehingga tidak diputar otomatis.
<div id="carouselExampleControlsNoTouching" class="carousel slide" data-touch="false" data-interval="false">
<div class="carousel-inner">
<div class="carousel-item active">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
<div class="carousel-item">
<img src="..." class="d-block w-100" alt="...">
</div>
</div>
<button class="carousel-control-prev" type="button" data-target="#carouselExampleControlsNoTouching" data-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</button>
<button class="carousel-control-next" type="button" data-target="#carouselExampleControlsNoTouching" data-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</button>
</div>
Penggunaan
Melalui atribut data
Gunakan atribut data untuk mengontrol posisi carousel dengan mudah. data-slide
menerima kata kunci prev
atau next
, yang mengubah posisi slide relatif terhadap posisinya saat ini. Atau, gunakan data-slide-to
untuk meneruskan indeks slide mentah ke carousel data-slide-to="2"
, yang menggeser posisi slide ke indeks tertentu yang diawali dengan 0
.
Atribut data-ride="carousel"
ini digunakan untuk menandai carousel sebagai animasi mulai dari pemuatan halaman. Jika Anda tidak menggunakan data-ride="carousel"
untuk menginisialisasi carousel Anda, Anda harus menginisialisasi sendiri. Itu tidak dapat digunakan dalam kombinasi dengan inisialisasi JavaScript eksplisit (berlebihan dan tidak perlu) dari korsel yang sama.
Melalui JavaScript
Panggil carousel secara manual dengan:
$('.carousel').carousel()
Pilihan
Opsi dapat diteruskan melalui atribut data atau JavaScript. Untuk atribut data, tambahkan nama opsi ke data-
, seperti pada data-interval=""
.
Nama | Jenis | Bawaan | Keterangan |
---|---|---|---|
selang | nomor | 5000 | Jumlah waktu tunda antara bersepeda item secara otomatis. Jika false , carousel tidak akan berputar secara otomatis. |
papan ketik | boolean | BENAR | Apakah carousel harus bereaksi terhadap peristiwa keyboard. |
berhenti sebentar | string | boolean | 'melayang' | Jika diatur ke Pada perangkat yang mendukung sentuhan, saat disetel ke |
mengendarai | rangkaian | Salah | Memutar korsel secara otomatis setelah pengguna memutar item pertama secara manual. Jika disetel ke 'carousel' , memutar korsel secara otomatis saat dimuat. |
membungkus | boolean | BENAR | Apakah korsel harus berputar terus menerus atau berhenti keras. |
menyentuh | boolean | BENAR | Apakah carousel harus mendukung interaksi geser ke kiri/kanan pada perangkat layar sentuh. |
Metode
Metode dan transisi asinkron
Semua metode API tidak sinkron dan memulai transisi . Mereka kembali ke penelepon segera setelah transisi dimulai tetapi sebelum berakhir . Selain itu, pemanggilan metode pada komponen transisi akan diabaikan .
Lihat dokumentasi JavaScript kami untuk informasi lebih lanjut .
.carousel(options)
Menginisialisasi korsel dengan opsi opsional object
dan mulai menelusuri item.
$('.carousel').carousel({
interval: 2000
})
.carousel('cycle')
Siklus melalui item korsel dari kiri ke kanan.
.carousel('pause')
Menghentikan korsel dari bersepeda melalui item.
.carousel(number)
Menggerakkan korsel ke bingkai tertentu (berbasis 0, mirip dengan larik). Kembali ke pemanggil sebelum item target ditampilkan (yaitu sebelum slid.bs.carousel
peristiwa terjadi).
.carousel('prev')
Siklus ke item sebelumnya. Kembali ke pemanggil sebelum item sebelumnya ditampilkan (yaitu sebelum slid.bs.carousel
peristiwa terjadi).
.carousel('next')
Siklus ke item berikutnya. Kembali ke pemanggil sebelum item berikutnya ditampilkan (yaitu sebelum slid.bs.carousel
peristiwa terjadi).
.carousel('dispose')
Menghancurkan korsel elemen.
.carousel('nextWhenVisible')
Jangan memutar korsel ke berikutnya saat halaman tidak terlihat atau korsel atau induknya tidak terlihat. Kembali ke pemanggil sebelum item berikutnya ditampilkan (yaitu sebelum slid.bs.carousel
peristiwa terjadi).
.carousel('to')
Menggerakkan korsel ke bingkai tertentu (berbasis 0, mirip dengan larik). Kembali ke pemanggil sebelum item berikutnya ditampilkan (yaitu sebelum slid.bs.carousel
peristiwa terjadi).
Acara
Kelas carousel Bootstrap memperlihatkan dua peristiwa untuk menghubungkan ke fungsionalitas carousel. Kedua acara memiliki properti tambahan berikut:
direction
: Arah korsel meluncur (salah satu"left"
atau"right"
).relatedTarget
: Elemen DOM yang sedang digeser ke tempatnya sebagai item aktif.from
: Indeks item saat inito
: Indeks item berikutnya
Semua event carousel dipicu pada carousel itu sendiri (yaitu pada <div class="carousel">
).
Jenis Acara | Keterangan |
---|---|
slide.bs.carousel | Acara ini langsung aktif ketika slide metode instance dipanggil. |
slide.bs.carousel | Peristiwa ini dipicu saat carousel telah menyelesaikan transisi slidenya. |
$('#myCarousel').on('slide.bs.carousel', function () {
// do something...
})
Ubah durasi transisi
Durasi transisi .carousel-item
dapat diubah dengan $carousel-transition
variabel Sass sebelum kompilasi atau gaya kustom jika Anda menggunakan CSS yang dikompilasi. Jika beberapa transisi diterapkan, pastikan transisi transformasi didefinisikan terlebih dahulu (mis. transition: transform 2s ease, opacity .5s ease-out
).