Berhijrah ke v5
Jejak dan semak perubahan pada fail sumber Bootstrap, dokumentasi dan komponen untuk membantu anda berhijrah dari v4 ke v5.
v5.2.0
Reka bentuk yang diperbaharui
Bootstrap v5.2.0 menampilkan kemas kini reka bentuk yang halus untuk segelintir komponen dan sifat merentas projek, terutamanya melalui border-radius
nilai yang diperhalusi pada butang dan kawalan borang . Dokumentasi kami juga telah dikemas kini dengan halaman utama baharu, reka letak dokumen yang lebih ringkas yang tidak lagi meruntuhkan bahagian bar sisi dan contoh Ikon Bootstrap yang lebih menonjol .
Lebih banyak pembolehubah CSS
Kami telah mengemas kini semua komponen kami untuk menggunakan pembolehubah CSS. Walaupun Sass masih menyokong segala-galanya, setiap komponen telah dikemas kini untuk memasukkan pembolehubah CSS pada kelas asas komponen (cth, .btn
), membenarkan lebih banyak penyesuaian masa nyata bagi Bootstrap. Dalam keluaran seterusnya, kami akan terus mengembangkan penggunaan pembolehubah CSS kami ke dalam reka letak, borang, pembantu dan utiliti kami. Baca lebih lanjut mengenai pembolehubah CSS dalam setiap komponen pada halaman dokumentasi masing-masing.
Penggunaan pembolehubah CSS kami akan menjadi agak tidak lengkap sehingga Bootstrap 6. Walaupun kami ingin melaksanakan sepenuhnya ini secara menyeluruh, mereka menghadapi risiko menyebabkan perubahan yang pecah. Sebagai contoh, tetapan $alert-border-width: var(--bs-border-width)
dalam kod sumber kami memecahkan potensi Sass dalam kod anda sendiri jika anda melakukannya $alert-border-width * 2
atas sebab tertentu.
Oleh itu, di mana mungkin, kami akan terus mendorong ke arah lebih banyak pembolehubah CSS, tetapi sila maklum bahawa pelaksanaan kami mungkin terhad sedikit dalam v5.
Baru_maps.scss
Bootstrap v5.2.0 memperkenalkan fail Sass baharu dengan _maps.scss
. Ia mengeluarkan beberapa peta Sass daripada _variables.scss
untuk menyelesaikan isu di mana kemas kini pada peta asal tidak digunakan pada peta sekunder yang memanjangkannya. Sebagai contoh, kemas kini kepada $theme-colors
tidak digunakan pada peta tema lain yang bergantung pada $theme-colors
, memecahkan aliran kerja penyesuaian utama. Ringkasnya, Sass mempunyai had apabila pembolehubah lalai atau peta telah digunakan , ia tidak boleh dikemas kini. Terdapat kelemahan yang sama dengan pembolehubah CSS apabila ia digunakan untuk mengarang pembolehubah CSS yang lain.
Inilah sebabnya mengapa penyesuaian pembolehubah dalam Bootstrap perlu dilakukan selepas @import "functions"
, tetapi sebelum @import "variables"
dan baki import kami yang lain. Perkara yang sama berlaku untuk peta Sass—anda mesti mengatasi lalai sebelum ia digunakan. Peta berikut telah dipindahkan ke peta baharu _maps.scss
:
$theme-colors-rgb
$utilities-colors
$utilities-text
$utilities-text-colors
$utilities-bg
$utilities-bg-colors
$negative-spacers
$gutters
Binaan CSS Bootstrap tersuai anda kini sepatutnya kelihatan seperti ini dengan import peta yang berasingan.
// Functions come first
@import "functions";
// Optional variable overrides here
+ $custom-color: #df711b;
+ $custom-theme-colors: (
+ "custom": $custom-color
+ );
// Variables come next
@import "variables";
+ // Optional Sass map overrides here
+ $theme-colors: map-merge($theme-colors, $custom-theme-colors);
+
+ // Followed by our default maps
+ @import "maps";
+
// Rest of our imports
@import "mixins";
@import "utilities";
@import "root";
@import "reboot";
// etc
Utiliti baharu
font-weight
Utiliti dikembangkan untuk disertakan.fw-semibold
untuk fon semibold.border-radius
Utiliti dikembangkan untuk memasukkan dua saiz baharu.rounded-4
dan.rounded-5
, untuk lebih banyak pilihan.
Perubahan tambahan
-
Memperkenalkan
$enable-container-classes
pilihan baharu. — Sekarang apabila mengikut serta dalam reka letak Grid CSS eksperimen,.container-*
kelas masih akan disusun, melainkan pilihan ini ditetapkan kepadafalse
. Bekas juga kini mengekalkan nilai longkang mereka. -
Komponen Offcanvas kini mempunyai variasi responsif . Kelas asal
.offcanvas
kekal tidak berubah—ia menyembunyikan kandungan merentas semua port pandangan. Untuk menjadikannya responsif, tukar.offcanvas
kelas itu kepada mana-mana.offcanvas-{sm|md|lg|xl|xxl}
kelas. -
Pembahagi meja yang lebih tebal kini ikut serta. — Kami telah mengalih keluar sempadan yang lebih tebal dan sukar untuk mengatasi antara kumpulan jadual dan mengalihkannya ke kelas pilihan yang boleh anda gunakan,
.table-group-divider
. Lihat dokumen jadual untuk contoh. -
Scrollspy telah ditulis semula untuk menggunakan Intersection Observer API , yang bermaksud anda tidak lagi memerlukan pembalut induk relatif, menafikan
offset
konfigurasi dan banyak lagi. Cari pelaksanaan Scrollspy anda agar lebih tepat dan konsisten dalam penyerlahan nav mereka. -
Popover dan petua alat kini menggunakan pembolehubah CSS. Beberapa pembolehubah CSS telah dikemas kini daripada rakan Sass mereka untuk mengurangkan bilangan pembolehubah. Akibatnya, tiga pembolehubah telah ditamatkan dalam keluaran ini:
$popover-arrow-color
,$popover-arrow-outer-color
, dan$tooltip-arrow-color
. -
Menambah
.text-bg-{color}
pembantu baharu. Daripada menetapkan individu.text-*
dan.bg-*
utiliti, anda kini boleh menggunakan pembantu.text-bg-*
untuk menetapkan denganbackground-color
latar depan yang berbezacolor
. -
Ditambah
.form-check-reverse
pengubah suai untuk membalikkan susunan label dan kotak semak/radio yang berkaitan. -
Menambahkan sokongan lajur berjalur pada jadual melalui
.table-striped-columns
kelas baharu.
Untuk senarai lengkap perubahan, lihat projek v5.2.0 di GitHub .
v5.1.0
-
Menambahkan sokongan percubaan untuk susun atur Grid CSS . — Ini sedang dalam proses dan belum bersedia untuk kegunaan pengeluaran, tetapi anda boleh mengikut serta dalam ciri baharu melalui Sass. Untuk mendayakannya, lumpuhkan grid lalai, dengan menetapkan
$enable-grid-classes: false
dan dayakan Grid CSS dengan menetapkan$enable-cssgrid: true
. -
Navbar dikemas kini untuk menyokong offcanvas. — Tambahkan laci offcanvas dalam mana-mana bar nav dengan kelas responsif
.navbar-expand-*
dan beberapa penanda offcanvas. -
Menambah komponen pemegang tempat baharu . — Komponen terbaharu kami, satu cara untuk menyediakan blok sementara sebagai ganti kandungan sebenar untuk membantu menunjukkan bahawa sesuatu masih dimuatkan dalam tapak atau apl anda.
-
Pemalam Runtuhkan kini menyokong runtuh mendatar . — Tambahkan
.collapse-horizontal
pada anda.collapse
untuk meruntuhkanwidth
bukannyaheight
. Elakkan pengecatan semula pelayar dengan menetapkan amin-height
atauheight
. -
Menambah tindanan baharu dan pembantu peraturan menegak. — Gunakan berbilang sifat flexbox dengan pantas untuk membuat reka letak tersuai dengan cepat dengan tindanan . Pilih daripada tindanan mendatar (
.hstack
) dan menegak ( )..vstack
Tambahkan pembahagi menegak yang serupa dengan<hr>
elemen dengan pembantu baharu.vr
. -
Menambah
:root
pembolehubah CSS global baharu. — Menambah beberapa pembolehubah CSS baharu ke:root
tahap untuk mengawal<body>
gaya. Lebih banyak lagi sedang dalam usaha, termasuk merentas utiliti dan komponen kami, tetapi buat masa ini baca pembolehubah CSS dalam bahagian Sesuaikan . -
Utiliti warna dan latar belakang yang dibaik pulih untuk menggunakan pembolehubah CSS, dan menambah utiliti kelegapan teks dan kelegapan latar belakang baharu . —
.text-*
dan.bg-*
utiliti kini dibina dengan pembolehubah CSS danrgba()
nilai warna, membolehkan anda menyesuaikan sebarang utiliti dengan mudah dengan utiliti kelegapan baharu. -
Menambahkan contoh coretan baharu berdasarkan untuk menunjukkan cara menyesuaikan komponen kami. — Tarik sedia untuk menggunakan komponen tersuai dan corak reka bentuk biasa yang lain dengan contoh Coretan baharu kami . Termasuk pengaki , lungsur turun , senarai kumpulan dan modal .
-
Mengalih keluar gaya kedudukan yang tidak digunakan daripada popover dan petua alatan kerana ini dikendalikan oleh Popper semata-mata.
$tooltip-margin
telah ditamatkan dan ditetapkan kepadanull
dalam proses.
Ingin maklumat lanjut? Baca catatan blog v5.1.0.
Kebergantungan
- jQuery digugurkan.
- Dinaik taraf daripada Popper v1.x kepada Popper v2.x.
- Menggantikan Libsass dengan Dart Sass kerana pengkompil Sass kami yang diberikan Libsass telah ditamatkan.
- Berhijrah dari Jekyll ke Hugo untuk membina dokumentasi kami
Sokongan penyemak imbas
- Menggugurkan Internet Explorer 10 dan 11
- Menggugurkan Microsoft Edge < 16 (Legacy Edge)
- Menggugurkan Firefox < 60
- Safari digugurkan < 12
- Menggugurkan iOS Safari < 12
- Chrome digugurkan < 60
Perubahan dokumentasi
- Laman utama reka bentuk semula, reka letak dokumen dan pengaki.
- Menambahkan panduan Bungkusan baharu .
- Menambah bahagian Peribadikan baharu , menggantikan halaman Tema v4 , dengan butiran baharu tentang Sass, pilihan konfigurasi global, skema warna, pembolehubah CSS dan banyak lagi.
- Menyusun semula semua dokumentasi borang ke bahagian Borang baharu , memecahkan kandungan kepada halaman yang lebih fokus.
- Begitu juga, kemas kini bahagian Reka Letak , untuk menyempurnakan kandungan grid dengan lebih jelas.
- Menamakan semula halaman komponen "Navs" kepada "Navs & Tabs".
- Menamakan semula halaman "Cek" kepada "Cek & radio".
- Mereka bentuk semula bar navigasi dan menambah subnav baharu untuk memudahkan anda meneroka tapak dan versi dokumen kami.
- Menambah pintasan papan kekunci baharu untuk medan carian: Ctrl + /.
Sass
-
Kami telah membuang gabungan peta Sass lalai untuk memudahkan anda mengalih keluar nilai berlebihan. Perlu diingat anda kini perlu menentukan semua nilai dalam peta Sass seperti
$theme-colors
. Semak cara berurusan dengan peta Sass . -
BerbukaMenamakan semula
color-yiq()
fungsi dan pembolehubah berkaitancolor-contrast()
kerana ia tidak lagi berkaitan dengan ruang warna YIQ. Lihat #30168.$yiq-contrasted-threshold
dinamakan semula kepada$min-contrast-ratio
.$yiq-text-dark
dan$yiq-text-light
masing-masing dinamakan semula kepada$color-contrast-dark
dan$color-contrast-light
.
-
BerbukaParameter campuran pertanyaan media telah berubah untuk pendekatan yang lebih logik.
media-breakpoint-down()
menggunakan titik putus itu sendiri dan bukannya titik putus seterusnya (cth,media-breakpoint-down(lg)
bukannyamedia-breakpoint-down(md)
sasaran pandangan yang lebih kecil daripadalg
).- Begitu juga, parameter kedua dalam
media-breakpoint-between()
juga menggunakan titik putus itu sendiri dan bukannya titik putus seterusnya (cth,media-between(sm, lg)
bukannyamedia-breakpoint-between(sm, md)
sasaran pandangan antarasm
danlg
).
-
BerbukaGaya cetakan dan
$enable-print-styles
pembolehubah dialih keluar. Kelas paparan cetakan masih ada. Lihat #28339 . -
BerbukaDigugurkan
color()
,theme-color()
, dangray()
fungsi memihak kepada pembolehubah. Lihat #29083 . -
Berbuka
theme-color-level()
Fungsi dinamakan semula kepadacolor-level()
dan kini menerima sebarang warna yang anda inginkan dan bukannya$theme-color
warna sahaja. Lihat #29083 Awas :color-level()
kemudiannya digugurkan dalamv5.0.0-alpha3
. -
BerbukaDinamakan semula
$enable-prefers-reduced-motion-media-query
dan$enable-pointer-cursor-for-buttons
kepada$enable-reduced-motion
dan$enable-button-pointers
untuk ringkas. -
BerbukaMengalih keluar
bg-gradient-variant()
campuran. Gunakan.bg-gradient
kelas untuk menambah kecerunan pada elemen dan bukannya.bg-gradient-*
kelas yang dijana. -
Berbuka Mengalih keluar campuran yang telah ditamatkan sebelum ini:
hover
,hover-focus
,plain-hover-focus
, danhover-focus-active
float()
form-control-mixin()
nav-divider()
retina-img()
text-hide()
(juga menjatuhkan kelas utiliti yang berkaitan,.text-hide
)visibility()
form-control-focus()
-
BerbukaMenamakan semula
scale-color()
fungsi kepadashift-color()
untuk mengelakkan perlanggaran dengan fungsi penskalaan warna Sass sendiri. -
box-shadow
mixins kini membenarkannull
nilai dan dropnone
daripada berbilang argumen. Lihat #30394 . -
Mixin
border-radius()
kini mempunyai nilai lalai.
Sistem warna
-
Sistem warna yang berfungsi dengan
color-level()
dan$theme-color-interval
telah dialih keluar memihak kepada sistem warna baharu. Semualighten()
dandarken()
fungsi dalam pangkalan kod kami digantikan dengantint-color()
danshade-color()
. Fungsi ini akan mencampurkan warna dengan sama ada putih atau hitam dan bukannya menukar kecerahannya dengan jumlah tetap. Sama adashift-color()
akan mewarna atau mewarnakan warna bergantung pada sama ada parameter beratnya adalah positif atau negatif. Lihat #30622 untuk butiran lanjut. -
Menambah warna dan warna baharu untuk setiap warna, menyediakan sembilan warna berasingan untuk setiap warna asas, sebagai pembolehubah Sass baharu.
-
Kontras warna yang dipertingkatkan. Nisbah kontras warna terhantuk daripada 3:1 hingga 4.5:1 dan warna biru, hijau, cyan dan merah jambu dikemas kini untuk memastikan kontras WCAG 2.1 AA. Juga menukar warna kontras warna kami daripada
$gray-900
kepada$black
. -
Untuk menyokong sistem warna kami, kami telah menambah adat
tint-color()
danshade-color()
fungsi baharu untuk mencampurkan warna kami dengan sewajarnya.
Kemas kini grid
-
Titik putus baru! Menambah
xxl
titik putus baharu untuk1400px
dan ke atas. Tiada perubahan pada semua titik putus yang lain. -
Longkang yang lebih baik. Parit kini ditetapkan dalam rem dan lebih sempit daripada v4 (
1.5rem
, atau kira-kira24px
, turun dari30px
). Ini menjajarkan longkang sistem grid kami dengan utiliti jarak kami.- Menambahkan kelas longkang baharu (
.g-*
,.gx-*
, dan.gy-*
) untuk mengawal longkang mendatar/menegak, longkang mendatar dan longkang menegak. - BerbukaDinamakan semula
.no-gutters
kepada.g-0
untuk memadankan utiliti longkang baharu.
- Menambahkan kelas longkang baharu (
-
Lajur tidak lagi
position: relative
digunakan, jadi anda mungkin perlu menambah.position-relative
beberapa elemen untuk memulihkan gelagat tersebut. -
BerbukaMenggugurkan beberapa
.order-*
kelas yang sering tidak digunakan. Kami kini hanya menyediakan.order-1
kepada.order-5
di luar kotak. -
BerbukaMenggugurkan
.media
komponen kerana ia boleh direplikasi dengan mudah dengan utiliti. Lihat #28265 dan halaman utiliti fleksibel untuk contoh . -
Berbuka
bootstrap-grid.css
kini hanya digunakanbox-sizing: border-box
pada lajur dan bukannya menetapkan semula saiz kotak global. Dengan cara ini, gaya grid kami boleh digunakan di lebih banyak tempat tanpa gangguan. -
$enable-grid-classes
tidak lagi melumpuhkan penjanaan kelas kontena lagi. Lihat #29146. -
Mengemas kini
make-col
mixin kepada lalai kepada lajur yang sama tanpa saiz yang ditentukan.
Kandungan, But semula, dsb
-
RFS kini didayakan secara lalai. Tajuk yang menggunakan
font-size()
mixin akan melaraskannya secara automatik mengikutfont-size
skala dengan port pandangan. Ciri ini sebelum ini ikut serta dengan v4. -
BerbukaMembaik pulih tipografi paparan kami untuk menggantikan
$display-*
pembolehubah kami dan dengan$display-font-sizes
peta Sass. Juga mengalih keluar$display-*-weight
pembolehubah individu untuk s tunggal$display-font-weight
dan diselaraskanfont-size
. -
Menambah dua
.display-*
saiz tajuk baharu.display-5
dan.display-6
. -
Pautan digariskan secara lalai (bukan hanya pada tuding), melainkan ia adalah sebahagian daripada komponen tertentu.
-
Jadual direka bentuk semula untuk menyegarkan gaya mereka dan membina semulanya dengan pembolehubah CSS untuk lebih kawalan ke atas penggayaan.
-
BerbukaJadual bersarang tidak mewarisi gaya lagi.
-
Berbuka
.thead-light
dan.thead-dark
digugurkan memihak kepada.table-*
kelas varian yang boleh digunakan untuk semua elemen jadual (thead
,tbody
,tfoot
,tr
,th
dantd
). -
BerbukaMixin
table-row-variant()
dinamakan semula kepadatable-variant()
dan menerima hanya 2 parameter:$color
(nama warna) dan$value
(kod warna). Warna sempadan dan warna aksen dikira secara automatik berdasarkan pembolehubah faktor jadual. -
Pisahkan pembolehubah pelapik sel jadual ke dalam
-y
dan-x
. -
BerbukaDigugurkan
.pre-scrollable
kelas. Lihat #29135 -
Berbuka
.text-*
utiliti tidak menambah keadaan tuding dan fokus pada pautan lagi..link-*
kelas pembantu boleh digunakan sebaliknya. Lihat #29267 -
BerbukaDigugurkan
.text-justify
kelas. Lihat #29793 -
Berbuka
<hr>
elemen kini digunakanheight
dan bukannyaborder
untuk menyokongsize
atribut dengan lebih baik. Ini juga membolehkan penggunaan utiliti pelapik untuk mencipta pembahagi yang lebih tebal (cth,<hr class="py-1">
). -
padding-left
Tetapkan semula lalai mendatar<ul>
dan<ol>
elemen daripada lalai penyemak imbas40px
kepada2rem
. -
Ditambah
$enable-smooth-scroll
, yang terpakaiscroll-behavior: smooth
secara global—kecuali untuk pengguna yang meminta gerakan yang dikurangkan melaluiprefers-reduced-motion
pertanyaan media. Lihat #31877
RTL
- Pembolehubah khusus arah mendatar, utiliti dan campuran semuanya telah dinamakan semula untuk menggunakan sifat logik seperti yang terdapat dalam reka letak kotak flex—cth,
start
danend
sebagai gantileft
danright
.
Borang
-
Menambah borang terapung baharu! Kami telah mempromosikan contoh label Terapung kepada komponen borang yang disokong sepenuhnya. Lihat halaman label Terapung baharu.
-
Berbuka Unsur bentuk asli dan tersuai disatukan. Kotak pilihan, radio, pilihan dan input lain yang mempunyai kelas asli dan tersuai dalam v4 telah disatukan. Kini hampir semua elemen borang kami adalah tersuai sepenuhnya, kebanyakannya tanpa memerlukan HTML tersuai.
.custom-control.custom-checkbox
adalah sekarang.form-check
..custom-control.custom-custom-radio
adalah sekarang.form-check
..custom-control.custom-switch
adalah sekarang.form-check.form-switch
..custom-select
adalah sekarang.form-select
..custom-file
dan.form-file
telah digantikan dengan gaya tersuai di atas.form-control
..custom-range
adalah sekarang.form-range
.- Digugurkan asli
.form-control-file
dan.form-control-range
.
-
BerbukaDijatuhkan
.input-group-append
dan.input-group-prepend
. Anda kini boleh menambah butang dan.input-group-text
sebagai anak langsung kumpulan input. -
Jejari sempadan Hilang yang lama pada kumpulan input dengan pepijat maklum balas pengesahan akhirnya dibetulkan dengan menambahkan
.has-validation
kelas tambahan pada kumpulan input dengan pengesahan. -
Berbuka Menggugurkan kelas reka letak khusus bentuk untuk sistem grid kami. Gunakan grid dan utiliti kami dan bukannya
.form-group
,.form-row
, atau.form-inline
. -
BerbukaLabel borang kini memerlukan
.form-label
. -
Berbuka
.form-text
tidak lagi setdisplay
, membolehkan anda membuat teks bantuan sebaris atau menyekat seperti yang anda inginkan hanya dengan menukar elemen HTML. -
Kawalan borang tidak lagi digunakan tetap
height
apabila boleh, sebaliknya menangguhkanmin-height
untuk meningkatkan penyesuaian dan keserasian dengan komponen lain. -
Ikon pengesahan tidak lagi digunakan pada
<select>
s denganmultiple
. -
Fail Sass sumber disusun semula di bawah
scss/forms/
, termasuk gaya kumpulan input.
Komponen
- Nilai bersatu
padding
untuk makluman, serbuk roti, kad, lungsur turun, kumpulan senarai, modal, popover dan petua alat berdasarkan$spacer
pembolehubah kami. Lihat #30564 .
Akordion
- Menambah komponen akordion baharu .
Makluman
-
Makluman kini mempunyai contoh dengan ikon .
-
Mengalih keluar gaya tersuai untuk
<hr>
s dalam setiap makluman kerana ia sudah menggunakancurrentColor
.
Lencana
-
BerbukaMenggugurkan semua
.badge-*
kelas warna untuk utiliti latar belakang (cth, gunakan.bg-primary
bukannya.badge-primary
). -
BerbukaDijatuhkan
.badge-pill
—gunakan.rounded-pill
utiliti sebaliknya. -
BerbukaGaya tuding dan fokus dialih keluar untuk
<a>
dan<button>
elemen. -
Menambahkan padding lalai untuk lencana dari
.25em
/.5em
ke.35em
/.65em
.
Serbuk roti
-
Mempermudahkan rupa lalai serbuk roti dengan mengalih keluar
padding
,background-color
, danborder-radius
. -
Menambah sifat tersuai CSS baharu
--bs-breadcrumb-divider
untuk penyesuaian mudah tanpa perlu menyusun semula CSS.
Butang
-
Berbuka Togol butang , dengan kotak pilihan atau radio, tidak lagi memerlukan JavaScript dan mempunyai penanda baharu. Kami tidak lagi memerlukan elemen pembalut, tambah
.btn-check
pada<input>
, dan pasangkannya dengan mana-mana.btn
kelas pada<label>
. Lihat #30650 . Dokumen untuk ini telah berpindah dari halaman Butang kami ke bahagian Borang baharu. -
Berbuka Digugurkan
.btn-block
untuk utiliti. Daripada menggunakan.btn-block
pada.btn
, bungkus butang anda dengan.d-grid
dan.gap-*
utiliti untuk menjarakkannya mengikut keperluan. Beralih kepada kelas responsif untuk mendapatkan lebih kawalan ke atasnya. Baca dokumen untuk beberapa contoh. -
Mengemas kini kami
button-variant()
danbutton-outline-variant()
mixin untuk menyokong parameter tambahan. -
Butang dikemas kini untuk memastikan peningkatan kontras pada tuding dan keadaan aktif.
-
Butang dilumpuhkan kini mempunyai
pointer-events: none;
.
Kad
-
BerbukaDijatuhkan
.card-deck
memihak kepada grid kami. Balut kad anda dalam kelas lajur dan tambah.row-cols-*
bekas induk untuk mencipta semula dek kad (tetapi dengan lebih kawalan ke atas penjajaran responsif). -
BerbukaDijatuhkan
.card-columns
memihak kepada Masonry. Lihat #28922 . -
BerbukaMenggantikan
.card
akordion berasaskan dengan komponen Akordion baharu .
karusel
-
Menambahkan
.carousel-dark
varian baharu untuk teks gelap, kawalan dan penunjuk (bagus untuk latar belakang yang lebih terang). -
Menggantikan ikon chevron untuk kawalan karusel dengan SVG baharu daripada Ikon Bootstrap .
Butang tutup
-
BerbukaDinamakan semula
.close
kepada.btn-close
untuk nama yang kurang generik. -
Butang tutup kini menggunakan
background-image
(SVG terbenam) dan bukannya a×
dalam HTML, membolehkan penyesuaian lebih mudah tanpa perlu menyentuh penanda anda. -
Menambahkan
.btn-close-white
varian baharu yang digunakanfilter: invert(1)
untuk mendayakan ikon tolak kontras yang lebih tinggi terhadap latar belakang yang lebih gelap.
Runtuh
- Dialih keluar penambat skrol untuk akordion.
Jatuh turun
-
Menambahkan
.dropdown-menu-dark
varian baharu dan pembolehubah yang berkaitan untuk menu lungsur gelap atas permintaan. -
Menambah pembolehubah baharu untuk
$dropdown-padding-x
. -
Menggelapkan pembahagi lungsur untuk kontras yang lebih baik.
-
BerbukaSemua peristiwa untuk lungsur turun kini dicetuskan pada butang togol lungsur turun dan kemudian menggelembung ke elemen induk.
-
Menu lungsur turun kini mempunyai
data-bs-popper="static"
atribut yang ditetapkan apabila kedudukan lungsur turun adalah statik, atau lungsur turun berada dalam bar navigasi. Ini ditambah oleh JavaScript kami dan membantu kami menggunakan gaya kedudukan tersuai tanpa mengganggu kedudukan Popper. -
BerbukaPilihan yang digugurkan
flip
untuk pemalam lungsur memihak kepada konfigurasi Popper asli. Anda kini boleh melumpuhkan tingkah laku membalik dengan menghantar tatasusunan kosong untukfallbackPlacements
pilihan dalam pengubah suai flip . -
Menu lungsur kini boleh diklik dengan pilihan baharu
autoClose
untuk mengendalikan gelagat auto tutup . Anda boleh menggunakan pilihan ini untuk menerima klik di dalam atau di luar menu lungsur turun untuk menjadikannya interaktif. -
Dropdown kini menyokong
.dropdown-item
s yang dibungkus dengan<li>
s.
Jumbotron
- BerbukaMenggugurkan komponen jumbotron kerana ia boleh direplikasi dengan utiliti. Lihat contoh Jumbotron baharu kami untuk demo.
Senaraikan kumpulan
- Menambahkan
.list-group-numbered
pengubah suai baharu pada senarai kumpulan.
Navs dan tab
- Menambah
null
pembolehubah baharu untukfont-size
,font-weight
,color
, dan:hover
color
pada.nav-link
kelas.
Navbars
- BerbukaNavbars kini memerlukan bekas dalam (untuk memudahkan keperluan jarak dan CSS yang diperlukan secara drastik).
- BerbukaKelas
.active
tidak lagi boleh digunakan untuk.nav-item
s, ia mesti digunakan terus pada.nav-link
s.
Luar Kanvas
- Menambahkan komponen offcanvas baharu .
penomboran
-
Pautan penomboran kini mempunyai boleh disesuaikan
margin-left
yang dibulatkan secara dinamik pada semua penjuru apabila dipisahkan antara satu sama lain. -
Ditambahkan
transition
s pada pautan penomboran.
Popovers
-
BerbukaDinamakan semula
.arrow
kepada.popover-arrow
dalam templat popover lalai kami. -
Menamakan semula
whiteList
pilihan kepadaallowList
.
Pemintal
-
Spinners kini menghormati
prefers-reduced-motion: reduce
dengan memperlahankan animasi. Lihat #31882 . -
Penjajaran menegak pemutar yang dipertingkatkan.
Roti bakar
-
Roti bakar kini boleh diletakkan di dalam a
.toast-container
dengan bantuan utiliti kedudukan . -
Menukar tempoh roti bakar lalai kepada 5 saat.
-
Dikeluarkan
overflow: hidden
daripada roti bakar dan digantikan denganborder-radius
s yang betul dengancalc()
fungsi.
Petua alat
-
BerbukaDinamakan semula
.arrow
kepada.tooltip-arrow
dalam templat petua alat lalai kami. -
BerbukaNilai lalai untuk
fallbackPlacements
ditukar kepada['top', 'right', 'bottom', 'left']
untuk penempatan elemen popper yang lebih baik. -
BerbukaMenamakan semula
whiteList
pilihan kepadaallowList
.
Utiliti
-
BerbukaMenamakan semula beberapa utiliti untuk menggunakan nama harta logik dan bukannya nama arah dengan penambahan sokongan RTL:
- Dinamakan semula
.left-*
dan.right-*
kepada.start-*
dan.end-*
. - Dinamakan semula
.float-left
dan.float-right
kepada.float-start
dan.float-end
. - Dinamakan semula
.border-left
dan.border-right
kepada.border-start
dan.border-end
. - Dinamakan semula
.rounded-left
dan.rounded-right
kepada.rounded-start
dan.rounded-end
. - Dinamakan semula
.ml-*
dan.mr-*
kepada.ms-*
dan.me-*
. - Dinamakan semula
.pl-*
dan.pr-*
kepada.ps-*
dan.pe-*
. - Dinamakan semula
.text-left
dan.text-right
kepada.text-start
dan.text-end
.
- Dinamakan semula
-
BerbukaJidar negatif dilumpuhkan secara lalai.
-
Menambah
.bg-body
kelas baharu untuk menetapkan latar belakang dengan pantas<body>
kepada elemen tambahan. -
Menambahkan utiliti kedudukan baharu untuk
top
,right
,bottom
, danleft
. Nilai termasuk0
,50%
, dan100%
untuk setiap harta. -
Ditambah baharu
.translate-middle-x
&.translate-middle-y
utiliti pada elemen kedudukan mutlak/tetap secara mendatar atau menegak. -
Menambah
border-width
utiliti baharu . -
BerbukaDinamakan semula
.text-monospace
kepada.font-monospace
. -
BerbukaDialih keluar
.text-hide
kerana ia merupakan kaedah lama untuk menyembunyikan teks yang tidak boleh digunakan lagi. -
Menambah
.fs-*
utiliti untukfont-size
utiliti (dengan RFS didayakan). Ini menggunakan skala yang sama seperti tajuk lalai HTML (1-6, besar ke kecil), dan boleh diubah suai melalui peta Sass. -
Berbuka
.font-weight-*
Utiliti dinamakan semula sebagai.fw-*
ringkas dan konsisten. -
Berbuka
.font-style-*
Utiliti dinamakan semula sebagai.fst-*
ringkas dan konsisten. -
Ditambah
.d-grid
untuk memaparkan utiliti dangap
utiliti baharu (.gap
) untuk susun atur Grid CSS dan flexbox. -
BerbukaDialih keluar
.rounded-sm
danrounded-lg
, dan memperkenalkan skala kelas baharu,.rounded-0
kepada.rounded-3
. Lihat #31687 . -
Menambah
line-height
utiliti baharu:.lh-1
,.lh-sm
,.lh-base
dan.lh-lg
. Lihat di sini . -
Mengalihkan
.d-none
utiliti dalam CSS kami untuk memberikannya lebih berat berbanding utiliti paparan lain. -
Dilanjutkan
.visually-hidden-focusable
pembantu untuk turut bekerja pada bekas, menggunakan:focus-within
.
Pembantu
-
Berbuka Pembantu benam responsif telah dinamakan semula kepada pembantu nisbah dengan nama kelas baharu dan gelagat yang dipertingkatkan, serta pembolehubah CSS yang berguna.
- Kelas telah dinamakan semula untuk ditukar
by
kepadax
dalam nisbah bidang. Sebagai contoh,.ratio-16by9
adalah sekarang.ratio-16x9
. - Kami telah menggugurkan
.embed-responsive-item
pemilih kumpulan elemen dan memihak kepada.ratio > *
pemilih yang lebih mudah. Tiada lagi kelas diperlukan dan pembantu nisbah kini berfungsi dengan mana-mana elemen HTML. - Peta
$embed-responsive-aspect-ratios
Sass telah dinamakan semula kepada$aspect-ratios
dan nilainya telah dipermudahkan untuk memasukkan nama kelas dan peratusan sebagaikey: value
pasangan. - Pembolehubah CSS kini dijana dan disertakan untuk setiap nilai dalam peta Sass. Ubah suai
--bs-aspect-ratio
pembolehubah pada.ratio
untuk mencipta sebarang nisbah aspek tersuai .
- Kelas telah dinamakan semula untuk ditukar
-
Berbuka Kelas "Pembaca skrin" kini ialah kelas "tersembunyi secara visual" .
- Menukar fail Sass daripada
scss/helpers/_screenreaders.scss
kepadascss/helpers/_visually-hidden.scss
- Dinamakan semula
.sr-only
dan.sr-only-focusable
kepada.visually-hidden
dan.visually-hidden-focusable
- Dinamakan semula
sr-only()
dansr-only-focusable()
campurkan kepadavisually-hidden()
danvisually-hidden-focusable()
.
- Menukar fail Sass daripada
-
bootstrap-utilities.css
kini juga termasuk pembantu kami. Pembantu tidak perlu diimport dalam binaan tersuai lagi.
JavaScript
-
Menggugurkan kebergantungan jQuery dan menulis semula pemalam untuk berada dalam JavaScript biasa.
-
BerbukaAtribut data untuk semua pemalam JavaScript kini diberi ruang nama untuk membantu membezakan fungsi Bootstrap daripada pihak ketiga dan kod anda sendiri. Sebagai contoh, kami menggunakan
data-bs-toggle
bukannyadata-toggle
. -
Semua pemalam kini boleh menerima pemilih CSS sebagai hujah pertama. Anda boleh sama ada menghantar elemen DOM atau mana-mana pemilih CSS yang sah untuk membuat contoh baharu pemalam:
const modal = new bootstrap.Modal('#myModal') const dropdown = new bootstrap.Dropdown('[data-bs-toggle="dropdown"]')
-
popperConfig
boleh diluluskan sebagai fungsi yang menerima konfigurasi Popper lalai Bootstrap sebagai hujah, supaya anda boleh menggabungkan konfigurasi lalai ini mengikut cara anda. Digunakan pada lungsur turun, popover dan petua alat. -
Nilai lalai untuk
fallbackPlacements
ditukar kepada['top', 'right', 'bottom', 'left']
peletakan elemen Popper yang lebih baik. Digunakan pada lungsur turun, popover dan petua alat. -
Garis bawah dialih keluar daripada kaedah statik awam seperti
_getInstance()
→getInstance()
.