summaryrefslogtreecommitdiffstats
path: root/site/content/docs
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2023-06-24 12:44:40 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2023-06-24 12:44:49 +0000
commitdb46bfc03f3a22752ef6bd91ae577d893872a216 (patch)
tree89d924513bc95e6bac4dc8e26f0da84caa477b7b /site/content/docs
parentReleasing debian version 5.2.3+dfsg-8. (diff)
downloadbootstrap-html-db46bfc03f3a22752ef6bd91ae577d893872a216.tar.xz
bootstrap-html-db46bfc03f3a22752ef6bd91ae577d893872a216.zip
Merging upstream version 5.3.0+dfsg.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'site/content/docs')
-rw-r--r--site/content/docs/5.2/_index.html5
-rw-r--r--site/content/docs/5.2/components/close-button.md38
-rw-r--r--site/content/docs/5.2/components/progress.md154
-rw-r--r--site/content/docs/5.2/customize/color.md151
-rw-r--r--site/content/docs/5.2/examples/.stylelintrc15
-rw-r--r--site/content/docs/5.2/examples/_index.md45
-rw-r--r--site/content/docs/5.2/examples/dashboard-rtl/index.html253
-rw-r--r--site/content/docs/5.2/examples/dashboard/dashboard.css92
-rw-r--r--site/content/docs/5.2/examples/dashboard/dashboard.rtl.css88
-rw-r--r--site/content/docs/5.2/examples/dashboard/index.html252
-rw-r--r--site/content/docs/5.2/examples/dropdowns/index.html338
-rw-r--r--site/content/docs/5.2/examples/grid/grid.css13
-rw-r--r--site/content/docs/5.2/examples/list-groups/index.html222
-rw-r--r--site/content/docs/5.2/examples/pricing/pricing.css11
-rw-r--r--site/content/docs/5.2/examples/product/index.html148
-rw-r--r--site/content/docs/5.2/examples/starter-template/index.html52
-rw-r--r--site/content/docs/5.2/examples/starter-template/starter-template.css9
-rw-r--r--site/content/docs/5.2/helpers/colored-links.md21
-rw-r--r--site/content/docs/5.2/utilities/overflow.md40
-rw-r--r--site/content/docs/5.2/utilities/sizing.md60
-rw-r--r--site/content/docs/5.3/_index.html5
-rw-r--r--site/content/docs/5.3/about/brand.md (renamed from site/content/docs/5.2/about/brand.md)20
-rw-r--r--site/content/docs/5.3/about/license.md (renamed from site/content/docs/5.2/about/license.md)6
-rw-r--r--site/content/docs/5.3/about/overview.md (renamed from site/content/docs/5.2/about/overview.md)2
-rw-r--r--site/content/docs/5.3/about/team.md (renamed from site/content/docs/5.2/about/team.md)0
-rw-r--r--site/content/docs/5.3/about/translations.md (renamed from site/content/docs/5.2/about/translations.md)0
-rw-r--r--site/content/docs/5.3/components/accordion.md (renamed from site/content/docs/5.2/components/accordion.md)44
-rw-r--r--site/content/docs/5.3/components/alerts.md (renamed from site/content/docs/5.2/components/alerts.md)35
-rw-r--r--site/content/docs/5.3/components/badge.md (renamed from site/content/docs/5.2/components/badge.md)2
-rw-r--r--site/content/docs/5.3/components/breadcrumb.md (renamed from site/content/docs/5.2/components/breadcrumb.md)5
-rw-r--r--site/content/docs/5.3/components/button-group.md (renamed from site/content/docs/5.2/components/button-group.md)38
-rw-r--r--site/content/docs/5.3/components/buttons.md (renamed from site/content/docs/5.2/components/buttons.md)20
-rw-r--r--site/content/docs/5.3/components/card.md (renamed from site/content/docs/5.2/components/card.md)38
-rw-r--r--site/content/docs/5.3/components/carousel.md (renamed from site/content/docs/5.2/components/carousel.md)179
-rw-r--r--site/content/docs/5.3/components/close-button.md54
-rw-r--r--site/content/docs/5.3/components/collapse.md (renamed from site/content/docs/5.2/components/collapse.md)18
-rw-r--r--site/content/docs/5.3/components/dropdowns.md (renamed from site/content/docs/5.2/components/dropdowns.md)45
-rw-r--r--site/content/docs/5.3/components/list-group.md (renamed from site/content/docs/5.2/components/list-group.md)32
-rw-r--r--site/content/docs/5.3/components/modal.md (renamed from site/content/docs/5.2/components/modal.md)43
-rw-r--r--site/content/docs/5.3/components/navbar.md (renamed from site/content/docs/5.2/components/navbar.md)90
-rw-r--r--site/content/docs/5.3/components/navs-tabs.md (renamed from site/content/docs/5.2/components/navs-tabs.md)31
-rw-r--r--site/content/docs/5.3/components/offcanvas.md (renamed from site/content/docs/5.2/components/offcanvas.md)16
-rw-r--r--site/content/docs/5.3/components/pagination.md (renamed from site/content/docs/5.2/components/pagination.md)0
-rw-r--r--site/content/docs/5.3/components/placeholders.md (renamed from site/content/docs/5.2/components/placeholders.md)12
-rw-r--r--site/content/docs/5.3/components/popovers.md (renamed from site/content/docs/5.2/components/popovers.md)28
-rw-r--r--site/content/docs/5.3/components/progress.md202
-rw-r--r--site/content/docs/5.3/components/scrollspy.md (renamed from site/content/docs/5.2/components/scrollspy.md)10
-rw-r--r--site/content/docs/5.3/components/spinners.md (renamed from site/content/docs/5.2/components/spinners.md)4
-rw-r--r--site/content/docs/5.3/components/toasts.md (renamed from site/content/docs/5.2/components/toasts.md)44
-rw-r--r--site/content/docs/5.3/components/tooltips.md (renamed from site/content/docs/5.2/components/tooltips.md)31
-rw-r--r--site/content/docs/5.3/content/figures.md (renamed from site/content/docs/5.2/content/figures.md)4
-rw-r--r--site/content/docs/5.3/content/images.md (renamed from site/content/docs/5.2/content/images.md)4
-rw-r--r--site/content/docs/5.3/content/reboot.md (renamed from site/content/docs/5.2/content/reboot.md)55
-rw-r--r--site/content/docs/5.3/content/tables.md (renamed from site/content/docs/5.2/content/tables.md)18
-rw-r--r--site/content/docs/5.3/content/typography.md (renamed from site/content/docs/5.2/content/typography.md)8
-rw-r--r--site/content/docs/5.3/customize/color-modes.md258
-rw-r--r--site/content/docs/5.3/customize/color.md510
-rw-r--r--site/content/docs/5.3/customize/components.md (renamed from site/content/docs/5.2/customize/components.md)2
-rw-r--r--site/content/docs/5.3/customize/css-variables.md (renamed from site/content/docs/5.2/customize/css-variables.md)35
-rw-r--r--site/content/docs/5.3/customize/optimize.md (renamed from site/content/docs/5.2/customize/optimize.md)5
-rw-r--r--site/content/docs/5.3/customize/options.md (renamed from site/content/docs/5.2/customize/options.md)1
-rw-r--r--site/content/docs/5.3/customize/overview.md (renamed from site/content/docs/5.2/customize/overview.md)4
-rw-r--r--site/content/docs/5.3/customize/sass.md (renamed from site/content/docs/5.2/customize/sass.md)9
-rw-r--r--site/content/docs/5.3/docsref.md49
-rw-r--r--site/content/docs/5.3/examples/_index.md66
-rw-r--r--site/content/docs/5.3/examples/album-rtl/index.html (renamed from site/content/docs/5.2/examples/album-rtl/index.html)34
-rw-r--r--site/content/docs/5.3/examples/album/index.html (renamed from site/content/docs/5.2/examples/album/index.html)34
-rw-r--r--site/content/docs/5.3/examples/badges/badges.css3
-rw-r--r--site/content/docs/5.3/examples/badges/index.html149
-rw-r--r--site/content/docs/5.3/examples/blog-rtl/index.html (renamed from site/content/docs/5.2/examples/blog-rtl/index.html)119
-rw-r--r--site/content/docs/5.3/examples/blog/blog.css (renamed from site/content/docs/5.2/examples/blog/blog.css)32
-rw-r--r--site/content/docs/5.3/examples/blog/blog.rtl.css (renamed from site/content/docs/5.2/examples/blog/blog.rtl.css)32
-rw-r--r--site/content/docs/5.3/examples/blog/index.html (renamed from site/content/docs/5.2/examples/blog/index.html)115
-rw-r--r--site/content/docs/5.3/examples/breadcrumbs/breadcrumbs.css50
-rw-r--r--site/content/docs/5.3/examples/breadcrumbs/index.html88
-rw-r--r--site/content/docs/5.3/examples/buttons/index.html88
-rw-r--r--site/content/docs/5.3/examples/carousel-rtl/index.html (renamed from site/content/docs/5.2/examples/carousel-rtl/index.html)30
-rw-r--r--site/content/docs/5.3/examples/carousel/carousel.css (renamed from site/content/docs/5.2/examples/carousel/carousel.css)2
-rw-r--r--site/content/docs/5.3/examples/carousel/carousel.rtl.css (renamed from site/content/docs/5.2/examples/carousel/carousel.rtl.css)2
-rw-r--r--site/content/docs/5.3/examples/carousel/index.html (renamed from site/content/docs/5.2/examples/carousel/index.html)30
-rw-r--r--site/content/docs/5.3/examples/cheatsheet-rtl/index.html (renamed from site/content/docs/5.2/examples/cheatsheet-rtl/index.html)56
-rw-r--r--site/content/docs/5.3/examples/cheatsheet/cheatsheet.css (renamed from site/content/docs/5.2/examples/cheatsheet/cheatsheet.css)0
-rw-r--r--site/content/docs/5.3/examples/cheatsheet/cheatsheet.js (renamed from site/content/docs/5.2/examples/cheatsheet/cheatsheet.js)0
-rw-r--r--site/content/docs/5.3/examples/cheatsheet/cheatsheet.rtl.css (renamed from site/content/docs/5.2/examples/cheatsheet/cheatsheet.rtl.css)0
-rw-r--r--site/content/docs/5.3/examples/cheatsheet/index.html (renamed from site/content/docs/5.2/examples/cheatsheet/index.html)56
-rw-r--r--site/content/docs/5.3/examples/checkout-rtl/index.html (renamed from site/content/docs/5.2/examples/checkout-rtl/index.html)30
-rw-r--r--site/content/docs/5.3/examples/checkout/checkout.css (renamed from site/content/docs/5.2/examples/checkout/form-validation.css)0
-rw-r--r--site/content/docs/5.3/examples/checkout/checkout.js (renamed from site/content/docs/5.2/examples/checkout/form-validation.js)0
-rw-r--r--site/content/docs/5.3/examples/checkout/index.html (renamed from site/content/docs/5.2/examples/checkout/index.html)28
-rw-r--r--site/content/docs/5.3/examples/cover/cover.css (renamed from site/content/docs/5.2/examples/cover/cover.css)6
-rw-r--r--site/content/docs/5.3/examples/cover/index.html (renamed from site/content/docs/5.2/examples/cover/index.html)3
-rw-r--r--site/content/docs/5.3/examples/dashboard-rtl/dashboard.js (renamed from site/content/docs/5.2/examples/dashboard-rtl/dashboard.js)20
-rw-r--r--site/content/docs/5.3/examples/dashboard-rtl/index.html333
-rw-r--r--site/content/docs/5.3/examples/dashboard/dashboard.css48
-rw-r--r--site/content/docs/5.3/examples/dashboard/dashboard.js (renamed from site/content/docs/5.2/examples/dashboard/dashboard.js)20
-rw-r--r--site/content/docs/5.3/examples/dashboard/dashboard.rtl.css48
-rw-r--r--site/content/docs/5.3/examples/dashboard/index.html332
-rw-r--r--site/content/docs/5.3/examples/dropdowns/dropdowns.css (renamed from site/content/docs/5.2/examples/dropdowns/dropdowns.css)24
-rw-r--r--site/content/docs/5.3/examples/dropdowns/index.html462
-rw-r--r--site/content/docs/5.3/examples/features/features.css (renamed from site/content/docs/5.2/examples/features/features.css)10
-rw-r--r--site/content/docs/5.3/examples/features/index.html (renamed from site/content/docs/5.2/examples/features/index.html)145
-rw-r--r--site/content/docs/5.3/examples/features/unsplash-photo-1.jpg (renamed from site/content/docs/5.2/examples/features/unsplash-photo-1.jpg)bin10451 -> 10451 bytes
-rw-r--r--site/content/docs/5.3/examples/features/unsplash-photo-2.jpg (renamed from site/content/docs/5.2/examples/features/unsplash-photo-2.jpg)bin113018 -> 113018 bytes
-rw-r--r--site/content/docs/5.3/examples/features/unsplash-photo-3.jpg (renamed from site/content/docs/5.2/examples/features/unsplash-photo-3.jpg)bin40607 -> 40607 bytes
-rw-r--r--site/content/docs/5.3/examples/footers/index.html (renamed from site/content/docs/5.2/examples/footers/index.html)106
-rw-r--r--site/content/docs/5.3/examples/grid/grid.css13
-rw-r--r--site/content/docs/5.3/examples/grid/index.html (renamed from site/content/docs/5.2/examples/grid/index.html)1
-rw-r--r--site/content/docs/5.3/examples/headers/headers.css (renamed from site/content/docs/5.2/examples/headers/headers.css)2
-rw-r--r--site/content/docs/5.3/examples/headers/index.html (renamed from site/content/docs/5.2/examples/headers/index.html)56
-rw-r--r--site/content/docs/5.3/examples/heroes/bootstrap-docs.png (renamed from site/content/docs/5.2/examples/heroes/bootstrap-docs.png)bin371399 -> 371399 bytes
-rw-r--r--site/content/docs/5.3/examples/heroes/bootstrap-themes.png (renamed from site/content/docs/5.2/examples/heroes/bootstrap-themes.png)bin278159 -> 278159 bytes
-rw-r--r--site/content/docs/5.3/examples/heroes/heroes.css (renamed from site/content/docs/5.2/examples/heroes/heroes.css)0
-rw-r--r--site/content/docs/5.3/examples/heroes/index.html (renamed from site/content/docs/5.2/examples/heroes/index.html)16
-rw-r--r--site/content/docs/5.3/examples/jumbotron/index.html (renamed from site/content/docs/5.2/examples/jumbotron/index.html)9
-rw-r--r--site/content/docs/5.3/examples/jumbotrons/index.html82
-rw-r--r--site/content/docs/5.3/examples/jumbotrons/jumbotrons.css1
-rw-r--r--site/content/docs/5.3/examples/list-groups/index.html225
-rw-r--r--site/content/docs/5.3/examples/list-groups/list-groups.css (renamed from site/content/docs/5.2/examples/list-groups/list-groups.css)14
-rw-r--r--site/content/docs/5.3/examples/masonry/index.html (renamed from site/content/docs/5.2/examples/masonry/index.html)10
-rw-r--r--site/content/docs/5.3/examples/modals/index.html (renamed from site/content/docs/5.2/examples/modals/index.html)49
-rw-r--r--site/content/docs/5.3/examples/modals/modals.css (renamed from site/content/docs/5.2/examples/modals/modals.css)7
-rw-r--r--site/content/docs/5.3/examples/navbar-bottom/index.html (renamed from site/content/docs/5.2/examples/navbar-bottom/index.html)2
-rw-r--r--site/content/docs/5.3/examples/navbar-fixed/index.html (renamed from site/content/docs/5.2/examples/navbar-fixed/index.html)4
-rw-r--r--site/content/docs/5.3/examples/navbar-fixed/navbar-fixed.css (renamed from site/content/docs/5.2/examples/navbar-fixed/navbar-top-fixed.css)0
-rw-r--r--site/content/docs/5.3/examples/navbar-static/index.html (renamed from site/content/docs/5.2/examples/navbar-static/index.html)4
-rw-r--r--site/content/docs/5.3/examples/navbar-static/navbar-static.css (renamed from site/content/docs/5.2/examples/navbar-static/navbar-top.css)0
-rw-r--r--site/content/docs/5.3/examples/navbars-offcanvas/index.html (renamed from site/content/docs/5.2/examples/navbars-offcanvas/index.html)12
-rw-r--r--site/content/docs/5.3/examples/navbars-offcanvas/navbars-offcanvas.css (renamed from site/content/docs/5.2/examples/navbars-offcanvas/navbar.css)0
-rw-r--r--site/content/docs/5.3/examples/navbars/index.html (renamed from site/content/docs/5.2/examples/navbars/index.html)42
-rw-r--r--site/content/docs/5.3/examples/navbars/navbars.css (renamed from site/content/docs/5.2/examples/navbars/navbar.css)0
-rw-r--r--site/content/docs/5.3/examples/offcanvas-navbar/index.html (renamed from site/content/docs/5.2/examples/offcanvas-navbar/index.html)20
-rw-r--r--site/content/docs/5.3/examples/offcanvas-navbar/offcanvas-navbar.css (renamed from site/content/docs/5.2/examples/offcanvas-navbar/offcanvas.css)0
-rw-r--r--site/content/docs/5.3/examples/offcanvas-navbar/offcanvas-navbar.js (renamed from site/content/docs/5.2/examples/offcanvas-navbar/offcanvas.js)0
-rw-r--r--site/content/docs/5.3/examples/pricing/index.html (renamed from site/content/docs/5.2/examples/pricing/index.html)23
-rw-r--r--site/content/docs/5.3/examples/pricing/pricing.css11
-rw-r--r--site/content/docs/5.3/examples/product/index.html189
-rw-r--r--site/content/docs/5.3/examples/product/product.css (renamed from site/content/docs/5.2/examples/product/product.css)5
-rw-r--r--site/content/docs/5.3/examples/sidebars/index.html (renamed from site/content/docs/5.2/examples/sidebars/index.html)107
-rw-r--r--site/content/docs/5.3/examples/sidebars/sidebars.css (renamed from site/content/docs/5.2/examples/sidebars/sidebars.css)14
-rw-r--r--site/content/docs/5.3/examples/sidebars/sidebars.js (renamed from site/content/docs/5.2/examples/sidebars/sidebars.js)0
-rw-r--r--site/content/docs/5.3/examples/sign-in/index.html (renamed from site/content/docs/5.2/examples/sign-in/index.html)16
-rw-r--r--site/content/docs/5.3/examples/sign-in/sign-in.css (renamed from site/content/docs/5.2/examples/sign-in/signin.css)10
-rw-r--r--site/content/docs/5.3/examples/starter-template/index.html107
-rw-r--r--site/content/docs/5.3/examples/sticky-footer-navbar/index.html (renamed from site/content/docs/5.2/examples/sticky-footer-navbar/index.html)4
-rw-r--r--site/content/docs/5.3/examples/sticky-footer-navbar/sticky-footer-navbar.css (renamed from site/content/docs/5.2/examples/sticky-footer-navbar/sticky-footer-navbar.css)0
-rw-r--r--site/content/docs/5.3/examples/sticky-footer/index.html (renamed from site/content/docs/5.2/examples/sticky-footer/index.html)5
-rw-r--r--site/content/docs/5.3/examples/sticky-footer/sticky-footer.css (renamed from site/content/docs/5.2/examples/sticky-footer/sticky-footer.css)0
-rw-r--r--site/content/docs/5.3/extend/approach.md (renamed from site/content/docs/5.2/extend/approach.md)6
-rw-r--r--site/content/docs/5.3/extend/icons.md (renamed from site/content/docs/5.2/extend/icons.md)0
-rw-r--r--site/content/docs/5.3/forms/checks-radios.md (renamed from site/content/docs/5.2/forms/checks-radios.md)12
-rw-r--r--site/content/docs/5.3/forms/floating-labels.md (renamed from site/content/docs/5.2/forms/floating-labels.md)32
-rw-r--r--site/content/docs/5.3/forms/form-control.md (renamed from site/content/docs/5.2/forms/form-control.md)42
-rw-r--r--site/content/docs/5.3/forms/input-group.md (renamed from site/content/docs/5.2/forms/input-group.md)15
-rw-r--r--site/content/docs/5.3/forms/layout.md (renamed from site/content/docs/5.2/forms/layout.md)0
-rw-r--r--site/content/docs/5.3/forms/overview.md (renamed from site/content/docs/5.2/forms/overview.md)44
-rw-r--r--site/content/docs/5.3/forms/range.md (renamed from site/content/docs/5.2/forms/range.md)4
-rw-r--r--site/content/docs/5.3/forms/select.md (renamed from site/content/docs/5.2/forms/select.md)4
-rw-r--r--site/content/docs/5.3/forms/validation.md (renamed from site/content/docs/5.2/forms/validation.md)32
-rw-r--r--site/content/docs/5.3/getting-started/accessibility.md (renamed from site/content/docs/5.2/getting-started/accessibility.md)0
-rw-r--r--site/content/docs/5.3/getting-started/best-practices.md (renamed from site/content/docs/5.2/getting-started/best-practices.md)0
-rw-r--r--site/content/docs/5.3/getting-started/browsers-devices.md (renamed from site/content/docs/5.2/getting-started/browsers-devices.md)6
-rw-r--r--site/content/docs/5.3/getting-started/contents.md (renamed from site/content/docs/5.2/getting-started/contents.md)0
-rw-r--r--site/content/docs/5.3/getting-started/contribute.md (renamed from site/content/docs/5.2/getting-started/contribute.md)6
-rw-r--r--site/content/docs/5.3/getting-started/download.md (renamed from site/content/docs/5.2/getting-started/download.md)4
-rw-r--r--site/content/docs/5.3/getting-started/introduction.md (renamed from site/content/docs/5.2/getting-started/introduction.md)6
-rw-r--r--site/content/docs/5.3/getting-started/javascript.md (renamed from site/content/docs/5.2/getting-started/javascript.md)59
-rw-r--r--site/content/docs/5.3/getting-started/parcel.md (renamed from site/content/docs/5.2/getting-started/parcel.md)6
-rw-r--r--site/content/docs/5.3/getting-started/rfs.md (renamed from site/content/docs/5.2/getting-started/rfs.md)0
-rw-r--r--site/content/docs/5.3/getting-started/rtl.md (renamed from site/content/docs/5.2/getting-started/rtl.md)8
-rw-r--r--site/content/docs/5.3/getting-started/vite.md (renamed from site/content/docs/5.2/getting-started/vite.md)39
-rw-r--r--site/content/docs/5.3/getting-started/webpack.md (renamed from site/content/docs/5.2/getting-started/webpack.md)89
-rw-r--r--site/content/docs/5.3/helpers/clearfix.md (renamed from site/content/docs/5.2/helpers/clearfix.md)2
-rw-r--r--site/content/docs/5.3/helpers/color-background.md (renamed from site/content/docs/5.2/helpers/color-background.md)8
-rw-r--r--site/content/docs/5.3/helpers/colored-links.md43
-rw-r--r--site/content/docs/5.3/helpers/focus-ring.md68
-rw-r--r--site/content/docs/5.3/helpers/icon-link.md88
-rw-r--r--site/content/docs/5.3/helpers/position.md (renamed from site/content/docs/5.2/helpers/position.md)0
-rw-r--r--site/content/docs/5.3/helpers/ratio.md (renamed from site/content/docs/5.2/helpers/ratio.md)2
-rw-r--r--site/content/docs/5.3/helpers/stacks.md (renamed from site/content/docs/5.2/helpers/stacks.md)34
-rw-r--r--site/content/docs/5.3/helpers/stretched-link.md (renamed from site/content/docs/5.2/helpers/stretched-link.md)4
-rw-r--r--site/content/docs/5.3/helpers/text-truncation.md (renamed from site/content/docs/5.2/helpers/text-truncation.md)0
-rw-r--r--site/content/docs/5.3/helpers/vertical-rule.md (renamed from site/content/docs/5.2/helpers/vertical-rule.md)8
-rw-r--r--site/content/docs/5.3/helpers/visually-hidden.md (renamed from site/content/docs/5.2/helpers/visually-hidden.md)2
-rw-r--r--site/content/docs/5.3/layout/breakpoints.md (renamed from site/content/docs/5.2/layout/breakpoints.md)8
-rw-r--r--site/content/docs/5.3/layout/columns.md (renamed from site/content/docs/5.2/layout/columns.md)25
-rw-r--r--site/content/docs/5.3/layout/containers.md (renamed from site/content/docs/5.2/layout/containers.md)24
-rw-r--r--site/content/docs/5.3/layout/css-grid.md (renamed from site/content/docs/5.2/layout/css-grid.md)0
-rw-r--r--site/content/docs/5.3/layout/grid.md (renamed from site/content/docs/5.2/layout/grid.md)8
-rw-r--r--site/content/docs/5.3/layout/gutters.md (renamed from site/content/docs/5.2/layout/gutters.md)56
-rw-r--r--site/content/docs/5.3/layout/utilities.md (renamed from site/content/docs/5.2/layout/utilities.md)0
-rw-r--r--site/content/docs/5.3/layout/z-index.md (renamed from site/content/docs/5.2/layout/z-index.md)0
-rw-r--r--site/content/docs/5.3/migration.md (renamed from site/content/docs/5.2/migration.md)239
-rw-r--r--site/content/docs/5.3/utilities/api.md (renamed from site/content/docs/5.2/utilities/api.md)9
-rw-r--r--site/content/docs/5.3/utilities/background.md (renamed from site/content/docs/5.2/utilities/background.md)42
-rw-r--r--site/content/docs/5.3/utilities/borders.md (renamed from site/content/docs/5.2/utilities/borders.md)30
-rw-r--r--site/content/docs/5.3/utilities/colors.md (renamed from site/content/docs/5.2/utilities/colors.md)46
-rw-r--r--site/content/docs/5.3/utilities/display.md (renamed from site/content/docs/5.2/utilities/display.md)10
-rw-r--r--site/content/docs/5.3/utilities/flex.md (renamed from site/content/docs/5.2/utilities/flex.md)100
-rw-r--r--site/content/docs/5.3/utilities/float.md (renamed from site/content/docs/5.2/utilities/float.md)4
-rw-r--r--site/content/docs/5.3/utilities/interactions.md (renamed from site/content/docs/5.2/utilities/interactions.md)6
-rw-r--r--site/content/docs/5.3/utilities/link.md105
-rw-r--r--site/content/docs/5.3/utilities/object-fit.md63
-rw-r--r--site/content/docs/5.3/utilities/opacity.md (renamed from site/content/docs/5.2/utilities/opacity.md)4
-rw-r--r--site/content/docs/5.3/utilities/overflow.md99
-rw-r--r--site/content/docs/5.3/utilities/position.md (renamed from site/content/docs/5.2/utilities/position.md)18
-rw-r--r--site/content/docs/5.3/utilities/shadows.md (renamed from site/content/docs/5.2/utilities/shadows.md)16
-rw-r--r--site/content/docs/5.3/utilities/sizing.md62
-rw-r--r--site/content/docs/5.3/utilities/spacing.md (renamed from site/content/docs/5.2/utilities/spacing.md)49
-rw-r--r--site/content/docs/5.3/utilities/text.md (renamed from site/content/docs/5.2/utilities/text.md)17
-rw-r--r--site/content/docs/5.3/utilities/vertical-align.md (renamed from site/content/docs/5.2/utilities/vertical-align.md)4
-rw-r--r--site/content/docs/5.3/utilities/visibility.md (renamed from site/content/docs/5.2/utilities/visibility.md)4
-rw-r--r--site/content/docs/5.3/utilities/z-index.md50
-rw-r--r--site/content/docs/_index.html2
-rw-r--r--site/content/docs/versions.md8
214 files changed, 5966 insertions, 3499 deletions
diff --git a/site/content/docs/5.2/_index.html b/site/content/docs/5.2/_index.html
deleted file mode 100644
index fe65dc3..0000000
--- a/site/content/docs/5.2/_index.html
+++ /dev/null
@@ -1,5 +0,0 @@
----
-layout: redirect
-sitemap_exclude: true
-redirect: "/docs/5.2/getting-started/introduction/"
----
diff --git a/site/content/docs/5.2/components/close-button.md b/site/content/docs/5.2/components/close-button.md
deleted file mode 100644
index f4a3ed0..0000000
--- a/site/content/docs/5.2/components/close-button.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-layout: docs
-title: Close button
-description: A generic close button for dismissing content like modals and alerts.
-group: components
-toc: true
----
-
-## Example
-
-Provide an option to dismiss or close a component with `.btn-close`. Default styling is limited, but highly customizable. Modify the Sass variables to replace the default `background-image`. **Be sure to include text for screen readers**, as we've done with `aria-label`.
-
-{{< example >}}
-<button type="button" class="btn-close" aria-label="Close"></button>
-{{< /example >}}
-
-## Disabled state
-
-Disabled close buttons change their `opacity`. We've also applied `pointer-events: none` and `user-select: none` to preventing hover and active states from triggering.
-
-{{< example >}}
-<button type="button" class="btn-close" disabled aria-label="Close"></button>
-{{< /example >}}
-
-## White variant
-
-Change the default `.btn-close` to be white with the `.btn-close-white` class. This class uses the `filter` property to invert the `background-image`.
-
-{{< example class="bg-dark" >}}
-<button type="button" class="btn-close btn-close-white" aria-label="Close"></button>
-<button type="button" class="btn-close btn-close-white" disabled aria-label="Close"></button>
-{{< /example >}}
-
-## Sass
-
-### Variables
-
-{{< scss-docs name="close-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/components/progress.md b/site/content/docs/5.2/components/progress.md
deleted file mode 100644
index aa79368..0000000
--- a/site/content/docs/5.2/components/progress.md
+++ /dev/null
@@ -1,154 +0,0 @@
----
-layout: docs
-title: Progress
-description: Documentation and examples for using Bootstrap custom progress bars featuring support for stacked bars, animated backgrounds, and text labels.
-group: components
-toc: true
----
-
-## How it works
-
-Progress components are built with two HTML elements, some CSS to set the width, and a few attributes. We don't use [the HTML5 `<progress>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/progress), ensuring you can stack progress bars, animate them, and place text labels over them.
-
-- We use the `.progress` as a wrapper to indicate the max value of the progress bar.
-- We use the inner `.progress-bar` to indicate the progress so far.
-- The `.progress-bar` requires an inline style, utility class, or custom CSS to set their width.
-- The `.progress-bar` also requires some `role` and `aria` attributes to make it accessible, including an accessible name (using `aria-label`, `aria-labelledby`, or similar).
-
-Put that all together, and you have the following examples.
-
-{{< example >}}
-<div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Basic example" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Basic example" style="width: 25%" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Basic example" style="width: 50%" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Basic example" style="width: 75%" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Basic example" style="width: 100%" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-{{< /example >}}
-
-Bootstrap provides a handful of [utilities for setting width]({{< docsref "/utilities/sizing" >}}). Depending on your needs, these may help with quickly configuring progress.
-
-{{< example >}}
-<div class="progress">
- <div class="progress-bar w-75" role="progressbar" aria-label="Basic example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-{{< /example >}}
-
-## Labels
-
-Add labels to your progress bars by placing text within the `.progress-bar`.
-
-{{< example >}}
-<div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Example with label" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">25%</div>
-</div>
-{{< /example >}}
-
-## Height
-
-We only set a `height` value on the `.progress`, so if you change that value the inner `.progress-bar` will automatically resize accordingly.
-
-{{< example >}}
-<div class="progress" style="height: 1px;">
- <div class="progress-bar" role="progressbar" aria-label="Example 1px high" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress" style="height: 20px;">
- <div class="progress-bar" role="progressbar" aria-label="Example 20px high" style="width: 25%;" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-{{< /example >}}
-
-## Backgrounds
-
-Use background utility classes to change the appearance of individual progress bars.
-
-{{< example >}}
-<div class="progress">
- <div class="progress-bar bg-success" role="progressbar" aria-label="Success example" style="width: 25%" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar bg-info" role="progressbar" aria-label="Info example" style="width: 50%" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar bg-warning" role="progressbar" aria-label="Warning example" style="width: 75%" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar bg-danger" role="progressbar" aria-label="Danger example" style="width: 100%" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-{{< /example >}}
-
-{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
-{{< /callout >}}
-
-## Multiple bars
-
-Include multiple progress bars in a progress component if you need.
-
-{{< example >}}
-<div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Segment one" style="width: 15%" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100"></div>
- <div class="progress-bar bg-success" role="progressbar" aria-label="Segment two" style="width: 30%" aria-valuenow="30" aria-valuemin="0" aria-valuemax="100"></div>
- <div class="progress-bar bg-info" role="progressbar" aria-label="Segment three" style="width: 20%" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-{{< /example >}}
-
-## Striped
-
-Add `.progress-bar-striped` to any `.progress-bar` to apply a stripe via CSS gradient over the progress bar's background color.
-
-{{< example >}}
-<div class="progress">
- <div class="progress-bar progress-bar-striped" role="progressbar" aria-label="Default striped example" style="width: 10%" aria-valuenow="10" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar progress-bar-striped bg-success" role="progressbar" aria-label="Success striped example" style="width: 25%" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar progress-bar-striped bg-info" role="progressbar" aria-label="Info striped example" style="width: 50%" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar progress-bar-striped bg-warning" role="progressbar" aria-label="Warning striped example" style="width: 75%" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-<div class="progress">
- <div class="progress-bar progress-bar-striped bg-danger" role="progressbar" aria-label="Danger striped example" style="width: 100%" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100"></div>
-</div>
-{{< /example >}}
-
-## Animated stripes
-
-The striped gradient can also be animated. Add `.progress-bar-animated` to `.progress-bar` to animate the stripes right to left via CSS3 animations.
-
-{{< example >}}
-<div class="progress">
- <div class="progress-bar progress-bar-striped progress-bar-animated" role="progressbar" aria-label="Animated striped example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100" style="width: 75%"></div>
-</div>
-{{< /example >}}
-
-## CSS
-
-### Variables
-
-{{< added-in "5.2.0" >}}
-
-As part of Bootstrap's evolving CSS variables approach, progress bars now use local CSS variables on `.progress` for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.
-
-{{< scss-docs name="progress-css-vars" file="scss/_progress.scss" >}}
-
-### Sass variables
-
-{{< scss-docs name="progress-variables" file="scss/_variables.scss" >}}
-
-### Keyframes
-
-Used for creating the CSS animations for `.progress-bar-animated`. Included in `scss/_progress-bar.scss`.
-
-{{< scss-docs name="progress-keyframes" file="scss/_progress.scss" >}}
diff --git a/site/content/docs/5.2/customize/color.md b/site/content/docs/5.2/customize/color.md
deleted file mode 100644
index 23a7f71..0000000
--- a/site/content/docs/5.2/customize/color.md
+++ /dev/null
@@ -1,151 +0,0 @@
----
-layout: docs
-title: Color
-description: Bootstrap is supported by an extensive color system that themes our styles and components. This enables more comprehensive customization and extension for any project.
-group: customize
-toc: true
----
-
-## Theme colors
-
-We use a subset of all colors to create a smaller color palette for generating color schemes, also available as Sass variables and a Sass map in Bootstrap's `scss/_variables.scss` file.
-
-<div class="row">
- {{< theme-colors.inline >}}
- {{- range (index $.Site.Data "theme-colors") }}
- <div class="col-md-4">
- <div class="p-3 mb-3 bg-{{ .name }} {{ if .contrast_color }}text-{{ .contrast_color }}{{ else }}text-white{{ end }}">{{ .name | title }}</div>
- </div>
- {{ end -}}
- {{< /theme-colors.inline >}}
-</div>
-
-All these colors are available as a Sass map, `$theme-colors`.
-
-{{< scss-docs name="theme-colors-map" file="scss/_variables.scss" >}}
-
-Check out [our Sass maps and loops docs]({{< docsref "/customize/sass#maps-and-loops" >}}) for how to modify these colors.
-
-## All colors
-
-All Bootstrap colors are available as Sass variables and a Sass map in `scss/_variables.scss` file. To avoid increased file sizes, we don't create text or background color classes for each of these variables. Instead, we choose a subset of these colors for a [theme palette](#theme-colors).
-
-Be sure to monitor contrast ratios as you customize colors. As shown below, we've added three contrast ratios to each of the main colors—one for the swatch's current colors, one for against white, and one for against black.
-
-<div class="row font-monospace">
- {{< theme-colors.inline >}}
- {{- range $color := $.Site.Data.colors }}
- {{- if (and (not (eq $color.name "white")) (not (eq $color.name "gray")) (not (eq $color.name "gray-dark"))) }}
- <div class="col-md-4 mb-3">
- <div class="p-3 mb-2 position-relative swatch-{{ $color.name }}">
- <strong class="d-block">${{ $color.name }}</strong>
- {{ $color.hex }}
- </div>
- {{ range (seq 100 100 900) }}
- <div class="p-3 bd-{{ $color.name }}-{{ . }}">${{ $color.name }}-{{ . }}</div>
- {{ end }}
- </div>
- {{ end -}}
- {{ end -}}
-
- <div class="col-md-4 mb-3">
- <div class="p-3 mb-2 position-relative swatch-gray-500">
- <strong class="d-block">$gray-500</strong>
- #adb5bd
- </div>
- {{- range $.Site.Data.grays }}
- <div class="p-3 bd-gray-{{ .name }}">$gray-{{ .name }}</div>
- {{ end -}}
- </div>
- {{< /theme-colors.inline >}}
-
- <div class="col-md-4 mb-3">
- <div class="p-3 mb-2 bd-black text-white">
- <strong class="d-block">$black</strong>
- #000
- </div>
- <div class="p-3 mb-2 bd-white border">
- <strong class="d-block">$white</strong>
- #fff
- </div>
- </div>
-</div>
-
-### Notes on Sass
-
-Sass cannot programmatically generate variables, so we manually created variables for every tint and shade ourselves. We specify the midpoint value (e.g., `$blue-500`) and use custom color functions to tint (lighten) or shade (darken) our colors via Sass's `mix()` color function.
-
-Using `mix()` is not the same as `lighten()` and `darken()`—the former blends the specified color with white or black, while the latter only adjusts the lightness value of each color. The result is a much more complete suite of colors, as [shown in this CodePen demo](https://codepen.io/emdeoh/pen/zYOQOPB).
-
-Our `tint-color()` and `shade-color()` functions use `mix()` alongside our `$theme-color-interval` variable, which specifies a stepped percentage value for each mixed color we produce. See the `scss/_functions.scss` and `scss/_variables.scss` files for the full source code.
-
-## Color Sass maps
-
-Bootstrap's source Sass files include three maps to help you quickly and easily loop over a list of colors and their hex values.
-
-- `$colors` lists all our available base (`500`) colors
-- `$theme-colors` lists all semantically named theme colors (shown below)
-- `$grays` lists all tints and shades of gray
-
-Within `scss/_variables.scss`, you'll find Bootstrap's color variables and Sass map. Here's an example of the `$colors` Sass map:
-
-{{< scss-docs name="colors-map" file="scss/_variables.scss" >}}
-
-Add, remove, or modify values within the map to update how they're used in many other components. Unfortunately at this time, not _every_ component utilizes this Sass map. Future updates will strive to improve upon this. Until then, plan on making use of the `${color}` variables and this Sass map.
-
-### Example
-
-Here's how you can use these in your Sass:
-
-```scss
-.alpha { color: $purple; }
-.beta {
- color: $yellow-300;
- background-color: $indigo-900;
-}
-```
-
-[Color]({{< docsref "/utilities/colors" >}}) and [background]({{< docsref "/utilities/background" >}}) utility classes are also available for setting `color` and `background-color` using the `500` color values.
-
-## Generating utilities
-
-{{< added-in "5.1.0" >}}
-
-Bootstrap doesn't include `color` and `background-color` utilities for every color variable, but you can generate these yourself with our [utility API]({{< docsref "/utilities/api" >}}) and our extended Sass maps added in v5.1.0.
-
-1. To start, make sure you've imported our functions, variables, mixins, and utilities.
-2. Use our `map-merge-multiple()` function to quickly merge multiple Sass maps together in a new map.
-3. Merge this new combined map to extend any utility with a `{color}-{level}` class name.
-
-Here's an example that generates text color utilities (e.g., `.text-purple-500`) using the above steps.
-
-```scss
-@import "bootstrap/scss/functions";
-@import "bootstrap/scss/variables";
-@import "bootstrap/scss/maps";
-@import "bootstrap/scss/mixins";
-@import "bootstrap/scss/utilities";
-
-$all-colors: map-merge-multiple($blues, $indigos, $purples, $pinks, $reds, $oranges, $yellows, $greens, $teals, $cyans);
-
-$utilities: map-merge(
- $utilities,
- (
- "color": map-merge(
- map-get($utilities, "color"),
- (
- values: map-merge(
- map-get(map-get($utilities, "color"), "values"),
- (
- $all-colors
- ),
- ),
- ),
- ),
- )
-);
-
-@import "bootstrap/scss/utilities/api";
-```
-
-This will generate new `.text-{color}-{level}` utilities for every color and level. You can do the same for any other utility and property as well.
diff --git a/site/content/docs/5.2/examples/.stylelintrc b/site/content/docs/5.2/examples/.stylelintrc
deleted file mode 100644
index 79ea92d..0000000
--- a/site/content/docs/5.2/examples/.stylelintrc
+++ /dev/null
@@ -1,15 +0,0 @@
-{
- "extends": [
- "stylelint-config-twbs-bootstrap"
- ],
- "rules": {
- "at-rule-no-vendor-prefix": null,
- "comment-empty-line-before": null,
- "media-feature-name-no-vendor-prefix": null,
- "property-disallowed-list": null,
- "property-no-vendor-prefix": null,
- "selector-no-qualifying-type": null,
- "selector-no-vendor-prefix": null,
- "value-no-vendor-prefix": null
- }
-}
diff --git a/site/content/docs/5.2/examples/_index.md b/site/content/docs/5.2/examples/_index.md
deleted file mode 100644
index 4668883..0000000
--- a/site/content/docs/5.2/examples/_index.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-layout: single
-title: Examples
-description: Quickly get a project started with any of our examples ranging from using parts of the framework to custom components and layouts.
-aliases: "/examples/"
----
-
-{{< list-examples.inline >}}
-{{ range $entry := $.Site.Data.examples -}}
-<div class="row g-lg-5 mb-5">
- <div class="bd-content col-lg-3">
- <h2 id="{{ $entry.category | urlize }}">{{ $entry.category }}</h2>
- <p>{{ $entry.description }}</p>
- {{ if eq $entry.category "RTL" -}}
- <div class="bd-callout bd-callout-warning small">
- <p>
- <strong>RTL is still experimental</strong> and will evolve with feedback. Spotted something or have an improvement to suggest?
- </p>
- <p><a href="{{ $.Site.Params.repo }}/issues/new/choose">Please open an issue.</a></p>
- </div>
- {{ end -}}
- </div>
-
- <div class="col-lg-9">
- {{ range $i, $example := $entry.examples -}}
- {{- $len := len $entry.examples -}}
- {{ if (eq $i 0) }}<div class="row">{{ end }}
- <div class="col-sm-6 col-md-4 mb-3">
- <a class="d-block" href="/docs/{{ $.Site.Params.docs_version }}/examples/{{ $example.name | urlize }}/"{{ if in $example.name "RTL" }} hreflang="ar"{{ end }}>
- <img class="img-thumbnail mb-3" srcset="/docs/{{ $.Site.Params.docs_version }}/assets/img/examples/{{ $example.name | urlize }}.png,
- /docs/{{ $.Site.Params.docs_version }}/assets/img/examples/{{ $example.name | urlize }}@2x.png 2x"
- src="/docs/{{ $.Site.Params.docs_version }}/assets/img/examples/{{ $example.name | urlize }}.png"
- alt=""
- width="480" height="300"
- loading="lazy">
- <h3 class="h5 mb-1">{{ $example.name }}</h3>
- </a>
- <p class="text-muted">{{ $example.description }}</p>
- </div>
- {{ if (eq (add $i 1) $len) }}</div>{{ end }}
- {{ end -}}
- </div>
-</div>
-{{ end -}}
-{{< /list-examples.inline >}}
diff --git a/site/content/docs/5.2/examples/dashboard-rtl/index.html b/site/content/docs/5.2/examples/dashboard-rtl/index.html
deleted file mode 100644
index bc41cc6..0000000
--- a/site/content/docs/5.2/examples/dashboard-rtl/index.html
+++ /dev/null
@@ -1,253 +0,0 @@
----
-layout: examples
-title: قالب لوحة القيادة
-direction: rtl
-extra_css:
- - "../dashboard/dashboard.rtl.css"
-extra_js:
- - src: "https://cdn.jsdelivr.net/npm/feather-icons@4.28.0/dist/feather.min.js"
- integrity: "sha384-uO3SXW5IuS1ZpFPKugNNWqTZRRglnUJK6UAZ/gxOX80nxEkN9NcGZTftn6RzhGWE"
- - src: "https://cdn.jsdelivr.net/npm/chart.js@2.9.4/dist/Chart.min.js"
- integrity: "sha384-zNy6FEbO50N+Cg5wap8IKA4M/ZnLJgzc6w2NqACZaK0u0FXfOWRRJOnQtpZun8ha"
- - src: "dashboard.js"
----
-
-<header class="navbar navbar-dark sticky-top bg-dark flex-md-nowrap p-0 shadow">
- <a class="navbar-brand col-md-3 col-lg-2 me-0 px-3 fs-6" href="#">اسم الشركة</a>
- <button class="navbar-toggler position-absolute d-md-none collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#sidebarMenu" aria-controls="sidebarMenu" aria-expanded="false" aria-label="عرض/إخفاء لوحة التنقل">
- <span class="navbar-toggler-icon"></span>
- </button>
- <input class="form-control form-control-dark w-100 rounded-0 border-0" type="text" placeholder="بحث" aria-label="بحث">
- <div class="navbar-nav">
- <div class="nav-item text-nowrap">
- <a class="nav-link px-3" href="#">تسجيل الخروج</a>
- </div>
- </div>
-</header>
-
-<div class="container-fluid">
- <div class="row">
- <nav id="sidebarMenu" class="col-md-3 col-lg-2 d-md-block bg-light sidebar collapse">
- <div class="position-sticky pt-3 sidebar-sticky">
- <ul class="nav flex-column">
- <li class="nav-item">
- <a class="nav-link active" aria-current="page" href="#">
- <span data-feather="home" class="align-text-bottom"></span>
- لوحة القيادة
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file" class="align-text-bottom"></span>
- الطلبات
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="shopping-cart" class="align-text-bottom"></span>
- المنتجات
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="users" class="align-text-bottom"></span>
- الزبائن
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="bar-chart-2" class="align-text-bottom"></span>
- التقارير
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="layers" class="align-text-bottom"></span>
- التكاملات
- </a>
- </li>
- </ul>
-
- <h6 class="sidebar-heading d-flex justify-content-between align-items-center px-3 mt-4 mb-1 text-muted text-uppercase">
- <span>التقارير المحفوظة</span>
- <a class="link-secondary" href="#" aria-label="إضافة تقرير جديد">
- <span data-feather="plus-circle" class="align-text-bottom"></span>
- </a>
- </h6>
- <ul class="nav flex-column mb-2">
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- الشهر الحالي
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- الربع الأخير
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- التفاعل الإجتماعي
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- مبيعات نهاية العام
- </a>
- </li>
- </ul>
- </div>
- </nav>
-
- <main class="col-md-9 ms-sm-auto col-lg-10 px-md-4">
- <div class="d-flex justify-content-between flex-wrap flex-md-nowrap align-items-center pt-3 pb-2 mb-3 border-bottom">
- <h1 class="h2">لوحة القيادة</h1>
- <div class="btn-toolbar mb-2 mb-md-0">
- <div class="btn-group me-2">
- <button type="button" class="btn btn-sm btn-outline-secondary">مشاركة</button>
- <button type="button" class="btn btn-sm btn-outline-secondary">تصدير</button>
- </div>
- <button type="button" class="btn btn-sm btn-outline-secondary dropdown-toggle">
- <span data-feather="calendar" class="align-text-bottom"></span>
- هذا الأسبوع
- </button>
- </div>
- </div>
-
- <canvas class="my-4 w-100" id="myChart" width="900" height="380"></canvas>
-
- <h2>عنوان القسم</h2>
- <div class="table-responsive">
- <table class="table table-striped table-sm">
- <thead>
- <tr>
- <th scope="col">#</th>
- <th scope="col">عنوان</th>
- <th scope="col">عنوان</th>
- <th scope="col">عنوان</th>
- <th scope="col">عنوان</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>1,001</td>
- <td>بيانات</td>
- <td>عشوائية</td>
- <td>تثري</td>
- <td>الجدول</td>
- </tr>
- <tr>
- <td>1,002</td>
- <td>تثري</td>
- <td>مبهة</td>
- <td>تصميم</td>
- <td>تنسيق</td>
- </tr>
- <tr>
- <td>1,003</td>
- <td>عشوائية</td>
- <td>غنية</td>
- <td>قيمة</td>
- <td>مفيدة</td>
- </tr>
- <tr>
- <td>1,003</td>
- <td>معلومات</td>
- <td>تثري</td>
- <td>توضيحية</td>
- <td>عشوائية</td>
- </tr>
- <tr>
- <td>1,004</td>
- <td>الجدول</td>
- <td>بيانات</td>
- <td>تنسيق</td>
- <td>قيمة</td>
- </tr>
- <tr>
- <td>1,005</td>
- <td>قيمة</td>
- <td>مبهة</td>
- <td>الجدول</td>
- <td>تثري</td>
- </tr>
- <tr>
- <td>1,006</td>
- <td>قيمة</td>
- <td>توضيحية</td>
- <td>غنية</td>
- <td>عشوائية</td>
- </tr>
- <tr>
- <td>1,007</td>
- <td>تثري</td>
- <td>مفيدة</td>
- <td>معلومات</td>
- <td>مبهة</td>
- </tr>
- <tr>
- <td>1,008</td>
- <td>بيانات</td>
- <td>عشوائية</td>
- <td>تثري</td>
- <td>الجدول</td>
- </tr>
- <tr>
- <td>1,009</td>
- <td>تثري</td>
- <td>مبهة</td>
- <td>تصميم</td>
- <td>تنسيق</td>
- </tr>
- <tr>
- <td>1,010</td>
- <td>عشوائية</td>
- <td>غنية</td>
- <td>قيمة</td>
- <td>مفيدة</td>
- </tr>
- <tr>
- <td>1,011</td>
- <td>معلومات</td>
- <td>تثري</td>
- <td>توضيحية</td>
- <td>عشوائية</td>
- </tr>
- <tr>
- <td>1,012</td>
- <td>الجدول</td>
- <td>تثري</td>
- <td>تنسيق</td>
- <td>قيمة</td>
- </tr>
- <tr>
- <td>1,013</td>
- <td>قيمة</td>
- <td>مبهة</td>
- <td>الجدول</td>
- <td>تصميم</td>
- </tr>
- <tr>
- <td>1,014</td>
- <td>قيمة</td>
- <td>توضيحية</td>
- <td>غنية</td>
- <td>عشوائية</td>
- </tr>
- <tr>
- <td>1,015</td>
- <td>بيانات</td>
- <td>مفيدة</td>
- <td>معلومات</td>
- <td>الجدول</td>
- </tr>
- </tbody>
- </table>
- </div>
- </main>
- </div>
-</div>
diff --git a/site/content/docs/5.2/examples/dashboard/dashboard.css b/site/content/docs/5.2/examples/dashboard/dashboard.css
deleted file mode 100644
index ad12048..0000000
--- a/site/content/docs/5.2/examples/dashboard/dashboard.css
+++ /dev/null
@@ -1,92 +0,0 @@
-body {
- font-size: .875rem;
-}
-
-.feather {
- width: 16px;
- height: 16px;
-}
-
-/*
- * Sidebar
- */
-
-.sidebar {
- position: fixed;
- top: 0;
- /* rtl:raw:
- right: 0;
- */
- bottom: 0;
- /* rtl:remove */
- left: 0;
- z-index: 100; /* Behind the navbar */
- padding: 48px 0 0; /* Height of navbar */
- box-shadow: inset -1px 0 0 rgba(0, 0, 0, .1);
-}
-
-@media (max-width: 767.98px) {
- .sidebar {
- top: 5rem;
- }
-}
-
-.sidebar-sticky {
- height: calc(100vh - 48px);
- overflow-x: hidden;
- overflow-y: auto; /* Scrollable contents if viewport is shorter than content. */
-}
-
-.sidebar .nav-link {
- font-weight: 500;
- color: #333;
-}
-
-.sidebar .nav-link .feather {
- margin-right: 4px;
- color: #727272;
-}
-
-.sidebar .nav-link.active {
- color: #2470dc;
-}
-
-.sidebar .nav-link:hover .feather,
-.sidebar .nav-link.active .feather {
- color: inherit;
-}
-
-.sidebar-heading {
- font-size: .75rem;
-}
-
-/*
- * Navbar
- */
-
-.navbar-brand {
- padding-top: .75rem;
- padding-bottom: .75rem;
- background-color: rgba(0, 0, 0, .25);
- box-shadow: inset -1px 0 0 rgba(0, 0, 0, .25);
-}
-
-.navbar .navbar-toggler {
- top: .25rem;
- right: 1rem;
-}
-
-.navbar .form-control {
- padding: .75rem 1rem;
-}
-
-.form-control-dark {
- color: #fff;
- background-color: rgba(255, 255, 255, .1);
- border-color: rgba(255, 255, 255, .1);
-}
-
-.form-control-dark:focus {
- border-color: transparent;
- box-shadow: 0 0 0 3px rgba(255, 255, 255, .25);
-}
diff --git a/site/content/docs/5.2/examples/dashboard/dashboard.rtl.css b/site/content/docs/5.2/examples/dashboard/dashboard.rtl.css
deleted file mode 100644
index 31ea3cc..0000000
--- a/site/content/docs/5.2/examples/dashboard/dashboard.rtl.css
+++ /dev/null
@@ -1,88 +0,0 @@
-body {
- font-size: .875rem;
-}
-
-.feather {
- width: 16px;
- height: 16px;
-}
-
-/*
- * Sidebar
- */
-
-.sidebar {
- position: fixed;
- top: 0;
- right: 0;
- bottom: 0;
- z-index: 100; /* Behind the navbar */
- padding: 48px 0 0; /* Height of navbar */
- box-shadow: inset 1px 0 0 rgba(0, 0, 0, .1);
-}
-
-@media (max-width: 767.98px) {
- .sidebar {
- top: 5rem;
- }
-}
-
-.sidebar-sticky {
- height: calc(100vh - 48px);
- overflow-x: hidden;
- overflow-y: auto; /* Scrollable contents if viewport is shorter than content. */
-}
-
-.sidebar .nav-link {
- font-weight: 500;
- color: #333;
-}
-
-.sidebar .nav-link .feather {
- margin-left: 4px;
- color: #727272;
-}
-
-.sidebar .nav-link.active {
- color: #2470dc;
-}
-
-.sidebar .nav-link:hover .feather,
-.sidebar .nav-link.active .feather {
- color: inherit;
-}
-
-.sidebar-heading {
- font-size: .75rem;
-}
-
-/*
- * Navbar
- */
-
-.navbar-brand {
- padding-top: .75rem;
- padding-bottom: .75rem;
- background-color: rgba(0, 0, 0, .25);
- box-shadow: inset 1px 0 0 rgba(0, 0, 0, .25);
-}
-
-.navbar .navbar-toggler {
- top: .25rem;
- left: 1rem;
-}
-
-.navbar .form-control {
- padding: .75rem 1rem;
-}
-
-.form-control-dark {
- color: #fff;
- background-color: rgba(255, 255, 255, .1);
- border-color: rgba(255, 255, 255, .1);
-}
-
-.form-control-dark:focus {
- border-color: transparent;
- box-shadow: 0 0 0 3px rgba(255, 255, 255, .25);
-}
diff --git a/site/content/docs/5.2/examples/dashboard/index.html b/site/content/docs/5.2/examples/dashboard/index.html
deleted file mode 100644
index b3b40c2..0000000
--- a/site/content/docs/5.2/examples/dashboard/index.html
+++ /dev/null
@@ -1,252 +0,0 @@
----
-layout: examples
-title: Dashboard Template
-extra_css:
- - "dashboard.css"
-extra_js:
- - src: "https://cdn.jsdelivr.net/npm/feather-icons@4.28.0/dist/feather.min.js"
- integrity: "sha384-uO3SXW5IuS1ZpFPKugNNWqTZRRglnUJK6UAZ/gxOX80nxEkN9NcGZTftn6RzhGWE"
- - src: "https://cdn.jsdelivr.net/npm/chart.js@2.9.4/dist/Chart.min.js"
- integrity: "sha384-zNy6FEbO50N+Cg5wap8IKA4M/ZnLJgzc6w2NqACZaK0u0FXfOWRRJOnQtpZun8ha"
- - src: "dashboard.js"
----
-
-<header class="navbar navbar-dark sticky-top bg-dark flex-md-nowrap p-0 shadow">
- <a class="navbar-brand col-md-3 col-lg-2 me-0 px-3 fs-6" href="#">Company name</a>
- <button class="navbar-toggler position-absolute d-md-none collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#sidebarMenu" aria-controls="sidebarMenu" aria-expanded="false" aria-label="Toggle navigation">
- <span class="navbar-toggler-icon"></span>
- </button>
- <input class="form-control form-control-dark w-100 rounded-0 border-0" type="text" placeholder="Search" aria-label="Search">
- <div class="navbar-nav">
- <div class="nav-item text-nowrap">
- <a class="nav-link px-3" href="#">Sign out</a>
- </div>
- </div>
-</header>
-
-<div class="container-fluid">
- <div class="row">
- <nav id="sidebarMenu" class="col-md-3 col-lg-2 d-md-block bg-light sidebar collapse">
- <div class="position-sticky pt-3 sidebar-sticky">
- <ul class="nav flex-column">
- <li class="nav-item">
- <a class="nav-link active" aria-current="page" href="#">
- <span data-feather="home" class="align-text-bottom"></span>
- Dashboard
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file" class="align-text-bottom"></span>
- Orders
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="shopping-cart" class="align-text-bottom"></span>
- Products
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="users" class="align-text-bottom"></span>
- Customers
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="bar-chart-2" class="align-text-bottom"></span>
- Reports
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="layers" class="align-text-bottom"></span>
- Integrations
- </a>
- </li>
- </ul>
-
- <h6 class="sidebar-heading d-flex justify-content-between align-items-center px-3 mt-4 mb-1 text-muted text-uppercase">
- <span>Saved reports</span>
- <a class="link-secondary" href="#" aria-label="Add a new report">
- <span data-feather="plus-circle" class="align-text-bottom"></span>
- </a>
- </h6>
- <ul class="nav flex-column mb-2">
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- Current month
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- Last quarter
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- Social engagement
- </a>
- </li>
- <li class="nav-item">
- <a class="nav-link" href="#">
- <span data-feather="file-text" class="align-text-bottom"></span>
- Year-end sale
- </a>
- </li>
- </ul>
- </div>
- </nav>
-
- <main class="col-md-9 ms-sm-auto col-lg-10 px-md-4">
- <div class="d-flex justify-content-between flex-wrap flex-md-nowrap align-items-center pt-3 pb-2 mb-3 border-bottom">
- <h1 class="h2">Dashboard</h1>
- <div class="btn-toolbar mb-2 mb-md-0">
- <div class="btn-group me-2">
- <button type="button" class="btn btn-sm btn-outline-secondary">Share</button>
- <button type="button" class="btn btn-sm btn-outline-secondary">Export</button>
- </div>
- <button type="button" class="btn btn-sm btn-outline-secondary dropdown-toggle">
- <span data-feather="calendar" class="align-text-bottom"></span>
- This week
- </button>
- </div>
- </div>
-
- <canvas class="my-4 w-100" id="myChart" width="900" height="380"></canvas>
-
- <h2>Section title</h2>
- <div class="table-responsive">
- <table class="table table-striped table-sm">
- <thead>
- <tr>
- <th scope="col">#</th>
- <th scope="col">Header</th>
- <th scope="col">Header</th>
- <th scope="col">Header</th>
- <th scope="col">Header</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>1,001</td>
- <td>random</td>
- <td>data</td>
- <td>placeholder</td>
- <td>text</td>
- </tr>
- <tr>
- <td>1,002</td>
- <td>placeholder</td>
- <td>irrelevant</td>
- <td>visual</td>
- <td>layout</td>
- </tr>
- <tr>
- <td>1,003</td>
- <td>data</td>
- <td>rich</td>
- <td>dashboard</td>
- <td>tabular</td>
- </tr>
- <tr>
- <td>1,003</td>
- <td>information</td>
- <td>placeholder</td>
- <td>illustrative</td>
- <td>data</td>
- </tr>
- <tr>
- <td>1,004</td>
- <td>text</td>
- <td>random</td>
- <td>layout</td>
- <td>dashboard</td>
- </tr>
- <tr>
- <td>1,005</td>
- <td>dashboard</td>
- <td>irrelevant</td>
- <td>text</td>
- <td>placeholder</td>
- </tr>
- <tr>
- <td>1,006</td>
- <td>dashboard</td>
- <td>illustrative</td>
- <td>rich</td>
- <td>data</td>
- </tr>
- <tr>
- <td>1,007</td>
- <td>placeholder</td>
- <td>tabular</td>
- <td>information</td>
- <td>irrelevant</td>
- </tr>
- <tr>
- <td>1,008</td>
- <td>random</td>
- <td>data</td>
- <td>placeholder</td>
- <td>text</td>
- </tr>
- <tr>
- <td>1,009</td>
- <td>placeholder</td>
- <td>irrelevant</td>
- <td>visual</td>
- <td>layout</td>
- </tr>
- <tr>
- <td>1,010</td>
- <td>data</td>
- <td>rich</td>
- <td>dashboard</td>
- <td>tabular</td>
- </tr>
- <tr>
- <td>1,011</td>
- <td>information</td>
- <td>placeholder</td>
- <td>illustrative</td>
- <td>data</td>
- </tr>
- <tr>
- <td>1,012</td>
- <td>text</td>
- <td>placeholder</td>
- <td>layout</td>
- <td>dashboard</td>
- </tr>
- <tr>
- <td>1,013</td>
- <td>dashboard</td>
- <td>irrelevant</td>
- <td>text</td>
- <td>visual</td>
- </tr>
- <tr>
- <td>1,014</td>
- <td>dashboard</td>
- <td>illustrative</td>
- <td>rich</td>
- <td>data</td>
- </tr>
- <tr>
- <td>1,015</td>
- <td>random</td>
- <td>tabular</td>
- <td>information</td>
- <td>text</td>
- </tr>
- </tbody>
- </table>
- </div>
- </main>
- </div>
-</div>
diff --git a/site/content/docs/5.2/examples/dropdowns/index.html b/site/content/docs/5.2/examples/dropdowns/index.html
deleted file mode 100644
index f08f697..0000000
--- a/site/content/docs/5.2/examples/dropdowns/index.html
+++ /dev/null
@@ -1,338 +0,0 @@
----
-layout: examples
-title: Dropdowns
-extra_css:
- - "dropdowns.css"
-body_class: ""
----
-
-<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
- <symbol id="bootstrap" viewBox="0 0 118 94">
- <title>Bootstrap</title>
- <path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z"></path>
- </symbol>
-
- <symbol id="exclamation-triangle-fill" viewBox="0 0 16 16">
- <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
- </symbol>
-
- <symbol id="check2" viewBox="0 0 16 16">
- <path d="M13.854 3.646a.5.5 0 0 1 0 .708l-7 7a.5.5 0 0 1-.708 0l-3.5-3.5a.5.5 0 1 1 .708-.708L6.5 10.293l6.646-6.647a.5.5 0 0 1 .708 0z"/>
- </symbol>
-
- <symbol id="check2-circle" viewBox="0 0 16 16">
- <path d="M2.5 8a5.5 5.5 0 0 1 8.25-4.764.5.5 0 0 0 .5-.866A6.5 6.5 0 1 0 14.5 8a.5.5 0 0 0-1 0 5.5 5.5 0 1 1-11 0z"/>
- <path d="M15.354 3.354a.5.5 0 0 0-.708-.708L8 9.293 5.354 6.646a.5.5 0 1 0-.708.708l3 3a.5.5 0 0 0 .708 0l7-7z"/>
- </symbol>
-
- <symbol id="bookmark-star" viewBox="0 0 16 16">
- <path d="M7.84 4.1a.178.178 0 0 1 .32 0l.634 1.285a.178.178 0 0 0 .134.098l1.42.206c.145.021.204.2.098.303L9.42 6.993a.178.178 0 0 0-.051.158l.242 1.414a.178.178 0 0 1-.258.187l-1.27-.668a.178.178 0 0 0-.165 0l-1.27.668a.178.178 0 0 1-.257-.187l.242-1.414a.178.178 0 0 0-.05-.158l-1.03-1.001a.178.178 0 0 1 .098-.303l1.42-.206a.178.178 0 0 0 .134-.098L7.84 4.1z"/>
- <path d="M2 2a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v13.5a.5.5 0 0 1-.777.416L8 13.101l-5.223 2.815A.5.5 0 0 1 2 15.5V2zm2-1a1 1 0 0 0-1 1v12.566l4.723-2.482a.5.5 0 0 1 .554 0L13 14.566V2a1 1 0 0 0-1-1H4z"/>
- </symbol>
-
- <symbol id="grid-fill" viewBox="0 0 16 16">
- <path d="M1 2.5A1.5 1.5 0 0 1 2.5 1h3A1.5 1.5 0 0 1 7 2.5v3A1.5 1.5 0 0 1 5.5 7h-3A1.5 1.5 0 0 1 1 5.5v-3zm8 0A1.5 1.5 0 0 1 10.5 1h3A1.5 1.5 0 0 1 15 2.5v3A1.5 1.5 0 0 1 13.5 7h-3A1.5 1.5 0 0 1 9 5.5v-3zm-8 8A1.5 1.5 0 0 1 2.5 9h3A1.5 1.5 0 0 1 7 10.5v3A1.5 1.5 0 0 1 5.5 15h-3A1.5 1.5 0 0 1 1 13.5v-3zm8 0A1.5 1.5 0 0 1 10.5 9h3a1.5 1.5 0 0 1 1.5 1.5v3a1.5 1.5 0 0 1-1.5 1.5h-3A1.5 1.5 0 0 1 9 13.5v-3z"/>
- </symbol>
-
- <symbol id="stars" viewBox="0 0 16 16">
- <path d="M7.657 6.247c.11-.33.576-.33.686 0l.645 1.937a2.89 2.89 0 0 0 1.829 1.828l1.936.645c.33.11.33.576 0 .686l-1.937.645a2.89 2.89 0 0 0-1.828 1.829l-.645 1.936a.361.361 0 0 1-.686 0l-.645-1.937a2.89 2.89 0 0 0-1.828-1.828l-1.937-.645a.361.361 0 0 1 0-.686l1.937-.645a2.89 2.89 0 0 0 1.828-1.828l.645-1.937zM3.794 1.148a.217.217 0 0 1 .412 0l.387 1.162c.173.518.579.924 1.097 1.097l1.162.387a.217.217 0 0 1 0 .412l-1.162.387A1.734 1.734 0 0 0 4.593 5.69l-.387 1.162a.217.217 0 0 1-.412 0L3.407 5.69A1.734 1.734 0 0 0 2.31 4.593l-1.162-.387a.217.217 0 0 1 0-.412l1.162-.387A1.734 1.734 0 0 0 3.407 2.31l.387-1.162zM10.863.099a.145.145 0 0 1 .274 0l.258.774c.115.346.386.617.732.732l.774.258a.145.145 0 0 1 0 .274l-.774.258a1.156 1.156 0 0 0-.732.732l-.258.774a.145.145 0 0 1-.274 0l-.258-.774a1.156 1.156 0 0 0-.732-.732L9.1 2.137a.145.145 0 0 1 0-.274l.774-.258c.346-.115.617-.386.732-.732L10.863.1z"/>
- </symbol>
-
- <symbol id="film" viewBox="0 0 16 16">
- <path d="M0 1a1 1 0 0 1 1-1h14a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H1a1 1 0 0 1-1-1V1zm4 0v6h8V1H4zm8 8H4v6h8V9zM1 1v2h2V1H1zm2 3H1v2h2V4zM1 7v2h2V7H1zm2 3H1v2h2v-2zm-2 3v2h2v-2H1zM15 1h-2v2h2V1zm-2 3v2h2V4h-2zm2 3h-2v2h2V7zm-2 3v2h2v-2h-2zm2 3h-2v2h2v-2z"/>
- </symbol>
-
- <symbol id="joystick" viewBox="0 0 16 16">
- <path d="M10 2a2 2 0 0 1-1.5 1.937v5.087c.863.083 1.5.377 1.5.726 0 .414-.895.75-2 .75s-2-.336-2-.75c0-.35.637-.643 1.5-.726V3.937A2 2 0 1 1 10 2z"/>
- <path d="M0 9.665v1.717a1 1 0 0 0 .553.894l6.553 3.277a2 2 0 0 0 1.788 0l6.553-3.277a1 1 0 0 0 .553-.894V9.665c0-.1-.06-.19-.152-.23L9.5 6.715v.993l5.227 2.178a.125.125 0 0 1 .001.23l-5.94 2.546a2 2 0 0 1-1.576 0l-5.94-2.546a.125.125 0 0 1 .001-.23L6.5 7.708l-.013-.988L.152 9.435a.25.25 0 0 0-.152.23z"/>
- </symbol>
-
- <symbol id="music-note-beamed" viewBox="0 0 16 16">
- <path d="M6 13c0 1.105-1.12 2-2.5 2S1 14.105 1 13c0-1.104 1.12-2 2.5-2s2.5.896 2.5 2zm9-2c0 1.105-1.12 2-2.5 2s-2.5-.895-2.5-2 1.12-2 2.5-2 2.5.895 2.5 2z"/>
- <path fill-rule="evenodd" d="M14 11V2h1v9h-1zM6 3v10H5V3h1z"/>
- <path d="M5 2.905a1 1 0 0 1 .9-.995l8-.8a1 1 0 0 1 1.1.995V3L5 4V2.905z"/>
- </symbol>
-
- <symbol id="files" viewBox="0 0 16 16">
- <path d="M13 0H6a2 2 0 0 0-2 2 2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h7a2 2 0 0 0 2-2 2 2 0 0 0 2-2V2a2 2 0 0 0-2-2zm0 13V4a2 2 0 0 0-2-2H5a1 1 0 0 1 1-1h7a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1zM3 4a1 1 0 0 1 1-1h7a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V4z"/>
- </symbol>
-
- <symbol id="image-fill" viewBox="0 0 16 16">
- <path d="M.002 3a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2h-12a2 2 0 0 1-2-2V3zm1 9v1a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1V9.5l-3.777-1.947a.5.5 0 0 0-.577.093l-3.71 3.71-2.66-1.772a.5.5 0 0 0-.63.062L1.002 12zm5-6.5a1.5 1.5 0 1 0-3 0 1.5 1.5 0 0 0 3 0z"/>
- </symbol>
-
- <symbol id="trash" viewBox="0 0 16 16">
- <path d="M5.5 5.5A.5.5 0 0 1 6 6v6a.5.5 0 0 1-1 0V6a.5.5 0 0 1 .5-.5zm2.5 0a.5.5 0 0 1 .5.5v6a.5.5 0 0 1-1 0V6a.5.5 0 0 1 .5-.5zm3 .5a.5.5 0 0 0-1 0v6a.5.5 0 0 0 1 0V6z"/>
- <path fill-rule="evenodd" d="M14.5 3a1 1 0 0 1-1 1H13v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V4h-.5a1 1 0 0 1-1-1V2a1 1 0 0 1 1-1H6a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1h3.5a1 1 0 0 1 1 1v1zM4.118 4 4 4.059V13a1 1 0 0 0 1 1h6a1 1 0 0 0 1-1V4.059L11.882 4H4.118zM2.5 3V2h11v1h-11z"/>
- </symbol>
-
- <symbol id="question-circle" viewBox="0 0 16 16">
- <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
- <path d="M5.255 5.786a.237.237 0 0 0 .241.247h.825c.138 0 .248-.113.266-.25.09-.656.54-1.134 1.342-1.134.686 0 1.314.343 1.314 1.168 0 .635-.374.927-.965 1.371-.673.489-1.206 1.06-1.168 1.987l.003.217a.25.25 0 0 0 .25.246h.811a.25.25 0 0 0 .25-.25v-.105c0-.718.273-.927 1.01-1.486.609-.463 1.244-.977 1.244-2.056 0-1.511-1.276-2.241-2.673-2.241-1.267 0-2.655.59-2.75 2.286zm1.557 5.763c0 .533.425.927 1.01.927.609 0 1.028-.394 1.028-.927 0-.552-.42-.94-1.029-.94-.584 0-1.009.388-1.009.94z"/>
- </symbol>
-
- <symbol id="arrow-left-short" viewBox="0 0 16 16">
- <path fill-rule="evenodd" d="M12 8a.5.5 0 0 1-.5.5H5.707l2.147 2.146a.5.5 0 0 1-.708.708l-3-3a.5.5 0 0 1 0-.708l3-3a.5.5 0 1 1 .708.708L5.707 7.5H11.5a.5.5 0 0 1 .5.5z"/>
- </symbol>
-
- <symbol id="arrow-right-short" viewBox="0 0 16 16">
- <path fill-rule="evenodd" d="M4 8a.5.5 0 0 1 .5-.5h5.793L8.146 5.354a.5.5 0 1 1 .708-.708l3 3a.5.5 0 0 1 0 .708l-3 3a.5.5 0 0 1-.708-.708L10.293 8.5H4.5A.5.5 0 0 1 4 8z"/>
- </symbol>
-</svg>
-
-<div class="d-flex gap-5 justify-content-center">
- <ul class="dropdown-menu position-static d-grid gap-1 p-2 rounded-3 mx-0 shadow w-220px">
- <li><a class="dropdown-item rounded-2 active" href="#">Action</a></li>
- <li><a class="dropdown-item rounded-2" href="#">Another action</a></li>
- <li><a class="dropdown-item rounded-2" href="#">Something else here</a></li>
- <li><hr class="dropdown-divider"></li>
- <li><a class="dropdown-item rounded-2" href="#">Separated link</a></li>
- </ul>
- <ul class="dropdown-menu dropdown-menu-dark position-static d-grid gap-1 p-2 rounded-3 mx-0 border-0 shadow w-220px">
- <li><a class="dropdown-item rounded-2 active" href="#">Action</a></li>
- <li><a class="dropdown-item rounded-2" href="#">Another action</a></li>
- <li><a class="dropdown-item rounded-2" href="#">Something else here</a></li>
- <li><hr class="dropdown-divider"></li>
- <li><a class="dropdown-item rounded-2" href="#">Separated link</a></li>
- </ul>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="d-flex gap-5 justify-content-center">
- <div class="dropdown-menu d-block position-static pt-0 mx-0 rounded-3 shadow overflow-hidden w-280px">
- <form class="p-2 mb-2 bg-light border-bottom">
- <input type="search" class="form-control" autocomplete="false" placeholder="Type to filter...">
- </form>
- <ul class="list-unstyled mb-0">
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-success rounded-circle p-1"></span>
- Action
- </a></li>
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-primary rounded-circle p-1"></span>
- Another action
- </a></li>
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-danger rounded-circle p-1"></span>
- Something else here
- </a></li>
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-info rounded-circle p-1"></span>
- Separated link
- </a></li>
- </ul>
- </div>
-
- <div class="dropdown-menu dropdown-menu-dark d-block position-static border-0 pt-0 mx-0 rounded-3 shadow overflow-hidden w-280px">
- <form class="p-2 mb-2 bg-dark border-bottom border-dark">
- <input type="search" class="form-control form-control-dark" autocomplete="false" placeholder="Type to filter...">
- </form>
- <ul class="list-unstyled mb-0">
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-success rounded-circle p-1"></span>
- Action
- </a></li>
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-primary rounded-circle p-1"></span>
- Another action
- </a></li>
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-danger rounded-circle p-1"></span>
- Something else here
- </a></li>
- <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
- <span class="d-inline-block bg-info rounded-circle p-1"></span>
- Separated link
- </a></li>
- </ul>
- </div>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="d-flex gap-5 justify-content-center">
- <ul class="dropdown-menu d-block position-static mx-0 shadow w-220px">
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#files"/></svg>
- Documents
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#image-fill"/></svg>
- Photos
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#film"/></svg>
- Movies
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#music-note-beamed"/></svg>
- Music
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#joystick"/></svg>
- Games
- </a>
- </li>
- <li><hr class="dropdown-divider"></li>
- <li>
- <a class="dropdown-item dropdown-item-danger d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#trash"/></svg>
- Trash
- </a>
- </li>
- </ul>
- <ul class="dropdown-menu dropdown-menu-dark d-block position-static mx-0 border-0 shadow w-220px">
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#files"/></svg>
- Documents
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#image-fill"/></svg>
- Photos
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#film"/></svg>
- Movies
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#music-note-beamed"/></svg>
- Music
- </a>
- </li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#joystick"/></svg>
- Games
- </a>
- </li>
- <li><hr class="dropdown-divider"></li>
- <li>
- <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
- <svg class="bi" width="16" height="16"><use xlink:href="#trash"/></svg>
- Trash
- </a>
- </li>
- </ul>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="dropdown-menu d-block position-static p-2 shadow rounded-3 w-340px">
- <div class="d-grid gap-1">
- <div class="cal">
- <div class="cal-month">
- <button class="btn cal-btn" type="button">
- <svg class="bi" width="16" height="16"><use xlink:href="#arrow-left-short"/></svg>
- </button>
- <strong class="cal-month-name">June</strong>
- <select class="form-select cal-month-name d-none">
- <option value="January">January</option>
- <option value="February">February</option>
- <option value="March">March</option>
- <option value="April">April</option>
- <option value="May">May</option>
- <option selected value="June">June</option>
- <option value="July">July</option>
- <option value="August">August</option>
- <option value="September">September</option>
- <option value="October">October</option>
- <option value="November">November</option>
- <option value="December">December</option>
- </select>
- <button class="btn cal-btn" type="button">
- <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-short"/></svg>
- </button>
- </div>
- <div class="cal-weekdays text-muted">
- <div class="cal-weekday">Sun</div>
- <div class="cal-weekday">Mon</div>
- <div class="cal-weekday">Tue</div>
- <div class="cal-weekday">Wed</div>
- <div class="cal-weekday">Thu</div>
- <div class="cal-weekday">Fri</div>
- <div class="cal-weekday">Sat</div>
- </div>
- <div class="cal-days">
- <button class="btn cal-btn" disabled type="button">30</button>
- <button class="btn cal-btn" disabled type="button">31</button>
-
- <button class="btn cal-btn" type="button">1</button>
- <button class="btn cal-btn" type="button">2</button>
- <button class="btn cal-btn" type="button">3</button>
- <button class="btn cal-btn" type="button">4</button>
- <button class="btn cal-btn" type="button">5</button>
- <button class="btn cal-btn" type="button">6</button>
- <button class="btn cal-btn" type="button">7</button>
-
- <button class="btn cal-btn" type="button">8</button>
- <button class="btn cal-btn" type="button">9</button>
- <button class="btn cal-btn" type="button">10</button>
- <button class="btn cal-btn" type="button">11</button>
- <button class="btn cal-btn" type="button">12</button>
- <button class="btn cal-btn" type="button">13</button>
- <button class="btn cal-btn" type="button">14</button>
-
- <button class="btn cal-btn" type="button">15</button>
- <button class="btn cal-btn" type="button">16</button>
- <button class="btn cal-btn" type="button">17</button>
- <button class="btn cal-btn" type="button">18</button>
- <button class="btn cal-btn" type="button">19</button>
- <button class="btn cal-btn" type="button">20</button>
- <button class="btn cal-btn" type="button">21</button>
-
- <button class="btn cal-btn" type="button">22</button>
- <button class="btn cal-btn" type="button">23</button>
- <button class="btn cal-btn" type="button">24</button>
- <button class="btn cal-btn" type="button">25</button>
- <button class="btn cal-btn" type="button">26</button>
- <button class="btn cal-btn" type="button">27</button>
- <button class="btn cal-btn" type="button">28</button>
-
- <button class="btn cal-btn" type="button">29</button>
- <button class="btn cal-btn" type="button">30</button>
- <button class="btn cal-btn" type="button">31</button>
- </div>
- </div>
- </div>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="dropdown-menu position-static d-flex align-items-stretch p-3 rounded-3 shadow-lg w-600px">
- <nav class="d-grid gap-2 col-8">
- <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-center gap-3 py-2 px-3 lh-sm text-start">
- <svg class="bi" width="32" height="32"><use xlink:href="#image-fill"/></svg>
- <div>
- <strong class="d-block">Features</strong>
- <small>Take a tour through the product</small>
- </div>
- </a>
- <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-center gap-3 py-2 px-3 lh-sm text-start">
- <svg class="bi" width="32" height="32"><use xlink:href="#question-circle"/></svg>
- <div>
- <strong class="d-block">Support</strong>
- <small>Get help from our support crew</small>
- </div>
- </a>
- </nav>
- <div class="col-4">
- ...
- </div>
-</div>
diff --git a/site/content/docs/5.2/examples/grid/grid.css b/site/content/docs/5.2/examples/grid/grid.css
deleted file mode 100644
index 18e3568..0000000
--- a/site/content/docs/5.2/examples/grid/grid.css
+++ /dev/null
@@ -1,13 +0,0 @@
-.themed-grid-col {
- padding-top: .75rem;
- padding-bottom: .75rem;
- background-color: rgba(86, 61, 124, .15);
- border: 1px solid rgba(86, 61, 124, .2);
-}
-
-.themed-container {
- padding: .75rem;
- margin-bottom: 1.5rem;
- background-color: rgba(0, 123, 255, .15);
- border: 1px solid rgba(0, 123, 255, .2);
-}
diff --git a/site/content/docs/5.2/examples/list-groups/index.html b/site/content/docs/5.2/examples/list-groups/index.html
deleted file mode 100644
index 9599913..0000000
--- a/site/content/docs/5.2/examples/list-groups/index.html
+++ /dev/null
@@ -1,222 +0,0 @@
----
-layout: examples
-title: List groups
-extra_css:
- - "list-groups.css"
-body_class: ""
----
-
-<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
- <symbol id="bootstrap" viewBox="0 0 118 94">
- <title>Bootstrap</title>
- <path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z"></path>
- </symbol>
-
- <symbol id="calendar-event" viewBox="0 0 16 16">
- <path d="M11 6.5a.5.5 0 0 1 .5-.5h1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-1a.5.5 0 0 1-.5-.5v-1z"/>
- <path d="M3.5 0a.5.5 0 0 1 .5.5V1h8V.5a.5.5 0 0 1 1 0V1h1a2 2 0 0 1 2 2v11a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2V3a2 2 0 0 1 2-2h1V.5a.5.5 0 0 1 .5-.5zM1 4v10a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1V4H1z"/>
- </symbol>
-
- <symbol id="alarm" viewBox="0 0 16 16">
- <path d="M8.5 5.5a.5.5 0 0 0-1 0v3.362l-1.429 2.38a.5.5 0 1 0 .858.515l1.5-2.5A.5.5 0 0 0 8.5 9V5.5z"/>
- <path d="M6.5 0a.5.5 0 0 0 0 1H7v1.07a7.001 7.001 0 0 0-3.273 12.474l-.602.602a.5.5 0 0 0 .707.708l.746-.746A6.97 6.97 0 0 0 8 16a6.97 6.97 0 0 0 3.422-.892l.746.746a.5.5 0 0 0 .707-.708l-.601-.602A7.001 7.001 0 0 0 9 2.07V1h.5a.5.5 0 0 0 0-1h-3zm1.038 3.018a6.093 6.093 0 0 1 .924 0 6 6 0 1 1-.924 0zM0 3.5c0 .753.333 1.429.86 1.887A8.035 8.035 0 0 1 4.387 1.86 2.5 2.5 0 0 0 0 3.5zM13.5 1c-.753 0-1.429.333-1.887.86a8.035 8.035 0 0 1 3.527 3.527A2.5 2.5 0 0 0 13.5 1z"/>
- </symbol>
-
- <symbol id="list-check" viewBox="0 0 16 16">
- <path fill-rule="evenodd" d="M5 11.5a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zM3.854 2.146a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 1 1 .708-.708L2 3.293l1.146-1.147a.5.5 0 0 1 .708 0zm0 4a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 1 1 .708-.708L2 7.293l1.146-1.147a.5.5 0 0 1 .708 0zm0 4a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 0 1 .708-.708l.146.147 1.146-1.147a.5.5 0 0 1 .708 0z"/>
- </symbol>
-</svg>
-
-<div class="list-group w-auto">
- <a href="#" class="list-group-item list-group-item-action d-flex gap-3 py-3" aria-current="true">
- <img src="https://github.com/twbs.png" alt="twbs" width="32" height="32" class="rounded-circle flex-shrink-0">
- <div class="d-flex gap-2 w-100 justify-content-between">
- <div>
- <h6 class="mb-0">List group item heading</h6>
- <p class="mb-0 opacity-75">Some placeholder content in a paragraph.</p>
- </div>
- <small class="opacity-50 text-nowrap">now</small>
- </div>
- </a>
- <a href="#" class="list-group-item list-group-item-action d-flex gap-3 py-3" aria-current="true">
- <img src="https://github.com/twbs.png" alt="twbs" width="32" height="32" class="rounded-circle flex-shrink-0">
- <div class="d-flex gap-2 w-100 justify-content-between">
- <div>
- <h6 class="mb-0">Another title here</h6>
- <p class="mb-0 opacity-75">Some placeholder content in a paragraph that goes a little longer so it wraps to a new line.</p>
- </div>
- <small class="opacity-50 text-nowrap">3d</small>
- </div>
- </a>
- <a href="#" class="list-group-item list-group-item-action d-flex gap-3 py-3" aria-current="true">
- <img src="https://github.com/twbs.png" alt="twbs" width="32" height="32" class="rounded-circle flex-shrink-0">
- <div class="d-flex gap-2 w-100 justify-content-between">
- <div>
- <h6 class="mb-0">Third heading</h6>
- <p class="mb-0 opacity-75">Some placeholder content in a paragraph.</p>
- </div>
- <small class="opacity-50 text-nowrap">1w</small>
- </div>
- </a>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="d-flex gap-5 justify-content-center">
- <div class="list-group mx-0 w-auto">
- <label class="list-group-item d-flex gap-2">
- <input class="form-check-input flex-shrink-0" type="checkbox" value="" checked>
- <span>
- First checkbox
- <small class="d-block text-muted">With support text underneath to add more detail</small>
- </span>
- </label>
- <label class="list-group-item d-flex gap-2">
- <input class="form-check-input flex-shrink-0" type="checkbox" value="">
- <span>
- Second checkbox
- <small class="d-block text-muted">Some other text goes here</small>
- </span>
- </label>
- <label class="list-group-item d-flex gap-2">
- <input class="form-check-input flex-shrink-0" type="checkbox" value="">
- <span>
- Third checkbox
- <small class="d-block text-muted">And we end with another snippet of text</small>
- </span>
- </label>
- </div>
-
- <div class="list-group mx-0 w-auto">
- <label class="list-group-item d-flex gap-2">
- <input class="form-check-input flex-shrink-0" type="radio" name="listGroupRadios" id="listGroupRadios1" value="" checked>
- <span>
- First radio
- <small class="d-block text-muted">With support text underneath to add more detail</small>
- </span>
- </label>
- <label class="list-group-item d-flex gap-2">
- <input class="form-check-input flex-shrink-0" type="radio" name="listGroupRadios" id="listGroupRadios2" value="">
- <span>
- Second radio
- <small class="d-block text-muted">Some other text goes here</small>
- </span>
- </label>
- <label class="list-group-item d-flex gap-2">
- <input class="form-check-input flex-shrink-0" type="radio" name="listGroupRadios" id="listGroupRadios3" value="">
- <span>
- Third radio
- <small class="d-block text-muted">And we end with another snippet of text</small>
- </span>
- </label>
- </div>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="list-group w-auto">
- <label class="list-group-item d-flex gap-3">
- <input class="form-check-input flex-shrink-0" type="checkbox" value="" checked style="font-size: 1.375em;">
- <span class="pt-1 form-checked-content">
- <strong>Finish sales report</strong>
- <small class="d-block text-muted">
- <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#calendar-event"/></svg>
- 1:00–2:00pm
- </small>
- </span>
- </label>
- <label class="list-group-item d-flex gap-3">
- <input class="form-check-input flex-shrink-0" type="checkbox" value="" style="font-size: 1.375em;">
- <span class="pt-1 form-checked-content">
- <strong>Weekly All Hands</strong>
- <small class="d-block text-muted">
- <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#calendar-event"/></svg>
- 2:00–2:30pm
- </small>
- </span>
- </label>
- <label class="list-group-item d-flex gap-3">
- <input class="form-check-input flex-shrink-0" type="checkbox" value="" style="font-size: 1.375em;">
- <span class="pt-1 form-checked-content">
- <strong>Out of office</strong>
- <small class="d-block text-muted">
- <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#alarm"/></svg>
- Tomorrow
- </small>
- </span>
- </label>
- <label class="list-group-item d-flex gap-3 bg-light">
- <input class="form-check-input form-check-input-placeholder bg-light flex-shrink-0 pe-none" disabled type="checkbox" value="" style="font-size: 1.375em;">
- <span class="pt-1 form-checked-content">
- <span contenteditable="true" class="w-100">Add new task...</span>
- <small class="d-block text-muted">
- <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#list-check"/></svg>
- Choose list...
- </small>
- </span>
- </label>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="list-group list-group-checkable d-grid gap-2 border-0 w-auto">
- <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios1" value="" checked>
- <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios1">
- First radio
- <span class="d-block small opacity-50">With support text underneath to add more detail</span>
- </label>
-
- <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios2" value="">
- <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios2">
- Second radio
- <span class="d-block small opacity-50">Some other text goes here</span>
- </label>
-
- <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios3" value="">
- <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios3">
- Third radio
- <span class="d-block small opacity-50">And we end with another snippet of text</span>
- </label>
-
- <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios4" value="" disabled>
- <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios4">
- Fourth disabled radio
- <span class="d-block small opacity-50">This option is disabled</span>
- </label>
-</div>
-
-<div class="b-example-divider"></div>
-
-<div class="list-group list-group-radio d-grid gap-2 border-0 w-auto">
- <div class="position-relative">
- <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid1" value="" checked>
- <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid1">
- <strong class="fw-semibold">First radio</strong>
- <span class="d-block small opacity-75">With support text underneath to add more detail</span>
- </label>
- </div>
-
- <div class="position-relative">
- <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid2" value="">
- <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid2">
- <strong class="fw-semibold">Second radio</strong>
- <span class="d-block small opacity-75">Some other text goes here</span>
- </label>
- </div>
-
- <div class="position-relative">
- <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid3" value="">
- <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid3">
- <strong class="fw-semibold">Third radio</strong>
- <span class="d-block small opacity-75">And we end with another snippet of text</span>
- </label>
- </div>
-
- <div class="position-relative">
- <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid4" value="" disabled>
- <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid4">
- <strong class="fw-semibold">Fourth disabled radio</strong>
- <span class="d-block small opacity-75">This option is disabled</span>
- </label>
- </div>
-</div>
diff --git a/site/content/docs/5.2/examples/pricing/pricing.css b/site/content/docs/5.2/examples/pricing/pricing.css
deleted file mode 100644
index c7304d1..0000000
--- a/site/content/docs/5.2/examples/pricing/pricing.css
+++ /dev/null
@@ -1,11 +0,0 @@
-body {
- background-image: linear-gradient(180deg, #eee, #fff 100px, #fff);
-}
-
-.container {
- max-width: 960px;
-}
-
-.pricing-header {
- max-width: 700px;
-}
diff --git a/site/content/docs/5.2/examples/product/index.html b/site/content/docs/5.2/examples/product/index.html
deleted file mode 100644
index c2eb0eb..0000000
--- a/site/content/docs/5.2/examples/product/index.html
+++ /dev/null
@@ -1,148 +0,0 @@
----
-layout: examples
-title: Product example
-extra_css:
- - "product.css"
----
-
-<header class="site-header sticky-top py-1">
- <nav class="container d-flex flex-column flex-md-row justify-content-between">
- <a class="py-2" href="#" aria-label="Product">
- <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" class="d-block mx-auto" role="img" viewBox="0 0 24 24"><title>Product</title><circle cx="12" cy="12" r="10"/><path d="M14.31 8l5.74 9.94M9.69 8h11.48M7.38 12l5.74-9.94M9.69 16L3.95 6.06M14.31 16H2.83m13.79-4l-5.74 9.94"/></svg>
- </a>
- <a class="py-2 d-none d-md-inline-block" href="#">Tour</a>
- <a class="py-2 d-none d-md-inline-block" href="#">Product</a>
- <a class="py-2 d-none d-md-inline-block" href="#">Features</a>
- <a class="py-2 d-none d-md-inline-block" href="#">Enterprise</a>
- <a class="py-2 d-none d-md-inline-block" href="#">Support</a>
- <a class="py-2 d-none d-md-inline-block" href="#">Pricing</a>
- <a class="py-2 d-none d-md-inline-block" href="#">Cart</a>
- </nav>
-</header>
-
-<main>
- <div class="position-relative overflow-hidden p-3 p-md-5 m-md-3 text-center bg-light">
- <div class="col-md-5 p-lg-5 mx-auto my-5">
- <h1 class="display-4 fw-normal">Punny headline</h1>
- <p class="lead fw-normal">And an even wittier subheading to boot. Jumpstart your marketing efforts with this example based on Apple’s marketing pages.</p>
- <a class="btn btn-outline-secondary" href="#">Coming soon</a>
- </div>
- <div class="product-device shadow-sm d-none d-md-block"></div>
- <div class="product-device product-device-2 shadow-sm d-none d-md-block"></div>
- </div>
-
- <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
- <div class="text-bg-dark me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 py-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-light shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- <div class="bg-light me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 p-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-dark shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- </div>
-
- <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
- <div class="bg-light me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 p-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-dark shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- <div class="text-bg-primary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 py-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-light shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- </div>
-
- <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
- <div class="bg-light me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 p-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- <div class="bg-light me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 py-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- </div>
-
- <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
- <div class="bg-light me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 p-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- <div class="bg-light me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
- <div class="my-3 py-3">
- <h2 class="display-5">Another headline</h2>
- <p class="lead">And an even wittier subheading.</p>
- </div>
- <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
- </div>
- </div>
-</main>
-
-<footer class="container py-5">
- <div class="row">
- <div class="col-12 col-md">
- <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" class="d-block mb-2" role="img" viewBox="0 0 24 24"><title>Product</title><circle cx="12" cy="12" r="10"/><path d="M14.31 8l5.74 9.94M9.69 8h11.48M7.38 12l5.74-9.94M9.69 16L3.95 6.06M14.31 16H2.83m13.79-4l-5.74 9.94"/></svg>
- <small class="d-block mb-3 text-muted">&copy; 2017–{{< year >}}</small>
- </div>
- <div class="col-6 col-md">
- <h5>Features</h5>
- <ul class="list-unstyled text-small">
- <li><a class="link-secondary" href="#">Cool stuff</a></li>
- <li><a class="link-secondary" href="#">Random feature</a></li>
- <li><a class="link-secondary" href="#">Team feature</a></li>
- <li><a class="link-secondary" href="#">Stuff for developers</a></li>
- <li><a class="link-secondary" href="#">Another one</a></li>
- <li><a class="link-secondary" href="#">Last time</a></li>
- </ul>
- </div>
- <div class="col-6 col-md">
- <h5>Resources</h5>
- <ul class="list-unstyled text-small">
- <li><a class="link-secondary" href="#">Resource name</a></li>
- <li><a class="link-secondary" href="#">Resource</a></li>
- <li><a class="link-secondary" href="#">Another resource</a></li>
- <li><a class="link-secondary" href="#">Final resource</a></li>
- </ul>
- </div>
- <div class="col-6 col-md">
- <h5>Resources</h5>
- <ul class="list-unstyled text-small">
- <li><a class="link-secondary" href="#">Business</a></li>
- <li><a class="link-secondary" href="#">Education</a></li>
- <li><a class="link-secondary" href="#">Government</a></li>
- <li><a class="link-secondary" href="#">Gaming</a></li>
- </ul>
- </div>
- <div class="col-6 col-md">
- <h5>About</h5>
- <ul class="list-unstyled text-small">
- <li><a class="link-secondary" href="#">Team</a></li>
- <li><a class="link-secondary" href="#">Locations</a></li>
- <li><a class="link-secondary" href="#">Privacy</a></li>
- <li><a class="link-secondary" href="#">Terms</a></li>
- </ul>
- </div>
- </div>
-</footer>
diff --git a/site/content/docs/5.2/examples/starter-template/index.html b/site/content/docs/5.2/examples/starter-template/index.html
deleted file mode 100644
index 5a898a4..0000000
--- a/site/content/docs/5.2/examples/starter-template/index.html
+++ /dev/null
@@ -1,52 +0,0 @@
----
-layout: examples
-title: Starter Template
-extra_css:
- - "starter-template.css"
----
-
-<div class="col-lg-8 mx-auto p-4 py-md-5">
- <header class="d-flex align-items-center pb-3 mb-5 border-bottom">
- <a href="/" class="d-flex align-items-center text-dark text-decoration-none">
- <svg xmlns="http://www.w3.org/2000/svg" width="40" height="32" class="me-2" viewBox="0 0 118 94" role="img"><title>Bootstrap</title><path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z" fill="currentColor"></path></svg>
- <span class="fs-4">Starter template</span>
- </a>
- </header>
-
- <main>
- <h1>Get started with Bootstrap</h1>
- <p class="fs-5 col-md-8">Quickly and easily get started with Bootstrap's compiled, production-ready files with this barebones example featuring some basic HTML and helpful links. Download all our examples to get started.</p>
-
- <div class="mb-5">
- <a href="{{< docsref "/examples" >}}" class="btn btn-primary btn-lg px-4">Download examples</a>
- </div>
-
- <hr class="col-3 col-md-2 mb-5">
-
- <div class="row g-5">
- <div class="col-md-6">
- <h2>Starter projects</h2>
- <p>Ready to beyond the starter template? Check out these open source projects that you can quickly duplicate to a new GitHub repository.</p>
- <ul class="icon-list ps-0">
- <li class="d-flex align-items-start mb-1"><a href="https://github.com/twbs/bootstrap-npm-starter" rel="noopener" target="_blank">Bootstrap npm starter</a></li>
- <li class="text-muted d-flex align-items-start mb-1">Bootstrap Parcel starter (coming soon!)</li>
- </ul>
- </div>
-
- <div class="col-md-6">
- <h2>Guides</h2>
- <p>Read more detailed instructions and documentation on using or contributing to Bootstrap.</p>
- <ul class="icon-list ps-0">
- <li class="d-flex align-items-start mb-1"><a href="{{< docsref "/getting-started/introduction" >}}">Bootstrap quick start guide</a></li>
- <li class="d-flex align-items-start mb-1"><a href="{{< docsref "/getting-started/webpack" >}}">Bootstrap Webpack guide</a></li>
- <li class="d-flex align-items-start mb-1"><a href="{{< docsref "/getting-started/parcel" >}}">Bootstrap Parcel guide</a></li>
- <li class="d-flex align-items-start mb-1"><a href="{{< docsref "/getting-started/vite" >}}">Bootstrap Vite guide</a></li>
- <li class="d-flex align-items-start mb-1"><a href="{{< docsref "/getting-started/contribute" >}}">Contributing to Bootstrap</a></li>
- </ul>
- </div>
- </div>
- </main>
- <footer class="pt-5 my-5 text-muted border-top">
- Created by the Bootstrap team &middot; &copy; {{< year >}}
- </footer>
-</div>
diff --git a/site/content/docs/5.2/examples/starter-template/starter-template.css b/site/content/docs/5.2/examples/starter-template/starter-template.css
deleted file mode 100644
index 582dcbe..0000000
--- a/site/content/docs/5.2/examples/starter-template/starter-template.css
+++ /dev/null
@@ -1,9 +0,0 @@
-.icon-list li::before {
- display: block;
- flex-shrink: 0;
- width: 1.5em;
- height: 1.5em;
- margin-right: .5rem;
- content: "";
- background: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='%23212529' viewBox='0 0 16 16'%3E%3Cpath d='M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0zM4.5 7.5a.5.5 0 0 0 0 1h5.793l-2.147 2.146a.5.5 0 0 0 .708.708l3-3a.5.5 0 0 0 0-.708l-3-3a.5.5 0 1 0-.708.708L10.293 7.5H4.5z'/%3E%3C/svg%3E") no-repeat center center / 100% auto;
-}
diff --git a/site/content/docs/5.2/helpers/colored-links.md b/site/content/docs/5.2/helpers/colored-links.md
deleted file mode 100644
index e940196..0000000
--- a/site/content/docs/5.2/helpers/colored-links.md
+++ /dev/null
@@ -1,21 +0,0 @@
----
-layout: docs
-title: Colored links
-description: Colored links with hover states
-group: helpers
-toc: false
----
-
-You can use the `.link-*` classes to colorize links. Unlike the [`.text-*` classes]({{< docsref "/utilities/colors" >}}), these classes have a `:hover` and `:focus` state.
-
-{{< example >}}
-{{< colored-links.inline >}}
-{{- range (index $.Site.Data "theme-colors") }}
-<a href="#" class="link-{{ .name }}">{{ .name | title }} link</a>
-{{- end -}}
-{{< /colored-links.inline >}}
-{{< /example >}}
-
-{{< callout info >}}
-Some of the link styles use a relatively light foreground color, and should only be used on a dark background in order to have sufficient contrast.
-{{< /callout >}}
diff --git a/site/content/docs/5.2/utilities/overflow.md b/site/content/docs/5.2/utilities/overflow.md
deleted file mode 100644
index a36374c..0000000
--- a/site/content/docs/5.2/utilities/overflow.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-layout: docs
-title: Overflow
-description: Use these shorthand utilities for quickly configuring how content overflows an element.
-group: utilities
----
-
-Adjust the `overflow` property on the fly with four default values and classes. These classes are not responsive by default.
-
-<div class="bd-example d-md-flex">
- <div class="overflow-auto p-3 mb-3 mb-md-0 me-md-3 bg-light" style="max-width: 260px; max-height: 100px;">
- This is an example of using <code>.overflow-auto</code> on an element with set width and height dimensions. By design, this content will vertically scroll.
- </div>
- <div class="overflow-hidden p-3 mb-3 mb-md-0 me-md-3 bg-light" style="max-width: 260px; max-height: 100px;">
- This is an example of using <code>.overflow-hidden</code> on an element with set width and height dimensions.
- </div>
- <div class="overflow-visible p-3 mb-3 mb-md-0 me-md-3 bg-light" style="max-width: 260px; max-height: 100px;">
- This is an example of using <code>.overflow-visible</code> on an element with set width and height dimensions.
- </div>
- <div class="overflow-scroll p-3 bg-light" style="max-width: 260px; max-height: 100px;">
- This is an example of using <code>.overflow-scroll</code> on an element with set width and height dimensions.
- </div>
-</div>
-
-```html
-<div class="overflow-auto">...</div>
-<div class="overflow-hidden">...</div>
-<div class="overflow-visible">...</div>
-<div class="overflow-scroll">...</div>
-```
-
-Using Sass variables, you may customize the overflow utilities by changing the `$overflows` variable in `_variables.scss`.
-
-## Sass
-
-### Utilities API
-
-Overflow utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
-
-{{< scss-docs name="utils-overflow" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/5.2/utilities/sizing.md b/site/content/docs/5.2/utilities/sizing.md
deleted file mode 100644
index 962575f..0000000
--- a/site/content/docs/5.2/utilities/sizing.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-layout: docs
-title: Sizing
-description: Easily make an element as wide or as tall with our width and height utilities.
-group: utilities
-toc: true
----
-
-## Relative to the parent
-
-Width and height utilities are generated from the utility API in `_utilities.scss`. Includes support for `25%`, `50%`, `75%`, `100%`, and `auto` by default. Modify those values as you need to generate different utilities here.
-
-{{< example >}}
-<div class="w-25 p-3" style="background-color: #eee;">Width 25%</div>
-<div class="w-50 p-3" style="background-color: #eee;">Width 50%</div>
-<div class="w-75 p-3" style="background-color: #eee;">Width 75%</div>
-<div class="w-100 p-3" style="background-color: #eee;">Width 100%</div>
-<div class="w-auto p-3" style="background-color: #eee;">Width auto</div>
-{{< /example >}}
-
-{{< example >}}
-<div style="height: 100px; background-color: rgba(255,0,0,0.1);">
- <div class="h-25 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 25%</div>
- <div class="h-50 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 50%</div>
- <div class="h-75 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 75%</div>
- <div class="h-100 d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height 100%</div>
- <div class="h-auto d-inline-block" style="width: 120px; background-color: rgba(0,0,255,.1)">Height auto</div>
-</div>
-{{< /example >}}
-
-You can also use `max-width: 100%;` and `max-height: 100%;` utilities as needed.
-
-{{< example >}}
-{{< placeholder width="100%" height="100" class="mw-100" text="Max-width 100%" >}}
-{{< /example >}}
-
-{{< example >}}
-<div style="height: 100px; background-color: rgba(255,0,0,.1);">
- <div class="mh-100" style="width: 100px; height: 200px; background-color: rgba(0,0,255,.1);">Max-height 100%</div>
-</div>
-{{< /example >}}
-
-## Relative to the viewport
-
-You can also use utilities to set the width and height relative to the viewport.
-
-```html
-<div class="min-vw-100">Min-width 100vw</div>
-<div class="min-vh-100">Min-height 100vh</div>
-<div class="vw-100">Width 100vw</div>
-<div class="vh-100">Height 100vh</div>
-```
-
-## Sass
-
-### Utilities API
-
-Sizing utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
-
-{{< scss-docs name="utils-sizing" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/5.3/_index.html b/site/content/docs/5.3/_index.html
new file mode 100644
index 0000000..b04e391
--- /dev/null
+++ b/site/content/docs/5.3/_index.html
@@ -0,0 +1,5 @@
+---
+layout: redirect
+sitemap_exclude: true
+redirect: "/docs/5.3/getting-started/introduction/"
+---
diff --git a/site/content/docs/5.2/about/brand.md b/site/content/docs/5.3/about/brand.md
index 80c6135..59f262e 100644
--- a/site/content/docs/5.2/about/brand.md
+++ b/site/content/docs/5.3/about/brand.md
@@ -10,15 +10,15 @@ Have a need for Bootstrap's brand resources? Great! We have only a few guideline
## Logo
-When referencing Bootstrap, use our logo mark. Do not modify our logos in any way. Do not use Bootstrap's branding for your own open or closed source projects. **Do not use the Twitter name or logo** in association with Bootstrap.
+When referencing Bootstrap, use our logo mark. Do not modify our logos in any way. Do not use Bootstrap's branding for your own open or closed source projects.
-<div class="bd-brand-item px-2 py-5 mb-3 bg-light rounded-lg">
+<div class="bd-brand-item px-2 py-5 mb-3 border rounded-3">
<img class="d-block img-fluid mx-auto" src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo.svg" alt="Bootstrap" width="256" height="204">
</div>
Our logo mark is also available in black and white. All rules for our primary logo apply to these as well.
-<div class="bd-brand-logos d-sm-flex text-center bg-light rounded-lg overflow-hidden w-100 mb-3">
+<div class="bd-brand-logos d-sm-flex text-center bg-light rounded-3 overflow-hidden w-100 mb-3">
<div class="bd-brand-item w-100 px-2 py-5">
<img src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo-black.svg" alt="Bootstrap" width="128" height="102" loading="lazy">
</div>
@@ -29,19 +29,15 @@ Our logo mark is also available in black and white. All rules for our primary lo
## Name
-Bootstrap should always be referred to as just **Bootstrap**. No Twitter before it and no capital _s_.
+Bootstrap should always be referred to as just **Bootstrap**. No capital _s_.
-<div class="bd-brand-logos d-sm-flex text-center bg-light rounded-lg overflow-hidden w-100 mb-3">
- <div class="bd-brand-item w-100 p-3">
+<div class="bd-brand-logos d-sm-flex text-center border rounded-3 overflow-hidden w-100 mb-3">
+ <div class="bd-brand-item w-100 px-2 py-5">
<div class="h3">Bootstrap</div>
<strong class="text-success">Correct</strong>
</div>
- <div class="bd-brand-item w-100 p-3">
- <div class="h3 text-muted">BootStrap</div>
- <strong class="text-danger">Incorrect</strong>
- </div>
- <div class="bd-brand-item w-100 p-3">
- <div class="h3 text-muted">Twitter Bootstrap</div>
+ <div class="bd-brand-item w-100 px-2 py-5">
+ <div class="h3 text-body-secondary">BootStrap</div>
<strong class="text-danger">Incorrect</strong>
</div>
</div>
diff --git a/site/content/docs/5.2/about/license.md b/site/content/docs/5.3/about/license.md
index 07e60e0..8698b1a 100644
--- a/site/content/docs/5.2/about/license.md
+++ b/site/content/docs/5.3/about/license.md
@@ -5,7 +5,7 @@ description: Commonly asked questions about Bootstrap's open source license.
group: about
---
-Bootstrap is released under the MIT license and is copyright {{< year >}} Twitter. Boiled down to smaller chunks, it can be described with the following conditions.
+Bootstrap is released under the MIT license and is copyright {{< year >}}. Boiled down to smaller chunks, it can be described with the following conditions.
## It requires you to:
@@ -23,8 +23,8 @@ Bootstrap is released under the MIT license and is copyright {{< year >}} Twitte
- Hold the authors and license owners liable for damages as Bootstrap is provided without warranty
- Hold the creators or copyright holders of Bootstrap liable
- Redistribute any piece of Bootstrap without proper attribution
-- Use any marks owned by Twitter in any way that might state or imply that Twitter endorses your distribution
-- Use any marks owned by Twitter in any way that might state or imply that you created the Twitter software in question
+- Use any marks owned by Bootstrap in any way that might state or imply that Bootstrap endorses your distribution
+- Use any marks owned by Bootstrap in any way that might state or imply that you created the Bootstrap software in question
## It does not require you to:
diff --git a/site/content/docs/5.2/about/overview.md b/site/content/docs/5.3/about/overview.md
index 1f39b85..0ccaf34 100644
--- a/site/content/docs/5.2/about/overview.md
+++ b/site/content/docs/5.3/about/overview.md
@@ -5,7 +5,7 @@ description: Learn more about the team maintaining Bootstrap, how and why the pr
group: about
aliases:
- "/about/"
- - "/docs/5.2/about/"
+ - "/docs/5.3/about/"
---
## Team
diff --git a/site/content/docs/5.2/about/team.md b/site/content/docs/5.3/about/team.md
index c00ba4e..c00ba4e 100644
--- a/site/content/docs/5.2/about/team.md
+++ b/site/content/docs/5.3/about/team.md
diff --git a/site/content/docs/5.2/about/translations.md b/site/content/docs/5.3/about/translations.md
index 5e2ae30..5e2ae30 100644
--- a/site/content/docs/5.2/about/translations.md
+++ b/site/content/docs/5.3/about/translations.md
diff --git a/site/content/docs/5.2/components/accordion.md b/site/content/docs/5.3/components/accordion.md
index 2e24723..227d11a 100644
--- a/site/content/docs/5.2/components/accordion.md
+++ b/site/content/docs/5.3/components/accordion.md
@@ -5,7 +5,7 @@ description: Build vertically collapsing accordions in combination with our Coll
group: components
aliases:
- "/components/"
- - "/docs/5.2/components/"
+ - "/docs/5.3/components/"
toc: true
---
@@ -14,7 +14,7 @@ toc: true
The accordion uses [collapse]({{< docsref "/components/collapse" >}}) internally to make it collapsible. To render an accordion that's expanded, add the `.open` class on the `.accordion`.
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
## Example
@@ -24,36 +24,36 @@ Click the accordions below to expand/collapse the accordion content.
{{< example >}}
<div class="accordion" id="accordionExample">
<div class="accordion-item">
- <h2 class="accordion-header" id="headingOne">
+ <h2 class="accordion-header">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
Accordion Item #1
</button>
</h2>
- <div id="collapseOne" class="accordion-collapse collapse show" aria-labelledby="headingOne" data-bs-parent="#accordionExample">
+ <div id="collapseOne" class="accordion-collapse collapse show" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>This is the first item's accordion body.</strong> It is shown by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h2 class="accordion-header" id="headingTwo">
+ <h2 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
Accordion Item #2
</button>
</h2>
- <div id="collapseTwo" class="accordion-collapse collapse" aria-labelledby="headingTwo" data-bs-parent="#accordionExample">
+ <div id="collapseTwo" class="accordion-collapse collapse" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>This is the second item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h2 class="accordion-header" id="headingThree">
+ <h2 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
Accordion Item #3
</button>
</h2>
- <div id="collapseThree" class="accordion-collapse collapse" aria-labelledby="headingThree" data-bs-parent="#accordionExample">
+ <div id="collapseThree" class="accordion-collapse collapse" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>This is the third item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
@@ -64,37 +64,37 @@ Click the accordions below to expand/collapse the accordion content.
### Flush
-Add `.accordion-flush` to remove the default `background-color`, some borders, and some rounded corners to render accordions edge-to-edge with their parent container.
+Add `.accordion-flush` to remove some borders and rounded corners to render accordions edge-to-edge with their parent container.
-{{< example class="bg-light" >}}
+{{< example class="bg-body-secondary" >}}
<div class="accordion accordion-flush" id="accordionFlushExample">
<div class="accordion-item">
- <h2 class="accordion-header" id="flush-headingOne">
+ <h2 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#flush-collapseOne" aria-expanded="false" aria-controls="flush-collapseOne">
Accordion Item #1
</button>
</h2>
- <div id="flush-collapseOne" class="accordion-collapse collapse" aria-labelledby="flush-headingOne" data-bs-parent="#accordionFlushExample">
+ <div id="flush-collapseOne" class="accordion-collapse collapse" data-bs-parent="#accordionFlushExample">
<div class="accordion-body">Placeholder content for this accordion, which is intended to demonstrate the <code>.accordion-flush</code> class. This is the first item's accordion body.</div>
</div>
</div>
<div class="accordion-item">
- <h2 class="accordion-header" id="flush-headingTwo">
+ <h2 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#flush-collapseTwo" aria-expanded="false" aria-controls="flush-collapseTwo">
Accordion Item #2
</button>
</h2>
- <div id="flush-collapseTwo" class="accordion-collapse collapse" aria-labelledby="flush-headingTwo" data-bs-parent="#accordionFlushExample">
+ <div id="flush-collapseTwo" class="accordion-collapse collapse" data-bs-parent="#accordionFlushExample">
<div class="accordion-body">Placeholder content for this accordion, which is intended to demonstrate the <code>.accordion-flush</code> class. This is the second item's accordion body. Let's imagine this being filled with some actual content.</div>
</div>
</div>
<div class="accordion-item">
- <h2 class="accordion-header" id="flush-headingThree">
+ <h2 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#flush-collapseThree" aria-expanded="false" aria-controls="flush-collapseThree">
Accordion Item #3
</button>
</h2>
- <div id="flush-collapseThree" class="accordion-collapse collapse" aria-labelledby="flush-headingThree" data-bs-parent="#accordionFlushExample">
+ <div id="flush-collapseThree" class="accordion-collapse collapse" data-bs-parent="#accordionFlushExample">
<div class="accordion-body">Placeholder content for this accordion, which is intended to demonstrate the <code>.accordion-flush</code> class. This is the third item's accordion body. Nothing more exciting happening here in terms of content, but just filling up the space to make it look, at least at first glance, a bit more representative of how this would look in a real-world application.</div>
</div>
</div>
@@ -108,36 +108,36 @@ Omit the `data-bs-parent` attribute on each `.accordion-collapse` to make accord
{{< example >}}
<div class="accordion" id="accordionPanelsStayOpenExample">
<div class="accordion-item">
- <h2 class="accordion-header" id="panelsStayOpen-headingOne">
+ <h2 class="accordion-header">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#panelsStayOpen-collapseOne" aria-expanded="true" aria-controls="panelsStayOpen-collapseOne">
Accordion Item #1
</button>
</h2>
- <div id="panelsStayOpen-collapseOne" class="accordion-collapse collapse show" aria-labelledby="panelsStayOpen-headingOne">
+ <div id="panelsStayOpen-collapseOne" class="accordion-collapse collapse show">
<div class="accordion-body">
<strong>This is the first item's accordion body.</strong> It is shown by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h2 class="accordion-header" id="panelsStayOpen-headingTwo">
+ <h2 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#panelsStayOpen-collapseTwo" aria-expanded="false" aria-controls="panelsStayOpen-collapseTwo">
Accordion Item #2
</button>
</h2>
- <div id="panelsStayOpen-collapseTwo" class="accordion-collapse collapse" aria-labelledby="panelsStayOpen-headingTwo">
+ <div id="panelsStayOpen-collapseTwo" class="accordion-collapse collapse">
<div class="accordion-body">
<strong>This is the second item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h2 class="accordion-header" id="panelsStayOpen-headingThree">
+ <h2 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#panelsStayOpen-collapseThree" aria-expanded="false" aria-controls="panelsStayOpen-collapseThree">
Accordion Item #3
</button>
</h2>
- <div id="panelsStayOpen-collapseThree" class="accordion-collapse collapse" aria-labelledby="panelsStayOpen-headingThree">
+ <div id="panelsStayOpen-collapseThree" class="accordion-collapse collapse">
<div class="accordion-body">
<strong>This is the third item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
diff --git a/site/content/docs/5.2/components/alerts.md b/site/content/docs/5.3/components/alerts.md
index 8837ed4..d634ce2 100644
--- a/site/content/docs/5.2/components/alerts.md
+++ b/site/content/docs/5.3/components/alerts.md
@@ -10,6 +10,10 @@ toc: true
Alerts are available for any length of text, as well as an optional close button. For proper styling, use one of the eight **required** contextual classes (e.g., `.alert-success`). For inline dismissal, use the [alerts JavaScript plugin](#dismissing).
+{{< callout info >}}
+**Heads up!** As of v5.3.0, the `alert-variant()` Sass mixin is deprecated. Alert variants now have their CSS variables overridden in [a Sass loop](#sass-loops).
+{{< /callout >}}
+
{{< example >}}
{{< alerts.inline >}}
{{- range (index $.Site.Data "theme-colors") }}
@@ -20,7 +24,7 @@ Alerts are available for any length of text, as well as an optional close button
{{< /example >}}
{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
{{< /callout >}}
### Live example
@@ -34,28 +38,7 @@ Click the button below to show an alert (hidden with inline styles to start), th
We use the following JavaScript to trigger our live alert demo:
-```js
-const alertPlaceholder = document.getElementById('liveAlertPlaceholder')
-
-const alert = (message, type) => {
- const wrapper = document.createElement('div')
- wrapper.innerHTML = [
- `<div class="alert alert-${type} alert-dismissible" role="alert">`,
- ` <div>${message}</div>`,
- ' <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>',
- '</div>'
- ].join('')
-
- alertPlaceholder.append(wrapper)
-}
-
-const alertTrigger = document.getElementById('liveAlertBtn')
-if (alertTrigger) {
- alertTrigger.addEventListener('click', () => {
- alert('Nice, you triggered this alert message!', 'success')
- })
-}
-```
+{{< js-docs name="live-alert" file="site/assets/js/snippets.js" >}}
### Link color
@@ -175,13 +158,15 @@ As part of Bootstrap's evolving CSS variables approach, alerts now use local CSS
{{< scss-docs name="alert-variables" file="scss/_variables.scss" >}}
-### Sass mixin
+### Sass mixins
+
+{{< deprecated-in "5.3.0" >}}
Used in combination with `$theme-colors` to create contextual modifier classes for our alerts.
{{< scss-docs name="alert-variant-mixin" file="scss/mixins/_alert.scss" >}}
-### Sass loop
+### Sass loops
Loop that generates the modifier classes with the `alert-variant()` mixin.
diff --git a/site/content/docs/5.2/components/badge.md b/site/content/docs/5.3/components/badge.md
index 55b1ffb..c073878 100644
--- a/site/content/docs/5.2/components/badge.md
+++ b/site/content/docs/5.3/components/badge.md
@@ -74,7 +74,7 @@ Set a `background-color` with contrasting foreground `color` with [our `.text-bg
{{< /example >}}
{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
{{< /callout >}}
## Pill badges
diff --git a/site/content/docs/5.2/components/breadcrumb.md b/site/content/docs/5.3/components/breadcrumb.md
index 0012f97..fc68fc5 100644
--- a/site/content/docs/5.2/components/breadcrumb.md
+++ b/site/content/docs/5.3/components/breadcrumb.md
@@ -54,11 +54,8 @@ $breadcrumb-divider: quote(">");
It's also possible to use an **embedded SVG icon**. Apply it via our CSS custom property, or use the Sass variable.
-
{{< callout info >}}
-### Using embedded SVG
-
-Inlining SVG as data URI requires to URL escape a few characters, most notably `<`, `>` and `#`. That's why the `$breadcrumb-divider` variable is passed through our [`escape-svg()` Sass function]({{< docsref "/customize/sass#escape-svg" >}}). When using the CSS custom property, you need to URL escape your SVG on your own. Read [Kevin Weber's explanations on CodePen](https://codepen.io/kevinweber/pen/dXWoRw ) for detailed information on what to escape.
+**Inlined SVG requires properly escaped characters.** Some reserved characters, such as `<`, `>` and `#`, must be URL-encoded or escaped. We do this with the `$breadcrumb-divider` variable using our [`escape-svg()` Sass function]({{< docsref "/customize/sass#escape-svg" >}}). When customizing the CSS variable, you must handle this yourself. Read [Kevin Weber's explanations on CodePen](https://codepen.io/kevinweber/pen/dXWoRw ) for more info.
{{< /callout >}}
{{< example >}}
diff --git a/site/content/docs/5.2/components/button-group.md b/site/content/docs/5.3/components/button-group.md
index 8f7d2d6..9c63562 100644
--- a/site/content/docs/5.2/components/button-group.md
+++ b/site/content/docs/5.3/components/button-group.md
@@ -18,12 +18,8 @@ Wrap a series of buttons with `.btn` in `.btn-group`.
</div>
{{< /example >}}
-{{< callout warning >}}
-##### Ensure correct `role` and provide a label
-
-In order for assistive technologies (such as screen readers) to convey that a series of buttons is grouped, an appropriate `role` attribute needs to be provided. For button groups, this would be `role="group"`, while toolbars should have a `role="toolbar"`.
-
-In addition, groups and toolbars should be given an explicit label, as most assistive technologies will otherwise not announce them, despite the presence of the correct role attribute. In the examples provided here, we use `aria-label`, but alternatives such as `aria-labelledby` can also be used.
+{{< callout info >}}
+Button groups require an appropriate `role` attribute and explicit label to ensure assistive technologies like screen readers identify buttons as grouped and announce them. Use `role="group"` for button groups or `role="toolbar"` for button toolbars. Then use `aria-label` or `aria-labelledby` to label them.
{{< /callout >}}
These classes can also be added to groups of links, as an alternative to the [`.nav` navigation components]({{< docsref "/components/navs-tabs" >}}).
@@ -145,21 +141,21 @@ Instead of applying button sizing classes to every button in a group, just add `
{{< example >}}
<div class="btn-group btn-group-lg" role="group" aria-label="Large button group">
- <button type="button" class="btn btn-outline-dark">Left</button>
- <button type="button" class="btn btn-outline-dark">Middle</button>
- <button type="button" class="btn btn-outline-dark">Right</button>
+ <button type="button" class="btn btn-outline-primary">Left</button>
+ <button type="button" class="btn btn-outline-primary">Middle</button>
+ <button type="button" class="btn btn-outline-primary">Right</button>
</div>
<br>
<div class="btn-group" role="group" aria-label="Default button group">
- <button type="button" class="btn btn-outline-dark">Left</button>
- <button type="button" class="btn btn-outline-dark">Middle</button>
- <button type="button" class="btn btn-outline-dark">Right</button>
+ <button type="button" class="btn btn-outline-primary">Left</button>
+ <button type="button" class="btn btn-outline-primary">Middle</button>
+ <button type="button" class="btn btn-outline-primary">Right</button>
</div>
<br>
<div class="btn-group btn-group-sm" role="group" aria-label="Small button group">
- <button type="button" class="btn btn-outline-dark">Left</button>
- <button type="button" class="btn btn-outline-dark">Middle</button>
- <button type="button" class="btn btn-outline-dark">Right</button>
+ <button type="button" class="btn btn-outline-primary">Left</button>
+ <button type="button" class="btn btn-outline-primary">Middle</button>
+ <button type="button" class="btn btn-outline-primary">Right</button>
</div>
{{< /example >}}
@@ -190,12 +186,12 @@ Make a set of buttons appear vertically stacked rather than horizontally. **Spli
{{< example >}}
<div class="btn-group-vertical" role="group" aria-label="Vertical button group">
- <button type="button" class="btn btn-dark">Button</button>
- <button type="button" class="btn btn-dark">Button</button>
- <button type="button" class="btn btn-dark">Button</button>
- <button type="button" class="btn btn-dark">Button</button>
- <button type="button" class="btn btn-dark">Button</button>
- <button type="button" class="btn btn-dark">Button</button>
+ <button type="button" class="btn btn-primary">Button</button>
+ <button type="button" class="btn btn-primary">Button</button>
+ <button type="button" class="btn btn-primary">Button</button>
+ <button type="button" class="btn btn-primary">Button</button>
+ <button type="button" class="btn btn-primary">Button</button>
+ <button type="button" class="btn btn-primary">Button</button>
</div>
{{< /example >}}
diff --git a/site/content/docs/5.2/components/buttons.md b/site/content/docs/5.3/components/buttons.md
index c2fdd75..ae58fca 100644
--- a/site/content/docs/5.2/components/buttons.md
+++ b/site/content/docs/5.3/components/buttons.md
@@ -6,9 +6,23 @@ group: components
toc: true
---
-## Examples
+## Base class
-Bootstrap includes several predefined button styles, each serving its own semantic purpose, with a few extras thrown in for more control.
+Bootstrap has a base `.btn` class that sets up basic styles such as padding and content alignment. By default, `.btn` controls have a transparent border and background color, and lack any explicit focus and hover styles.
+
+{{< example >}}
+<button type="button" class="btn">Base class</button>
+{{< /example >}}
+
+The `.btn` class is intended to be used in conjunction with our button variants, or to serve as a basis for your own custom styles.
+
+{{< callout warning >}}
+If you are using the `.btn` class on its own, remember to at least define some explicit `:focus` and/or `:focus-visible` styles.
+{{< /callout >}}
+
+## Variants
+
+Bootstrap includes several button variants, each serving its own semantic purpose, with a few extras thrown in for more control.
{{< example >}}
{{< buttons.inline >}}
@@ -21,7 +35,7 @@ Bootstrap includes several predefined button styles, each serving its own semant
{{< /example >}}
{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
{{< /callout >}}
## Disable text wrapping
diff --git a/site/content/docs/5.2/components/card.md b/site/content/docs/5.3/components/card.md
index 6bc90e7..2ad32b4 100644
--- a/site/content/docs/5.2/components/card.md
+++ b/site/content/docs/5.3/components/card.md
@@ -53,7 +53,7 @@ Subtitles are used by adding a `.card-subtitle` to a `<h*>` tag. If the `.card-t
<div class="card" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Card title</h5>
- <h6 class="card-subtitle mb-2 text-muted">Card subtitle</h6>
+ <h6 class="card-subtitle mb-2 text-body-secondary">Card subtitle</h6>
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
<a href="#" class="card-link">Card link</a>
<a href="#" class="card-link">Another link</a>
@@ -191,7 +191,7 @@ Card headers can be styled by adding `.card-header` to `<h*>` elements.
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
- <div class="card-footer text-muted">
+ <div class="card-footer text-body-secondary">
2 days ago
</div>
</div>
@@ -207,7 +207,7 @@ Using the grid, wrap cards in columns and rows as needed.
{{< example >}}
<div class="row">
- <div class="col-sm-6">
+ <div class="col-sm-6 mb-3 mb-sm-0">
<div class="card">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
@@ -233,7 +233,7 @@ Using the grid, wrap cards in columns and rows as needed.
Use our handful of [available sizing utilities]({{< docsref "/utilities/sizing" >}}) to quickly set a card's width.
{{< example >}}
-<div class="card w-75">
+<div class="card w-75 mb-3">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
@@ -269,7 +269,7 @@ Use custom CSS in your stylesheets or as inline styles to set a width.
You can quickly change the text alignment of any card—in its entirety or specific parts—with our [text align classes]({{< docsref "/utilities/text#text-alignment" >}}).
{{< example >}}
-<div class="card" style="width: 18rem;">
+<div class="card mb-3" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
@@ -277,7 +277,7 @@ You can quickly change the text alignment of any card—in its entirety or speci
</div>
</div>
-<div class="card text-center" style="width: 18rem;">
+<div class="card text-center mb-3" style="width: 18rem;">
<div class="card-body">
<h5 class="card-title">Special title treatment</h5>
<p class="card-text">With supporting text below as a natural lead-in to additional content.</p>
@@ -358,14 +358,14 @@ Similar to headers and footers, cards can include top and bottom "image caps"—
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
<div class="card">
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
{{< placeholder width="100%" height="180" class="card-img-bottom" text="Image cap" >}}
</div>
@@ -404,7 +404,7 @@ Using a combination of grid and utility classes, cards can be made horizontal in
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
</div>
@@ -436,7 +436,7 @@ Set a `background-color` with contrasting foreground `color` with [our `.text-bg
{{< /example >}}
{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
{{< /callout >}}
### Border
@@ -487,7 +487,7 @@ Use card groups to render cards as a single, attached element with equal width a
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
<div class="card">
@@ -495,7 +495,7 @@ Use card groups to render cards as a single, attached element with equal width a
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
<div class="card">
@@ -503,7 +503,7 @@ Use card groups to render cards as a single, attached element with equal width a
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
</div>
@@ -520,7 +520,7 @@ When using card groups with footers, their content will automatically line up.
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
<div class="card-footer">
- <small class="text-muted">Last updated 3 mins ago</small>
+ <small class="text-body-secondary">Last updated 3 mins ago</small>
</div>
</div>
<div class="card">
@@ -530,7 +530,7 @@ When using card groups with footers, their content will automatically line up.
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
</div>
<div class="card-footer">
- <small class="text-muted">Last updated 3 mins ago</small>
+ <small class="text-body-secondary">Last updated 3 mins ago</small>
</div>
</div>
<div class="card">
@@ -540,7 +540,7 @@ When using card groups with footers, their content will automatically line up.
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.</p>
</div>
<div class="card-footer">
- <small class="text-muted">Last updated 3 mins ago</small>
+ <small class="text-body-secondary">Last updated 3 mins ago</small>
</div>
</div>
</div>
@@ -689,7 +689,7 @@ Just like with card groups, card footers will automatically line up.
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
</div>
<div class="card-footer">
- <small class="text-muted">Last updated 3 mins ago</small>
+ <small class="text-body-secondary">Last updated 3 mins ago</small>
</div>
</div>
</div>
@@ -701,7 +701,7 @@ Just like with card groups, card footers will automatically line up.
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
</div>
<div class="card-footer">
- <small class="text-muted">Last updated 3 mins ago</small>
+ <small class="text-body-secondary">Last updated 3 mins ago</small>
</div>
</div>
</div>
@@ -713,7 +713,7 @@ Just like with card groups, card footers will automatically line up.
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.</p>
</div>
<div class="card-footer">
- <small class="text-muted">Last updated 3 mins ago</small>
+ <small class="text-body-secondary">Last updated 3 mins ago</small>
</div>
</div>
</div>
diff --git a/site/content/docs/5.2/components/carousel.md b/site/content/docs/5.3/components/carousel.md
index e32ce64..422f0aa 100644
--- a/site/content/docs/5.2/components/carousel.md
+++ b/site/content/docs/5.3/components/carousel.md
@@ -8,48 +8,24 @@ toc: true
## How it works
-The carousel is a slideshow for cycling through a series of content, built with CSS 3D transforms and a bit of JavaScript. It works with a series of images, text, or custom markup. It also includes support for previous/next controls and indicators.
+- The carousel is a slideshow for cycling through a series of content, built with CSS 3D transforms and a bit of JavaScript. It works with a series of images, text, or custom markup. It also includes support for previous/next controls and indicators.
-In browsers where the [Page Visibility API](https://www.w3.org/TR/page-visibility/) is supported, the carousel will avoid sliding when the webpage is not visible to the user (such as when the browser tab is inactive, the browser window is minimized, etc.).
+- For performance reasons, **carousels must be manually initialized** using the [carousel constructor method](#methods). Without initialization, some of the event listeners (specifically, the events needed touch/swipe support) will not be registered until a user has explicitly activated a control or indicator.
-{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
-{{< /callout >}}
-
-Please be aware that nested carousels are not supported, and carousels are generally not compliant with accessibility standards.
-
-## Example
-
-Carousels don't automatically normalize slide dimensions. As such, you may need to use additional utilities or custom styles to appropriately size content. While carousels support previous/next controls and indicators, they're not explicitly required. Add and customize as you see fit.
-
-**The `.active` class needs to be added to one of the slides** otherwise the carousel will not be visible. Also be sure to set a unique `id` on the `.carousel` for optional controls, especially if you're using multiple carousels on a single page. Control and indicator elements must have a `data-bs-target` attribute (or `href` for links) that matches the `id` of the `.carousel` element.
+ The only exception are [autoplaying carousels](#autoplaying-carousels) with the `data-bs-ride="carousel"` attribute as these are initialized automatically on page load. If you're using autoplaying carousels with the data attribute, **don't explicitly initialize the same carousels with the constructor method.**
-### Slides only
+- Nested carousels are not supported. You should also be aware that carousels in general can often cause usability and accessibility challenges.
-Here's a carousel with slides only. Note the presence of the `.d-block` and `.w-100` on carousel images to prevent browser default image alignment.
-
-{{< example >}}
-<div id="carouselExampleSlidesOnly" class="carousel slide" data-bs-ride="carousel">
- <div class="carousel-inner">
- <div class="carousel-item active">
- {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#555" background="#777" text="First slide" >}}
- </div>
- <div class="carousel-item">
- {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#444" background="#666" text="Second slide" >}}
- </div>
- <div class="carousel-item">
- {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#333" background="#555" text="Third slide" >}}
- </div>
- </div>
-</div>
-{{< /example >}}
+{{< callout info >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
+{{< /callout >}}
-### With controls
+## Basic examples
-Adding in the previous and next controls. We recommend using `<button>` elements, but you can also use `<a>` elements with `role="button"`.
+Here is a basic example of a carousel with three slides. Note the previous/next controls. We recommend using `<button>` elements, but you can also use `<a>` elements with `role="button"`.
{{< example >}}
-<div id="carouselExampleControls" class="carousel slide" data-bs-ride="carousel">
+<div id="carouselExample" class="carousel slide">
<div class="carousel-inner">
<div class="carousel-item active">
{{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#555" background="#777" text="First slide" >}}
@@ -61,23 +37,27 @@ Adding in the previous and next controls. We recommend using `<button>` elements
{{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#333" background="#555" text="Third slide" >}}
</div>
</div>
- <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleControls" data-bs-slide="prev">
+ <button class="carousel-control-prev" type="button" data-bs-target="#carouselExample" data-bs-slide="prev">
<span class="carousel-control-prev-icon" aria-hidden="true"></span>
<span class="visually-hidden">Previous</span>
</button>
- <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleControls" data-bs-slide="next">
+ <button class="carousel-control-next" type="button" data-bs-target="#carouselExample" data-bs-slide="next">
<span class="carousel-control-next-icon" aria-hidden="true"></span>
<span class="visually-hidden">Next</span>
</button>
</div>
{{< /example >}}
-### With indicators
+Carousels don't automatically normalize slide dimensions. As such, you may need to use additional utilities or custom styles to appropriately size content. While carousels support previous/next controls and indicators, they're not explicitly required. Add and customize as you see fit.
+
+**You must add the `.active` class to one of the slides**, otherwise the carousel will not be visible. Also be sure to set a unique `id` on the `.carousel` for optional controls, especially if you're using multiple carousels on a single page. Control and indicator elements must have a `data-bs-target` attribute (or `href` for links) that matches the `id` of the `.carousel` element.
-You can also add the indicators to the carousel, alongside the controls, too.
+### Indicators
+
+You can add indicators to the carousel, alongside the previous/next controls. The indicators let users jump directly to a particular slide.
{{< example >}}
-<div id="carouselExampleIndicators" class="carousel slide" data-bs-ride="true">
+<div id="carouselExampleIndicators" class="carousel slide">
<div class="carousel-indicators">
<button type="button" data-bs-target="#carouselExampleIndicators" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
<button type="button" data-bs-target="#carouselExampleIndicators" data-bs-slide-to="1" aria-label="Slide 2"></button>
@@ -105,12 +85,12 @@ You can also add the indicators to the carousel, alongside the controls, too.
</div>
{{< /example >}}
-### With captions
+### Captions
-Add captions to your slides easily with the `.carousel-caption` element within any `.carousel-item`. They can be easily hidden on smaller viewports, as shown below, with optional [display utilities]({{< docsref "/utilities/display" >}}). We hide them initially with `.d-none` and bring them back on medium-sized devices with `.d-md-block`.
+You can add captions to your slides with the `.carousel-caption` element within any `.carousel-item`. They can be easily hidden on smaller viewports, as shown below, with optional [display utilities]({{< docsref "/utilities/display" >}}). We hide them initially with `.d-none` and bring them back on medium-sized devices with `.d-md-block`.
{{< example >}}
-<div id="carouselExampleCaptions" class="carousel slide" data-bs-ride="false">
+<div id="carouselExampleCaptions" class="carousel slide">
<div class="carousel-indicators">
<button type="button" data-bs-target="#carouselExampleCaptions" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
<button type="button" data-bs-target="#carouselExampleCaptions" data-bs-slide-to="1" aria-label="Slide 2"></button>
@@ -155,7 +135,7 @@ Add captions to your slides easily with the `.carousel-caption` element within a
Add `.carousel-fade` to your carousel to animate slides with a fade transition instead of a slide. Depending on your carousel content (e.g., text only slides), you may want to add `.bg-body` or some custom CSS to the `.carousel-item`s for proper crossfading.
{{< example >}}
-<div id="carouselExampleFade" class="carousel slide carousel-fade" data-bs-ride="carousel">
+<div id="carouselExampleFade" class="carousel slide carousel-fade">
<div class="carousel-inner">
<div class="carousel-item active">
{{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#555" background="#777" text="First slide" >}}
@@ -178,6 +158,66 @@ Add `.carousel-fade` to your carousel to animate slides with a fade transition i
</div>
{{< /example >}}
+## Autoplaying carousels
+
+You can make your carousels autoplay on page load by setting the `ride` option to `carousel`. Autoplaying carousels automatically pause while hovered with the mouse. This behavior can be controlled with the `pause` option. In browsers that support the [Page Visibility API](https://www.w3.org/TR/page-visibility/), the carousel will stop cycling when the webpage is not visible to the user (such as when the browser tab is inactive, or when the browser window is minimized).
+
+{{< callout info >}}
+For accessibility reasons, we recommend avoiding the use of autoplaying carousels. If your page does include an autoplaying carousel, we recommend providing an additional button or control to explicitly pause/stop the carousel.
+
+See [WCAG 2.1 Success Criterion 2.2.2 Pause, Stop, Hide](https://www.w3.org/TR/WCAG21/#pause-stop-hide).
+{{< /callout >}}
+
+{{< example >}}
+<div id="carouselExampleAutoplaying" class="carousel slide" data-bs-ride="carousel">
+ <div class="carousel-inner">
+ <div class="carousel-item active">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#555" background="#777" text="First slide" >}}
+ </div>
+ <div class="carousel-item">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#444" background="#666" text="Second slide" >}}
+ </div>
+ <div class="carousel-item">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#333" background="#555" text="Third slide" >}}
+ </div>
+ </div>
+ <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleAutoplaying" data-bs-slide="prev">
+ <span class="carousel-control-prev-icon" aria-hidden="true"></span>
+ <span class="visually-hidden">Previous</span>
+ </button>
+ <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleAutoplaying" data-bs-slide="next">
+ <span class="carousel-control-next-icon" aria-hidden="true"></span>
+ <span class="visually-hidden">Next</span>
+ </button>
+</div>
+{{< /example >}}
+
+When the `ride` option is set to `true`, rather than `carousel`, the carousel won't automatically start to cycle on page load. Instead, it will only start after the first user interaction.
+
+{{< example >}}
+<div id="carouselExampleRide" class="carousel slide" data-bs-ride="true">
+ <div class="carousel-inner">
+ <div class="carousel-item active">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#555" background="#777" text="First slide" >}}
+ </div>
+ <div class="carousel-item">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#444" background="#666" text="Second slide" >}}
+ </div>
+ <div class="carousel-item">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#333" background="#555" text="Third slide" >}}
+ </div>
+ </div>
+ <button class="carousel-control-prev" type="button" data-bs-target="#carouselExampleRide" data-bs-slide="prev">
+ <span class="carousel-control-prev-icon" aria-hidden="true"></span>
+ <span class="visually-hidden">Previous</span>
+ </button>
+ <button class="carousel-control-next" type="button" data-bs-target="#carouselExampleRide" data-bs-slide="next">
+ <span class="carousel-control-next-icon" aria-hidden="true"></span>
+ <span class="visually-hidden">Next</span>
+ </button>
+</div>
+{{< /example >}}
+
### Individual `.carousel-item` interval
Add `data-bs-interval=""` to a `.carousel-item` to change the amount of time to delay between automatically cycling to the next item.
@@ -206,9 +246,29 @@ Add `data-bs-interval=""` to a `.carousel-item` to change the amount of time to
</div>
{{< /example >}}
-### Disable touch swiping
+### Autoplaying carousels without controls
-Carousels support swiping left/right on touchscreen devices to move between slides. This can be disabled using the `data-bs-touch` attribute. The example below also does not include the `data-bs-ride` attribute so it doesn't autoplay.
+Here's a carousel with slides only. Note the presence of the `.d-block` and `.w-100` on carousel images to prevent browser default image alignment.
+
+{{< example >}}
+<div id="carouselExampleSlidesOnly" class="carousel slide" data-bs-ride="carousel">
+ <div class="carousel-inner">
+ <div class="carousel-item active">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#555" background="#777" text="First slide" >}}
+ </div>
+ <div class="carousel-item">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#444" background="#666" text="Second slide" >}}
+ </div>
+ <div class="carousel-item">
+ {{< placeholder width="800" height="400" class="bd-placeholder-img-lg d-block w-100" color="#333" background="#555" text="Third slide" >}}
+ </div>
+ </div>
+</div>
+{{< /example >}}
+
+## Disable touch swiping
+
+Carousels support swiping left/right on touchscreen devices to move between slides. This can be disabled by setting the `touch` option to `false`.
{{< example >}}
<div id="carouselExampleControlsNoTouching" class="carousel slide" data-bs-touch="false">
@@ -236,10 +296,14 @@ Carousels support swiping left/right on touchscreen devices to move between slid
## Dark variant
-Add `.carousel-dark` to the `.carousel` for darker controls, indicators, and captions. Controls have been inverted from their default white fill with the `filter` CSS property. Captions and controls have additional Sass variables that customize the `color` and `background-color`.
+{{< deprecated-in "5.3.0" >}}
+
+Add `.carousel-dark` to the `.carousel` for darker controls, indicators, and captions. Controls are inverted compared to their default white fill with the `filter` CSS property. Captions and controls have additional Sass variables that customize the `color` and `background-color`.
+
+{{< callout-deprecated-dark-variants "carousel" >}}
{{< example >}}
-<div id="carouselExampleDark" class="carousel carousel-dark slide" data-bs-ride="carousel">
+<div id="carouselExampleDark" class="carousel carousel-dark slide">
<div class="carousel-indicators">
<button type="button" data-bs-target="#carouselExampleDark" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
<button type="button" data-bs-target="#carouselExampleDark" data-bs-slide-to="1" aria-label="Slide 2"></button>
@@ -283,9 +347,9 @@ Add `.carousel-dark` to the `.carousel` for darker controls, indicators, and cap
The transition duration of `.carousel-item` can be changed with the `$carousel-transition-duration` Sass variable before compiling or custom styles if you're using the compiled CSS. If multiple transitions are applied, make sure the transform transition is defined first (e.g. `transition: transform 2s ease, opacity .5s ease-out`).
-## Sass
+## CSS
-### Variables
+### Sass variables
Variables for all carousels:
@@ -301,8 +365,6 @@ Variables for the [dark carousel](#dark-variant):
Use data attributes to easily control the position of the carousel. `data-bs-slide` accepts the keywords `prev` or `next`, which alters the slide position relative to its current position. Alternatively, use `data-bs-slide-to` to pass a raw slide index to the carousel `data-bs-slide-to="2"`, which shifts the slide position to a particular index beginning with `0`.
-The `data-bs-ride="carousel"` attribute is used to mark a carousel as animating starting at page load. If you don't use `data-bs-ride="carousel"` to initialize your carousel, you have to initialize it yourself. **It cannot be used in combination with (redundant and unnecessary) explicit JavaScript initialization of the same carousel.**
-
### Via JavaScript
Call carousel manually with:
@@ -331,28 +393,29 @@ const carousel = new bootstrap.Carousel('#myCarousel')
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
-You can create a carousel instance with the carousel constructor, for example, to initialize with additional options and start cycling through items:
+You can create a carousel instance with the carousel constructor, and pass on any additional options. For example, to manually initialize an autoplaying carousel (assuming you're not using the `data-bs-ride="carousel"` attribute in the markup itself) with a specific interval and with touch support disabled, you can use:
```js
const myCarouselElement = document.querySelector('#myCarousel')
+
const carousel = new bootstrap.Carousel(myCarouselElement, {
interval: 2000,
- wrap: false
+ touch: false
})
```
{{< bs-table >}}
| Method | Description |
| --- | --- |
-| `cycle` | Cycles through the carousel items from left to right. |
+| `cycle` | Starts cycling through the carousel items from left to right. |
| `dispose` | Destroys an element's carousel. (Removes stored data on the DOM element) |
-| `getInstance` | Static method which allows you to get the carousel instance associated to a DOM element, you can use it like this: `bootstrap.Carousel.getInstance(element)`. |
-| `getOrCreateInstance` | Static method which returns a carousel instance associated to a DOM element or create a new one in case it wasn't initialized. You can use it like this: `bootstrap.Carousel.getOrCreateInstance(element)`. |
+| `getInstance` | Static method which allows you to get the carousel instance associated to a DOM element. You can use it like this: `bootstrap.Carousel.getInstance(element)`. |
+| `getOrCreateInstance` | Static method which returns a carousel instance associated to a DOM element, or creates a new one in case it wasn't initialized. You can use it like this: `bootstrap.Carousel.getOrCreateInstance(element)`. |
| `next` | Cycles to the next item. **Returns to the caller before the next item has been shown** (e.g., before the `slid.bs.carousel` event occurs). |
-| `nextWhenVisible` | Don't cycle carousel to next when the page isn't visible or the carousel or its parent isn't visible. **Returns to the caller before the target item has been shown**. |
+| `nextWhenVisible` | Don't cycle carousel to next when the page, the carousel, or the carousel's parent aren't visible. **Returns to the caller before the target item has been shown**. |
| `pause` | Stops the carousel from cycling through items. |
| `prev` | Cycles to the previous item. **Returns to the caller before the previous item has been shown** (e.g., before the `slid.bs.carousel` event occurs). |
| `to` | Cycles the carousel to a particular frame (0 based, similar to an array). **Returns to the caller before the target item has been shown** (e.g., before the `slid.bs.carousel` event occurs). |
diff --git a/site/content/docs/5.3/components/close-button.md b/site/content/docs/5.3/components/close-button.md
new file mode 100644
index 0000000..533271b
--- /dev/null
+++ b/site/content/docs/5.3/components/close-button.md
@@ -0,0 +1,54 @@
+---
+layout: docs
+title: Close button
+description: A generic close button for dismissing content like modals and alerts.
+group: components
+toc: true
+---
+
+## Example
+
+Provide an option to dismiss or close a component with `.btn-close`. Default styling is limited, but highly customizable. Modify the Sass variables to replace the default `background-image`. **Be sure to include text for screen readers**, as we've done with `aria-label`.
+
+{{< example >}}
+<button type="button" class="btn-close" aria-label="Close"></button>
+{{< /example >}}
+
+## Disabled state
+
+Disabled close buttons change their `opacity`. We've also applied `pointer-events: none` and `user-select: none` to preventing hover and active states from triggering.
+
+{{< example >}}
+<button type="button" class="btn-close" disabled aria-label="Close"></button>
+{{< /example >}}
+
+## Dark variant
+
+{{< deprecated-in "5.3.0" >}}
+
+{{< callout warning >}}
+**Heads up!** As of v5.3.0, the `.btn-close-white` class is deprecated. Instead, use `data-bs-theme="dark"` to change the color mode of the close button.
+{{< /callout >}}
+
+Add `data-bs-theme="dark"` to the `.btn-close`, or to its parent element, to invert the close button. This uses the `filter` property to invert the `background-image` without overriding its value.
+
+{{< example class="bg-dark" >}}
+<div data-bs-theme="dark">
+ <button type="button" class="btn-close" aria-label="Close"></button>
+ <button type="button" class="btn-close" disabled aria-label="Close"></button>
+</div>
+{{< /example >}}
+
+## CSS
+
+### Variables
+
+{{< added-in "5.3.0" >}}
+
+As part of Bootstrap's evolving CSS variables approach, close button now uses local CSS variables on `.btn-close` for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.
+
+{{< scss-docs name="close-css-vars" file="scss/_close.scss" >}}
+
+### Sass variables
+
+{{< scss-docs name="close-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/components/collapse.md b/site/content/docs/5.3/components/collapse.md
index 21be901..21b9c3e 100644
--- a/site/content/docs/5.2/components/collapse.md
+++ b/site/content/docs/5.3/components/collapse.md
@@ -11,7 +11,7 @@ toc: true
The collapse JavaScript plugin is used to show and hide content. Buttons or anchors are used as triggers that are mapped to specific elements you toggle. Collapsing an element will animate the `height` from its current value to `0`. Given how CSS handles animations, you cannot use `padding` on a `.collapse` element. Instead, use the class as an independent wrapping element.
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
## Example
@@ -22,7 +22,7 @@ Click the buttons below to show and hide another element via class changes:
- `.collapsing` is applied during transitions
- `.collapse.show` shows content
-Generally, we recommend using a button with the `data-bs-target` attribute. While not recommended from a semantic point of view, you can also use a link with the `href` attribute (and a `role="button"`). In both cases, the `data-bs-toggle="collapse"` is required.
+Generally, we recommend using a `<button>` with the `data-bs-target` attribute. While not recommended from a semantic point of view, you can also use an `<a>` link with the `href` attribute (and a `role="button"`). In both cases, the `data-bs-toggle="collapse"` is required.
{{< example >}}
<p>
@@ -42,7 +42,7 @@ Generally, we recommend using a button with the `data-bs-target` attribute. Whil
## Horizontal
-The collapse plugin also supports horizontal collapsing. Add the `.collapse-horizontal` modifier class to transition the `width` instead of `height` and set a `width` on the immediate child element. Feel free to write your own custom Sass, use inline styles, or use our [width utilities]({{< docsref "/utilities/sizing" >}}).
+The collapse plugin supports horizontal collapsing. Add the `.collapse-horizontal` modifier class to transition the `width` instead of `height` and set a `width` on the immediate child element. Feel free to write your own custom Sass, use inline styles, or use our [width utilities]({{< docsref "/utilities/sizing" >}}).
{{< callout info >}}
Please note that while the example below has a `min-height` set to avoid excessive repaints in our docs, this is not explicitly required. **Only the `width` on the child element is required.**
@@ -63,10 +63,10 @@ Please note that while the example below has a `min-height` set to avoid excessi
</div>
{{< /example >}}
-## Multiple targets
+## Multiple toggles and targets
-A `<button>` or `<a>` can show and hide multiple elements by referencing them with a selector in its `href` or `data-bs-target` attribute.
-Multiple `<button>` or `<a>` can show and hide an element if they each reference it with their `href` or `data-bs-target` attribute
+A `<button>` or `<a>` element can show and hide multiple elements by referencing them with a selector in its `data-bs-target` or `href` attribute.
+Conversely, multiple `<button>` or `<a>` elements can show and hide the same element if they each reference it with their `data-bs-target` or `href` attribute.
{{< example >}}
<p>
@@ -100,9 +100,9 @@ If your control element is targeting a single collapsible element – i.e. the `
Note that Bootstrap's current implementation does not cover the various *optional* keyboard interactions described in the [ARIA Authoring Practices Guide accordion pattern](https://www.w3.org/WAI/ARIA/apg/patterns/accordion/) - you will need to include these yourself with custom JavaScript.
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="collapse-transition" file="scss/_variables.scss" >}}
@@ -153,7 +153,7 @@ const collapseList = [...collapseElementList].map(collapseEl => new bootstrap.Co
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
Activates your content as a collapsible element. Accepts an optional options `object`.
diff --git a/site/content/docs/5.2/components/dropdowns.md b/site/content/docs/5.3/components/dropdowns.md
index b589227..0988820 100644
--- a/site/content/docs/5.2/components/dropdowns.md
+++ b/site/content/docs/5.3/components/dropdowns.md
@@ -18,15 +18,15 @@ The [<abbr title="Web Accessibility Initiative">WAI</abbr> <abbr title="Accessib
Bootstrap's dropdowns, on the other hand, are designed to be generic and applicable to a variety of situations and markup structures. For instance, it is possible to create dropdowns that contain additional inputs and form controls, such as search fields or login forms. For this reason, Bootstrap does not expect (nor automatically add) any of the `role` and `aria-` attributes required for true <abbr title="Accessible Rich Internet Applications">ARIA</abbr> menus. Authors will have to include these more specific attributes themselves.
-However, Bootstrap does add built-in support for most standard keyboard menu interactions, such as the ability to move through individual `.dropdown-item` elements using the cursor keys and close the menu with the <kbd>ESC</kbd> key.
+However, Bootstrap does add built-in support for most standard keyboard menu interactions, such as the ability to move through individual `.dropdown-item` elements using the cursor keys and close the menu with the <kbd>Esc</kbd> key.
## Examples
-Wrap the dropdown's toggle (your button or link) and the dropdown menu within `.dropdown`, or another element that declares `position: relative;`. Dropdowns can be triggered from `<a>` or `<button>` elements to better fit your potential needs. The examples shown here use semantic `<ul>` elements where appropriate, but custom markup is supported.
+Wrap the dropdown's toggle (your button or link) and the dropdown menu within `.dropdown`, or another element that declares `position: relative;`. Ideally, you should use a `<button>` element as the dropdown trigger, but the plugin will work with `<a>` elements as well. The examples shown here use semantic `<ul>` elements where appropriate, but custom markup is supported.
### Single button
-Any single `.btn` can be turned into a dropdown toggle with some markup changes. Here's how you can put them to work with either `<button>` elements:
+Any single `.btn` can be turned into a dropdown toggle with some markup changes. Here's how you can put them to work with `<button>` elements:
{{< example >}}
<div class="dropdown">
@@ -41,7 +41,7 @@ Any single `.btn` can be turned into a dropdown toggle with some markup changes.
</div>
{{< /example >}}
-And with `<a>` elements:
+While `<button>` is the recommended control for a dropdown toggle, there might be situations where you have to use an `<a>` element. If you do, we recommend adding a `role="button"` attribute to appropriately convey control's purpose to assistive technologies such as screen readers.
{{< example >}}
<div class="dropdown">
@@ -349,8 +349,12 @@ Button dropdowns work with buttons of all sizes, including default and split dro
## Dark dropdowns
+{{< deprecated-in "5.3.0" >}}
+
Opt into darker dropdowns to match a dark navbar or custom style by adding `.dropdown-menu-dark` onto an existing `.dropdown-menu`. No changes are required to the dropdown items.
+{{< callout-deprecated-dark-variants "dropdown-menu" >}}
+
{{< example >}}
<div class="dropdown">
<button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" aria-expanded="false">
@@ -378,9 +382,9 @@ And putting it to use in a navbar:
<div class="collapse navbar-collapse" id="navbarNavDarkDropdown">
<ul class="navbar-nav">
<li class="nav-item dropdown">
- <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
+ <button class="btn btn-dark dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
Dropdown
- </a>
+ </button>
<ul class="dropdown-menu dropdown-menu-dark">
<li><a class="dropdown-item" href="#">Action</a></li>
<li><a class="dropdown-item" href="#">Another action</a></li>
@@ -396,8 +400,7 @@ And putting it to use in a navbar:
## Directions
{{< callout info >}}
-#### RTL
-Directions are mirrored when using Bootstrap in RTL, meaning `.dropstart` will appear on the right side.
+**Directions are flipped in RTL mode.** As such, `.dropstart` will appear on the right side.
{{< /callout >}}
### Centered
@@ -838,7 +841,7 @@ Separate groups of related menu items with a divider.
Place any freeform text within a dropdown menu with text and use [spacing utilities]({{< docsref "/utilities/spacing" >}}). Note that you'll likely need additional sizing styles to constrain the menu width.
{{< example >}}
-<div class="dropdown-menu p-4 text-muted" style="max-width: 200px;">
+<div class="dropdown-menu p-4 text-body-secondary" style="max-width: 200px;">
<p>
Some example text that's free-flowing within the dropdown menu.
</p>
@@ -956,7 +959,7 @@ By default, the dropdown menu is closed when clicking inside or outside the drop
<div class="btn-group">
<button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" data-bs-auto-close="inside" aria-expanded="false">
- Clickable outside
+ Clickable inside
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Menu item</a></li>
@@ -967,7 +970,7 @@ By default, the dropdown menu is closed when clicking inside or outside the drop
<div class="btn-group">
<button class="btn btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" data-bs-auto-close="outside" aria-expanded="false">
- Clickable inside
+ Clickable outside
</button>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#">Menu item</a></li>
@@ -998,6 +1001,12 @@ As part of Bootstrap's evolving CSS variables approach, dropdowns now use local
{{< scss-docs name="dropdown-css-vars" file="scss/_dropdown.scss" >}}
+{{< callout info >}}
+Dropdown items include at least one variable that is not set on `.dropdown`. This allows you to provide a new value while Bootstrap defaults to a fallback value.
+
+- `--bs-dropdown-item-border-radius`
+{{< /callout >}}
+
Customization through CSS variables can be seen on the `.dropdown-menu-dark` class where we override specific values without adding duplicate CSS selectors.
{{< scss-docs name="dropdown-dark-css-vars" file="scss/_dropdown.scss" >}}
@@ -1016,7 +1025,7 @@ Variables for the CSS-based carets that indicate a dropdown's interactivity:
{{< scss-docs name="caret-variables" file="scss/_variables.scss" >}}
-### Mixins
+### Sass mixins
Mixins are used to generate the CSS-based carets and can be found in `scss/mixins/_caret.scss`.
@@ -1047,6 +1056,10 @@ Add `data-bs-toggle="dropdown"` to a link or button to toggle a dropdown.
### Via JavaScript
+{{< callout warning >}}
+Dropdowns must have `data-bs-toggle="dropdown"` on their trigger element, regardless of whether you call your dropdown via JavaScript or use the data-api.
+{{< /callout >}}
+
Call the dropdowns via JavaScript:
```js
@@ -1054,12 +1067,6 @@ const dropdownElementList = document.querySelectorAll('.dropdown-toggle')
const dropdownList = [...dropdownElementList].map(dropdownToggleEl => new bootstrap.Dropdown(dropdownToggleEl))
```
-{{< callout info >}}
-##### `data-bs-toggle="dropdown"` still required
-
-Regardless of whether you call your dropdown via JavaScript or instead use the data-api, `data-bs-toggle="dropdown"` is always required to be present on the dropdown's trigger element.
-{{< /callout >}}
-
### Options
{{< markdown >}}
@@ -1069,7 +1076,7 @@ Regardless of whether you call your dropdown via JavaScript or instead use the d
{{< bs-table "table" >}}
| Name | Type | Default | Description |
| --- | --- | --- | --- |
-| `autoClose` | boolean, string | `true` | Configure the auto close behavior of the dropdown: <ul class="my-2"><li>`true` - the dropdown will be closed by clicking outside or inside the dropdown menu.</li><li>`false` - the dropdown will be closed by clicking the toggle button and manually calling `hide` or `toggle` method. (Also will not be closed by pressing <kbd>esc</kbd> key)</li><li>`'inside'` - the dropdown will be closed (only) by clicking inside the dropdown menu.</li> <li>`'outside'` - the dropdown will be closed (only) by clicking outside the dropdown menu.</li></ul> Note: the dropdown can always be closed with the <kbd>ESC</kbd> key. |
+| `autoClose` | boolean, string | `true` | Configure the auto close behavior of the dropdown: <ul class="my-2"><li>`true` - the dropdown will be closed by clicking outside or inside the dropdown menu.</li><li>`false` - the dropdown will be closed by clicking the toggle button and manually calling `hide` or `toggle` method. (Also will not be closed by pressing <kbd>Esc</kbd> key)</li><li>`'inside'` - the dropdown will be closed (only) by clicking inside the dropdown menu.</li> <li>`'outside'` - the dropdown will be closed (only) by clicking outside the dropdown menu.</li></ul> Note: the dropdown can always be closed with the <kbd>Esc</kbd> key. |
| `boundary` | string, element | `'clippingParents'` | Overflow constraint boundary of the dropdown menu (applies only to Popper's preventOverflow modifier). By default it's `clippingParents` and can accept an HTMLElement reference (via JavaScript only). For more information refer to Popper's [detectOverflow docs](https://popper.js.org/docs/v2/utils/detect-overflow/#boundary). |
| `display` | string | `'dynamic'` | By default, we use Popper for dynamic positioning. Disable this with `static`. |
| `offset` | array, string, function | `[0, 2]` | Offset of the dropdown relative to its target. You can pass a string in data attributes with comma separated values like: `data-bs-offset="10,20"`. When a function is used to determine the offset, it is called with an object containing the popper placement, the reference, and popper rects as its first argument. The triggering element DOM node is passed as the second argument. The function must return an array with two numbers: [skidding](https://popper.js.org/docs/v2/modifiers/offset/#skidding-1), [distance](https://popper.js.org/docs/v2/modifiers/offset/#distance-1). For more information refer to Popper's [offset docs](https://popper.js.org/docs/v2/modifiers/offset/#options). |
diff --git a/site/content/docs/5.2/components/list-group.md b/site/content/docs/5.3/components/list-group.md
index 7804c74..6c22809 100644
--- a/site/content/docs/5.2/components/list-group.md
+++ b/site/content/docs/5.3/components/list-group.md
@@ -154,7 +154,11 @@ Add `.list-group-horizontal` to change the layout of list group items from verti
{{< /list-group.inline >}}
{{< /example >}}
-## Contextual classes
+## Variants
+
+{{< callout info >}}
+**Heads up!** As of v5.3.0, the `list-group-item-variant()` Sass mixin is deprecated. List group item variants now have their CSS variables overridden in [a Sass loop](#sass-loops).
+{{< /callout >}}
Use contextual classes to style list items with a stateful background and color.
@@ -169,7 +173,9 @@ Use contextual classes to style list items with a stateful background and color.
</ul>
{{< /example >}}
-Contextual classes also work with `.list-group-item-action`. Note the addition of the hover styles here not present in the previous example. Also supported is the `.active` state; apply it to indicate an active selection on a contextual list group item.
+### For links and buttons
+
+Contextual classes also work with `.list-group-item-action` for `<a>` and `<button>` elements. Note the addition of the hover styles here not present in the previous example. Also supported is the `.active` state; apply it to indicate an active selection on a contextual list group item.
{{< example >}}
<div class="list-group">
@@ -183,7 +189,7 @@ Contextual classes also work with `.list-group-item-action`. Note the addition o
{{< /example >}}
{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
{{< /callout >}}
## With badges
@@ -224,18 +230,18 @@ Add nearly any HTML within, even for linked list groups like the one below, with
<a href="#" class="list-group-item list-group-item-action">
<div class="d-flex w-100 justify-content-between">
<h5 class="mb-1">List group item heading</h5>
- <small class="text-muted">3 days ago</small>
+ <small class="text-body-secondary">3 days ago</small>
</div>
<p class="mb-1">Some placeholder content in a paragraph.</p>
- <small class="text-muted">And some muted small print.</small>
+ <small class="text-body-secondary">And some muted small print.</small>
</a>
<a href="#" class="list-group-item list-group-item-action">
<div class="d-flex w-100 justify-content-between">
<h5 class="mb-1">List group item heading</h5>
- <small class="text-muted">3 days ago</small>
+ <small class="text-body-secondary">3 days ago</small>
</div>
<p class="mb-1">Some placeholder content in a paragraph.</p>
- <small class="text-muted">And some muted small print.</small>
+ <small class="text-body-secondary">And some muted small print.</small>
</a>
</div>
{{< /example >}}
@@ -311,15 +317,17 @@ As part of Bootstrap's evolving CSS variables approach, list groups now use loca
{{< scss-docs name="list-group-variables" file="scss/_variables.scss" >}}
-### Mixins
+### Sass mixins
+
+{{< deprecated-in "5.3.0" >}}
-Used in combination with `$theme-colors` to generate the [contextual variant classes](#contextual-classes) for `.list-group-item`s.
+Used in combination with `$theme-colors` to generate the [contextual variant classes](#variants) for `.list-group-item`s.
{{< scss-docs name="list-group-mixin" file="scss/mixins/_list-group.scss" >}}
-### Loop
+### Sass loops
-Loop that generates the modifier classes with the `list-group-item-variant()` mixin.
+Loop that generates the modifier classes with an overriding of CSS variables.
{{< scss-docs name="list-group-modifiers" file="scss/_list-group.scss" >}}
@@ -443,7 +451,7 @@ To make tabs panel fade in, add `.fade` to each `.tab-pane`. The first tab pane
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
Activates your content as a tab element.
diff --git a/site/content/docs/5.2/components/modal.md b/site/content/docs/5.3/components/modal.md
index ed31b73..ba2a51a 100644
--- a/site/content/docs/5.2/components/modal.md
+++ b/site/content/docs/5.3/components/modal.md
@@ -27,7 +27,7 @@ myModal.addEventListener('shown.bs.modal', () => {
```
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
Keep reading for demos and usage guidelines.
@@ -38,7 +38,7 @@ Keep reading for demos and usage guidelines.
Below is a _static_ modal example (meaning its `position` and `display` have been overridden). Included are the modal header, modal body (required for `padding`), and modal footer (optional). We ask that you include modal headers with dismiss actions whenever possible, or provide another explicit dismiss action.
-<div class="bd-example bg-light">
+<div class="bd-example bg-body-tertiary">
<div class="modal position-static d-block" tabindex="-1">
<div class="modal-dialog">
<div class="modal-content">
@@ -202,7 +202,7 @@ When modals become too long for the user's viewport or device, they scroll indep
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body" style="min-height: 1500px">
- <p>This is some placeholder content to show the scrolling behavior for modals. Instead of repeating the text the modal, we use an inline style set a minimum height, thereby extending the length of the overall modal and demonstrating the overflow scrolling. When content becomes longer than the height of the viewport, scrolling will move the modal as needed.</p>
+ <p>This is some placeholder content to show the scrolling behavior for modals. Instead of repeating the text in the modal, we use an inline style to set a minimum height, thereby extending the length of the overall modal and demonstrating the overflow scrolling. When content becomes longer than the height of the viewport, scrolling will move the modal as needed.</p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
@@ -329,7 +329,7 @@ Add `.modal-dialog-centered` to `.modal-dialog` to vertically center the modal.
</div>
<div class="modal-body">
<h2 class="fs-5">Popover in a modal</h2>
- <p>This <a href="#" role="button" class="btn btn-secondary" data-bs-toggle="popover" title="Popover title" data-bs-content="Popover body content is set in this attribute." data-bs-container="#exampleModalPopovers">button</a> triggers a popover on click.</p>
+ <p>This <button class="btn btn-secondary" data-bs-toggle="popover" title="Popover title" data-bs-content="Popover body content is set in this attribute." data-bs-container="#exampleModalPopovers">button</button> triggers a popover on click.</p>
<hr>
<h2 class="fs-5">Tooltips in a modal</h2>
<p><a href="#" data-bs-toggle="tooltip" title="Tooltip" data-bs-container="#exampleModalPopovers">This link</a> and <a href="#" data-bs-toggle="tooltip" title="Tooltip" data-bs-container="#exampleModalPopovers">that link</a> have tooltips on hover.</p>
@@ -351,7 +351,7 @@ Add `.modal-dialog-centered` to `.modal-dialog` to vertically center the modal.
```html
<div class="modal-body">
<h2 class="fs-5">Popover in a modal</h2>
- <p>This <a href="#" role="button" class="btn btn-secondary" data-bs-toggle="popover" title="Popover title" data-bs-content="Popover body content is set in this attribute.">button</a> triggers a popover on click.</p>
+ <p>This <button class="btn btn-secondary" data-bs-toggle="popover" title="Popover title" data-bs-content="Popover body content is set in this attribute.">button</button> triggers a popover on click.</p>
<hr>
<h2 class="fs-5">Tooltips in a modal</h2>
<p><a href="#" data-bs-toggle="tooltip" title="Tooltip">This link</a> and <a href="#" data-bs-toggle="tooltip" title="Tooltip">that link</a> have tooltips on hover.</p>
@@ -481,24 +481,7 @@ Below is a live demo followed by example HTML and JavaScript. For more informati
</div>
{{< /example >}}
-```js
-const exampleModal = document.getElementById('exampleModal')
-exampleModal.addEventListener('show.bs.modal', event => {
- // Button that triggered the modal
- const button = event.relatedTarget
- // Extract info from data-bs-* attributes
- const recipient = button.getAttribute('data-bs-whatever')
- // If necessary, you could initiate an AJAX request here
- // and then do the updating in a callback.
- //
- // Update the modal's content.
- const modalTitle = exampleModal.querySelector('.modal-title')
- const modalBodyInput = exampleModal.querySelector('.modal-body input')
-
- modalTitle.textContent = `New message to ${recipient}`
- modalBodyInput.value = recipient
-})
-```
+{{< js-docs name="varying-modal-content" file="site/assets/js/snippets.js" >}}
### Toggle between modals
@@ -537,7 +520,7 @@ Toggle between multiple modals with some clever placement of the `data-bs-target
</div>
</div>
</div>
-<a class="btn btn-primary" data-bs-toggle="modal" href="#exampleModalToggle" role="button">Open first modal</a>
+<button class="btn btn-primary" data-bs-target="#exampleModalToggle" data-bs-toggle="modal">Open first modal</button>
{{< /example >}}
### Change animation
@@ -576,7 +559,7 @@ Modals have three optional sizes, available via modifier classes to be placed on
| Size | Class | Modal max-width
| --- | --- | --- |
| Small | `.modal-sm` | `300px` |
-| Default | <span class="text-muted">None</span> | `500px` |
+| Default | <span class="text-body-secondary">None</span> | `500px` |
| Large | `.modal-lg` | `800px` |
| Extra large | `.modal-xl` | `1140px` |
{{< /bs-table >}}
@@ -643,7 +626,7 @@ Another override is the option to pop up a modal that covers the user viewport,
{{< bs-table >}}
| Class | Availability |
-| --- | --- | --- |
+| --- | --- |
| `.modal-fullscreen` | Always |
| `.modal-fullscreen-sm-down` | `576px` |
| `.modal-fullscreen-md-down` | `768px` |
@@ -786,7 +769,7 @@ As part of Bootstrap's evolving CSS variables approach, modals now use local CSS
{{< scss-docs name="modal-variables" file="scss/_variables.scss" >}}
-### Loop
+### Sass loops
[Responsive fullscreen modals](#fullscreen-modal) are generated via the `$breakpoints` map and a loop in `scss/_modal.scss`.
@@ -841,7 +824,7 @@ const myModalAlternative = new bootstrap.Modal('#myModal', options)
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
#### Passing options
@@ -858,8 +841,8 @@ const myModal = new bootstrap.Modal('#myModal', {
| Method | Description |
| --- | --- |
| `dispose` | Destroys an element's modal. (Removes stored data on the DOM element) |
-| `getInstance` | *Static* method which allows you to get the modal instance associated with a DOM element. |
-| `getOrCreateInstance` | *Static* method which allows you to get the modal instance associated with a DOM element, or create a new one in case it wasn't initialized. |
+| `getInstance` | _Static_ method which allows you to get the modal instance associated with a DOM element. |
+| `getOrCreateInstance` | _Static_ method which allows you to get the modal instance associated with a DOM element, or create a new one in case it wasn't initialized. |
| `handleUpdate` | Manually readjust the modal's position if the height of a modal changes while it is open (i.e. in case a scrollbar appears). |
| `hide` | Manually hides a modal. **Returns to the caller before the modal has actually been hidden** (i.e. before the `hidden.bs.modal` event occurs). |
| `show` | Manually opens a modal. **Returns to the caller before the modal has actually been shown** (i.e. before the `shown.bs.modal` event occurs). Also, you can pass a DOM element as an argument that can be received in the modal events (as the `relatedTarget` property). (i.e. `const modalToggle = document.getElementById('toggleMyModal'); myModal.show(modalToggle)`. |
diff --git a/site/content/docs/5.2/components/navbar.md b/site/content/docs/5.3/components/navbar.md
index 7cbc4e2..9b9f86a 100644
--- a/site/content/docs/5.2/components/navbar.md
+++ b/site/content/docs/5.3/components/navbar.md
@@ -19,7 +19,7 @@ Here's what you need to know before getting started with the navbar:
- **New in v5.2.0:** Navbars can be themed with CSS variables that are scoped to the `.navbar` base class. `.navbar-light` has been deprecated and `.navbar-dark` has been rewritten to override CSS variables instead of adding additional styles.
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
## Supported content
@@ -37,7 +37,7 @@ Navbars come with built-in support for a handful of sub-components. Choose from
Here's an example of all the sub-components included in a responsive light-themed navbar that automatically collapses at the `lg` (large) breakpoint.
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
@@ -75,7 +75,7 @@ Here's an example of all the sub-components included in a responsive light-theme
</nav>
{{< /example >}}
-This example uses [background]({{< docsref "/utilities/background" >}}) (`bg-light`) and [spacing]({{< docsref "/utilities/spacing" >}}) (`me-auto`, `mb-2`, `mb-lg-0`, `me-2`) utility classes.
+This example uses [background]({{< docsref "/utilities/background" >}}) (`bg-body-tertiary`) and [spacing]({{< docsref "/utilities/spacing" >}}) (`me-auto`, `mb-2`, `mb-lg-0`, `me-2`) utility classes.
### Brand
@@ -87,14 +87,14 @@ Add your text within an element with the `.navbar-brand` class.
{{< example >}}
<!-- As a link -->
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
</div>
</nav>
<!-- As a heading -->
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container-fluid">
<span class="navbar-brand mb-0 h1">Navbar</span>
</div>
@@ -106,7 +106,7 @@ Add your text within an element with the `.navbar-brand` class.
You can replace the text within the `.navbar-brand` with an `<img>`.
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container">
<a class="navbar-brand" href="#">
<img src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo.svg" alt="Bootstrap" width="30" height="24">
@@ -120,7 +120,7 @@ You can replace the text within the `.navbar-brand` with an `<img>`.
You can also make use of some additional utilities to add an image and text at the same time. Note the addition of `.d-inline-block` and `.align-text-top` on the `<img>`.
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">
<img src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo.svg" alt="Logo" width="30" height="24" class="d-inline-block align-text-top">
@@ -139,7 +139,7 @@ Add the `.active` class on `.nav-link` to indicate the current page.
Please note that you should also add the `aria-current` attribute on the active `.nav-link`.
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
@@ -168,7 +168,7 @@ Please note that you should also add the `aria-current` attribute on the active
And because we use classes for our navs, you can avoid the list-based approach entirely if you like.
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavAltMarkup" aria-controls="navbarNavAltMarkup" aria-expanded="false" aria-label="Toggle navigation">
@@ -189,7 +189,7 @@ And because we use classes for our navs, you can avoid the list-based approach e
You can also use dropdowns in your navbar. Dropdown menus require a wrapping element for positioning, so be sure to use separate and nested elements for `.nav-item` and `.nav-link` as shown below.
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavDropdown" aria-controls="navbarNavDropdown" aria-expanded="false" aria-label="Toggle navigation">
@@ -227,7 +227,7 @@ You can also use dropdowns in your navbar. Dropdown menus require a wrapping ele
Place various form controls and components within a navbar:
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container-fluid">
<form class="d-flex" role="search">
<input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
@@ -240,7 +240,7 @@ Place various form controls and components within a navbar:
Immediate child elements of `.navbar` use flex layout and will default to `justify-content: space-between`. Use additional [flex utilities]({{< docsref "/utilities/flex" >}}) as needed to adjust this behavior.
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand">Navbar</a>
<form class="d-flex" role="search">
@@ -254,7 +254,7 @@ Immediate child elements of `.navbar` use flex layout and will default to `justi
Input groups work, too. If your navbar is an entire form, or mostly a form, you can use the `<form>` element as the container and save some HTML.
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<form class="container-fluid">
<div class="input-group">
<span class="input-group-text" id="basic-addon1">@</span>
@@ -267,7 +267,7 @@ Input groups work, too. If your navbar is an entire form, or mostly a form, you
Various buttons are supported as part of these navbar forms, too. This is also a great reminder that vertical alignment utilities can be used to align different sized elements.
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<form class="container-fluid justify-content-start">
<button class="btn btn-outline-success me-2" type="button">Main button</button>
<button class="btn btn-sm btn-outline-secondary" type="button">Smaller button</button>
@@ -280,7 +280,7 @@ Various buttons are supported as part of these navbar forms, too. This is also a
Navbars may contain bits of text with the help of `.navbar-text`. This class adjusts vertical alignment and horizontal spacing for strings of text.
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container-fluid">
<span class="navbar-text">
Navbar text with an inline element
@@ -292,7 +292,7 @@ Navbars may contain bits of text with the help of `.navbar-text`. This class adj
Mix and match with other components and utilities as needed.
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar w/ text</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarText" aria-controls="navbarText" aria-expanded="false" aria-label="Toggle navigation">
@@ -321,13 +321,17 @@ Mix and match with other components and utilities as needed.
## Color schemes
{{< callout warning >}}
-**New in v5.2.0:** Navbar theming is now powered by CSS variables and `.navbar-light` has been deprecated. CSS variables are applied to `.navbar`, defaulting to the "light" appearance, and can be overridden with `.navbar-dark`.
+**New dark navbars in v5.3.0 —** We've deprecated `.navbar-dark` in favor of the new `data-bs-theme="dark"`. Add `data-bs-theme="dark"` to the `.navbar` to enable a component-specific color mode. [Learn more about our color modes.]({{< docsref "/customize/color-modes" >}})
+
+---
+
+**New in v5.2.0 —** Navbar theming is now powered by CSS variables and `.navbar-light` has been deprecated. CSS variables are applied to `.navbar`, defaulting to the "light" appearance, and can be overridden with `.navbar-dark`.
{{< /callout >}}
-Navbar themes are easier than ever thanks to Bootstrap's combination of Sass and CSS variables. The default is our "light navbar" for use with light background colors, but you can also apply `.navbar-dark` for dark background colors. Then, customize with `.bg-*` utilities.
+Navbar themes are easier than ever thanks to Bootstrap's combination of Sass and CSS variables. The default is our "light navbar" for use with light background colors, but you can also apply `data-bs-theme="dark"` to the `.navbar` parent for dark background colors. Then, customize with `.bg-*` and additional utilities.
<div class="bd-example">
- <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
+ <nav class="navbar navbar-expand-lg bg-dark border-bottom border-bottom-dark" data-bs-theme="dark">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarColor01" aria-controls="navbarColor01" aria-expanded="false" aria-label="Toggle navigation">
@@ -356,7 +360,7 @@ Navbar themes are easier than ever thanks to Bootstrap's combination of Sass and
</div>
</nav>
- <nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+ <nav class="navbar navbar-expand-lg bg-primary" data-bs-theme="dark">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarColor02" aria-controls="navbarColor02" aria-expanded="false" aria-label="Toggle navigation">
@@ -385,7 +389,7 @@ Navbar themes are easier than ever thanks to Bootstrap's combination of Sass and
</div>
</nav>
- <nav class="navbar navbar-expand-lg" style="background-color: #e3f2fd;">
+ <nav class="navbar navbar-expand-lg" style="background-color: #e3f2fd;" data-bs-theme="light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarColor03" aria-controls="navbarColor03" aria-expanded="false" aria-label="Toggle navigation">
@@ -416,11 +420,11 @@ Navbar themes are easier than ever thanks to Bootstrap's combination of Sass and
</div>
```html
-<nav class="navbar navbar-dark bg-dark">
+<nav class="navbar bg-dark border-bottom border-bottom-dark" data-bs-theme="dark">
<!-- Navbar content -->
</nav>
-<nav class="navbar navbar-dark bg-primary">
+<nav class="navbar bg-primary" data-bs-theme="dark">
<!-- Navbar content -->
</nav>
@@ -435,7 +439,7 @@ Although it's not required, you can wrap a navbar in a `.container` to center it
{{< example >}}
<div class="container">
- <nav class="navbar navbar-expand-lg bg-light">
+ <nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
</div>
@@ -446,7 +450,7 @@ Although it's not required, you can wrap a navbar in a `.container` to center it
Use any of the responsive containers to change how wide the content in your navbar is presented.
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-md">
<a class="navbar-brand" href="#">Navbar</a>
</div>
@@ -460,7 +464,7 @@ Use our [position utilities]({{< docsref "/utilities/position" >}}) to place nav
Fixed navbars use `position: fixed`, meaning they're pulled from the normal flow of the DOM and may require custom CSS (e.g., `padding-top` on the `<body>`) to prevent overlap with other elements.
{{< example >}}
-<nav class="navbar bg-light">
+<nav class="navbar bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Default</a>
</div>
@@ -468,7 +472,7 @@ Fixed navbars use `position: fixed`, meaning they're pulled from the normal flow
{{< /example >}}
{{< example >}}
-<nav class="navbar fixed-top bg-light">
+<nav class="navbar fixed-top bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Fixed top</a>
</div>
@@ -476,7 +480,7 @@ Fixed navbars use `position: fixed`, meaning they're pulled from the normal flow
{{< /example >}}
{{< example >}}
-<nav class="navbar fixed-bottom bg-light">
+<nav class="navbar fixed-bottom bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Fixed bottom</a>
</div>
@@ -484,7 +488,7 @@ Fixed navbars use `position: fixed`, meaning they're pulled from the normal flow
{{< /example >}}
{{< example >}}
-<nav class="navbar sticky-top bg-light">
+<nav class="navbar sticky-top bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Sticky top</a>
</div>
@@ -492,7 +496,7 @@ Fixed navbars use `position: fixed`, meaning they're pulled from the normal flow
{{< /example >}}
{{< example >}}
-<nav class="navbar sticky-bottom bg-light">
+<nav class="navbar sticky-bottom bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Sticky bottom</a>
</div>
@@ -508,7 +512,7 @@ Please note that this behavior comes with a potential drawback of `overflow`—w
Here's an example navbar using `.navbar-nav-scroll` with `style="--bs-scroll-height: 100px;"`, with some extra margin utilities for optimum spacing.
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar scroll</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarScroll" aria-controls="navbarScroll" aria-expanded="false" aria-label="Toggle navigation">
@@ -559,7 +563,7 @@ Navbar togglers are left-aligned by default, but should they follow a sibling el
With no `.navbar-brand` shown at the smallest breakpoint:
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo01" aria-controls="navbarTogglerDemo01" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
@@ -589,7 +593,7 @@ With no `.navbar-brand` shown at the smallest breakpoint:
With a brand name shown on the left and toggler on the right:
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo02" aria-controls="navbarTogglerDemo02" aria-expanded="false" aria-label="Toggle navigation">
@@ -619,7 +623,7 @@ With a brand name shown on the left and toggler on the right:
With a toggler on the left and brand name on the right:
{{< example >}}
-<nav class="navbar navbar-expand-lg bg-light">
+<nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo03" aria-controls="navbarTogglerDemo03" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
@@ -651,10 +655,10 @@ With a toggler on the left and brand name on the right:
Sometimes you want to use the collapse plugin to trigger a container element for content that structurally sits outside of the `.navbar` . Because our plugin works on the `id` and `data-bs-target` matching, that's easily done!
{{< example >}}
-<div class="collapse" id="navbarToggleExternalContent">
+<div class="collapse" id="navbarToggleExternalContent" data-bs-theme="dark">
<div class="bg-dark p-4">
- <h5 class="text-white h4">Collapsed content</h5>
- <span class="text-muted">Toggleable via the navbar brand.</span>
+ <h5 class="text-body-emphasis h4">Collapsed content</h5>
+ <span class="text-body-secondary">Toggleable via the navbar brand.</span>
</div>
</div>
<nav class="navbar navbar-dark bg-dark">
@@ -675,10 +679,10 @@ Transform your expanding and collapsing navbar into an offcanvas drawer with the
In the example below, to create an offcanvas navbar that is always collapsed across all breakpoints, omit the `.navbar-expand-*` class entirely.
{{< example >}}
-<nav class="navbar bg-light fixed-top">
+<nav class="navbar bg-body-tertiary fixed-top">
<div class="container-fluid">
<a class="navbar-brand" href="#">Offcanvas navbar</a>
- <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbar" aria-controls="offcanvasNavbar">
+ <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbar" aria-controls="offcanvasNavbar" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="offcanvas offcanvas-end" tabindex="-1" id="offcanvasNavbar" aria-labelledby="offcanvasNavbarLabel">
@@ -721,9 +725,9 @@ In the example below, to create an offcanvas navbar that is always collapsed acr
To create an offcanvas navbar that expands into a normal navbar at a specific breakpoint like `lg`, use `.navbar-expand-lg`.
```html
-<nav class="navbar navbar-expand-lg bg-light fixed-top">
+<nav class="navbar navbar-expand-lg bg-body-tertiary fixed-top">
<a class="navbar-brand" href="#">Offcanvas navbar</a>
- <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#navbarOffcanvasLg" aria-controls="navbarOffcanvasLg">
+ <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#navbarOffcanvasLg" aria-controls="navbarOffcanvasLg" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="offcanvas offcanvas-end" tabindex="-1" id="navbarOffcanvasLg" aria-labelledby="navbarOffcanvasLgLabel">
@@ -738,7 +742,7 @@ When using offcanvas in a dark navbar, be aware that you may need to have a dark
<nav class="navbar navbar-dark bg-dark fixed-top">
<div class="container-fluid">
<a class="navbar-brand" href="#">Offcanvas dark navbar</a>
- <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasDarkNavbar" aria-controls="offcanvasDarkNavbar">
+ <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasDarkNavbar" aria-controls="offcanvasDarkNavbar" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="offcanvas offcanvas-end text-bg-dark" tabindex="-1" id="offcanvasDarkNavbar" aria-labelledby="offcanvasDarkNavbarLabel">
@@ -806,7 +810,7 @@ Variables for the [dark navbar](#color-schemes):
{{< scss-docs name="navbar-dark-variables" file="scss/_variables.scss" >}}
-### Sass loop
+### Sass loops
[Responsive navbar expand/collapse classes](#responsive-behaviors) (e.g., `.navbar-expand-lg`) are combined with the `$breakpoints` map and generated through a loop in `scss/_navbar.scss`.
diff --git a/site/content/docs/5.2/components/navs-tabs.md b/site/content/docs/5.3/components/navs-tabs.md
index 1748dd1..3242506 100644
--- a/site/content/docs/5.2/components/navs-tabs.md
+++ b/site/content/docs/5.3/components/navs-tabs.md
@@ -3,7 +3,7 @@ layout: docs
title: Navs and tabs
description: Documentation and examples for how to use Bootstrap's included navigation components.
group: components
-aliases: "/docs/5.2/components/navs/"
+aliases: "/docs/5.3/components/navs/"
toc: true
---
@@ -167,6 +167,27 @@ Take that same HTML, but use `.nav-pills` instead:
</ul>
{{< /example >}}
+### Underline
+
+Take that same HTML, but use `.nav-underline` instead:
+
+{{< example >}}
+<ul class="nav nav-underline">
+ <li class="nav-item">
+ <a class="nav-link active" aria-current="page" href="#">Active</a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link" href="#">Link</a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link" href="#">Link</a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link disabled">Disabled</a>
+ </li>
+</ul>
+{{< /example >}}
+
### Fill and justify
Force your `.nav`'s contents to extend the full available width one of two modifier classes. To proportionately fill all available space with your `.nav-item`s, use `.nav-fill`. Notice that all horizontal space is occupied, but not every nav item has the same width.
@@ -324,6 +345,12 @@ On the `.nav-pills` modifier class:
{{< scss-docs name="nav-pills-css-vars" file="scss/_nav.scss" >}}
+{{< added-in "5.3.0" >}}
+
+On the `.nav-underline` modifier class:
+
+{{< scss-docs name="nav-underline-css-vars" file="scss/_nav.scss" >}}
+
### Sass variables
{{< scss-docs name="nav-variables" file="scss/_variables.scss" >}}
@@ -622,7 +649,7 @@ To make tabs fade in, add `.fade` to each `.tab-pane`. The first tab pane must a
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
Activates your content as a tab element.
diff --git a/site/content/docs/5.2/components/offcanvas.md b/site/content/docs/5.3/components/offcanvas.md
index c4290ad..7c4c862 100644
--- a/site/content/docs/5.2/components/offcanvas.md
+++ b/site/content/docs/5.3/components/offcanvas.md
@@ -11,14 +11,14 @@ toc: true
Offcanvas is a sidebar component that can be toggled via JavaScript to appear from the left, right, top, or bottom edge of the viewport. Buttons or anchors are used as triggers that are attached to specific elements you toggle, and `data` attributes are used to invoke our JavaScript.
- Offcanvas shares some of the same JavaScript code as modals. Conceptually, they are quite similar, but they are separate plugins.
-- Similarly, some [source Sass](#sass) variables for offcanvas's styles and dimensions are inherited from the modal's variables.
+- Similarly, some [source Sass](#sass-variables) variables for offcanvas's styles and dimensions are inherited from the modal's variables.
- When shown, offcanvas includes a default backdrop that can be clicked to hide the offcanvas.
- Similar to modals, only one offcanvas can be shown at a time.
**Heads up!** Given how CSS handles animations, you cannot use `margin` or `translate` on an `.offcanvas` element. Instead, use the class as an independent wrapping element.
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
## Examples
@@ -27,7 +27,7 @@ Offcanvas is a sidebar component that can be toggled via JavaScript to appear fr
Below is an offcanvas example that is shown by default (via `.show` on `.offcanvas`). Offcanvas includes support for a header with a close button and an optional body class for some initial `padding`. We suggest that you include offcanvas headers with dismiss actions whenever possible, or provide an explicit dismiss action.
-{{< example class="bd-example-offcanvas p-0 bg-light overflow-hidden" >}}
+{{< example class="bd-example-offcanvas p-0 bg-body-tertiary overflow-hidden" >}}
<div class="offcanvas offcanvas-start show" tabindex="-1" id="offcanvas" aria-labelledby="offcanvasLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasLabel">Offcanvas</h5>
@@ -139,11 +139,15 @@ When backdrop is set to static, the offcanvas will not close when clicking outsi
## Dark offcanvas
-{{< added-in "5.2.0" >}}
+{{< deprecated-in "5.3.0" >}} {{< added-in "5.2.0" >}}
Change the appearance of offcanvases with utilities to better match them to different contexts like dark navbars. Here we add `.text-bg-dark` to the `.offcanvas` and `.btn-close-white` to `.btn-close` for proper styling with a dark offcanvas. If you have dropdowns within, consider also adding `.dropdown-menu-dark` to `.dropdown-menu`.
-{{< example class="bd-example-offcanvas p-0 bg-light overflow-hidden" >}}
+{{< callout warning >}}
+Heads up! Dark variants for components were deprecated in v5.3.0 with the introduction of color modes. Instead of manually adding classes mentioned above, set `data-bs-theme="dark"` on the root element, a parent wrapper, or the component itself.
+{{< /callout >}}
+
+{{< example class="bd-example-offcanvas p-0 bg-body-secondary overflow-hidden" >}}
<div class="offcanvas offcanvas-start show text-bg-dark" tabindex="-1" id="offcanvasDark" aria-labelledby="offcanvasDarkLabel">
<div class="offcanvas-header">
<h5 class="offcanvas-title" id="offcanvasDarkLabel">Offcanvas</h5>
@@ -310,7 +314,7 @@ const offcanvasList = [...offcanvasElementList].map(offcanvasEl => new bootstrap
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
Activates your content as an offcanvas element. Accepts an optional options `object`.
diff --git a/site/content/docs/5.2/components/pagination.md b/site/content/docs/5.3/components/pagination.md
index 7251405..7251405 100644
--- a/site/content/docs/5.2/components/pagination.md
+++ b/site/content/docs/5.3/components/pagination.md
diff --git a/site/content/docs/5.2/components/placeholders.md b/site/content/docs/5.3/components/placeholders.md
index 4de4057..3dca347 100644
--- a/site/content/docs/5.2/components/placeholders.md
+++ b/site/content/docs/5.3/components/placeholders.md
@@ -38,7 +38,7 @@ In the example below, we take a typical card component and recreate it with plac
<span class="placeholder col-6"></span>
<span class="placeholder col-8"></span>
</p>
- <a href="#" tabindex="-1" class="btn btn-primary disabled placeholder col-6"></a>
+ <a class="btn btn-primary disabled placeholder col-6"></a>
</div>
</div>
</div>
@@ -67,7 +67,7 @@ In the example below, we take a typical card component and recreate it with plac
<span class="placeholder col-6"></span>
<span class="placeholder col-8"></span>
</p>
- <a href="#" tabindex="-1" class="btn btn-primary disabled placeholder col-6"></a>
+ <a class="btn btn-primary disabled placeholder col-6"></a>
</div>
</div>
```
@@ -83,7 +83,7 @@ We apply additional styling to `.btn`s via `::before` to ensure the `height` is
<span class="placeholder col-6"></span>
</p>
-<a href="#" tabindex="-1" class="btn btn-primary disabled placeholder col-4" aria-hidden="true"></a>
+<a class="btn btn-primary disabled placeholder col-4"></a>
{{< /example >}}
{{< callout info >}}
@@ -126,7 +126,7 @@ The size of `.placeholder`s are based on the typographic style of the parent ele
### Animation
-Animate placeholders with `.placeholder-glow` or `.placeholder-wave` to better convey the perception of something being _actively_ loaded.
+Animate placeholders with `.placeholder-glow` or `.placeholder-wave` to better convey the perception of something being *actively* loaded.
{{< example >}}
<p class="placeholder-glow">
@@ -138,8 +138,8 @@ Animate placeholders with `.placeholder-glow` or `.placeholder-wave` to better c
</p>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="placeholders" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/components/popovers.md b/site/content/docs/5.3/components/popovers.md
index 9726c30..0a2138d 100644
--- a/site/content/docs/5.2/components/popovers.md
+++ b/site/content/docs/5.3/components/popovers.md
@@ -22,11 +22,11 @@ Things to know when using the popover plugin:
- Popovers can be triggered thanks to an element inside a shadow DOM.
{{< callout info >}}
-{{< partial "callout-info-sanitizer.md" >}}
+{{< partial "callouts/info-sanitizer.md" >}}
{{< /callout >}}
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
Keep reading to see how popovers work with some examples.
@@ -47,7 +47,7 @@ const popoverList = [...popoverTriggerList].map(popoverTriggerEl => new bootstra
We use JavaScript similar to the snippet above to render the following live popover. Titles are set via `data-bs-title` and body content is set via `data-bs-content`.
{{< callout warning >}}
-{{< partial "callout-warning-data-bs-title-vs-title.md" >}}
+{{< partial "callouts/warning-data-bs-title-vs-title.md" >}}
{{< /callout >}}
{{< example stackblitz_add_js="true" >}}
@@ -111,12 +111,10 @@ You can customize the appearance of popovers using [CSS variables](#variables).
### Dismiss on next click
-Use the `focus` trigger to dismiss popovers on the user's next click of a different element than the toggle element.
+Use the `focus` trigger to dismiss popovers on the user's next click of an element other than the toggle element.
{{< callout danger >}}
-#### Specific markup required for dismiss-on-next-click
-
-For proper cross-browser and cross-platform behavior, you must use the `<a>` tag, _not_ the `<button>` tag, and you also must include a [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) attribute.
+**Dismissing on next click requires specific HTML for proper cross-browser and cross-platform behavior.** You can only use `<a>` elements, not `<button>`s, and you must include a [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex).
{{< /callout >}}
{{< example stackblitz_add_js="true" >}}
@@ -165,13 +163,11 @@ const popover = new bootstrap.Popover(exampleEl, options)
```
{{< callout warning >}}
-### Making popovers work for keyboard and assistive technology users
-
-To allow keyboard users to activate your popovers, you should only add them to HTML elements that are traditionally keyboard-focusable and interactive (such as links or form controls). Although arbitrary HTML elements (such as `<span>`s) can be made focusable by adding the `tabindex="0"` attribute, this will add potentially annoying and confusing tab stops on non-interactive elements for keyboard users, and most assistive technologies currently do not announce the popover's content in this situation. Additionally, do not rely solely on `hover` as the trigger for your popovers, as this will make them impossible to trigger for keyboard users.
+**Keep popovers accessible to keyboard and assistive technology users** by only adding them to HTML elements that are traditionally keyboard-focusable and interactive (such as links or form controls). While other HTML elements can be made focusable by adding `tabindex="0"`, this can create annoying and confusing tab stops on non-interactive elements for keyboard users, and most assistive technologies currently do not announce popovers in this situation. Additionally, do not rely solely on `hover` as the trigger for your popovers as this will make them impossible to trigger for keyboard users.
-While you can insert rich, structured HTML in popovers with the `html` option, we strongly recommend that you avoid adding an excessive amount of content. The way popovers currently work is that, once displayed, their content is tied to the trigger element with the `aria-describedby` attribute. As a result, the entirety of the popover's content will be announced to assistive technology users as one long, uninterrupted stream.
+Avoid adding an excessive amount of content in popovers with the `html` option. Once popovers are displayed, their content is tied to the trigger element with the `aria-describedby` attribute, causing all of the popover's content to be announced to assistive technology users as one long, uninterrupted stream.
-Additionally, while it is possible to also include interactive controls (such as form elements or links) in your popover (by adding these elements to the `allowList` of allowed attributes and tags), be aware that currently the popover does not manage keyboard focus order. When a keyboard user opens a popover, focus remains on the triggering element, and as the popover usually does not immediately follow the trigger in the document's structure, there is no guarantee that moving forward/pressing <kbd>TAB</kbd> will move a keyboard user into the popover itself. In short, simply adding interactive controls to a popover is likely to make these controls unreachable/unusable for keyboard users and users of assistive technologies, or at the very least make for an illogical overall focus order. In these cases, consider using a modal dialog instead.
+Popovers do not manage keyboard focus order, and their placement can be random in the DOM, so be careful when adding interactive elements (like forms or links), as it may lead to an illogical focus order or make the popover content itself completely unreachable for keyboard users. In cases where you must use these elements, consider using a modal dialog instead.
{{< /callout >}}
### Options
@@ -191,7 +187,7 @@ Note that for security reasons the `sanitize`, `sanitizeFn`, and `allowList` opt
| `animation` | boolean | `true` | Apply a CSS fade transition to the popover. |
| `boundary` | string, element | `'clippingParents'` | Overflow constraint boundary of the popover (applies only to Popper's preventOverflow modifier). By default, it's `'clippingParents'` and can accept an HTMLElement reference (via JavaScript only). For more information refer to Popper's [detectOverflow docs](https://popper.js.org/docs/v2/utils/detect-overflow/#boundary). |
| `container` | string, element, false | `false` | Appends the popover to a specific element. Example: `container: 'body'`. This option is particularly useful in that it allows you to position the popover in the flow of the document near the triggering element - which will prevent the popover from floating away from the triggering element during a window resize. |
-| `content` | string, element, function | `''` | Default content value if `data-bs-content` attribute isn't present. If a function is given, it will be called with its `this` reference set to the element that the popover is attached to. |
+| `content` | string, element, function | `''` | The popover's text content. If a function is given, it will be called with its `this` reference set to the element that the popover is attached to. |
| `customClass` | string, function | `''` | Add classes to the popover when it is shown. Note that these classes will be added in addition to any classes specified in the template. To add multiple classes, separate them with spaces: `'class-1 class-2'`. You can also pass a function that should return a single string containing additional class names. |
| `delay` | number, object | `0` | Delay showing and hiding the popover (ms)—doesn't apply to manual trigger type. If a number is supplied, delay is applied to both hide/show. Object structure is: `delay: { "show": 500, "hide": 100 }`. |
| `fallbackPlacements` | string, array | `['top', 'right', 'bottom', 'left']` | Define fallback placements by providing a list of placements in array (in order of preference). For more information refer to Popper's [behavior docs](https://popper.js.org/docs/v2/modifiers/flip/#fallbackplacements). |
@@ -203,7 +199,7 @@ Note that for security reasons the `sanitize`, `sanitizeFn`, and `allowList` opt
| `sanitizeFn` | null, function | `null` | Here you can supply your own sanitize function. This can be useful if you prefer to use a dedicated library to perform sanitization. |
| `selector` | string, false | `false` | If a selector is provided, popover objects will be delegated to the specified targets. In practice, this is used to also apply popovers to dynamically added DOM elements (`jQuery.on` support). See [this issue]({{< param repo >}}/issues/4215) and [an informative example](https://codepen.io/Johann-S/pen/djJYPb). **Note**: `title` attribute must not be used as a selector. |
| `template` | string | `'<div class="popover" role="popover"><div class="popover-arrow"></div><div class="popover-inner"></div></div>'` | Base HTML to use when creating the popover. The popover's `title` will be injected into the `.popover-inner`. `.popover-arrow` will become the popover's arrow. The outermost wrapper element should have the `.popover` class and `role="popover"`. |
-| `title` | string, element, function | `''` | Default title value if `title` attribute isn't present. If a function is given, it will be called with its `this` reference set to the element that the popover is attached to. |
+| `title` | string, element, function | `''` | The popover title. If a function is given, it will be called with its `this` reference set to the element that the popover is attached to. |
| `trigger` | string | `'hover focus'` | How popover is triggered: click, hover, focus, manual. You may pass multiple triggers; separate them with a space. `'manual'` indicates that the popover will be triggered programmatically via the `.popover('show')`, `.popover('hide')` and `.popover('toggle')` methods; this value cannot be combined with any other trigger. `'hover'` on its own will result in popovers that cannot be triggered via the keyboard, and should only be used if alternative methods for conveying the same information for keyboard users is present. |
{{< /bs-table >}}
@@ -228,7 +224,7 @@ const popover = new bootstrap.Popover(element, {
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
{{< bs-table "table" >}}
@@ -238,7 +234,7 @@ const popover = new bootstrap.Popover(element, {
| `dispose` | Hides and destroys an element's popover (Removes stored data on the DOM element). Popovers that use delegation (which are created using [the `selector` option](#options)) cannot be individually destroyed on descendant trigger elements. |
| `enable` | Gives an element's popover the ability to be shown. **Popovers are enabled by default.** |
| `getInstance` | _Static_ method which allows you to get the popover instance associated with a DOM element. |
-| `getOrCreateInstance` | *Static* method which allows you to get the popover instance associated with a DOM element, or create a new one in case it wasn't initialized. |
+| `getOrCreateInstance` | _Static_ method which allows you to get the popover instance associated with a DOM element, or create a new one in case it wasn't initialized. |
| `hide` | Hides an element's popover. **Returns to the caller before the popover has actually been hidden** (i.e. before the `hidden.bs.popover` event occurs). This is considered a "manual" triggering of the popover. |
| `setContent` | Gives a way to change the popover's content after its initialization. |
| `show` | Reveals an element's popover. **Returns to the caller before the popover has actually been shown** (i.e. before the `shown.bs.popover` event occurs). This is considered a "manual" triggering of the popover. Popovers whose title and content are both zero-length are never displayed. |
diff --git a/site/content/docs/5.3/components/progress.md b/site/content/docs/5.3/components/progress.md
new file mode 100644
index 0000000..73f1315
--- /dev/null
+++ b/site/content/docs/5.3/components/progress.md
@@ -0,0 +1,202 @@
+---
+layout: docs
+title: Progress
+description: Documentation and examples for using Bootstrap custom progress bars featuring support for stacked bars, animated backgrounds, and text labels.
+group: components
+toc: true
+---
+
+{{< callout info >}}
+**New markup in v5.3.0 —** We've deprecated the previous HTML structure for progress bars and replaced it with a more accessible one. The previous structure will continue to work until v6. [See what's changed in our migration guide.]({{< docsref "/migration#improved-markup-for-progress-bars" >}})
+{{< /callout >}}
+
+## How it works
+
+Progress components are built with two HTML elements, some CSS to set the width, and a few attributes. We don't use [the HTML5 `<progress>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/progress), ensuring you can stack progress bars, animate them, and place text labels over them.
+
+- We use the `.progress` as a wrapper to indicate the max value of the progress bar.
+- The `.progress` wrapper also requires a `role="progressbar"` and `aria` attributes to make it accessible, including an accessible name (using `aria-label`, `aria-labelledby`, or similar).
+- We use the inner `.progress-bar` purely for the visual bar and label.
+- The `.progress-bar` requires an inline style, utility class, or custom CSS to set its width.
+- We provide a special `.progress-stacked` class to create multiple/stacked progress bars.
+
+Put that all together, and you have the following examples.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar" style="width: 0%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar" style="width: 25%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar" style="width: 50%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar" style="width: 75%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar" style="width: 100%"></div>
+</div>
+{{< /example >}}
+
+## Bar sizing
+
+### Width
+
+Bootstrap provides a handful of [utilities for setting width]({{< docsref "/utilities/sizing" >}}). Depending on your needs, these may help with quickly configuring the width of the `.progress-bar`.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar w-75"></div>
+</div>
+{{< /example >}}
+
+### Height
+
+You only set a `height` value on the `.progress` container, so if you change that value, the inner `.progress-bar` will automatically resize accordingly.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Example 1px high" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100" style="height: 1px">
+ <div class="progress-bar" style="width: 25%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Example 20px high" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100" style="height: 20px">
+ <div class="progress-bar" style="width: 25%"></div>
+</div>
+{{< /example >}}
+
+## Labels
+
+Add labels to your progress bars by placing text within the `.progress-bar`.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Example with label" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar" style="width: 25%">25%</div>
+</div>
+{{< /example >}}
+
+Note that by default, the content inside the `.progress-bar` is controlled with `overflow: hidden`, so it doesn't bleed out of the bar. If your progress bar is shorter than its label, the content will be capped and may become unreadable. To change this behavior, you can use `.overflow-visible` from the [overflow utilities]({{< docsref "/utilities/overflow" >}}), but make sure to also define an explicit [text color]({{< docsref "/utilities/colors#colors" >}}) so the text remains readable. Be aware though that currently this approach does not take into account [color modes]({{< docsref "/customize/color-modes" >}}).
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Example with label" aria-valuenow="10" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar overflow-visible text-dark" style="width: 10%">Long label text for the progress bar, set to a dark color</div>
+</div>
+{{< /example >}}
+
+## Backgrounds
+
+Use background utility classes to change the appearance of individual progress bars.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Success example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-success" style="width: 25%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Info example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-info" style="width: 50%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Warning example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-warning" style="width: 75%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Danger example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-danger" style="width: 100%"></div>
+</div>
+{{< /example >}}
+
+{{< callout info >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
+{{< /callout >}}
+
+If you're adding labels to progress bars with a custom background color, make sure to also set an appropriate [text color]({{< docsref "/utilities/colors#colors" >}}), so the labels remain readable and have sufficient contrast.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Success example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-success" style="width: 25%">25%</div>
+</div>
+<div class="progress" role="progressbar" aria-label="Info example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-info text-dark" style="width: 50%">50%</div>
+</div>
+<div class="progress" role="progressbar" aria-label="Warning example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-warning text-dark" style="width: 75%">75%</div>
+</div>
+<div class="progress" role="progressbar" aria-label="Danger example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-danger" style="width: 100%">100%</div>
+</div>
+{{< /example >}}
+
+Alternatively, you can use the new combined [color and background]({{< docsref "/helpers/color-background" >}}) helper classes.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Warning example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar text-bg-warning" style="width: 75%">75%</div>
+</div>
+{{< /example >}}
+
+## Multiple bars
+
+You can include multiple progress components inside a container with `.progress-stacked` to create a single stacked progress bar. Note that in this case, the styling to set the visual width of the progress bar *must* be applied to the `.progress` elements, rather than the `.progress-bar`s.
+
+{{< example >}}
+<div class="progress-stacked">
+ <div class="progress" role="progressbar" aria-label="Segment one" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100" style="width: 15%">
+ <div class="progress-bar"></div>
+ </div>
+ <div class="progress" role="progressbar" aria-label="Segment two" aria-valuenow="30" aria-valuemin="0" aria-valuemax="100" style="width: 30%">
+ <div class="progress-bar bg-success"></div>
+ </div>
+ <div class="progress" role="progressbar" aria-label="Segment three" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
+ <div class="progress-bar bg-info"></div>
+ </div>
+</div>
+{{< /example >}}
+
+## Striped
+
+Add `.progress-bar-striped` to any `.progress-bar` to apply a stripe via CSS gradient over the progress bar's background color.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Default striped example" aria-valuenow="10" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped" style="width: 10%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Success striped example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped bg-success" style="width: 25%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Info striped example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped bg-info" style="width: 50%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Warning striped example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped bg-warning" style="width: 75%"></div>
+</div>
+<div class="progress" role="progressbar" aria-label="Danger striped example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped bg-danger" style="width: 100%"></div>
+</div>
+{{< /example >}}
+
+## Animated stripes
+
+The striped gradient can also be animated. Add `.progress-bar-animated` to `.progress-bar` to animate the stripes right to left via CSS3 animations.
+
+{{< example >}}
+<div class="progress" role="progressbar" aria-label="Animated striped example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped progress-bar-animated" style="width: 75%"></div>
+</div>
+{{< /example >}}
+
+## CSS
+
+### Variables
+
+{{< added-in "5.2.0" >}}
+
+As part of Bootstrap's evolving CSS variables approach, progress bars now use local CSS variables on `.progress` for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.
+
+{{< scss-docs name="progress-css-vars" file="scss/_progress.scss" >}}
+
+### Sass variables
+
+{{< scss-docs name="progress-variables" file="scss/_variables.scss" >}}
+
+### Keyframes
+
+Used for creating the CSS animations for `.progress-bar-animated`. Included in `scss/_progress-bar.scss`.
+
+{{< scss-docs name="progress-keyframes" file="scss/_progress.scss" >}}
diff --git a/site/content/docs/5.2/components/scrollspy.md b/site/content/docs/5.3/components/scrollspy.md
index 53e3fa0..d1abf75 100644
--- a/site/content/docs/5.2/components/scrollspy.md
+++ b/site/content/docs/5.3/components/scrollspy.md
@@ -12,7 +12,7 @@ Scrollspy toggles the `.active` class on anchor (`<a>`) elements when the elemen
- To start, scrollspy requires two things: a navigation, list group, or a simple set of links, plus a scrollable container. The scrollable container can be the `<body>` or a custom element with a set `height` and `overflow-y: scroll`.
-- On the scrollable container, add `data-bs-spy="scroll"` and `data-bs-target="#navId"` where `navId` is the unique `id` of the associated navigation. Be sure to also include a `tabindex="0"` to ensure keyboard access.
+- On the scrollable container, add `data-bs-spy="scroll"` and `data-bs-target="#navId"` where `navId` is the unique `id` of the associated navigation. If there is no focusable element inside the element, be sure to also include a `tabindex="0"` to ensure keyboard access.
- As you scroll the "spied" container, an `.active` class is added and removed from anchor links within the associated navigation. Links must have resolvable `id` targets, otherwise they're ignored. For example, a `<a href="#home">home</a>` must correspond to something in the DOM like `<div id="home"></div>`
@@ -25,7 +25,7 @@ Scrollspy toggles the `.active` class on anchor (`<a>`) elements when the elemen
Scroll the area below the navbar and watch the active class change. Open the dropdown menu and watch the dropdown items be highlighted as well.
<div class="bd-example">
- <nav id="navbar-example2" class="navbar bg-light px-3 mb-3">
+ <nav id="navbar-example2" class="navbar bg-body-tertiary px-3 mb-3 rounded-2">
<a class="navbar-brand" href="#">Navbar</a>
<ul class="nav nav-pills">
<li class="nav-item">
@@ -45,7 +45,7 @@ Scroll the area below the navbar and watch the active class change. Open the dro
</li>
</ul>
</nav>
- <div class="scrollspy-example bg-light p-3 rounded-2" data-bs-spy="scroll" data-bs-target="#navbar-example2" data-bs-root-margin="0px 0px -40%" data-bs-smooth-scroll="true" tabindex="0">
+ <div class="scrollspy-example bg-body-tertiary p-3 rounded-2" data-bs-spy="scroll" data-bs-target="#navbar-example2" data-bs-root-margin="0px 0px -40%" data-bs-smooth-scroll="true" tabindex="0">
<h4 id="scrollspyHeading1">First heading</h4>
<p>This is some placeholder content for the scrollspy page. Note that as you scroll down the page, the appropriate navigation link is highlighted. It's repeated throughout the component example. We keep adding some more example copy here to emphasize the scrolling and highlighting.</p>
<h4 id="scrollspyHeading2">Second heading</h4>
@@ -60,7 +60,7 @@ Scroll the area below the navbar and watch the active class change. Open the dro
</div>
```html
-<nav id="navbar-example2" class="navbar bg-light px-3 mb-3">
+<nav id="navbar-example2" class="navbar bg-body-tertiary px-3 mb-3">
<a class="navbar-brand" href="#">Navbar</a>
<ul class="nav nav-pills">
<li class="nav-item">
@@ -80,7 +80,7 @@ Scroll the area below the navbar and watch the active class change. Open the dro
</li>
</ul>
</nav>
-<div data-bs-spy="scroll" data-bs-target="#navbar-example2" data-bs-root-margin="0px 0px -40%" data-bs-smooth-scroll="true" class="scrollspy-example bg-light p-3 rounded-2" tabindex="0">
+<div data-bs-spy="scroll" data-bs-target="#navbar-example2" data-bs-root-margin="0px 0px -40%" data-bs-smooth-scroll="true" class="scrollspy-example bg-body-tertiary p-3 rounded-2" tabindex="0">
<h4 id="scrollspyHeading1">First heading</h4>
<p>...</p>
<h4 id="scrollspyHeading2">Second heading</h4>
diff --git a/site/content/docs/5.2/components/spinners.md b/site/content/docs/5.3/components/spinners.md
index bc1b1e6..f2635c6 100644
--- a/site/content/docs/5.2/components/spinners.md
+++ b/site/content/docs/5.3/components/spinners.md
@@ -13,7 +13,7 @@ Bootstrap "spinners" can be used to show the loading state in your projects. The
For accessibility purposes, each loader here includes `role="status"` and a nested `<span class="visually-hidden">Loading...</span>`.
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
## Border spinner
@@ -205,9 +205,7 @@ Used for creating the CSS animations for our spinners. Included in `scss/_spinne
[color]: {{< docsref "/utilities/colors" >}}
-[display]: {{< docsref "/utilities/display" >}}
[flex]: {{< docsref "/utilities/flex" >}}
[float]: {{< docsref "/utilities/float" >}}
[margin]: {{< docsref "/utilities/spacing" >}}
-[sizing]: {{< docsref "/utilities/sizing" >}}
[text]: {{< docsref "/utilities/text" >}}
diff --git a/site/content/docs/5.2/components/toasts.md b/site/content/docs/5.3/components/toasts.md
index abcb392..a7d1cb7 100644
--- a/site/content/docs/5.2/components/toasts.md
+++ b/site/content/docs/5.3/components/toasts.md
@@ -16,7 +16,7 @@ Things to know when using the toast plugin:
- Toasts will automatically hide if you do not specify `autohide: false`.
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
## Examples
@@ -27,7 +27,7 @@ To encourage extensible and predictable toasts, we recommend a header and body.
Toasts are as flexible as you need and have very little required markup. At a minimum, we require a single element to contain your "toasted" content and strongly encourage a dismiss button.
-{{< example class="bg-light" >}}
+{{< example >}}
<div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
@@ -87,17 +87,7 @@ Click the button below to show a toast (positioned with our utilities in the low
We use the following JavaScript to trigger our live toast demo:
-```js
-const toastTrigger = document.getElementById('liveToastBtn')
-const toastLiveExample = document.getElementById('liveToast')
-if (toastTrigger) {
- toastTrigger.addEventListener('click', () => {
- const toast = new bootstrap.Toast(toastLiveExample)
-
- toast.show()
- })
-}
-```
+{{< js-docs name="live-toast" file="site/assets/js/snippets.js" >}}
### Translucent
@@ -108,7 +98,7 @@ Toasts are slightly translucent to blend in with what's below them.
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
<strong class="me-auto">Bootstrap</strong>
- <small class="text-muted">11 mins ago</small>
+ <small class="text-body-secondary">11 mins ago</small>
<button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
</div>
<div class="toast-body">
@@ -121,13 +111,13 @@ Toasts are slightly translucent to blend in with what's below them.
You can stack toasts by wrapping them in a toast container, which will vertically add some spacing.
-{{< example class="bg-light" >}}
+{{< example >}}
<div class="toast-container position-static">
<div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
<strong class="me-auto">Bootstrap</strong>
- <small class="text-muted">just now</small>
+ <small class="text-body-secondary">just now</small>
<button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
</div>
<div class="toast-body">
@@ -139,7 +129,7 @@ You can stack toasts by wrapping them in a toast container, which will verticall
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
<strong class="me-auto">Bootstrap</strong>
- <small class="text-muted">2 seconds ago</small>
+ <small class="text-body-secondary">2 seconds ago</small>
<button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
</div>
<div class="toast-body">
@@ -153,7 +143,7 @@ You can stack toasts by wrapping them in a toast container, which will verticall
Customize your toasts by removing sub-components, tweaking them with [utilities]({{< docsref "/utilities/api" >}}), or by adding your own markup. Here we've created a simpler toast by removing the default `.toast-header`, adding a custom hide icon from [Bootstrap Icons]({{< param icons >}}), and using some [flexbox utilities]({{< docsref "/utilities/flex" >}}) to adjust the layout.
-{{< example class="bg-light" >}}
+{{< example >}}
<div class="toast align-items-center" role="alert" aria-live="assertive" aria-atomic="true">
<div class="d-flex">
<div class="toast-body">
@@ -166,7 +156,7 @@ Customize your toasts by removing sub-components, tweaking them with [utilities]
Alternatively, you can also add additional controls and components to toasts.
-{{< example class="bg-light" >}}
+{{< example >}}
<div class="toast" role="alert" aria-live="assertive" aria-atomic="true">
<div class="toast-body">
Hello, world! This is a toast message.
@@ -182,7 +172,7 @@ Alternatively, you can also add additional controls and components to toasts.
Building on the above example, you can create different toast color schemes with our [color]({{< docsref "/utilities/colors" >}}) and [background]({{< docsref "/utilities/background" >}}) utilities. Here we've added `.text-bg-primary` to the `.toast`, and then added `.btn-close-white` to our close button. For a crisp edge, we remove the default border with `.border-0`.
-{{< example class="bg-light" >}}
+{{< example >}}
<div class="toast align-items-center text-bg-primary border-0" role="alert" aria-live="assertive" aria-atomic="true">
<div class="d-flex">
<div class="toast-body">
@@ -215,7 +205,7 @@ Place toasts with custom CSS as you need them. The top right is often used for n
</select>
</div>
</form>
-<div aria-live="polite" aria-atomic="true" class="bg-dark position-relative bd-example-toasts">
+<div aria-live="polite" aria-atomic="true" class="bg-body-secondary position-relative bd-example-toasts rounded-3">
<div class="toast-container p-3" id="toastPlacement">
<div class="toast">
<div class="toast-header">
@@ -233,7 +223,7 @@ Place toasts with custom CSS as you need them. The top right is often used for n
For systems that generate more notifications, consider using a wrapping element so they can easily stack.
-{{< example class="bg-dark bd-example-toasts p-0" >}}
+{{< example class="bd-example-toasts p-0" >}}
<div aria-live="polite" aria-atomic="true" class="position-relative">
<!-- Position it: -->
<!-- - `.toast-container` for spacing between toasts -->
@@ -246,7 +236,7 @@ For systems that generate more notifications, consider using a wrapping element
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
<strong class="me-auto">Bootstrap</strong>
- <small class="text-muted">just now</small>
+ <small class="text-body-secondary">just now</small>
<button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
</div>
<div class="toast-body">
@@ -258,7 +248,7 @@ For systems that generate more notifications, consider using a wrapping element
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
<strong class="me-auto">Bootstrap</strong>
- <small class="text-muted">2 seconds ago</small>
+ <small class="text-body-secondary">2 seconds ago</small>
<button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
</div>
<div class="toast-body">
@@ -271,7 +261,7 @@ For systems that generate more notifications, consider using a wrapping element
You can also get fancy with flexbox utilities to align toasts horizontally and/or vertically.
-{{< example class="bg-dark bd-example-toasts d-flex" >}}
+{{< example class="bd-example-toasts d-flex" >}}
<!-- Flexbox container for aligning the toasts -->
<div aria-live="polite" aria-atomic="true" class="d-flex justify-content-center align-items-center w-100">
@@ -308,7 +298,7 @@ As the content you're displaying changes, be sure to update the [`delay` timeout
When using `autohide: false`, you must add a close button to allow users to dismiss the toast.
-{{< example class="bg-light" >}}
+{{< example >}}
<div role="alert" aria-live="assertive" aria-atomic="true" class="toast" data-bs-autohide="false">
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
@@ -368,7 +358,7 @@ const toastList = [...toastElList].map(toastEl => new bootstrap.Toast(toastEl, o
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
{{< bs-table "table" >}}
diff --git a/site/content/docs/5.2/components/tooltips.md b/site/content/docs/5.3/components/tooltips.md
index a106d9d..cf628e3 100644
--- a/site/content/docs/5.2/components/tooltips.md
+++ b/site/content/docs/5.3/components/tooltips.md
@@ -23,11 +23,11 @@ Things to know when using the tooltip plugin:
Got all that? Great, let's see how they work with some examples.
{{< callout info >}}
-{{< partial "callout-info-sanitizer.md" >}}
+{{< partial "callouts/info-sanitizer.md" >}}
{{< /callout >}}
{{< callout info >}}
-{{< partial "callout-info-prefersreducedmotion.md" >}}
+{{< partial "callouts/info-prefersreducedmotion.md" >}}
{{< /callout >}}
## Examples
@@ -46,12 +46,11 @@ const tooltipList = [...tooltipTriggerList].map(tooltipTriggerEl => new bootstra
Hover over the links below to see tooltips:
{{< example class="tooltip-demo" stackblitz_add_js="true" >}}
-<p class="muted">Placeholder text to demonstrate some <a href="#" data-bs-toggle="tooltip" data-bs-title="Default tooltip">inline links</a> with tooltips. This is now just filler, no killer. Content placed here just to mimic the presence of <a href="#" data-bs-toggle="tooltip" data-bs-title="Another tooltip">real text</a>. And all that just to give you an idea of how tooltips would look when used in real-world situations. So hopefully you've now seen how <a href="#" data-bs-toggle="tooltip" data-bs-title="Another one here too">these tooltips on links</a> can work in practice, once you use them on <a href="#" data-bs-toggle="tooltip" data-bs-title="The last tip!">your own</a> site or project.
-</p>
+<p class="muted">Placeholder text to demonstrate some <a href="#" data-bs-toggle="tooltip" data-bs-title="Default tooltip">inline links</a> with tooltips. This is now just filler, no killer. Content placed here just to mimic the presence of <a href="#" data-bs-toggle="tooltip" data-bs-title="Another tooltip">real text</a>. And all that just to give you an idea of how tooltips would look when used in real-world situations. So hopefully you've now seen how <a href="#" data-bs-toggle="tooltip" data-bs-title="Another one here too">these tooltips on links</a> can work in practice, once you use them on <a href="#" data-bs-toggle="tooltip" data-bs-title="The last tip!">your own</a> site or project.</p>
{{< /example >}}
{{< callout warning >}}
-{{< partial "callout-warning-data-bs-title-vs-title.md" >}}
+{{< partial "callouts/warning-data-bs-title-vs-title.md" >}}
{{< /callout >}}
### Custom tooltips
@@ -136,9 +135,7 @@ As part of Bootstrap’s evolving CSS variables approach, tooltips now use local
## Usage
-The tooltip plugin generates content and markup on demand, and by default places tooltips after their trigger element.
-
-Trigger the tooltip via JavaScript:
+The tooltip plugin generates content and markup on demand, and by default places tooltips after their trigger element. Trigger the tooltip via JavaScript:
```js
const exampleEl = document.getElementById('example')
@@ -146,9 +143,7 @@ const tooltip = new bootstrap.Tooltip(exampleEl, options)
```
{{< callout warning >}}
-##### Overflow `auto` and `scroll`
-
-Tooltip position attempts to automatically change when a **parent container** has `overflow: auto` or `overflow: scroll` like our `.table-responsive`, but still keeps the original placement's positioning. To resolve this, set the [`boundary` option](https://popper.js.org/docs/v2/modifiers/flip/#boundary) (for the flip modifier using the `popperConfig` option) to any HTMLElement to override the default value, `'clippingParents'`, such as `document.body`:
+Tooltips automatically attempt to change positions when a parent container has `overflow: auto` or `overflow: scroll`, but still keeps the original placement's positioning. Set the [`boundary` option](https://popper.js.org/docs/v2/modifiers/flip/#boundary) (for the flip modifier using the `popperConfig` option) to any HTMLElement to override the default value, `'clippingParents'`, such as `document.body`:
```js
const tooltip = new bootstrap.Tooltip('#example', {
@@ -162,9 +157,7 @@ const tooltip = new bootstrap.Tooltip('#example', {
The required markup for a tooltip is only a `data` attribute and `title` on the HTML element you wish to have a tooltip. The generated markup of a tooltip is rather simple, though it does require a position (by default, set to `top` by the plugin).
{{< callout warning >}}
-##### Making tooltips work for keyboard and assistive technology users
-
-You should only add tooltips to HTML elements that are traditionally keyboard-focusable and interactive (such as links or form controls). Although arbitrary HTML elements (such as `<span>`s) can be made focusable by adding the `tabindex="0"` attribute, this will add potentially annoying and confusing tab stops on non-interactive elements for keyboard users, and most assistive technologies currently do not announce the tooltip in this situation. Additionally, do not rely solely on `hover` as the trigger for your tooltip, as this will make your tooltips impossible to trigger for keyboard users.
+**Keep tooltips accessible to keyboard and assistive technology users** by only adding them to HTML elements that are traditionally keyboard-focusable and interactive (such as links or form controls). While other HTML elements can be made focusable by adding `tabindex="0"`, this can create annoying and confusing tab stops on non-interactive elements for keyboard users, and most assistive technologies currently do not announce tooltips in this situation. Additionally, do not rely solely on `hover` as the trigger for your tooltips as this will make theme impossible to trigger for keyboard users.
{{< /callout >}}
```html
@@ -221,7 +214,7 @@ Note that for security reasons the `sanitize`, `sanitizeFn`, and `allowList` opt
| `sanitizeFn` | null, function | `null` | Here you can supply your own sanitize function. This can be useful if you prefer to use a dedicated library to perform sanitization. |
| `selector` | string, false | `false` | If a selector is provided, tooltip objects will be delegated to the specified targets. In practice, this is used to also apply tooltips to dynamically added DOM elements (`jQuery.on` support). See [this issue]({{< param repo >}}/issues/4215) and [an informative example](https://codepen.io/Johann-S/pen/djJYPb). **Note**: `title` attribute must not be used as a selector. |
| `template` | string | `'<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>'` | Base HTML to use when creating the tooltip. The tooltip's `title` will be injected into the `.tooltip-inner`. `.tooltip-arrow` will become the tooltip's arrow. The outermost wrapper element should have the `.tooltip` class and `role="tooltip"`. |
-| `title` | string, element, function | `''` | Default title value if `title` attribute isn't present. If a function is given, it will be called with its `this` reference set to the element that the popover is attached to. |
+| `title` | string, element, function | `''` | The tooltip title. If a function is given, it will be called with its `this` reference set to the element that the popover is attached to. |
| `trigger` | string | `'hover focus'` | How tooltip is triggered: click, hover, focus, manual. You may pass multiple triggers; separate them with a space. `'manual'` indicates that the tooltip will be triggered programmatically via the `.tooltip('show')`, `.tooltip('hide')` and `.tooltip('toggle')` methods; this value cannot be combined with any other trigger. `'hover'` on its own will result in tooltips that cannot be triggered via the keyboard, and should only be used if alternative methods for conveying the same information for keyboard users is present. |
{{< /bs-table >}}
@@ -246,7 +239,7 @@ const tooltip = new bootstrap.Tooltip(element, {
### Methods
{{< callout danger >}}
-{{< partial "callout-danger-async-methods.md" >}}
+{{< partial "callouts/danger-async-methods.md" >}}
{{< /callout >}}
{{< bs-table "table" >}}
@@ -274,7 +267,7 @@ tooltip.setContent({ '.tooltip-inner': 'another title' })
```
{{< callout info >}}
-The `setContent` method accepts an `object` argument, where each property-key is a valid `string` selector within the popover template, and each related property-value can be `string` | `element` | `function` | `null`
+The `setContent` method accepts an `object` argument, where each property-key is a valid `string` selector within the tooltip template, and each related property-value can be `string` | `element` | `function` | `null`
{{< /callout >}}
### Events
@@ -283,10 +276,10 @@ The `setContent` method accepts an `object` argument, where each property-key is
| Event | Description |
| --- | --- |
| `hide.bs.tooltip` | This event is fired immediately when the `hide` instance method has been called. |
-| `hidden.bs.tooltip` | This event is fired when the popover has finished being hidden from the user (will wait for CSS transitions to complete). |
+| `hidden.bs.tooltip` | This event is fired when the tooltip has finished being hidden from the user (will wait for CSS transitions to complete). |
| `inserted.bs.tooltip` | This event is fired after the `show.bs.tooltip` event when the tooltip template has been added to the DOM. |
| `show.bs.tooltip` | This event fires immediately when the `show` instance method is called. |
-| `shown.bs.tooltip` | This event is fired when the popover has been made visible to the user (will wait for CSS transitions to complete). |
+| `shown.bs.tooltip` | This event is fired when the tooltip has been made visible to the user (will wait for CSS transitions to complete). |
{{< /bs-table >}}
```js
diff --git a/site/content/docs/5.2/content/figures.md b/site/content/docs/5.3/content/figures.md
index 29a38d7..9851137 100644
--- a/site/content/docs/5.2/content/figures.md
+++ b/site/content/docs/5.3/content/figures.md
@@ -26,8 +26,8 @@ Aligning the figure's caption is easy with our [text utilities]({{< docsref "/ut
</figure>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="figure-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/content/images.md b/site/content/docs/5.3/content/images.md
index b55e7a2..0279561 100644
--- a/site/content/docs/5.2/content/images.md
+++ b/site/content/docs/5.3/content/images.md
@@ -54,9 +54,9 @@ If you are using the `<picture>` element to specify multiple `<source>` elements
</picture>
```
-## Sass
+## CSS
-### Variables
+### Sass variables
Variables are available for image thumbnails.
diff --git a/site/content/docs/5.2/content/reboot.md b/site/content/docs/5.3/content/reboot.md
index ca667b2..ef2bd13 100644
--- a/site/content/docs/5.2/content/reboot.md
+++ b/site/content/docs/5.3/content/reboot.md
@@ -3,7 +3,7 @@ layout: docs
title: Reboot
description: Reboot, a collection of element-specific CSS changes in a single file, kickstart Bootstrap to provide an elegant, consistent, and simple baseline to build upon.
group: content
-aliases: "/docs/5.2/content/"
+aliases: "/docs/5.3/content/"
toc: true
---
@@ -80,9 +80,9 @@ Note that because the font stack includes emoji fonts, many common symbol/dingba
This `font-family` is applied to the `<body>` and automatically inherited globally throughout Bootstrap. To switch the global `font-family`, update `$font-family-base` and recompile Bootstrap.
-## Headings and paragraphs
+## Headings
-All heading elements—e.g., `<h1>`—and `<p>` are reset to have their `margin-top` removed. Headings have `margin-bottom: .5rem` added and paragraphs `margin-bottom: 1rem` for easy spacing.
+All heading elements—`<h1>`—`<h6>` have their `margin-top` removed, `margin-bottom: .5rem` set, and `line-height` tightened. While headings inherit their `color` by default, you can also override it via optional CSS variable, `--bs-heading-color`.
{{< bs-table "table" >}}
| Heading | Example |
@@ -95,6 +95,35 @@ All heading elements—e.g., `<h1>`—and `<p>` are reset to have their `margin-
| `<h6></h6>` | <span class="h6">h6. Bootstrap heading</span> |
{{< /bs-table >}}
+## Paragraphs
+
+All `<p>` elements have their `margin-top` removed and `margin-bottom: 1rem` set for easy spacing.
+
+{{< example >}}
+<p>This is an example paragraph.</p>
+{{< /example >}}
+
+## Links
+
+Links have a default `color` and underline applied. While links change on `:hover`, they don't change based on whether someone `:visited` the link. They also receive no special `:focus` styles.
+
+{{< example >}}
+<a href="#">This is an example link</a>
+{{< /example >}}
+
+As of v5.3.x, link `color` is set using `rgba()` and new `-rgb` CSS variables, allowing for easy customization of link color opacity. Change the link color opacity with the `--bs-link-opacity` CSS variable:
+
+{{< example >}}
+<a href="#" style="--bs-link-opacity: .5">This is an example link</a>
+{{< /example >}}
+
+
+Placeholder links—those without an `href`—are targeted with a more specific selector and have their `color` and `text-decoration` reset to their default values.
+
+{{< example >}}
+<a>This is a placeholder link</a>
+{{< /example >}}
+
## Horizontal rules
The `<hr>` element has been simplified. Similar to browser defaults, `<hr>`s are styled via `border-top`, have a default `opacity: .25`, and automatically inherit their `border-color` via `color`, including when `color` is set via the parent. They can be modified with text, border, and opacity utilities.
@@ -176,7 +205,7 @@ Use the `<kbd>` to indicate input that is typically entered via keyboard.
{{< example >}}
To switch directories, type <kbd>cd</kbd> followed by the name of the directory.<br>
-To edit settings, press <kbd><kbd>ctrl</kbd> + <kbd>,</kbd></kbd>
+To edit settings, press <kbd><kbd>Ctrl</kbd> + <kbd>,</kbd></kbd>
{{< /example >}}
## Sample output
@@ -240,6 +269,10 @@ Various form elements have been rebooted for simpler base styles. Here are some
These changes, and more, are demonstrated below.
+{{< callout warning >}}
+{{< partial "callouts/warning-input-support.md" >}}
+{{< /callout >}}
+
<form class="bd-example">
<fieldset>
<legend>Example legend</legend>
@@ -362,10 +395,6 @@ These changes, and more, are demonstrated below.
</fieldset>
</form>
-{{< callout warning >}}
-{{< partial "callout-warning-input-support.md" >}}
-{{< /callout >}}
-
### Pointers on buttons
Reboot includes an enhancement for `role="button"` to change the default cursor to `pointer`. Add this attribute to elements to help indicate elements are interactive. This role isn't necessary for `<button>` elements, which get their own `cursor` change.
@@ -382,8 +411,8 @@ The `<address>` element is updated to reset the browser default `font-style` fro
<div class="bd-example">
<address>
- <strong>Twitter, Inc.</strong><br>
- 1355 Market St, Suite 900<br>
+ <strong>ACME Corporation</strong><br>
+ 1123 Fictional St,<br>
San Francisco, CA 94103<br>
<abbr title="Phone">P:</abbr> (123) 456-7890
</address>
@@ -437,10 +466,8 @@ HTML5 adds [a new global attribute named `[hidden]`](https://developer.mozilla.o
<input type="text" hidden>
```
-{{< callout warning >}}
-##### jQuery incompatibility
-
-`[hidden]` is not compatible with jQuery's `$(...).hide()` and `$(...).show()` methods. Therefore, we don't currently especially endorse `[hidden]` over other techniques for managing the `display` of elements.
+{{< callout info >}}
+Since `[hidden]` is not compatible with jQuery's `$(...).hide()` and `$(...).show()` methods, we don't specifically endorse `[hidden]` over other techniques for managing the `display` of elements.
{{< /callout >}}
To merely toggle the visibility of an element, meaning its `display` is not modified and the element can still affect the flow of the document, use [the `.invisible` class]({{< docsref "/utilities/visibility" >}}) instead.
diff --git a/site/content/docs/5.2/content/tables.md b/site/content/docs/5.3/content/tables.md
index 577e3ef..b75b233 100644
--- a/site/content/docs/5.2/content/tables.md
+++ b/site/content/docs/5.3/content/tables.md
@@ -18,6 +18,10 @@ Using the most basic table markup, here's how `.table`-based tables look in Boot
Use contextual classes to color tables, table rows or individual cells.
+{{< callout info >}}
+**Heads up!** Because of the more complicated CSS used to generate our table variants, they most likely won't see color mode adaptive styling until v6.
+{{< /callout >}}
+
<div class="bd-example">
<table class="table">
<thead>
@@ -69,7 +73,7 @@ Use contextual classes to color tables, table rows or individual cells.
{{< /highlight >}}
{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
{{< /callout >}}
## Accented tables
@@ -223,8 +227,8 @@ Highlight a table row or cell by adding a `.table-active` class.
For the accented tables ([striped rows](#striped-rows), [striped columns](#striped-columns), [hoverable rows](#hoverable-rows), and [active tables](#active-tables)), we used some techniques to make these effects work for all our [table variants](#variants):
- We start by setting the background of a table cell with the `--bs-table-bg` custom property. All table variants then set that custom property to colorize the table cells. This way, we don't get into trouble if semi-transparent colors are used as table backgrounds.
-- Then we add an inset box shadow on the table cells with `box-shadow: inset 0 0 0 9999px var(--bs-table-accent-bg);` to layer on top of any specified `background-color`. Because we use a huge spread and no blur, the color will be monotone. Since `--bs-table-accent-bg` is unset by default, we don't have a default box shadow.
-- When either `.table-striped`, `.table-striped-columns`, `.table-hover` or `.table-active` classes are added, the `--bs-table-accent-bg` is set to a semitransparent color to colorize the background.
+- Then we add an inset box shadow on the table cells with `box-shadow: inset 0 0 0 9999px var(--bs-table-bg-state, var(--bs-table-bg-type, var(--bs-table-accent-bg)));` to layer on top of any specified `background-color`. It uses custom cascade to override the `box-shadow`, regardless the CSS specificity. Because we use a huge spread and no blur, the color will be monotone. Since `--bs-table-accent-bg` is set to `transparent` by default, we don't have a default box shadow.
+- When either `.table-striped`, `.table-striped-columns`, `.table-hover` or `.table-active` classes are added, either `--bs-table-bg-type` or `--bs-table-bg-state` (by default set to `initial`) are set to a semitransparent color (`--bs-table-striped-bg`, `--bs-table-active-bg` or `--bs-table-hover-bg`) to colorize the background and override default `--bs-table-accent-bg`.
- For each table variant, we generate a `--bs-table-accent-bg` color with the highest contrast depending on that color. For example, the accent color for `.table-primary` is darker while `.table-dark` has a lighter accent color.
- Text and border colors are generated the same way, and their colors are inherited by default.
@@ -423,7 +427,7 @@ Border styles, active styles, and table variants are not inherited by nested tab
</div>
```html
-<table class="table table-striped">
+<table class="table table-striped table-bordered">
<thead>
...
</thead>
@@ -819,13 +823,13 @@ Use `.table-responsive{-sm|-md|-lg|-xl|-xxl}` as needed to create responsive tab
{{< /tables.inline >}}
{{< /highlight >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="table-variables" file="scss/_variables.scss" >}}
-### Loop
+### Sass loops
{{< scss-docs name="table-loop" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/content/typography.md b/site/content/docs/5.3/content/typography.md
index 7330132..ca0f4e9 100644
--- a/site/content/docs/5.2/content/typography.md
+++ b/site/content/docs/5.3/content/typography.md
@@ -60,7 +60,7 @@ Use the included utility classes to recreate the small secondary heading text fr
{{< example >}}
<h3>
Fancy display heading
- <small class="text-muted">With faded secondary text</small>
+ <small class="text-body-secondary">With faded secondary text</small>
</h3>
{{< /example >}}
@@ -269,9 +269,9 @@ Align terms and descriptions horizontally by using our grid system's predefined
In Bootstrap 5, we've enabled responsive font sizes by default, allowing text to scale more naturally across device and viewport sizes. Have a look at the [RFS page]({{< docsref "/getting-started/rfs" >}}) to find out how this works.
-## Sass
+## CSS
-### Variables
+### Sass variables
Headings have some dedicated variables for sizing and spacing.
@@ -281,6 +281,6 @@ Miscellaneous typography elements covered here and in [Reboot]({{< docsref "/con
{{< scss-docs name="type-variables" file="scss/_variables.scss" >}}
-### Mixins
+### Sass mixins
There are no dedicated mixins for typography, but Bootstrap does use [Responsive Font Sizing (RFS)]({{< docsref "/getting-started/rfs" >}}).
diff --git a/site/content/docs/5.3/customize/color-modes.md b/site/content/docs/5.3/customize/color-modes.md
new file mode 100644
index 0000000..945d5ec
--- /dev/null
+++ b/site/content/docs/5.3/customize/color-modes.md
@@ -0,0 +1,258 @@
+---
+layout: docs
+title: Color modes
+description: Bootstrap now supports color modes, or themes, as of v5.3.0. Explore our default light color mode and the new dark mode, or create your own using our styles as your template.
+group: customize
+toc: true
+added: "5.3"
+---
+
+{{< callout >}}
+**Try it yourself!** Download the source code and working demo for using Bootstrap with Stylelint, and the color modes from the [twbs/examples repository](https://github.com/twbs/examples/tree/main/color-modes). You can also [open the example in StackBlitz](https://stackblitz.com/github/twbs/examples/tree/main/color-modes?file=index.html).
+{{< /callout >}}
+
+## Dark mode
+
+**Bootstrap now supports color modes, starting with dark mode!** With v5.3.0 you can implement your own color mode toggler (see below for an example from Bootstrap's docs) and apply the different color modes as you see fit. We support a light mode (default) and now dark mode. Color modes can be toggled globally on the `<html>` element, or on specific components and elements, thanks to the `data-bs-theme` attribute.
+
+Alternatively, you can also switch to a media query implementation thanks to our color mode mixin—see [the usage section for details](#building-with-sass). Heads up though—this eliminates your ability to change themes on a per-component basis as shown below.
+
+## Example
+
+For example, to change the color mode of a dropdown menu, add `data-bs-theme="light"` or `data-bs-theme="dark"` to the parent `.dropdown`. Now, no matter the global color mode, these dropdowns will display with the specified theme value.
+
+{{< example class="d-flex justify-content-between" >}}
+<div class="dropdown" data-bs-theme="light">
+ <button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButtonLight" data-bs-toggle="dropdown" aria-expanded="false">
+ Default dropdown
+ </button>
+ <ul class="dropdown-menu" aria-labelledby="dropdownMenuButtonLight">
+ <li><a class="dropdown-item active" href="#">Action</a></li>
+ <li><a class="dropdown-item" href="#">Action</a></li>
+ <li><a class="dropdown-item" href="#">Another action</a></li>
+ <li><a class="dropdown-item" href="#">Something else here</a></li>
+ <li><hr class="dropdown-divider"></li>
+ <li><a class="dropdown-item" href="#">Separated link</a></li>
+ </ul>
+</div>
+
+<div class="dropdown" data-bs-theme="dark">
+ <button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButtonDark" data-bs-toggle="dropdown" aria-expanded="false">
+ Dark dropdown
+ </button>
+ <ul class="dropdown-menu" aria-labelledby="dropdownMenuButtonDark">
+ <li><a class="dropdown-item active" href="#">Action</a></li>
+ <li><a class="dropdown-item" href="#">Action</a></li>
+ <li><a class="dropdown-item" href="#">Another action</a></li>
+ <li><a class="dropdown-item" href="#">Something else here</a></li>
+ <li><hr class="dropdown-divider"></li>
+ <li><a class="dropdown-item" href="#">Separated link</a></li>
+ </ul>
+</div>
+{{< /example >}}
+
+## How it works
+
+- As shown above, color mode styles are controlled by the `data-bs-theme` attribute. This attribute can be applied to the `<html>` element, or to any other element or Bootstrap component. If applied to the `<html>` element, it will apply to everything. If applied to a component or element, it will be scoped to that specific component or element.
+
+- For each color mode you wish to support, you'll need to add new overrides for the shared global CSS variables. We do this already in our `_root.scss` stylesheet for dark mode, with light mode being the default values. In writing color mode specific styles, use the mixin:
+
+ ```scss
+ // Color mode variables in _root.scss
+ @include color-mode(dark) {
+ // CSS variable overrides here...
+ }
+ ```
+
+- We use a custom `_variables-dark.scss` to power those shared global CSS variable overrides for dark mode. This file isn't required for your own custom color modes, but it's required for our dark mode for two reasons. First, it's better to have a single place to reset global colors. Second, some Sass variables had to be overridden for background images embedded in our CSS for accordions, form components, and more.
+
+## Usage
+
+### Enable dark mode
+
+Enable the built in dark color mode across your entire project by adding the `data-bs-theme="dark"` attribute to the `<html>` element. This will apply the dark color mode to all components and elements, other than those with a specific `data-bs-theme` attribute applied. Building on the [quick start template]({{< docsref "/getting-started/introduction#quick-start" >}}):
+
+```html
+<!doctype html>
+<html lang="en" data-bs-theme="dark">
+ <head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Bootstrap demo</title>
+ <link href="{{< param "cdn.css" >}}" rel="stylesheet" integrity="{{< param "cdn.css_hash" >}}" crossorigin="anonymous">
+ </head>
+ <body>
+ <h1>Hello, world!</h1>
+ <script src="{{< param "cdn.js_bundle" >}}" integrity="{{< param "cdn.js_bundle_hash" >}}" crossorigin="anonymous"></script>
+ </body>
+</html>
+```
+
+Bootstrap does not yet ship with a built-in color mode picker, but you can use the one from our own documentation if you like. [Learn more in the JavaScript section.](#javascript)
+
+### Building with Sass
+
+Our new dark mode option is available to use for all users of Bootstrap, but it's controlled via data attributes instead of media queries and does not automatically toggle your project's color mode. You can disable our dark mode entirely via Sass by changing `$enable-dark-mode` to `false`.
+
+We use a custom Sass mixin, `color-mode()`, to help you control _how_ color modes are applied. By default, we use a `data` attribute approach, allowing you to create more user-friendly experiences where your visitors can choose to have an automatic dark mode or control their preference (like in our own docs here). This is also an easy and scalable way to add different themes and more custom color modes beyond light and dark.
+
+In case you want to use media queries and only make color modes automatic, you can change the mixin's default type via Sass variable. Consider the following snippet and its compiled CSS output.
+
+```scss
+$color-mode-type: data;
+
+@include color-mode(dark) {
+ .element {
+ color: var(--bs-primary-text-emphasis);
+ background-color: var(--bs-primary-bg-subtle);
+ }
+}
+```
+
+Outputs to:
+
+```css
+[data-bs-theme=dark] .element {
+ color: var(--bs-primary-text-emphasis);
+ background-color: var(--bs-primary-bg-subtle);
+}
+```
+
+And when setting to `media-query`:
+
+```scss
+$color-mode-type: media-query;
+
+@include color-mode(dark) {
+ .element {
+ color: var(--bs-primary-text-emphasis);
+ background-color: var(--bs-primary-bg-subtle);
+ }
+}
+```
+
+Outputs to:
+
+```css
+@media (prefers-color-scheme: dark) {
+ .element {
+ color: var(--bs-primary-text-emphasis);
+ background-color: var(--bs-primary-bg-subtle);
+ }
+}
+```
+
+## Custom color modes
+
+While the primary use case for color modes is light and dark mode, custom color modes are also possible. Create your own `data-bs-theme` selector with a custom value as the name of your color mode, then modify our Sass and CSS variables as needed. We opted to create a separate `_variables-dark.scss` stylesheet to house Bootstrap's dark mode specific Sass variables, but that's not required for you.
+
+For example, you can create a "blue theme" with the selector `data-bs-theme="blue"`. In your custom Sass or CSS file, add the new selector and override any global or component CSS variables as needed. If you're using Sass, you can also use Sass's functions within your CSS variable overrides.
+
+{{< scss-docs name="custom-color-mode" file="site/assets/scss/_content.scss" >}}
+
+<div class="bd-example text-body bg-body" data-bs-theme="blue">
+ <div class="h4">Example blue theme</div>
+ <p>Some paragraph text to show how the blue theme might look with written copy.</p>
+
+ <hr class="my-4">
+
+ <div class="dropdown">
+ <button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButtonCustom" data-bs-toggle="dropdown" aria-expanded="false">
+ Dropdown button
+ </button>
+ <ul class="dropdown-menu" aria-labelledby="dropdownMenuButtonCustom">
+ <li><a class="dropdown-item active" href="#">Action</a></li>
+ <li><a class="dropdown-item" href="#">Action</a></li>
+ <li><a class="dropdown-item" href="#">Another action</a></li>
+ <li><a class="dropdown-item" href="#">Something else here</a></li>
+ <li><hr class="dropdown-divider"></li>
+ <li><a class="dropdown-item" href="#">Separated link</a></li>
+ </ul>
+ </div>
+</div>
+
+```html
+<div data-bs-theme="blue">
+ ...
+</div>
+```
+
+## JavaScript
+
+To allow visitors or users to toggle color modes, you'll need to create a toggle element to control the `data-bs-theme` attribute on the root element, `<html>`. We've built a toggler in our documentation that initially defers to a user's current system color mode, but provides an option to override that and pick a specific color mode.
+
+Here's a look at the JavaScript that powers it. Feel free to inspect our own documentation navbar to see how it's implemented using HTML and CSS from our own components. It is suggested to include the JavaScript at the top of your page to reduce potential screen flickering during reloading of your site. Note that if you decide to use media queries for your color modes, your JavaScript may need to be modified or removed if you prefer an implicit control.
+
+{{< example lang="js" show_preview="false" >}}
+{{< js.inline >}}
+{{- readFile (path.Join "site/static/docs" .Site.Params.docs_version "assets/js/color-modes.js") -}}
+{{< /js.inline >}}
+{{< /example >}}
+
+## Adding theme colors
+
+Adding a new color in `$theme-colors` is not enough for some of our components like [alerts]({{< docsref "/components/alerts" >}}) and [list groups]({{< docsref "/components/list-group" >}}). New colors must also be defined in `$theme-colors-text`, `$theme-colors-bg-subtle`, and `$theme-colors-border-subtle` for light theme; but also in `$theme-colors-text-dark`, `$theme-colors-bg-subtle-dark`, and `$theme-colors-border-subtle-dark` for dark theme.
+
+This is a manual process because Sass cannot generate its own Sass variables from an existing variable or map. In future versions of Bootstrap, we'll revisit this setup to reduce the duplication.
+
+```scss
+// Required
+@import "functions";
+@import "variables";
+@import "variables-dark";
+
+// Add a custom color to $theme-colors
+$custom-colors: (
+ "custom-color": #712cf9
+);
+$theme-colors: map-merge($theme-colors, $custom-colors);
+
+@import "maps";
+@import "mixins";
+@import "utilities";
+
+// Add a custom color to new theme maps
+
+// Light mode
+$custom-colors-text: ("custom-color": #712cf9);
+$custom-colors-bg-subtle: ("custom-color": #e1d2fe);
+$custom-colors-border-subtle: ("custom-color": #bfa1fc);
+
+$theme-colors-text: map-merge($theme-colors-text, $custom-colors-text);
+$theme-colors-bg-subtle: map-merge($theme-colors-bg-subtle, $custom-colors-bg-subtle);
+$theme-colors-border-subtle: map-merge($theme-colors-border-subtle, $custom-colors-border-subtle);
+
+// Dark mode
+$custom-colors-text-dark: ("custom-color": #e1d2f2);
+$custom-colors-bg-subtle-dark: ("custom-color": #8951fa);
+$custom-colors-border-subtle-dark: ("custom-color": #e1d2f2);
+
+$theme-colors-text-dark: map-merge($theme-colors-text-dark, $custom-colors-text-dark);
+$theme-colors-bg-subtle-dark: map-merge($theme-colors-bg-subtle-dark, $custom-colors-bg-subtle-dark);
+$theme-colors-border-subtle-dark: map-merge($theme-colors-border-subtle-dark, $custom-colors-border-subtle-dark);
+
+// Remainder of Bootstrap imports
+@import "root";
+@import "reboot";
+// etc
+```
+
+## CSS
+
+### Variables
+
+Dozens of root level CSS variables are repeated as overrides for dark mode. These are scoped to the color mode selector, which defaults to `data-bs-theme` but [can be configured](#building-with-sass) to use a `prefers-color-scheme` media query. Use these variables as a guideline for generating your own new color modes.
+
+{{< scss-docs name="root-dark-mode-vars" file="scss/_root.scss" >}}
+
+### Sass variables
+
+CSS variables for our dark color mode are partially generated from dark mode specific Sass variables in `_variables-dark.scss`. This also includes some custom overrides for changing the colors of embedded SVGs used throughout our components.
+
+{{< scss-docs name="sass-dark-mode-vars" file="scss/_variables-dark.scss" >}}
+
+### Sass mixins
+
+Styles for dark mode, and any custom color modes you create, can be scoped appropriately to the `data-bs-theme` attribute selector or media query with the customizable `color-mode()` mixin. See the [Sass usage section](#building-with-sass) for more details.
+
+{{< scss-docs name="color-mode-mixin" file="scss/mixins/_color-mode.scss" >}}
diff --git a/site/content/docs/5.3/customize/color.md b/site/content/docs/5.3/customize/color.md
new file mode 100644
index 0000000..6a3c323
--- /dev/null
+++ b/site/content/docs/5.3/customize/color.md
@@ -0,0 +1,510 @@
+---
+layout: docs
+title: Color
+description: Bootstrap is supported by an extensive color system that themes our styles and components. This enables more comprehensive customization and extension for any project.
+group: customize
+toc: true
+---
+
+## Colors
+
+{{< added-in "5.3.0" >}}
+
+Bootstrap's color palette has continued to expand and become more nuanced in v5.3.0. We've added new variables for `secondary` and `tertiary` text and background colors, plus `{color}-bg-subtle`, `{color}-border-subtle`, and `{color}-text-emphasis` for our theme colors. These new colors are available through Sass and CSS variables (but not our color maps or utility classes) with the express goal of making it easier to customize across multiple colors modes like light and dark. These new variables are globally set on `:root` and are adapted for our new dark color mode while our original theme colors remain unchanged.
+
+Colors ending in `-rgb` provide the `red, green, blue` values for use in `rgb()` and `rgba()` color modes. For example, `rgba(var(--bs-secondary-bg-rgb), .5)`.
+
+{{< callout warning>}}
+**Heads up!** There's some potential confusion with our new secondary and tertiary colors, and our existing secondary theme color, as well as our light and dark theme colors. Expect this to be ironed out in v6.
+{{< /callout >}}
+
+<table class="table table-swatches">
+ <thead>
+ <tr>
+ <th style="width: 340px;">Description</th>
+ <th style="width: 200px;" class="ps-0">Swatch</th>
+ <th>Variables</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td rowspan="2">
+ {{< markdown >}}**Body —** Default foreground (color) and background, including components.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2" style="background-color: var(--bs-body-color);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-body-color`<br>`--bs-body-color-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2 border" style="background-color: var(--bs-body-bg);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-body-bg`<br>`--bs-body-bg-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="2">
+ {{< markdown >}}**Secondary —** Use the `color` option for lighter text. Use the `bg` option for dividers and to indicate disabled component states.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2" style="background-color: var(--bs-secondary-color);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-secondary-color`<br>`--bs-secondary-color-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2 border" style="background-color: var(--bs-secondary-bg);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-secondary-bg`<br>`--bs-secondary-bg-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="2">
+ {{< markdown >}}**Tertiary —** Use the `color` option for even lighter text. Use the `bg` option to style backgrounds for hover states, accents, and wells.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2" style="background-color: var(--bs-tertiary-color);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-tertiary-color`<br>`--bs-tertiary-color-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2 border" style="background-color: var(--bs-tertiary-bg);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-tertiary-bg`<br>`--bs-tertiary-bg-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ {{< markdown >}}**Emphasis —** For higher contrast text. Not applicable for backgrounds.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2" style="background-color: var(--bs-emphasis-color);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-emphasis-color`<br>`--bs-emphasis-color-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ {{< markdown >}}**Border —** For component borders, dividers, and rules. Use `--bs-border-color-translucent` to blend with backgrounds with an `rgba()` value.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2" style="background-color: var(--bs-border-color);">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-border-color`<br>`--bs-border-color-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="4">
+ {{< markdown >}}**Primary —** Main theme color, used for hyperlinks, focus styles, and component and form active states.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2 bg-primary">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-primary`<br>`--bs-primary-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="background-color: var(--bs-primary-bg-subtle)">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-primary-bg-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="border: 5px var(--bs-primary-border-subtle) solid">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-primary-border-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="py-3 fw-bold h5" style="color: var(--bs-primary-text-emphasis)">Text</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-primary-text-emphasis`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="4">
+ {{< markdown >}}**Success —** Theme color used for positive or successful actions and information.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2 bg-success">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-success`<br>`--bs-success-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="background-color: var(--bs-success-bg-subtle)">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-success-bg-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="border: 5px var(--bs-success-border-subtle) solid">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-success-border-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="py-3 fw-bold h5" style="color: var(--bs-success-text-emphasis)">Text</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-success-text-emphasis`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="4">
+ {{< markdown >}}**Danger —** Theme color used for errors and dangerous actions.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2 bg-danger">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-danger`<br>`--bs-danger-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="background-color: var(--bs-danger-bg-subtle)">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-danger-bg-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="border: 5px var(--bs-danger-border-subtle) solid">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-danger-border-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="py-3 fw-bold h5" style="color: var(--bs-danger-text-emphasis)">Text</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-danger-text-emphasis`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="4">
+ {{< markdown >}}**Warning —** Theme color used for non-destructive warning messages.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2 bg-warning">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-warning`<br>`--bs-warning-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="background-color: var(--bs-warning-bg-subtle)">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-warning-bg-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="border: 5px var(--bs-warning-border-subtle) solid">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-warning-border-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="py-3 fw-bold h5" style="color: var(--bs-warning-text-emphasis)">Text</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-warning-text-emphasis`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="4">
+ {{< markdown >}}**Info —** Theme color used for neutral and informative content.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2 bg-info">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-info`<br>`--bs-info-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="background-color: var(--bs-info-bg-subtle)">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-info-bg-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="border: 5px var(--bs-info-border-subtle) solid">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-info-border-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="py-3 fw-bold h5" style="color: var(--bs-info-text-emphasis)">Text</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-info-text-emphasis`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="4">
+ {{< markdown >}}**Light —** Additional theme option for less contrasting colors.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2 bg-light">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-light`<br>`--bs-light-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="background-color: var(--bs-light-bg-subtle)">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-light-bg-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="border: 5px var(--bs-light-border-subtle) solid">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-light-border-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="py-3 fw-bold h5" style="color: var(--bs-light-text-emphasis)">Text</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-light-text-emphasis`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td rowspan="4">
+ {{< markdown >}}**Dark —** Additional theme option for higher contrasting colors.{{< /markdown >}}
+ </td>
+ <td class="ps-0">
+ <div class="p-3 rounded-2 bg-dark">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-dark`<br>`--bs-dark-rgb`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="background-color: var(--bs-dark-bg-subtle)">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-dark-bg-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="p-3 rounded-2" style="border: 5px var(--bs-dark-border-subtle) solid">&nbsp;</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-dark-border-subtle`{{< /markdown >}}
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="py-3 fw-bold h5" style="color: var(--bs-dark-text-emphasis)">Text</div>
+ </td>
+ <td>
+ {{< markdown >}}`--bs-dark-text-emphasis`{{< /markdown >}}
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+### Using the new colors
+
+These new colors are accessible via CSS variables and utility classes—like `--bs-primary-bg-subtle` and `.bg-primary-subtle`—allowing you to compose your own CSS rules with the variables, or to quickly apply styles via classes. The utilities are built with the color's associated CSS variables, and since we customize those CSS variables for dark mode, they are also adaptive to color mode by default.
+
+{{< example >}}
+<div class="p-3 text-primary-emphasis bg-primary-subtle border border-primary-subtle rounded-3">
+ Example element with utilities
+</div>
+{{< /example >}}
+
+### Theme colors
+
+We use a subset of all colors to create a smaller color palette for generating color schemes, also available as Sass variables and a Sass map in Bootstrap's `scss/_variables.scss` file.
+
+<div class="row">
+ {{< theme-colors.inline >}}
+ {{- range (index $.Site.Data "theme-colors") }}
+ <div class="col-md-4">
+ <div class="p-3 mb-3 text-bg-{{ .name }} rounded-3">{{ .name | title }}</div>
+ </div>
+ {{ end -}}
+ {{< /theme-colors.inline >}}
+</div>
+
+All these colors are available as a Sass map, `$theme-colors`.
+
+{{< scss-docs name="theme-colors-map" file="scss/_variables.scss" >}}
+
+Check out [our Sass maps and loops docs]({{< docsref "/customize/sass#maps-and-loops" >}}) for how to modify these colors.
+
+### All colors
+
+All Bootstrap colors are available as Sass variables and a Sass map in `scss/_variables.scss` file. To avoid increased file sizes, we don't create text or background color classes for each of these variables. Instead, we choose a subset of these colors for a [theme palette](#theme-colors).
+
+Be sure to monitor contrast ratios as you customize colors. As shown below, we've added three contrast ratios to each of the main colors—one for the swatch's current colors, one for against white, and one for against black.
+
+<div class="row font-monospace">
+ {{< theme-colors.inline >}}
+ {{- range $color := $.Site.Data.colors }}
+ {{- if (and (not (eq $color.name "white")) (not (eq $color.name "gray")) (not (eq $color.name "gray-dark"))) }}
+ <div class="col-md-4 mb-3">
+ <div class="p-3 mb-2 position-relative swatch-{{ $color.name }}">
+ <strong class="d-block">${{ $color.name }}</strong>
+ {{ $color.hex }}
+ </div>
+ {{ range (seq 100 100 900) }}
+ <div class="p-3 bd-{{ $color.name }}-{{ . }}">${{ $color.name }}-{{ . }}</div>
+ {{ end }}
+ </div>
+ {{ end -}}
+ {{ end -}}
+
+ <div class="col-md-4 mb-3">
+ <div class="p-3 mb-2 position-relative swatch-gray-500">
+ <strong class="d-block">$gray-500</strong>
+ #adb5bd
+ </div>
+ {{- range $.Site.Data.grays }}
+ <div class="p-3 bd-gray-{{ .name }}">$gray-{{ .name }}</div>
+ {{ end -}}
+ </div>
+ {{< /theme-colors.inline >}}
+
+ <div class="col-md-4 mb-3">
+ <div class="p-3 mb-2 bd-black text-white">
+ <strong class="d-block">$black</strong>
+ #000
+ </div>
+ <div class="p-3 mb-2 bd-white border">
+ <strong class="d-block">$white</strong>
+ #fff
+ </div>
+ </div>
+</div>
+
+### Notes on Sass
+
+Sass cannot programmatically generate variables, so we manually created variables for every tint and shade ourselves. We specify the midpoint value (e.g., `$blue-500`) and use custom color functions to tint (lighten) or shade (darken) our colors via Sass's `mix()` color function.
+
+Using `mix()` is not the same as `lighten()` and `darken()`—the former blends the specified color with white or black, while the latter only adjusts the lightness value of each color. The result is a much more complete suite of colors, as [shown in this CodePen demo](https://codepen.io/emdeoh/pen/zYOQOPB).
+
+Our `tint-color()` and `shade-color()` functions use `mix()` alongside our `$theme-color-interval` variable, which specifies a stepped percentage value for each mixed color we produce. See the `scss/_functions.scss` and `scss/_variables.scss` files for the full source code.
+
+## Color Sass maps
+
+Bootstrap's source Sass files include three maps to help you quickly and easily loop over a list of colors and their hex values.
+
+- `$colors` lists all our available base (`500`) colors
+- `$theme-colors` lists all semantically named theme colors (shown below)
+- `$grays` lists all tints and shades of gray
+
+Within `scss/_variables.scss`, you'll find Bootstrap's color variables and Sass map. Here's an example of the `$colors` Sass map:
+
+{{< scss-docs name="colors-map" file="scss/_variables.scss" >}}
+
+Add, remove, or modify values within the map to update how they're used in many other components. Unfortunately at this time, not _every_ component utilizes this Sass map. Future updates will strive to improve upon this. Until then, plan on making use of the `${color}` variables and this Sass map.
+
+### Example
+
+Here's how you can use these in your Sass:
+
+```scss
+.alpha { color: $purple; }
+.beta {
+ color: $yellow-300;
+ background-color: $indigo-900;
+}
+```
+
+[Color]({{< docsref "/utilities/colors" >}}) and [background]({{< docsref "/utilities/background" >}}) utility classes are also available for setting `color` and `background-color` using the `500` color values.
+
+## Generating utilities
+
+{{< added-in "5.1.0" >}}
+
+Bootstrap doesn't include `color` and `background-color` utilities for every color variable, but you can generate these yourself with our [utility API]({{< docsref "/utilities/api" >}}) and our extended Sass maps added in v5.1.0.
+
+1. To start, make sure you've imported our functions, variables, mixins, and utilities.
+2. Use our `map-merge-multiple()` function to quickly merge multiple Sass maps together in a new map.
+3. Merge this new combined map to extend any utility with a `{color}-{level}` class name.
+
+Here's an example that generates text color utilities (e.g., `.text-purple-500`) using the above steps.
+
+```scss
+@import "bootstrap/scss/functions";
+@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
+@import "bootstrap/scss/maps";
+@import "bootstrap/scss/mixins";
+@import "bootstrap/scss/utilities";
+
+$all-colors: map-merge-multiple($blues, $indigos, $purples, $pinks, $reds, $oranges, $yellows, $greens, $teals, $cyans);
+
+$utilities: map-merge(
+ $utilities,
+ (
+ "color": map-merge(
+ map-get($utilities, "color"),
+ (
+ values: map-merge(
+ map-get(map-get($utilities, "color"), "values"),
+ (
+ $all-colors
+ ),
+ ),
+ ),
+ ),
+ )
+);
+
+@import "bootstrap/scss/utilities/api";
+```
+
+This will generate new `.text-{color}-{level}` utilities for every color and level. You can do the same for any other utility and property as well.
diff --git a/site/content/docs/5.2/customize/components.md b/site/content/docs/5.3/customize/components.md
index b512a90..262c8d8 100644
--- a/site/content/docs/5.2/customize/components.md
+++ b/site/content/docs/5.3/customize/components.md
@@ -34,7 +34,7 @@ Should you modify your `$grid-breakpoints`, your changes will apply to all the l
{{< scss-docs name="grid-breakpoints" file="scss/_variables.scss" >}}
-For more information and examples on how to modify our Sass maps and variables, please refer to [the Sass section of the Grid documentation]({{< docsref "/layout/grid#sass" >}}).
+For more information and examples on how to modify our Sass maps and variables, please refer to [the CSS section of the Grid documentation]({{< docsref "/layout/grid#css" >}}).
## Creating your own
diff --git a/site/content/docs/5.2/customize/css-variables.md b/site/content/docs/5.3/customize/css-variables.md
index 26d1675..ffb40c0 100644
--- a/site/content/docs/5.2/customize/css-variables.md
+++ b/site/content/docs/5.3/customize/css-variables.md
@@ -14,10 +14,14 @@ Bootstrap includes many [CSS custom properties (variables)](https://developer.mo
Here are the variables we include (note that the `:root` is required) that can be accessed anywhere Bootstrap's CSS is loaded. They're located in our `_root.scss` file and included in our compiled dist files.
+### Default
+
+These CSS variables are available everywhere, regardless of color mode.
+
```css
{{< root.inline >}}
{{- $css := readFile "dist/css/bootstrap.css" -}}
-{{- $match := findRE ":root {([^}]*)}" $css 1 -}}
+{{- $match := findRE `:root,\n\[data-bs-theme=light\] {([^}]*)}` $css 1 -}}
{{- if (eq (len $match) 0) -}}
{{- errorf "Got no matches for :root in %q!" $.Page.Path -}}
@@ -28,6 +32,21 @@ Here are the variables we include (note that the `:root` is required) that can b
{{< /root.inline >}}
```
+### Dark mode
+
+These variables are scoped to our built-in dark mode.
+
+```css
+{{< root.inline >}}
+{{- $css := readFile "dist/css/bootstrap.css" -}}
+{{- $match := findRE `\[data-bs-theme=dark\] {([^}]*)}` $css 1 -}}
+{{- if (eq (len $match) 0) -}}
+{{- errorf "Got no matches for [data-bs-theme=dark] in %q!" $.Page.Path -}}
+{{- end -}}
+{{- index $match 0 -}}
+{{< /root.inline >}}
+```
+
## Component variables
Bootstrap 5 is increasingly making use of custom properties as local variables for various components. This way we reduce our compiled CSS, ensure styles aren't inherited in places like nested tables, and allow some basic restyling and extending of Bootstrap components after Sass compilation.
@@ -55,6 +74,20 @@ a {
}
```
+## Focus variables
+
+{{< added-in "5.3.0" >}}
+
+Bootstrap provides custom `:focus` styles using a combination of Sass and CSS variables that can be optionally added to specific components and elements. We do not yet globally override all `:focus` styles.
+
+In our Sass, we set default values that can be customized before compiling.
+
+{{< scss-docs name="focus-ring-variables" file="scss/_variables.scss" >}}
+
+Those variables are then reassigned to `:root` level CSS variables that can be customized in real-time, including with options for `x` and `y` offsets (which default to their fallback value of `0`).
+
+{{< scss-docs name="root-focus-variables" file="scss/_root.scss" >}}
+
## Grid breakpoints
While we include our grid breakpoints as CSS variables (except for `xs`), be aware that **CSS variables do not work in media queries**. This is by design in the CSS spec for variables, but may change in coming years with support for `env()` variables. Check out [this Stack Overflow answer](https://stackoverflow.com/a/47212942) for some helpful links. In the meantime, you can use these variables in other CSS situations, as well as in your JavaScript.
diff --git a/site/content/docs/5.2/customize/optimize.md b/site/content/docs/5.3/customize/optimize.md
index e618ce2..2622f88 100644
--- a/site/content/docs/5.2/customize/optimize.md
+++ b/site/content/docs/5.3/customize/optimize.md
@@ -42,14 +42,11 @@ import 'bootstrap/js/dist/modal';
This way, you're not including any JavaScript you don't intend to use for components like buttons, carousels, and tooltips. If you're importing dropdowns, tooltips or popovers, be sure to list the Popper dependency in your `package.json` file.
{{< callout info >}}
-### Default Exports
-
-Files in `bootstrap/js/dist` use the **default export**, so if you want to use one of them you have to do the following:
+**Heads up!** Files in `bootstrap/js/dist` use the **default export**. To use them, do the following:
<!-- eslint-skip -->
```js
import Modal from 'bootstrap/js/dist/modal'
-
const modal = new Modal(document.getElementById('myModal'))
```
{{< /callout >}}
diff --git a/site/content/docs/5.2/customize/options.md b/site/content/docs/5.3/customize/options.md
index 5013fb9..b5c4fc3 100644
--- a/site/content/docs/5.2/customize/options.md
+++ b/site/content/docs/5.3/customize/options.md
@@ -13,6 +13,7 @@ You can find and customize these variables for key global options in Bootstrap's
| Variable | Values | Description |
| ------------------------------ | ---------------------------------- | -------------------------------------------------------------------------------------- |
| `$spacer` | `1rem` (default), or any value > 0 | Specifies the default spacer value to programmatically generate our [spacer utilities]({{< docsref "/utilities/spacing" >}}). |
+| `$enable-dark-mode` | `true` (default) or `false` | Enables built-in [dark mode support]({{< docsref "/customize/color-modes#dark-mode" >}}) across the project and its components. |
| `$enable-rounded` | `true` (default) or `false` | Enables predefined `border-radius` styles on various components. |
| `$enable-shadows` | `true` or `false` (default) | Enables predefined decorative `box-shadow` styles on various components. Does not affect `box-shadow`s used for focus states. |
| `$enable-gradients` | `true` or `false` (default) | Enables predefined gradients via `background-image` styles on various components. |
diff --git a/site/content/docs/5.2/customize/overview.md b/site/content/docs/5.3/customize/overview.md
index d0a853c..ed890ac 100644
--- a/site/content/docs/5.2/customize/overview.md
+++ b/site/content/docs/5.3/customize/overview.md
@@ -4,7 +4,7 @@ title: Customize
description: Learn how to theme, customize, and extend Bootstrap with Sass, a boatload of global options, an expansive color system, and more.
group: customize
toc: false
-aliases: "/docs/5.2/customize/"
+aliases: "/docs/5.3/customize/"
sections:
- title: Sass
description: Utilize our source Sass files to take advantage of variables, maps, mixins, and functions.
@@ -12,6 +12,8 @@ sections:
description: Customize Bootstrap with built-in variables to easily toggle global CSS preferences.
- title: Color
description: Learn about and customize the color systems that support the entire toolkit.
+ - title: Color modes
+ description: Explore our default light mode and the new dark mode, or create custom color modes yourself.
- title: Components
description: Learn how we build nearly all our components responsively and with base and modifier classes.
- title: CSS variables
diff --git a/site/content/docs/5.2/customize/sass.md b/site/content/docs/5.3/customize/sass.md
index 0fd90bc..6da6bbe 100644
--- a/site/content/docs/5.2/customize/sass.md
+++ b/site/content/docs/5.3/customize/sass.md
@@ -57,8 +57,9 @@ In your `custom.scss`, you'll import Bootstrap's source Sass files. You have two
// 2. Include any default variable overrides here
-// 3. Include remainder of required Bootstrap stylesheets
+// 3. Include remainder of required Bootstrap stylesheets (including any separate color mode stylesheets)
@import "../node_modules/bootstrap/scss/variables";
+@import "../node_modules/bootstrap/scss/variables-dark";
// 4. Include any default map overrides here
@@ -104,6 +105,7 @@ $body-color: #111;
// Required
@import "../node_modules/bootstrap/scss/variables";
+@import "../node_modules/bootstrap/scss/variables-dark";
@import "../node_modules/bootstrap/scss/maps";
@import "../node_modules/bootstrap/scss/mixins";
@import "../node_modules/bootstrap/scss/root";
@@ -117,7 +119,7 @@ $body-color: #111;
Repeat as necessary for any variable in Bootstrap, including the global options below.
{{< callout info >}}
-{{< partial "callout-info-npm-starter.md" >}}
+{{< partial "callouts/info-npm-starter.md" >}}
{{< /callout >}}
## Maps and loops
@@ -166,6 +168,7 @@ To remove colors from `$theme-colors`, or any other map, use `map-remove`. Be aw
// Required
@import "../node_modules/bootstrap/scss/functions";
@import "../node_modules/bootstrap/scss/variables";
+@import "../node_modules/bootstrap/scss/variables-dark";
$theme-colors: map-remove($theme-colors, "info", "light", "dark");
@@ -294,7 +297,7 @@ Our `scss/mixins/` directory has a ton of mixins that power parts of Bootstrap a
### Color schemes
-A shorthand mixin for the `prefers-color-scheme` media query is available with support for `light`, `dark`, and custom color schemes.
+A shorthand mixin for the `prefers-color-scheme` media query is available with support for `light`, `dark`, and custom color schemes. See [the color modes documentation]({{< docsref "/customize/color-modes" >}}) for information on our color mode mixin.
{{< scss-docs name="mixin-color-scheme" file="scss/mixins/_color-scheme.scss" >}}
diff --git a/site/content/docs/5.3/docsref.md b/site/content/docs/5.3/docsref.md
new file mode 100644
index 0000000..d0fc42f
--- /dev/null
+++ b/site/content/docs/5.3/docsref.md
@@ -0,0 +1,49 @@
+---
+layout: docs
+title: Docs reference
+description: Examples of Bootstrap's documentation-specific components and styles.
+aliases: "/docsref/"
+toc: true
+robots: noindex,follow
+sitemap_exclude: true
+---
+
+## Buttons
+
+<button class="btn btn-bd-primary">Primary button</button>
+<button class="btn btn-bd-accent">Accent button</button>
+<button class="btn btn-bd-light">Light button</button>
+
+## Callouts
+
+{{< callout >}}
+ Default callout
+{{< /callout >}}
+
+{{< callout warning >}}
+ Warning callout
+{{< /callout >}}
+
+{{< callout danger >}}
+ Danger callout
+{{< /callout >}}
+
+## Code example
+
+```scss
+.test {
+ --color: blue;
+}
+```
+
+<div class="bd-example">
+ The <abbr title="HyperText Markup Language">HTML</abbr> abbreviation element.
+</div>
+
+{{< example >}}
+<div class="test">This is a test.</div>
+{{< /example >}}
+
+{{< scss-docs name="variable-gradient" file="scss/_variables.scss" >}}
+
+{{< js-docs name="live-toast" file="site/assets/js/snippets.js" >}}
diff --git a/site/content/docs/5.3/examples/_index.md b/site/content/docs/5.3/examples/_index.md
new file mode 100644
index 0000000..c3c2423
--- /dev/null
+++ b/site/content/docs/5.3/examples/_index.md
@@ -0,0 +1,66 @@
+---
+layout: single
+title: Examples
+description: Quickly get a project started with any of our examples ranging from using parts of the framework to custom components and layouts.
+aliases: "/examples/"
+---
+
+{{< list-examples.inline >}}
+{{ range $entry := $.Site.Data.examples -}}
+<div class="bd-content">
+ <h2 id="{{ $entry.category | urlize }}">{{ $entry.category }}</h2>
+ <p>{{ $entry.description }}</p>
+ {{ if eq $entry.category "RTL" -}}
+ <div class="bd-callout bd-callout-warning small">
+ <p>
+ <strong>RTL is still experimental</strong> and will evolve with feedback. Spotted something or have an improvement to suggest?
+ </p>
+ <p><a href="{{ $.Site.Params.repo }}/issues/new/choose">Please open an issue.</a></p>
+ </div>
+ {{ end -}}
+ {{ range $i, $example := $entry.examples -}}
+ {{- $len := len $entry.examples -}}
+ {{ if (eq $i 0) }}<div class="row">{{ end }}
+ {{ if $entry.external }}
+ <div class="col-md-6 col-lg-4 mb-3 d-flex gap-3">
+ <svg class="bi fs-5 flex-shrink-0 mt-1"><use xlink:href="#box-seam"></use></svg>
+ <div>
+ <h3 class="h5 mb-1">
+ <a class="d-block link-offset-1" href="{{ $.Site.Params.github_org }}{{ $example.url }}/" target="_blank" rel="noopener">
+ {{ $example.name }}
+ </a>
+ </h3>
+ <p class="text-body-secondary">{{ $example.description }}</p>
+ <p>
+ {{- $indexPath := "index.html" -}}
+ {{- if $example.indexPath -}}
+ {{- $indexPath = $example.indexPath -}}
+ {{- end }}
+ <a class="icon-link small link-secondary link-offset-1" href="https://stackblitz.com/github/twbs{{ $example.url }}?file={{ $indexPath | urlquery }}" target="_blank" rel="noopener">
+ <svg class="bi flex-shrink-0"><use xlink:href="#lightning-charge-fill"></use></svg>
+ Edit in StackBlitz
+ </a>
+ </p>
+ </div>
+ </div>
+ {{ else }}
+ <div class="col-sm-6 col-md-3 mb-3">
+ <a class="d-block link-offset-1" href="/docs/{{ $.Site.Params.docs_version }}/examples/{{ $example.name | urlize }}/"{{ if in $example.name "RTL" }} hreflang="ar"{{ end }}>
+ <img class="img-thumbnail mb-3" srcset="/docs/{{ $.Site.Params.docs_version }}/assets/img/examples/{{ $example.name | urlize }}.png,
+ /docs/{{ $.Site.Params.docs_version }}/assets/img/examples/{{ $example.name | urlize }}@2x.png 2x"
+ src="/docs/{{ $.Site.Params.docs_version }}/assets/img/examples/{{ $example.name | urlize }}.png"
+ alt=""
+ width="480" height="300"
+ loading="lazy">
+ <h3 class="h5 mb-1">
+ {{ $example.name }}
+ </h3>
+ </a>
+ <p class="text-body-secondary">{{ $example.description }}</p>
+ </div>
+ {{ end }}
+ {{ if (eq (add $i 1) $len) }}</div>{{ end }}
+ {{ end -}}
+</div>
+{{ end -}}
+{{< /list-examples.inline >}}
diff --git a/site/content/docs/5.2/examples/album-rtl/index.html b/site/content/docs/5.3/examples/album-rtl/index.html
index 3408056..bae4737 100644
--- a/site/content/docs/5.2/examples/album-rtl/index.html
+++ b/site/content/docs/5.3/examples/album-rtl/index.html
@@ -4,16 +4,16 @@ title: مثال الألبوم
direction: rtl
---
-<header>
- <div class="collapse bg-dark" id="navbarHeader">
+<header data-bs-theme="dark">
+ <div class="collapse text-bg-dark" id="navbarHeader">
<div class="container">
<div class="row">
<div class="col-sm-8 col-md-7 py-4">
- <h4 class="text-white">حول</h4>
- <p class="text-muted">أضف بعض المعلومات حول الألبوم، المؤلف، أو أي سياق خلفية آخر. اجعلها بضع جمل حتى يتمكن الزوار من التقاط بعض التلميحات المفيدة. ثم اربطها ببعض مواقع التواصل الاجتماعي أو معلومات الاتصال.</p>
+ <h4>حول</h4>
+ <p class="text-body-secondary">أضف بعض المعلومات حول الألبوم، المؤلف، أو أي سياق خلفية آخر. اجعلها بضع جمل حتى يتمكن الزوار من التقاط بعض التلميحات المفيدة. ثم اربطها ببعض مواقع التواصل الاجتماعي أو معلومات الاتصال.</p>
</div>
<div class="col-sm-4 offset-md-1 py-4">
- <h4 class="text-white">تواصل معي</h4>
+ <h4>تواصل معي</h4>
<ul class="list-unstyled">
<li><a href="#" class="text-white">تابعني على تويتر</a></li>
<li><a href="#" class="text-white">شاركني الإعجاب في فيسبوك</a></li>
@@ -42,7 +42,7 @@ direction: rtl
<div class="row py-lg-5">
<div class="col-lg-6 col-md-8 mx-auto">
<h1 class="fw-light">مثال الألبوم</h1>
- <p class="lead text-muted">وصف قصير حول الألبوم أدناه (محتوياته ، ومنشؤه ، وما إلى ذلك). اجعله قصير ولطيف، ولكن ليست قصير جدًا حتى لا يتخطى الناس هذا الألبوم تمامًا.</p>
+ <p class="lead text-body-secondary">وصف قصير حول الألبوم أدناه (محتوياته ، ومنشؤه ، وما إلى ذلك). اجعله قصير ولطيف، ولكن ليست قصير جدًا حتى لا يتخطى الناس هذا الألبوم تمامًا.</p>
<p>
<a href="#" class="btn btn-primary my-2">الدعوة الرئيسية للعمل</a>
<a href="#" class="btn btn-secondary my-2">عمل ثانوي</a>
@@ -51,7 +51,7 @@ direction: rtl
</div>
</section>
- <div class="album py-5 bg-light">
+ <div class="album py-5 bg-body-tertiary">
<div class="container">
<div class="row row-cols-1 row-cols-sm-2 row-cols-md-3 g-3">
@@ -65,7 +65,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -80,7 +80,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -95,7 +95,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -111,7 +111,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -126,7 +126,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -141,7 +141,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -157,7 +157,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -172,7 +172,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -187,7 +187,7 @@ direction: rtl
<button type="button" class="btn btn-sm btn-outline-secondary">عرض</button>
<button type="button" class="btn btn-sm btn-outline-secondary">تعديل</button>
</div>
- <small class="text-muted">9 دقائق</small>
+ <small class="text-body-secondary">9 دقائق</small>
</div>
</div>
</div>
@@ -198,7 +198,7 @@ direction: rtl
</main>
-<footer class="text-muted py-5">
+<footer class="text-body-secondary py-5">
<div class="container">
<p class="float-end mb-1">
<a href="#">عد إلى الأعلى</a>
diff --git a/site/content/docs/5.2/examples/album/index.html b/site/content/docs/5.3/examples/album/index.html
index 2d25d72..54b2c5b 100644
--- a/site/content/docs/5.2/examples/album/index.html
+++ b/site/content/docs/5.3/examples/album/index.html
@@ -3,16 +3,16 @@ layout: examples
title: Album example
---
-<header>
- <div class="collapse bg-dark" id="navbarHeader">
+<header data-bs-theme="dark">
+ <div class="collapse text-bg-dark" id="navbarHeader">
<div class="container">
<div class="row">
<div class="col-sm-8 col-md-7 py-4">
- <h4 class="text-white">About</h4>
- <p class="text-muted">Add some information about the album below, the author, or any other background context. Make it a few sentences long so folks can pick up some informative tidbits. Then, link them off to some social networking sites or contact information.</p>
+ <h4>About</h4>
+ <p class="text-body-secondary">Add some information about the album below, the author, or any other background context. Make it a few sentences long so folks can pick up some informative tidbits. Then, link them off to some social networking sites or contact information.</p>
</div>
<div class="col-sm-4 offset-md-1 py-4">
- <h4 class="text-white">Contact</h4>
+ <h4>Contact</h4>
<ul class="list-unstyled">
<li><a href="#" class="text-white">Follow on Twitter</a></li>
<li><a href="#" class="text-white">Like on Facebook</a></li>
@@ -41,7 +41,7 @@ title: Album example
<div class="row py-lg-5">
<div class="col-lg-6 col-md-8 mx-auto">
<h1 class="fw-light">Album example</h1>
- <p class="lead text-muted">Something short and leading about the collection below—its contents, the creator, etc. Make it short and sweet, but not too short so folks don’t simply skip over it entirely.</p>
+ <p class="lead text-body-secondary">Something short and leading about the collection below—its contents, the creator, etc. Make it short and sweet, but not too short so folks don’t simply skip over it entirely.</p>
<p>
<a href="#" class="btn btn-primary my-2">Main call to action</a>
<a href="#" class="btn btn-secondary my-2">Secondary action</a>
@@ -50,7 +50,7 @@ title: Album example
</div>
</section>
- <div class="album py-5 bg-light">
+ <div class="album py-5 bg-body-tertiary">
<div class="container">
<div class="row row-cols-1 row-cols-sm-2 row-cols-md-3 g-3">
@@ -64,7 +64,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -79,7 +79,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -94,7 +94,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -110,7 +110,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -125,7 +125,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -140,7 +140,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -156,7 +156,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -171,7 +171,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -186,7 +186,7 @@ title: Album example
<button type="button" class="btn btn-sm btn-outline-secondary">View</button>
<button type="button" class="btn btn-sm btn-outline-secondary">Edit</button>
</div>
- <small class="text-muted">9 mins</small>
+ <small class="text-body-secondary">9 mins</small>
</div>
</div>
</div>
@@ -197,7 +197,7 @@ title: Album example
</main>
-<footer class="text-muted py-5">
+<footer class="text-body-secondary py-5">
<div class="container">
<p class="float-end mb-1">
<a href="#">Back to top</a>
diff --git a/site/content/docs/5.3/examples/badges/badges.css b/site/content/docs/5.3/examples/badges/badges.css
new file mode 100644
index 0000000..b6ce0f5
--- /dev/null
+++ b/site/content/docs/5.3/examples/badges/badges.css
@@ -0,0 +1,3 @@
+.badge > a {
+ color: inherit;
+}
diff --git a/site/content/docs/5.3/examples/badges/index.html b/site/content/docs/5.3/examples/badges/index.html
new file mode 100644
index 0000000..a452d36
--- /dev/null
+++ b/site/content/docs/5.3/examples/badges/index.html
@@ -0,0 +1,149 @@
+---
+layout: examples
+title: Badges
+extra_css:
+ - "badges.css"
+body_class: ""
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="x-circle-fill" viewBox="0 0 16 16">
+ <path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0zM5.354 4.646a.5.5 0 1 0-.708.708L7.293 8l-2.647 2.646a.5.5 0 0 0 .708.708L8 8.707l2.646 2.647a.5.5 0 0 0 .708-.708L8.707 8l2.647-2.646a.5.5 0 0 0-.708-.708L8 7.293 5.354 4.646z"/>
+ </symbol>
+</svg>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <span class="badge text-bg-primary rounded-pill">Primary</span>
+ <span class="badge text-bg-secondary rounded-pill">Secondary</span>
+ <span class="badge text-bg-success rounded-pill">Success</span>
+ <span class="badge text-bg-danger rounded-pill">Danger</span>
+ <span class="badge text-bg-warning rounded-pill">Warning</span>
+ <span class="badge text-bg-info rounded-pill">Info</span>
+ <span class="badge text-bg-light rounded-pill">Light</span>
+ <span class="badge text-bg-dark rounded-pill">Dark</span>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <span class="badge bg-primary-subtle text-primary-emphasis rounded-pill">Primary</span>
+ <span class="badge bg-secondary-subtle text-secondary-emphasis rounded-pill">Secondary</span>
+ <span class="badge bg-success-subtle text-success-emphasis rounded-pill">Success</span>
+ <span class="badge bg-danger-subtle text-danger-emphasis rounded-pill">Danger</span>
+ <span class="badge bg-warning-subtle text-warning-emphasis rounded-pill">Warning</span>
+ <span class="badge bg-info-subtle text-info-emphasis rounded-pill">Info</span>
+ <span class="badge bg-light-subtle text-light-emphasis rounded-pill">Light</span>
+ <span class="badge bg-dark-subtle text-dark-emphasis rounded-pill">Dark</span>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <span class="badge bg-primary-subtle border border-primary-subtle text-primary-emphasis rounded-pill">Primary</span>
+ <span class="badge bg-secondary-subtle border border-secondary-subtle text-secondary-emphasis rounded-pill">Secondary</span>
+ <span class="badge bg-success-subtle border border-success-subtle text-success-emphasis rounded-pill">Success</span>
+ <span class="badge bg-danger-subtle border border-danger-subtle text-danger-emphasis rounded-pill">Danger</span>
+ <span class="badge bg-warning-subtle border border-warning-subtle text-warning-emphasis rounded-pill">Warning</span>
+ <span class="badge bg-info-subtle border border-info-subtle text-info-emphasis rounded-pill">Info</span>
+ <span class="badge bg-light-subtle border border-light-subtle text-light-emphasis rounded-pill">Light</span>
+ <span class="badge bg-dark-subtle border border-dark-subtle text-dark-emphasis rounded-pill">Dark</span>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <span class="badge d-flex align-items-center p-1 pe-2 text-primary-emphasis bg-primary-subtle border border-primary-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Primary
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-secondary-emphasis bg-secondary-subtle border border-secondary-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Secondary
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-success-emphasis bg-success-subtle border border-success-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Success
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-danger-emphasis bg-danger-subtle border border-danger-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Danger
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-warning-emphasis bg-warning-subtle border border-warning-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Warning
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-info-emphasis bg-info-subtle border border-info-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Info
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-dark-emphasis bg-light-subtle border border-dark-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Light
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-dark-emphasis bg-dark-subtle border border-dark-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">Dark
+ </span>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <span class="badge d-flex p-2 align-items-center text-bg-primary rounded-pill">
+ <span class="px-1">Primary</span>
+ <a href="#"><svg class="bi ms-1" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex p-2 align-items-center text-primary-emphasis bg-primary-subtle rounded-pill">
+ <span class="px-1">Primary</span>
+ <a href="#"><svg class="bi ms-1" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex p-2 align-items-center text-primary-emphasis bg-primary-subtle border border-primary-subtle rounded-pill">
+ <span class="px-1">Primary</span>
+ <a href="#"><svg class="bi ms-1" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <span class="badge d-flex align-items-center p-1 pe-2 text-primary-emphasis bg-primary-subtle border border-primary-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Primary
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-secondary-emphasis bg-secondary-subtle border border-secondary-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Secondary
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-success-emphasis bg-success-subtle border border-success-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Success
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-danger-emphasis bg-danger-subtle border border-danger-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Danger
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-warning-emphasis bg-warning-subtle border border-warning-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Warning
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-info-emphasis bg-info-subtle border border-info-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Info
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-light-emphasis bg-light-subtle border border-dark-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Light
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+ <span class="badge d-flex align-items-center p-1 pe-2 text-dark-emphasis bg-dark-subtle border border-dark-subtle rounded-pill">
+ <img class="rounded-circle me-1" width="24" height="24" src="https://github.com/mdo.png" alt="">
+ Dark
+ <span class="vr mx-2"></span>
+ <a href="#"><svg class="bi" width="16" height="16"><use xlink:href="#x-circle-fill"/></svg></a>
+ </span>
+</div>
diff --git a/site/content/docs/5.2/examples/blog-rtl/index.html b/site/content/docs/5.3/examples/blog-rtl/index.html
index 05af925..274ea0e 100644
--- a/site/content/docs/5.2/examples/blog-rtl/index.html
+++ b/site/content/docs/5.3/examples/blog-rtl/index.html
@@ -5,17 +5,29 @@ direction: rtl
extra_css:
- "https://fonts.googleapis.com/css?family=Amiri:wght@400;700&display=swap"
- "../blog/blog.rtl.css"
-include_js: false
---
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="aperture" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24">
+ <circle cx="12" cy="12" r="10"/>
+ <path d="M14.31 8l5.74 9.94M9.69 8h11.48M7.38 12l5.74-9.94M9.69 16L3.95 6.06M14.31 16H2.83m13.79-4l-5.74 9.94"/>
+ </symbol>
+ <symbol id="cart" viewBox="0 0 16 16">
+ <path d="M0 1.5A.5.5 0 0 1 .5 1H2a.5.5 0 0 1 .485.379L2.89 3H14.5a.5.5 0 0 1 .49.598l-1 5a.5.5 0 0 1-.465.401l-9.397.472L4.415 11H13a.5.5 0 0 1 0 1H4a.5.5 0 0 1-.491-.408L2.01 3.607 1.61 2H.5a.5.5 0 0 1-.5-.5zM3.102 4l.84 4.479 9.144-.459L13.89 4H3.102zM5 12a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm7 0a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm-7 1a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm7 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
+ </symbol>
+ <symbol id="chevron-right" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z"/>
+ </symbol>
+</svg>
+
<div class="container">
- <header class="blog-header lh-1 py-3">
+ <header class="border-bottom lh-1 py-3">
<div class="row flex-nowrap justify-content-between align-items-center">
<div class="col-4 pt-1">
<a class="link-secondary" href="#">الإشتراك في النشرة البريدية</a>
</div>
<div class="col-4 text-center">
- <a class="blog-header-logo text-dark" href="#">كبير</a>
+ <a class="blog-header-logo text-body-emphasis text-decoration-none" href="#">كبير</a>
</div>
<div class="col-4 d-flex justify-content-end align-items-center">
<a class="link-secondary" href="#" aria-label="بحث">
@@ -26,30 +38,30 @@ include_js: false
</div>
</header>
- <div class="nav-scroller py-1 mb-2">
- <nav class="nav d-flex justify-content-between">
- <a class="p-2 link-secondary" href="#">العالم</a>
- <a class="p-2 link-secondary" href="#">الولايات المتحدة</a>
- <a class="p-2 link-secondary" href="#">التقنية</a>
- <a class="p-2 link-secondary" href="#">التصميم</a>
- <a class="p-2 link-secondary" href="#">الحضارة</a>
- <a class="p-2 link-secondary" href="#">المال والأعمال</a>
- <a class="p-2 link-secondary" href="#">السياسة</a>
- <a class="p-2 link-secondary" href="#">الرأي العام</a>
- <a class="p-2 link-secondary" href="#">العلوم</a>
- <a class="p-2 link-secondary" href="#">الصحة</a>
- <a class="p-2 link-secondary" href="#">الموضة</a>
- <a class="p-2 link-secondary" href="#">السفر</a>
+ <div class="nav-scroller py-1 mb-3 border-bottom">
+ <nav class="nav nav-underline justify-content-between">
+ <a class="nav-item nav-link link-body-emphasis active" href="#">العالم</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">الولايات المتحدة</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">التقنية</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">التصميم</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">الحضارة</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">المال والأعمال</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">السياسة</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">الرأي العام</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">العلوم</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">الصحة</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">الموضة</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">السفر</a>
</nav>
</div>
</div>
<main class="container">
- <div class="p-4 p-md-5 mb-4 rounded text-bg-dark">
- <div class="col-md-6 px-0">
+ <div class="p-4 p-md-5 mb-4 rounded text-body-emphasis bg-body-secondary">
+ <div class="col-lg-6 px-0">
<h1 class="display-4 fst-italic">عنوان تدوينة مميزة أطول</h1>
<p class="lead my-3">عدة أسطر نصية متعددة تعبر عن التدوية، وذلك لإعلام القراء الجدد بسرعة وكفاءة حول أكثر الأشياء إثارة للاهتمام في محتويات هذه التدوينة.</p>
- <p class="lead mb-0"><a href="#" class="text-white fw-bold">أكمل القراءة...</a></p>
+ <p class="lead mb-0"><a href="#" class="text-body-emphasis fw-bold">أكمل القراءة...</a></p>
</div>
</div>
@@ -57,11 +69,14 @@ include_js: false
<div class="col-md-6">
<div class="row g-0 border rounded overflow-hidden flex-md-row mb-4 shadow-sm h-md-250 position-relative">
<div class="col p-4 d-flex flex-column position-static">
- <strong class="d-inline-block mb-2 text-primary">العالم</strong>
+ <strong class="d-inline-block mb-2 text-primary-emphasis">العالم</strong>
<h3 class="mb-0">مشاركة مميزة</h3>
- <div class="mb-1 text-muted">نوفمبر 12</div>
+ <div class="mb-1 text-body-secondary">نوفمبر 12</div>
<p class="card-text mb-auto">هذه بطاقة أوسع مع نص داعم أدناه كمقدمة طبيعية لمحتوى إضافي.</p>
- <a href="#" class="stretched-link">أكمل القراءة</a>
+ <a href="#" class="icon-link gap-1 icon-link-hover stretched-link">
+ أكمل القراءة
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
+ </a>
</div>
<div class="col-auto d-none d-lg-block">
{{< placeholder width="200" height="250" background="#55595c" color="#eceeef" text="صورة مصغرة" >}}
@@ -71,11 +86,14 @@ include_js: false
<div class="col-md-6">
<div class="row g-0 border rounded overflow-hidden flex-md-row mb-4 shadow-sm h-md-250 position-relative">
<div class="col p-4 d-flex flex-column position-static">
- <strong class="d-inline-block mb-2 text-success">التصميم</strong>
+ <strong class="d-inline-block mb-2 text-success-emphasis">التصميم</strong>
<h3 class="mb-0">عنوان الوظيفة</h3>
- <div class="mb-1 text-muted">نوفمبر 11</div>
+ <div class="mb-1 text-body-secondary">نوفمبر 11</div>
<p class="mb-auto">هذه بطاقة أوسع مع نص داعم أدناه كمقدمة طبيعية لمحتوى إضافي.</p>
- <a href="#" class="stretched-link">أكمل القراءة</a>
+ <a href="#" class="icon-link gap-1 icon-link-hover stretched-link">
+ أكمل القراءة
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
+ </a>
</div>
<div class="col-auto d-none d-lg-block">
{{< placeholder width="200" height="250" background="#55595c" color="#eceeef" text="صورة مصغرة" >}}
@@ -84,20 +102,20 @@ include_js: false
</div>
</div>
- <div class="row">
+ <div class="row g-5">
<div class="col-md-8">
<h3 class="pb-4 mb-4 fst-italic border-bottom">
من Firehose
</h3>
<article class="blog-post">
- <h2 class="blog-post-title mb-1">مثال على تدوينة</h2>
+ <h2 class="display-5 link-body-emphasis mb-1">مثال على تدوينة</h2>
<p class="blog-post-meta">1 يناير 2021 بواسطة <a href="#"> Mark </a></p>
<p>تعرض مشاركة المدونة هذه بضعة أنواع مختلفة من المحتوى الذي يتم دعمه وتصميمه باستخدام Bootstrap. النصوص الأساسية، الصور، والأكواد مدعومة بشكل كامل.</p>
<hr>
<p>يشكِّل تأمين الغذاء في المستقبل قضية تؤرِّق حكومات العالَم والعلماء على حدٍّ سواء. فخلال القرن العشرين ازداد عدد سكان الأرض أربعة أضعاف، وتشير التقديرات إلى أن العدد سوف يصل إلى عشرة مليارات إنسان بحلول عام 2050م. وسوف تمثل هذه الزيادة الهائلة تحدياً كبيراً وضغطاً متصاعداً على قدرة الإنتاج الزراعي. الأمر الذي كان ولا بد من أن يدفع إلى تطوير تقنيات مبتكرة في تصنيع الغذاء غير الزراعة، منها تقنية مستقبلية تقوم على تصنيع الغذاء من الهواء.</p>
- <blockquote>
+ <blockquote class="blockquote">
<p>تشغل الزراعة مساحات كبيرة من اليابسة، وتستهلك كميات هائلة من المياه، كما أن إنتاج الغذاء بواسطة الزراعة يسهم بنسبة عالية من انبعاثات غازات الاحتباس الحراري العالمية</p>
</blockquote>
<p>تشغل الزراعة مساحات كبيرة من اليابسة، وتستهلك كميات هائلة من المياه. كما أن إنتاج الغذاء بواسطة الزراعة يسهم بنسبة عالية من انبعاثات غازات الاحتباس الحراري العالمية، وللمقارنة فإن هذه النسبة من الانبعاثات هي أكبر مما ينتجه قطاع النقل بكل ما فيه من سيارات وشاحنات وطائرات وقطارات.</p>
@@ -126,7 +144,7 @@ include_js: false
</article>
<article class="blog-post">
- <h2 class="blog-post-title mb-1">تدوينة أخرى</h2>
+ <h2 class="display-5 link-body-emphasis mb-1">تدوينة أخرى</h2>
<p class="blog-post-meta">23 ديسمبر 2020 بواسطة <a href="#">Jacob</a></p>
<p>في الوقت الحالي، تدرس عدَّة شركات هذه الميكروبات بشكل أعمق، وتستزرعها من أجل الحصول على الغذاء. ففي عام 2019م، أعلن باحثون في شركة (Air Protein) الأمريكية نجاحهم في تحويل ثاني أكسيد الكربون الموجود في الهواء إلى لحوم صناعية مصنوعة من البروتين، التي لا تتطلَّب أي أرض زراعية، بل هي معتمدة بشكل أساسي على الهواء.</p>
@@ -138,7 +156,7 @@ include_js: false
</article>
<article class="blog-post">
- <h2 class="blog-post-title mb-1">ميزة جديدة</h2>
+ <h2 class="display-5 link-body-emphasis mb-1">ميزة جديدة</h2>
<p class="blog-post-meta">14 ديسمبر 2020 بواسطة <a href="#">Jacob</a></p>
<p>كما أن الشركة الفنلندية (Solar Foods) طوَّرت تقنية لإنتاج البروتين من الهواء، حيث تبدأ العملية بتقسيم الماء إلى مكوناته الهيدروجين والأكسجين عن طريق الكهرباء. فالهيدروجين يوفِّر الطاقة للبكتريا لتحويل ثاني أكسيد الكربون والنيتروجين الموجودين في الهواء إلى مادة عضوية غنية بالبروتين بشكل أكفأ من نمو النباتات باستخدام البناء الضوئي. وهذا البروتين يشبه دقيق القمح وقد أطلق عليه اسم "سولين" (Solein).</p>
@@ -161,11 +179,44 @@ include_js: false
<div class="col-md-4">
<div class="position-sticky" style="top: 2rem;">
- <div class="p-4 mb-3 bg-light rounded">
+ <div class="p-4 mb-3 bg-body-tertiary rounded">
<h4 class="fst-italic">حول</h4>
<p class="mb-0">أقبلت، فأقبلت معك الحياة بجميع صنوفها وألوانها: فالنبات ينبت، والأشجار تورق وتزهر، والهرة تموء، والقمري يسجع، والغنم يثغو، والبقر يخور، وكل أليف يدعو أليفه. كل شيء يشعر بالحياة وينسي هموم الحياة، ولا يذكر إلا سعادة الحياة، فإن كان الزمان جسدا فأنت روحه، وإن كان عمرا فأنت شبابه.</p>
</div>
+ <div>
+ <h4 class="fst-italic">المشاركات الاخيرة</h4>
+ <ul class="list-unstyled">
+ <li>
+ <a class="d-flex flex-column flex-lg-row gap-3 align-items-start align-items-lg-center py-3 link-body-emphasis text-decoration-none border-top" href="#">
+ {{< placeholder width="100%" height="96" background="#777" color="#777" text="false" title="false" >}}
+ <div class="col-lg-8">
+ <h6 class="mb-0">مثال على عنوان منشور المدونة</h6>
+ <small class="text-body-secondary">15 يناير 2023</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a class="d-flex flex-column flex-lg-row gap-3 align-items-start align-items-lg-center py-3 link-body-emphasis text-decoration-none border-top" href="#">
+ {{< placeholder width="100%" height="96" background="#777" color="#777" text="false" title="false" >}}
+ <div class="col-lg-8">
+ <h6 class="mb-0">هذا عنوان آخر للمدونة</h6>
+ <small class="text-body-secondary">14 يناير 2023</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a class="d-flex flex-column flex-lg-row gap-3 align-items-start align-items-lg-center py-3 link-body-emphasis text-decoration-none border-top" href="#">
+ {{< placeholder width="100%" height="96" background="#777" color="#777" text="false" title="false" >}}
+ <div class="col-lg-8">
+ <h6 class="mb-0">أطول عنوان منشور للمدونة: يحتوي هذا الخط على عدة أسطر!</h6>
+ <small class="text-body-secondary">13 يناير 2023</small>
+ </div>
+ </a>
+ </li>
+ </ul>
+ </div>
+
<div class="p-4">
<h4 class="fst-italic">الأرشيف</h4>
<ol class="list-unstyled mb-0">
@@ -198,9 +249,9 @@ include_js: false
</main>
-<footer class="blog-footer">
+<footer class="py-5 text-center text-body-secondary bg-body-tertiary">
<p>تم تصميم نموذج المدونة لـ <a href="https://getbootstrap.com/">Bootstrap</a> بواسطة <a href="https://twitter.com/mdo"><bdi lang="en" dir="ltr">@mdo</bdi></a>.</p>
- <p>
+ <p class="mb-0">
<a href="#">عد إلى الأعلى</a>
</p>
</footer>
diff --git a/site/content/docs/5.2/examples/blog/blog.css b/site/content/docs/5.3/examples/blog/blog.css
index cc5fc74..ddbca5a 100644
--- a/site/content/docs/5.2/examples/blog/blog.css
+++ b/site/content/docs/5.3/examples/blog/blog.css
@@ -1,8 +1,4 @@
-/* stylelint-disable selector-list-comma-newline-after */
-
-.blog-header {
- border-bottom: 1px solid #e5e5e5;
-}
+/* stylelint-disable stylistic/selector-list-comma-newline-after */
.blog-header-logo {
font-family: "Playfair Display", Georgia, "Times New Roman", serif/*rtl:Amiri, Georgia, "Times New Roman", serif*/;
@@ -17,15 +13,6 @@ h1, h2, h3, h4, h5, h6 {
font-family: "Playfair Display", Georgia, "Times New Roman", serif/*rtl:Amiri, Georgia, "Times New Roman", serif*/;
}
-.display-4 {
- font-size: 2.5rem;
-}
-@media (min-width: 768px) {
- .display-4 {
- font-size: 3rem;
- }
-}
-
.flex-auto {
flex: 0 0 auto;
}
@@ -46,24 +33,7 @@ h1, h2, h3, h4, h5, h6 {
.blog-post {
margin-bottom: 4rem;
}
-.blog-post-title {
- font-size: 2.5rem;
-}
.blog-post-meta {
margin-bottom: 1.25rem;
color: #727272;
}
-
-/*
- * Footer
- */
-.blog-footer {
- padding: 2.5rem 0;
- color: #727272;
- text-align: center;
- background-color: #f9f9f9;
- border-top: .05rem solid #e5e5e5;
-}
-.blog-footer p:last-child {
- margin-bottom: 0;
-}
diff --git a/site/content/docs/5.2/examples/blog/blog.rtl.css b/site/content/docs/5.3/examples/blog/blog.rtl.css
index fc03c35..043d4e6 100644
--- a/site/content/docs/5.2/examples/blog/blog.rtl.css
+++ b/site/content/docs/5.3/examples/blog/blog.rtl.css
@@ -1,8 +1,4 @@
-/* stylelint-disable selector-list-comma-newline-after */
-
-.blog-header {
- border-bottom: 1px solid #e5e5e5;
-}
+/* stylelint-disable stylistic/selector-list-comma-newline-after */
.blog-header-logo {
font-family: Amiri, Georgia, "Times New Roman", serif;
@@ -17,15 +13,6 @@ h1, h2, h3, h4, h5, h6 {
font-family: Amiri, Georgia, "Times New Roman", serif;
}
-.display-4 {
- font-size: 2.5rem;
-}
-@media (min-width: 768px) {
- .display-4 {
- font-size: 3rem;
- }
-}
-
.flex-auto {
flex: 0 0 auto;
}
@@ -46,24 +33,7 @@ h1, h2, h3, h4, h5, h6 {
.blog-post {
margin-bottom: 4rem;
}
-.blog-post-title {
- font-size: 2.5rem;
-}
.blog-post-meta {
margin-bottom: 1.25rem;
color: #727272;
}
-
-/*
- * Footer
- */
-.blog-footer {
- padding: 2.5rem 0;
- color: #727272;
- text-align: center;
- background-color: #f9f9f9;
- border-top: .05rem solid #e5e5e5;
-}
-.blog-footer p:last-child {
- margin-bottom: 0;
-}
diff --git a/site/content/docs/5.2/examples/blog/index.html b/site/content/docs/5.3/examples/blog/index.html
index 6b60ea0..d0d6f08 100644
--- a/site/content/docs/5.2/examples/blog/index.html
+++ b/site/content/docs/5.3/examples/blog/index.html
@@ -4,17 +4,29 @@ title: Blog Template
extra_css:
- "https://fonts.googleapis.com/css?family=Playfair+Display:700,900&display=swap"
- "blog.css"
-include_js: false
---
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="aperture" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24">
+ <circle cx="12" cy="12" r="10"/>
+ <path d="M14.31 8l5.74 9.94M9.69 8h11.48M7.38 12l5.74-9.94M9.69 16L3.95 6.06M14.31 16H2.83m13.79-4l-5.74 9.94"/>
+ </symbol>
+ <symbol id="cart" viewBox="0 0 16 16">
+ <path d="M0 1.5A.5.5 0 0 1 .5 1H2a.5.5 0 0 1 .485.379L2.89 3H14.5a.5.5 0 0 1 .49.598l-1 5a.5.5 0 0 1-.465.401l-9.397.472L4.415 11H13a.5.5 0 0 1 0 1H4a.5.5 0 0 1-.491-.408L2.01 3.607 1.61 2H.5a.5.5 0 0 1-.5-.5zM3.102 4l.84 4.479 9.144-.459L13.89 4H3.102zM5 12a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm7 0a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm-7 1a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm7 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
+ </symbol>
+ <symbol id="chevron-right" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z"/>
+ </symbol>
+</svg>
+
<div class="container">
- <header class="blog-header lh-1 py-3">
+ <header class="border-bottom lh-1 py-3">
<div class="row flex-nowrap justify-content-between align-items-center">
<div class="col-4 pt-1">
<a class="link-secondary" href="#">Subscribe</a>
</div>
<div class="col-4 text-center">
- <a class="blog-header-logo text-dark" href="#">Large</a>
+ <a class="blog-header-logo text-body-emphasis text-decoration-none" href="#">Large</a>
</div>
<div class="col-4 d-flex justify-content-end align-items-center">
<a class="link-secondary" href="#" aria-label="Search">
@@ -25,30 +37,30 @@ include_js: false
</div>
</header>
- <div class="nav-scroller py-1 mb-2">
- <nav class="nav d-flex justify-content-between">
- <a class="p-2 link-secondary" href="#">World</a>
- <a class="p-2 link-secondary" href="#">U.S.</a>
- <a class="p-2 link-secondary" href="#">Technology</a>
- <a class="p-2 link-secondary" href="#">Design</a>
- <a class="p-2 link-secondary" href="#">Culture</a>
- <a class="p-2 link-secondary" href="#">Business</a>
- <a class="p-2 link-secondary" href="#">Politics</a>
- <a class="p-2 link-secondary" href="#">Opinion</a>
- <a class="p-2 link-secondary" href="#">Science</a>
- <a class="p-2 link-secondary" href="#">Health</a>
- <a class="p-2 link-secondary" href="#">Style</a>
- <a class="p-2 link-secondary" href="#">Travel</a>
+ <div class="nav-scroller py-1 mb-3 border-bottom">
+ <nav class="nav nav-underline justify-content-between">
+ <a class="nav-item nav-link link-body-emphasis active" href="#">World</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">U.S.</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Technology</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Design</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Culture</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Business</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Politics</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Opinion</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Science</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Health</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Style</a>
+ <a class="nav-item nav-link link-body-emphasis" href="#">Travel</a>
</nav>
</div>
</div>
<main class="container">
- <div class="p-4 p-md-5 mb-4 rounded text-bg-dark">
- <div class="col-md-6 px-0">
+ <div class="p-4 p-md-5 mb-4 rounded text-body-emphasis bg-body-secondary">
+ <div class="col-lg-6 px-0">
<h1 class="display-4 fst-italic">Title of a longer featured blog post</h1>
<p class="lead my-3">Multiple lines of text that form the lede, informing new readers quickly and efficiently about what’s most interesting in this post’s contents.</p>
- <p class="lead mb-0"><a href="#" class="text-white fw-bold">Continue reading...</a></p>
+ <p class="lead mb-0"><a href="#" class="text-body-emphasis fw-bold">Continue reading...</a></p>
</div>
</div>
@@ -56,11 +68,14 @@ include_js: false
<div class="col-md-6">
<div class="row g-0 border rounded overflow-hidden flex-md-row mb-4 shadow-sm h-md-250 position-relative">
<div class="col p-4 d-flex flex-column position-static">
- <strong class="d-inline-block mb-2 text-primary">World</strong>
+ <strong class="d-inline-block mb-2 text-primary-emphasis">World</strong>
<h3 class="mb-0">Featured post</h3>
- <div class="mb-1 text-muted">Nov 12</div>
+ <div class="mb-1 text-body-secondary">Nov 12</div>
<p class="card-text mb-auto">This is a wider card with supporting text below as a natural lead-in to additional content.</p>
- <a href="#" class="stretched-link">Continue reading</a>
+ <a href="#" class="icon-link gap-1 icon-link-hover stretched-link">
+ Continue reading
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
+ </a>
</div>
<div class="col-auto d-none d-lg-block">
{{< placeholder width="200" height="250" background="#55595c" color="#eceeef" text="Thumbnail" >}}
@@ -70,11 +85,14 @@ include_js: false
<div class="col-md-6">
<div class="row g-0 border rounded overflow-hidden flex-md-row mb-4 shadow-sm h-md-250 position-relative">
<div class="col p-4 d-flex flex-column position-static">
- <strong class="d-inline-block mb-2 text-success">Design</strong>
+ <strong class="d-inline-block mb-2 text-success-emphasis">Design</strong>
<h3 class="mb-0">Post title</h3>
- <div class="mb-1 text-muted">Nov 11</div>
+ <div class="mb-1 text-body-secondary">Nov 11</div>
<p class="mb-auto">This is a wider card with supporting text below as a natural lead-in to additional content.</p>
- <a href="#" class="stretched-link">Continue reading</a>
+ <a href="#" class="icon-link gap-1 icon-link-hover stretched-link">
+ Continue reading
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
+ </a>
</div>
<div class="col-auto d-none d-lg-block">
{{< placeholder width="200" height="250" background="#55595c" color="#eceeef" text="Thumbnail" >}}
@@ -90,7 +108,7 @@ include_js: false
</h3>
<article class="blog-post">
- <h2 class="blog-post-title mb-1">Sample blog post</h2>
+ <h2 class="display-5 link-body-emphasis mb-1">Sample blog post</h2>
<p class="blog-post-meta">January 1, 2021 by <a href="#">Mark</a></p>
<p>This blog post shows a few different types of content that’s supported and styled with Bootstrap. Basic typography, lists, tables, images, code, and more are all supported as expected.</p>
@@ -144,7 +162,7 @@ include_js: false
</article>
<article class="blog-post">
- <h2 class="blog-post-title mb-1">Another blog post</h2>
+ <h2 class="display-5 link-body-emphasis mb-1">Another blog post</h2>
<p class="blog-post-meta">December 23, 2020 by <a href="#">Jacob</a></p>
<p>This is some additional paragraph placeholder content. It has been written to fill the available space and show how a longer snippet of text affects the surrounding content. We'll repeat it often to keep the demonstration flowing, so be on the lookout for this exact same string of text.</p>
@@ -192,7 +210,7 @@ include_js: false
</article>
<article class="blog-post">
- <h2 class="blog-post-title mb-1">New feature</h2>
+ <h2 class="display-5 link-body-emphasis mb-1">New feature</h2>
<p class="blog-post-meta">December 14, 2020 by <a href="#">Chris</a></p>
<p>This is some additional paragraph placeholder content. It has been written to fill the available space and show how a longer snippet of text affects the surrounding content. We'll repeat it often to keep the demonstration flowing, so be on the lookout for this exact same string of text.</p>
@@ -213,11 +231,44 @@ include_js: false
<div class="col-md-4">
<div class="position-sticky" style="top: 2rem;">
- <div class="p-4 mb-3 bg-light rounded">
+ <div class="p-4 mb-3 bg-body-tertiary rounded">
<h4 class="fst-italic">About</h4>
<p class="mb-0">Customize this section to tell your visitors a little bit about your publication, writers, content, or something else entirely. Totally up to you.</p>
</div>
+ <div>
+ <h4 class="fst-italic">Recent posts</h4>
+ <ul class="list-unstyled">
+ <li>
+ <a class="d-flex flex-column flex-lg-row gap-3 align-items-start align-items-lg-center py-3 link-body-emphasis text-decoration-none border-top" href="#">
+ {{< placeholder width="100%" height="96" background="#777" color="#777" text="false" title="false" >}}
+ <div class="col-lg-8">
+ <h6 class="mb-0">Example blog post title</h6>
+ <small class="text-body-secondary">January 15, 2023</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a class="d-flex flex-column flex-lg-row gap-3 align-items-start align-items-lg-center py-3 link-body-emphasis text-decoration-none border-top" href="#">
+ {{< placeholder width="100%" height="96" background="#777" color="#777" text="false" title="false" >}}
+ <div class="col-lg-8">
+ <h6 class="mb-0">This is another blog post title</h6>
+ <small class="text-body-secondary">January 14, 2023</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a class="d-flex flex-column flex-lg-row gap-3 align-items-start align-items-lg-center py-3 link-body-emphasis text-decoration-none border-top" href="#">
+ {{< placeholder width="100%" height="96" background="#777" color="#777" text="false" title="false" >}}
+ <div class="col-lg-8">
+ <h6 class="mb-0">Longer blog post title: This one has multiple lines!</h6>
+ <small class="text-body-secondary">January 13, 2023</small>
+ </div>
+ </a>
+ </li>
+ </ul>
+ </div>
+
<div class="p-4">
<h4 class="fst-italic">Archives</h4>
<ol class="list-unstyled mb-0">
@@ -250,9 +301,9 @@ include_js: false
</main>
-<footer class="blog-footer">
+<footer class="py-5 text-center text-body-secondary bg-body-tertiary">
<p>Blog template built for <a href="https://getbootstrap.com/">Bootstrap</a> by <a href="https://twitter.com/mdo">@mdo</a>.</p>
- <p>
+ <p class="mb-0">
<a href="#">Back to top</a>
</p>
</footer>
diff --git a/site/content/docs/5.3/examples/breadcrumbs/breadcrumbs.css b/site/content/docs/5.3/examples/breadcrumbs/breadcrumbs.css
new file mode 100644
index 0000000..a6be558
--- /dev/null
+++ b/site/content/docs/5.3/examples/breadcrumbs/breadcrumbs.css
@@ -0,0 +1,50 @@
+.breadcrumb-chevron {
+ --bs-breadcrumb-divider: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' fill='%236c757d'%3E%3Cpath fill-rule='evenodd' d='M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z'/%3E%3C/svg%3E");
+ gap: .5rem;
+}
+.breadcrumb-chevron .breadcrumb-item {
+ display: flex;
+ gap: inherit;
+ align-items: center;
+ padding-left: 0;
+ line-height: 1;
+}
+.breadcrumb-chevron .breadcrumb-item::before {
+ gap: inherit;
+ float: none;
+ width: 1rem;
+ height: 1rem;
+}
+
+.breadcrumb-custom .breadcrumb-item {
+ position: relative;
+ flex-grow: 1;
+ padding: .75rem 3rem;
+}
+.breadcrumb-custom .breadcrumb-item::before {
+ display: none;
+}
+.breadcrumb-custom .breadcrumb-item::after {
+ position: absolute;
+ top: 50%;
+ right: -25px;
+ z-index: 1;
+ display: inline-block;
+ width: 50px;
+ height: 50px;
+ margin-top: -25px;
+ content: "";
+ background-color: var(--bs-tertiary-bg);
+ border-top-right-radius: .5rem;
+ box-shadow: 1px -1px var(--bs-border-color);
+ transform: scale(.707) rotate(45deg);
+}
+.breadcrumb-custom .breadcrumb-item:first-child {
+ padding-left: 1.5rem;
+}
+.breadcrumb-custom .breadcrumb-item:last-child {
+ padding-right: 1.5rem;
+}
+.breadcrumb-custom .breadcrumb-item:last-child::after {
+ display: none;
+}
diff --git a/site/content/docs/5.3/examples/breadcrumbs/index.html b/site/content/docs/5.3/examples/breadcrumbs/index.html
new file mode 100644
index 0000000..2d90962
--- /dev/null
+++ b/site/content/docs/5.3/examples/breadcrumbs/index.html
@@ -0,0 +1,88 @@
+---
+layout: examples
+title: Breadcrumbs
+extra_css:
+ - "breadcrumbs.css"
+body_class: ""
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="house-door-fill" viewBox="0 0 16 16">
+ <path d="M6.5 14.5v-3.505c0-.245.25-.495.5-.495h2c.25 0 .5.25.5.5v3.5a.5.5 0 0 0 .5.5h4a.5.5 0 0 0 .5-.5v-7a.5.5 0 0 0-.146-.354L13 5.793V2.5a.5.5 0 0 0-.5-.5h-1a.5.5 0 0 0-.5.5v1.293L8.354 1.146a.5.5 0 0 0-.708 0l-6 6A.5.5 0 0 0 1.5 7.5v7a.5.5 0 0 0 .5.5h4a.5.5 0 0 0 .5-.5z"/>
+ </symbol>
+</svg>
+
+<div class="container my-5">
+ <nav aria-label="breadcrumb">
+ <ol class="breadcrumb p-3 bg-body-tertiary rounded-3">
+ <li class="breadcrumb-item"><a href="#">Home</a></li>
+ <li class="breadcrumb-item"><a href="#">Library</a></li>
+ <li class="breadcrumb-item active" aria-current="page">Data</li>
+ </ol>
+ </nav>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="container my-5">
+ <nav aria-label="breadcrumb">
+ <ol class="breadcrumb p-3 bg-body-tertiary rounded-3">
+ <li class="breadcrumb-item">
+ <a class="link-body-emphasis" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#house-door-fill"></use></svg>
+ <span class="visually-hidden">Home</span>
+ </a>
+ </li>
+ <li class="breadcrumb-item">
+ <a class="link-body-emphasis fw-semibold text-decoration-none" href="#">Library</a>
+ </li>
+ <li class="breadcrumb-item active" aria-current="page">
+ Data
+ </li>
+ </ol>
+ </nav>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="container my-5">
+ <nav aria-label="breadcrumb">
+ <ol class="breadcrumb breadcrumb-chevron p-3 bg-body-tertiary rounded-3">
+ <li class="breadcrumb-item">
+ <a class="link-body-emphasis" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#house-door-fill"></use></svg>
+ <span class="visually-hidden">Home</span>
+ </a>
+ </li>
+ <li class="breadcrumb-item">
+ <a class="link-body-emphasis fw-semibold text-decoration-none" href="#">Library</a>
+ </li>
+ <li class="breadcrumb-item active" aria-current="page">
+ Data
+ </li>
+ </ol>
+ </nav>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="container my-5">
+ <nav aria-label="breadcrumb">
+ <ol class="breadcrumb breadcrumb-custom overflow-hidden text-center bg-body-tertiary border rounded-3">
+ <li class="breadcrumb-item">
+ <a class="link-body-emphasis fw-semibold text-decoration-none" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#house-door-fill"></use></svg>
+ Home
+ </a>
+ </li>
+ <li class="breadcrumb-item">
+ <a class="link-body-emphasis fw-semibold text-decoration-none" href="#">Library</a>
+ </li>
+ <li class="breadcrumb-item active" aria-current="page">
+ Data
+ </li>
+ </ol>
+ </nav>
+</div>
+
+<div class="b-example-divider"></div>
diff --git a/site/content/docs/5.3/examples/buttons/index.html b/site/content/docs/5.3/examples/buttons/index.html
new file mode 100644
index 0000000..f1b5ea6
--- /dev/null
+++ b/site/content/docs/5.3/examples/buttons/index.html
@@ -0,0 +1,88 @@
+---
+layout: examples
+title: Buttons
+body_class: ""
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="arrow-right-short" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4 8a.5.5 0 0 1 .5-.5h5.793L8.146 5.354a.5.5 0 1 1 .708-.708l3 3a.5.5 0 0 1 0 .708l-3 3a.5.5 0 0 1-.708-.708L10.293 8.5H4.5A.5.5 0 0 1 4 8z"/>
+ </symbol>
+ <symbol id="x-lg" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M13.854 2.146a.5.5 0 0 1 0 .708l-11 11a.5.5 0 0 1-.708-.708l11-11a.5.5 0 0 1 .708 0Z"/>
+ <path fill-rule="evenodd" d="M2.146 2.146a.5.5 0 0 0 0 .708l11 11a.5.5 0 0 0 .708-.708l-11-11a.5.5 0 0 0-.708 0Z"/>
+ </symbol>
+</svg>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <button class="btn btn-primary rounded-pill px-3" type="button">Primary</button>
+ <button class="btn btn-secondary rounded-pill px-3" type="button">Secondary</button>
+ <button class="btn btn-success rounded-pill px-3" type="button">Success</button>
+ <button class="btn btn-danger rounded-pill px-3" type="button">Danger</button>
+ <button class="btn btn-warning rounded-pill px-3" type="button">Warning</button>
+ <button class="btn btn-info rounded-pill px-3" type="button">Info</button>
+ <button class="btn btn-light rounded-pill px-3" type="button">Light</button>
+ <button class="btn btn-dark rounded-pill px-3" type="button">Dark</button>
+ <button class="btn btn-link rounded-pill px-3" type="button">Link</button>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="col-lg-6 col-xxl-4 my-5 mx-auto">
+ <div class="d-grid gap-2">
+ <button class="btn btn-outline-secondary" type="button">Secondary action</button>
+ <button class="btn btn-primary" type="button">Primary action</button>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <button class="btn btn-primary d-inline-flex align-items-center" type="button">
+ Primary icon
+ <svg class="bi ms-1" width="20" height="20"><use xlink:href="#arrow-right-short"/></svg>
+ </button>
+ <button class="btn btn-outline-secondary d-inline-flex align-items-center" type="button">
+ Secondary icon
+ <svg class="bi ms-1" width="20" height="20"><use xlink:href="#arrow-right-short"/></svg>
+ </button>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center py-5">
+ <button class="btn btn-primary" type="button" disabled>
+ <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
+ <span class="visually-hidden">Loading...</span>
+ </button>
+ <button class="btn btn-primary" type="button" disabled>
+ <span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>
+ Loading...
+ </button>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex gap-2 justify-content-center pt-5 pb-4">
+ <button class="btn btn-primary rounded-circle p-2 lh-1" type="button">
+ <svg class="bi" width="16" height="16"><use xlink:href="#x-lg"/></svg>
+ <span class="visually-hidden">Dismiss</span>
+ </button>
+ <button class="btn btn-outline-primary rounded-circle p-2 lh-1" type="button">
+ <svg class="bi" width="16" height="16"><use xlink:href="#x-lg"/></svg>
+ <span class="visually-hidden">Dismiss</span>
+ </button>
+</div>
+
+<div class="d-flex gap-2 justify-content-center pb-5">
+ <button class="btn btn-primary rounded-circle p-3 lh-1" type="button">
+ <svg class="bi" width="24" height="24"><use xlink:href="#x-lg"/></svg>
+ <span class="visually-hidden">Dismiss</span>
+ </button>
+ <button class="btn btn-outline-primary rounded-circle p-3 lh-1" type="button">
+ <svg class="bi" width="24" height="24"><use xlink:href="#x-lg"/></svg>
+ <span class="visually-hidden">Dismiss</span>
+ </button>
+</div>
+
+<div class="b-example-divider"></div>
diff --git a/site/content/docs/5.2/examples/carousel-rtl/index.html b/site/content/docs/5.3/examples/carousel-rtl/index.html
index b8c35d6..db184d7 100644
--- a/site/content/docs/5.2/examples/carousel-rtl/index.html
+++ b/site/content/docs/5.3/examples/carousel-rtl/index.html
@@ -6,7 +6,7 @@ extra_css:
- "../carousel/carousel.rtl.css"
---
-<header>
+<header data-bs-theme="dark">
<nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark">
<div class="container-fluid">
<a class="navbar-brand" href="#">شرائح العرض</a>
@@ -36,7 +36,7 @@ extra_css:
<main>
- <div id="myCarousel" class="carousel slide" data-bs-ride="carousel">
+ <div id="myCarousel" class="carousel slide mb-6" data-bs-ride="carousel" data-bs-theme="light">
<div class="carousel-indicators">
<button type="button" data-bs-target="#myCarousel" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
<button type="button" data-bs-target="#myCarousel" data-bs-slide-to="1" aria-label="Slide 2"></button>
@@ -44,17 +44,17 @@ extra_css:
</div>
<div class="carousel-inner">
<div class="carousel-item active">
- {{< placeholder width="100%" height="100%" background="#777" color="#777" text="false" title="false" >}}
+ {{< placeholder width="100%" height="100%" background="var(--bs-secondary-color)" text="false" title="false" >}}
<div class="container">
<div class="carousel-caption text-start">
<h1>عنوان المثال.</h1>
- <p>تشير الدراسات الإحصائية حسب الجمعية الأمريكية للغات بأن الإقبال على العربية زاد %126 في الولايات المتحدة الأمريكية وحدها بين عامي 2002 و2009م.</p>
+ <p class="opacity-75">تشير الدراسات الإحصائية حسب الجمعية الأمريكية للغات بأن الإقبال على العربية زاد %126 في الولايات المتحدة الأمريكية وحدها بين عامي 2002 و2009م.</p>
<p><a class="btn btn-lg btn-primary" href="#">سجل اليوم</a></p>
</div>
</div>
</div>
<div class="carousel-item">
- {{< placeholder width="100%" height="100%" background="#777" color="#777" text="false" title="false" >}}
+ {{< placeholder width="100%" height="100%" background="var(--bs-secondary-color)" text="false" title="false" >}}
<div class="container">
<div class="carousel-caption">
<h1>عنوان مثال آخر.</h1>
@@ -64,7 +64,7 @@ extra_css:
</div>
</div>
<div class="carousel-item">
- {{< placeholder width="100%" height="100%" background="#777" color="#777" text="false" title="false" >}}
+ {{< placeholder width="100%" height="100%" background="var(--bs-secondary-color)" text="false" title="false" >}}
<div class="container">
<div class="carousel-caption text-end">
<h1>واحد أكثر لقياس جيد.</h1>
@@ -94,19 +94,19 @@ extra_css:
<!-- Three columns of text below the carousel -->
<div class="row">
<div class="col-lg-4">
- {{< placeholder width="140" height="140" background="#777" color="#777" class="rounded-circle" >}}
+ {{< placeholder width="140" height="140" background="var(--bs-secondary-color)" text="false" class="rounded-circle" >}}
<h2 class="fw-normal">عنوان</h2>
<p>تذكر دائماً أن الحاسوب لا يمتلك ذكاءً، ولكنه يكتسب الذكاء الاصطناعي من خلال ثلاثة عناصر وظيفية رئيسة، هي: القدرة على التحليل، والقدرة على التأليف، والاستدلال المنطقي.</p>
<p><a class="btn btn-secondary" href="#">عرض التفاصيل</a></p>
</div><!-- /.col-lg-4 -->
<div class="col-lg-4">
- {{< placeholder width="140" height="140" background="#777" color="#777" class="rounded-circle" >}}
+ {{< placeholder width="140" height="140" background="var(--bs-secondary-color)" text="false" class="rounded-circle" >}}
<h2 class="fw-normal">عنوان آخر</h2>
<p>إذا أردنا استخدام الحاسوب الذكي في معالجة اللغة العربية فإننا نجد أنفسنا أمام تحدٍّ كبير، خاصة وأن لغتنا تمتاز بتماسك منظوماتها وتداخلها، ومع ذلك فإن الذكاء الاصطناعي يمكّننا من الحصول على أربعة أنواع من المعالجة، هي: المعالجة الصوتية، والمعالجة الصرفية، والمعالجة النحوية، والمعالجة الدلالية.</p>
<p><a class="btn btn-secondary" href="#">عرض التفاصيل</a></p>
</div><!-- /.col-lg-4 -->
<div class="col-lg-4">
- {{< placeholder width="140" height="140" background="#777" color="#777" class="rounded-circle" >}}
+ {{< placeholder width="140" height="140" background="var(--bs-secondary-color)" text="false" class="rounded-circle" >}}
<h2 class="fw-normal">عنوان ثالث لتأكيد المعلومة</h2>
<p>بفضل بحوث الذكاء الاصطناعي وتقنياته استطعنا الانتقال من مرحلة التعامل مع الفيزيائي إلى مرحلة التعامل مع المنطقي، وقد انعكس هذا الانتقال بصورة إيجابية على الكيفية التي تتعامل بها الشعوب مع لغاتها الحيَّة، وهذا يعني أنه يجب أن ينعكس بصورة إيجابية على كيفية تعاملنا مع لغتنا العربية.</p>
<p><a class="btn btn-secondary" href="#">عرض التفاصيل</a></p>
@@ -120,11 +120,11 @@ extra_css:
<div class="row featurette">
<div class="col-md-7">
- <h2 class="featurette-heading fw-normal lh-1">العنوان الأول المميز. <span class="text-muted"> سيذهل عقلك. </span></h2>
+ <h2 class="featurette-heading fw-normal lh-1">العنوان الأول المميز. <span class="text-body-secondary"> سيذهل عقلك. </span></h2>
<p class="lead">وجه الإنسان هو جزء معقَّد ومتميِّز للغاية من جسمه. وفي الواقع، إنه أحد أكثر أنظمة الإشارات المتاحة تعقيداً لدينا؛ فهو يتضمَّن أكثر من 40 عضلة مستقلة هيكلياً ووظيفياً، بحيث يمكن تشغيل كل منها بشكل مستقل عن البعض الآخر؛ وتشكِّل أحد أقوى مؤشرات العواطف.</p>
</div>
<div class="col-md-5">
- {{< placeholder width="500" height="500" background="#eee" color="#aaa" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
+ {{< placeholder width="500" height="500" background="var(--bs-secondary-bg)" color="var(--bs-secondary-color)" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
</div>
</div>
@@ -132,11 +132,11 @@ extra_css:
<div class="row featurette">
<div class="col-md-7 order-md-2">
- <h2 class="featurette-heading fw-normal lh-1">أوه نعم، هذا جيد. <span class="text-muted"> شاهد بنفسك. </span></h2>
+ <h2 class="featurette-heading fw-normal lh-1">أوه نعم، هذا جيد. <span class="text-body-secondary"> شاهد بنفسك. </span></h2>
<p class="lead">عندما نضحك أو نبكي، فإننا نعرض عواطفنا، مما يسمح للآخرين بإلقاء نظرة خاطفة على أذهاننا أثناء "قراءة" وجوهنا بناءً على التغييرات في مكوّنات الوجه الرئيسة، مثل: العينين والحاجبين والجفنين والأنف والشفتين.</p>
</div>
<div class="col-md-5 order-md-1">
- {{< placeholder width="500" height="500" background="#eee" color="#aaa" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
+ {{< placeholder width="500" height="500" background="var(--bs-secondary-bg)" color="var(--bs-secondary-color)" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
</div>
</div>
@@ -144,11 +144,11 @@ extra_css:
<div class="row featurette">
<div class="col-md-7">
- <h2 class="featurette-heading fw-normal lh-1">وأخيرًا، هذا. <span class="text-muted"> كش ملك. </span></h2>
+ <h2 class="featurette-heading fw-normal lh-1">وأخيرًا، هذا. <span class="text-body-secondary"> كش ملك. </span></h2>
<p class="lead">إن جميع العضلات في أجسامنا مدعمة بالأعصاب المتصلة من كافة أنحاء الجسم بالنخاع الشوكي والدماغ. وهذا الاتصال العصبي هو ثنائي الاتجاه، أي إن العصب يتسبَّب في تقلصات العضلات بناءً على إشارات الدماغ، ويقوم في الوقت نفسه بإرسال معلومات عن حالة العضلات إلى الدماغ</p>
</div>
<div class="col-md-5">
- {{< placeholder width="500" height="500" background="#eee" color="#aaa" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
+ {{< placeholder width="500" height="500" background="var(--bs-secondary-bg)" color="var(--bs-secondary-color)" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
</div>
</div>
diff --git a/site/content/docs/5.2/examples/carousel/carousel.css b/site/content/docs/5.3/examples/carousel/carousel.css
index 0bdf976..be0af52 100644
--- a/site/content/docs/5.2/examples/carousel/carousel.css
+++ b/site/content/docs/5.3/examples/carousel/carousel.css
@@ -5,7 +5,7 @@
body {
padding-top: 3rem;
padding-bottom: 3rem;
- color: #5a5a5a;
+ color: rgb(var(--bs-tertiary-color-rgb));
}
diff --git a/site/content/docs/5.2/examples/carousel/carousel.rtl.css b/site/content/docs/5.3/examples/carousel/carousel.rtl.css
index d20a811..9ff275d 100644
--- a/site/content/docs/5.2/examples/carousel/carousel.rtl.css
+++ b/site/content/docs/5.3/examples/carousel/carousel.rtl.css
@@ -5,7 +5,7 @@
body {
padding-top: 3rem;
padding-bottom: 3rem;
- color: #5a5a5a;
+ color: rgb(var(--bs-tertiary-color-rgb));
}
diff --git a/site/content/docs/5.2/examples/carousel/index.html b/site/content/docs/5.3/examples/carousel/index.html
index 67c0dd5..e03f4d7 100644
--- a/site/content/docs/5.2/examples/carousel/index.html
+++ b/site/content/docs/5.3/examples/carousel/index.html
@@ -5,7 +5,7 @@ extra_css:
- "carousel.css"
---
-<header>
+<header data-bs-theme="dark">
<nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark">
<div class="container-fluid">
<a class="navbar-brand" href="#">Carousel</a>
@@ -35,7 +35,7 @@ extra_css:
<main>
- <div id="myCarousel" class="carousel slide" data-bs-ride="carousel">
+ <div id="myCarousel" class="carousel slide mb-6" data-bs-ride="carousel" data-bs-theme="light">
<div class="carousel-indicators">
<button type="button" data-bs-target="#myCarousel" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
<button type="button" data-bs-target="#myCarousel" data-bs-slide-to="1" aria-label="Slide 2"></button>
@@ -43,17 +43,17 @@ extra_css:
</div>
<div class="carousel-inner">
<div class="carousel-item active">
- {{< placeholder width="100%" height="100%" background="#777" color="#777" text="false" title="false" >}}
+ {{< placeholder width="100%" height="100%" background="var(--bs-secondary-color)" text="false" title="false" >}}
<div class="container">
<div class="carousel-caption text-start">
<h1>Example headline.</h1>
- <p>Some representative placeholder content for the first slide of the carousel.</p>
+ <p class="opacity-75">Some representative placeholder content for the first slide of the carousel.</p>
<p><a class="btn btn-lg btn-primary" href="#">Sign up today</a></p>
</div>
</div>
</div>
<div class="carousel-item">
- {{< placeholder width="100%" height="100%" background="#777" color="#777" text="false" title="false" >}}
+ {{< placeholder width="100%" height="100%" background="var(--bs-secondary-color)" text="false" title="false" >}}
<div class="container">
<div class="carousel-caption">
<h1>Another example headline.</h1>
@@ -63,7 +63,7 @@ extra_css:
</div>
</div>
<div class="carousel-item">
- {{< placeholder width="100%" height="100%" background="#777" color="#777" text="false" title="false" >}}
+ {{< placeholder width="100%" height="100%" background="var(--bs-secondary-color)" text="false" title="false" >}}
<div class="container">
<div class="carousel-caption text-end">
<h1>One more for good measure.</h1>
@@ -93,19 +93,19 @@ extra_css:
<!-- Three columns of text below the carousel -->
<div class="row">
<div class="col-lg-4">
- {{< placeholder width="140" height="140" background="#777" color="#777" class="rounded-circle" >}}
+ {{< placeholder width="140" height="140" background="var(--bs-secondary-color)" text="false" class="rounded-circle" >}}
<h2 class="fw-normal">Heading</h2>
<p>Some representative placeholder content for the three columns of text below the carousel. This is the first column.</p>
<p><a class="btn btn-secondary" href="#">View details &raquo;</a></p>
</div><!-- /.col-lg-4 -->
<div class="col-lg-4">
- {{< placeholder width="140" height="140" background="#777" color="#777" class="rounded-circle" >}}
+ {{< placeholder width="140" height="140" background="var(--bs-secondary-color)" text="false" class="rounded-circle" >}}
<h2 class="fw-normal">Heading</h2>
<p>Another exciting bit of representative placeholder content. This time, we've moved on to the second column.</p>
<p><a class="btn btn-secondary" href="#">View details &raquo;</a></p>
</div><!-- /.col-lg-4 -->
<div class="col-lg-4">
- {{< placeholder width="140" height="140" background="#777" color="#777" class="rounded-circle" >}}
+ {{< placeholder width="140" height="140" background="var(--bs-secondary-color)" text="false" class="rounded-circle" >}}
<h2 class="fw-normal">Heading</h2>
<p>And lastly this, the third column of representative placeholder content.</p>
<p><a class="btn btn-secondary" href="#">View details &raquo;</a></p>
@@ -119,11 +119,11 @@ extra_css:
<div class="row featurette">
<div class="col-md-7">
- <h2 class="featurette-heading fw-normal lh-1">First featurette heading. <span class="text-muted">It’ll blow your mind.</span></h2>
+ <h2 class="featurette-heading fw-normal lh-1">First featurette heading. <span class="text-body-secondary">It’ll blow your mind.</span></h2>
<p class="lead">Some great placeholder content for the first featurette here. Imagine some exciting prose here.</p>
</div>
<div class="col-md-5">
- {{< placeholder width="500" height="500" background="#eee" color="#aaa" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
+ {{< placeholder width="500" height="500" background="var(--bs-secondary-bg)" color="var(--bs-secondary-color)" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
</div>
</div>
@@ -131,11 +131,11 @@ extra_css:
<div class="row featurette">
<div class="col-md-7 order-md-2">
- <h2 class="featurette-heading fw-normal lh-1">Oh yeah, it’s that good. <span class="text-muted">See for yourself.</span></h2>
+ <h2 class="featurette-heading fw-normal lh-1">Oh yeah, it’s that good. <span class="text-body-secondary">See for yourself.</span></h2>
<p class="lead">Another featurette? Of course. More placeholder content here to give you an idea of how this layout would work with some actual real-world content in place.</p>
</div>
<div class="col-md-5 order-md-1">
- {{< placeholder width="500" height="500" background="#eee" color="#aaa" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
+ {{< placeholder width="500" height="500" background="var(--bs-secondary-bg)" color="var(--bs-secondary-color)" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
</div>
</div>
@@ -143,11 +143,11 @@ extra_css:
<div class="row featurette">
<div class="col-md-7">
- <h2 class="featurette-heading fw-normal lh-1">And lastly, this one. <span class="text-muted">Checkmate.</span></h2>
+ <h2 class="featurette-heading fw-normal lh-1">And lastly, this one. <span class="text-body-secondary">Checkmate.</span></h2>
<p class="lead">And yes, this is the last block of representative placeholder content. Again, not really intended to be actually read, simply here to give you a better view of what this would look like with some actual content. Your content.</p>
</div>
<div class="col-md-5">
- {{< placeholder width="500" height="500" background="#eee" color="#aaa" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
+ {{< placeholder width="500" height="500" background="var(--bs-secondary-bg)" color="var(--bs-secondary-color)" class="bd-placeholder-img-lg featurette-image img-fluid mx-auto" >}}
</div>
</div>
diff --git a/site/content/docs/5.2/examples/cheatsheet-rtl/index.html b/site/content/docs/5.3/examples/cheatsheet-rtl/index.html
index a057998..8ffbb57 100644
--- a/site/content/docs/5.2/examples/cheatsheet-rtl/index.html
+++ b/site/content/docs/5.3/examples/cheatsheet-rtl/index.html
@@ -5,7 +5,7 @@ extra_css:
- "../cheatsheet/cheatsheet.rtl.css"
extra_js:
- src: "../cheatsheet/cheatsheet.js"
-body_class: "bg-light"
+body_class: "bg-body-tertiary"
direction: rtl
---
@@ -18,7 +18,7 @@ direction: rtl
<a href="{{< docsref "/examples/cheatsheet" >}}" class="ms-auto link-light" hreflang="en">جدول بيانات LTR</a>
</div>
</header>
-<aside class="bd-aside sticky-xl-top text-muted align-self-start mb-3 mb-xl-5 px-2">
+<aside class="bd-aside sticky-xl-top text-body-secondary align-self-start mb-3 mb-xl-5 px-2">
<h2 class="h6 pt-4 pb-3 mb-4 border-bottom">على هذه الصفحة</h2>
<nav class="small" id="toc">
<ul class="list-unstyled">
@@ -623,36 +623,36 @@ direction: rtl
{{< example show_markup="false" >}}
<div class="accordion" id="accordionExample">
<div class="accordion-item">
- <h4 class="accordion-header" id="headingOne">
+ <h4 class="accordion-header">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
عنصر المطوية الأول
</button>
</h4>
- <div id="collapseOne" class="accordion-collapse collapse show" aria-labelledby="headingOne" data-bs-parent="#accordionExample">
+ <div id="collapseOne" class="accordion-collapse collapse show" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>هذا هو محتوى عنصر المطوية الأول.</strong> سيكون المحتوى مخفيًا بشكل إفتراضي حتى يقوم Bootstrap بإضافة الكلاسات اللازمة لكل عنصر في المطوية. هذه الكلاسات تتحكم بالمظهر العام ووتتحكم أيضا بإظهار وإخفاء أقسام المطوية عبر حركات CSS الإنتقالية. يمكنك تعديل أي من هذه عبر كلاسات CSS خاصة بك، او عبر تغيير القيم الإفتراضية المقدمة من Bootstrap. من الجدير بالذكر أنه يمكن وضع أي كود HTML هنا، ولكن الحركة الإنتقالية قد تحد من الoverflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h4 class="accordion-header" id="headingTwo">
+ <h4 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
عنصر المطوية الثاني
</button>
</h4>
- <div id="collapseTwo" class="accordion-collapse collapse" aria-labelledby="headingTwo" data-bs-parent="#accordionExample">
+ <div id="collapseTwo" class="accordion-collapse collapse" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>هذا هو محتوى عنصر المطوية الثاني.</strong> سيكون المحتوى مخفيًا بشكل إفتراضي حتى يقوم Bootstrap بإضافة الكلاسات اللازمة لكل عنصر في المطوية. هذه الكلاسات تتحكم بالمظهر العام ووتتحكم أيضا بإظهار وإخفاء أقسام المطوية عبر حركات CSS الإنتقالية. يمكنك تعديل أي من هذه عبر كلاسات CSS خاصة بك، او عبر تغيير القيم الإفتراضية المقدمة من Bootstrap. من الجدير بالذكر أنه يمكن وضع أي كود HTML هنا، ولكن الحركة الإنتقالية قد تحد من الoverflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h4 class="accordion-header" id="headingThree">
+ <h4 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
عنصر المطوية الثالث
</button>
</h4>
- <div id="collapseThree" class="accordion-collapse collapse" aria-labelledby="headingThree" data-bs-parent="#accordionExample">
+ <div id="collapseThree" class="accordion-collapse collapse" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>هذا هو محتوى عنصر المطوية الثالث.</strong> سيكون المحتوى مخفيًا بشكل إفتراضي حتى يقوم Bootstrap بإضافة الكلاسات اللازمة لكل عنصر في المطوية. هذه الكلاسات تتحكم بالمظهر العام ووتتحكم أيضا بإظهار وإخفاء أقسام المطوية عبر حركات CSS الإنتقالية. يمكنك تعديل أي من هذه عبر كلاسات CSS خاصة بك، او عبر تغيير القيم الإفتراضية المقدمة من Bootstrap. من الجدير بالذكر أنه يمكن وضع أي كود HTML هنا، ولكن الحركة الإنتقالية قد تحد من الoverflow.
</div>
@@ -821,7 +821,7 @@ direction: rtl
<p class="card-text">بعض الأمثلة السريعة للنصوص للبناء على عنوان البطاقة وتشكيل الجزء الأكبر من محتوى البطاقة.</p>
<a href="#" class="btn btn-primary">اذهب لمكان ما</a>
</div>
- <div class="card-footer text-muted">
+ <div class="card-footer text-body-secondary">
منذ يومان
</div>
</div>
@@ -853,7 +853,7 @@ direction: rtl
<div class="card-body">
<h5 class="card-title">عنوان البطاقة</h5>
<p class="card-text">هذه بطاقة أعرض مع نص داعم تحتها كمقدمة طبيعية لمحتوى إضافي. هذا المحتوى أطول قليلاً.</p>
- <p class="card-text"><small class="text-muted">آخر تحديث منذ 3 دقائق</small></p>
+ <p class="card-text"><small class="text-body-secondary">آخر تحديث منذ 3 دقائق</small></p>
</div>
</div>
</div>
@@ -1221,7 +1221,7 @@ direction: rtl
<div>
{{< example show_markup="false" >}}
- <nav class="navbar navbar-expand-lg bg-light">
+ <nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">
<img src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo-white.svg" width="38" height="30" class="d-inline-block align-top" alt="Bootstrap" loading="lazy"
@@ -1397,27 +1397,31 @@ direction: rtl
<div>
{{< example show_markup="false" >}}
- <div class="progress mb-3">
- <div class="progress-bar" role="progressbar" aria-label="مثال مع عنوان" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">0%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="مثال مع عنوان" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar">0%</div>
</div>
- <div class="progress mb-3">
- <div class="progress-bar bg-success w-25" role="progressbar" aria-label="مثال ناجح مع عنوان" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">25%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="مثال ناجح مع عنوان" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-success w-25">25%</div>
</div>
- <div class="progress mb-3">
- <div class="progress-bar text-bg-info w-50" role="progressbar" aria-label="مثال توضيح مع عنوان" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">50%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="مثال توضيح مع عنوان" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar text-bg-info w-50">50%</div>
</div>
- <div class="progress mb-3">
- <div class="progress-bar text-bg-warning w-75" role="progressbar" aria-label="مثال تنبيه مع عنوان" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">75%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="مثال تنبيه مع عنوان" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar text-bg-warning w-75">75%</div>
</div>
- <div class="progress">
- <div class="progress-bar bg-danger w-100" role="progressbar" aria-label="مثال خطر مع عنوان" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">100%</div>
+ <div class="progress" role="progressbar" aria-label="مثال خطر مع عنوان" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-danger w-100">100%</div>
</div>
{{< /example >}}
{{< example show_markup="false" >}}
- <div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="القسم الأول - مثال افتراضي" style="width: 15%" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100"></div>
- <div class="progress-bar progress-bar-striped progress-bar-animated bg-success" role="progressbar" aria-label="القسم الثاني - مثال ناجح مقلّم متحرك" style="width: 40%" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100"></div>
+ <div class="progress-stacked">
+ <div class="progress" role="progressbar" aria-label="القسم الأول - مثال افتراضي" style="width: 15%" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar"></div>
+ </div>
+ <div class="progress" role="progressbar" aria-label="القسم الثاني - مثال ناجح مقلّم متحرك" style="width: 40%" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped progress-bar-animated bg-success"></div>
+ </div>
</div>
{{< /example >}}
</div>
@@ -1430,7 +1434,7 @@ direction: rtl
<div>
<div class="bd-example">
- <nav id="navbar-example2" class="navbar bg-light px-3">
+ <nav id="navbar-example2" class="navbar bg-body-tertiary px-3">
<a class="navbar-brand" href="#">شريط التنقل</a>
<ul class="nav nav-pills">
<li class="nav-item">
@@ -1506,7 +1510,7 @@ direction: rtl
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
<strong class="me-auto">Bootstrap</strong>
- <small class="text-muted">قبل 11 دقيقة</small>
+ <small class="text-body-secondary">قبل 11 دقيقة</small>
<button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="قريب"></button>
</div>
<div class="toast-body">
diff --git a/site/content/docs/5.2/examples/cheatsheet/cheatsheet.css b/site/content/docs/5.3/examples/cheatsheet/cheatsheet.css
index e2f99b8..e2f99b8 100644
--- a/site/content/docs/5.2/examples/cheatsheet/cheatsheet.css
+++ b/site/content/docs/5.3/examples/cheatsheet/cheatsheet.css
diff --git a/site/content/docs/5.2/examples/cheatsheet/cheatsheet.js b/site/content/docs/5.3/examples/cheatsheet/cheatsheet.js
index e25a89e..e25a89e 100644
--- a/site/content/docs/5.2/examples/cheatsheet/cheatsheet.js
+++ b/site/content/docs/5.3/examples/cheatsheet/cheatsheet.js
diff --git a/site/content/docs/5.2/examples/cheatsheet/cheatsheet.rtl.css b/site/content/docs/5.3/examples/cheatsheet/cheatsheet.rtl.css
index e04d848..e04d848 100644
--- a/site/content/docs/5.2/examples/cheatsheet/cheatsheet.rtl.css
+++ b/site/content/docs/5.3/examples/cheatsheet/cheatsheet.rtl.css
diff --git a/site/content/docs/5.2/examples/cheatsheet/index.html b/site/content/docs/5.3/examples/cheatsheet/index.html
index a2285d0..7470c4e 100644
--- a/site/content/docs/5.2/examples/cheatsheet/index.html
+++ b/site/content/docs/5.3/examples/cheatsheet/index.html
@@ -5,7 +5,7 @@ extra_css:
- "cheatsheet.css"
extra_js:
- src: "cheatsheet.js"
-body_class: "bg-light"
+body_class: "bg-body-tertiary"
---
<header class="bd-header bg-dark py-3 d-flex align-items-stretch border-bottom border-dark">
@@ -17,7 +17,7 @@ body_class: "bg-light"
<a href="{{< docsref "/examples/cheatsheet-rtl" >}}" class="ms-auto link-light" hreflang="ar">RTL cheatsheet</a>
</div>
</header>
-<aside class="bd-aside sticky-xl-top text-muted align-self-start mb-3 mb-xl-5 px-2">
+<aside class="bd-aside sticky-xl-top text-body-secondary align-self-start mb-3 mb-xl-5 px-2">
<h2 class="h6 pt-4 pb-3 mb-4 border-bottom">On this page</h2>
<nav class="small" id="toc">
<ul class="list-unstyled">
@@ -622,36 +622,36 @@ body_class: "bg-light"
{{< example show_markup="false" >}}
<div class="accordion" id="accordionExample">
<div class="accordion-item">
- <h4 class="accordion-header" id="headingOne">
+ <h4 class="accordion-header">
<button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
Accordion Item #1
</button>
</h4>
- <div id="collapseOne" class="accordion-collapse collapse show" aria-labelledby="headingOne" data-bs-parent="#accordionExample">
+ <div id="collapseOne" class="accordion-collapse collapse show" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>This is the first item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h4 class="accordion-header" id="headingTwo">
+ <h4 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
Accordion Item #2
</button>
</h4>
- <div id="collapseTwo" class="accordion-collapse collapse" aria-labelledby="headingTwo" data-bs-parent="#accordionExample">
+ <div id="collapseTwo" class="accordion-collapse collapse" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>This is the second item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
</div>
</div>
<div class="accordion-item">
- <h4 class="accordion-header" id="headingThree">
+ <h4 class="accordion-header">
<button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
Accordion Item #3
</button>
</h4>
- <div id="collapseThree" class="accordion-collapse collapse" aria-labelledby="headingThree" data-bs-parent="#accordionExample">
+ <div id="collapseThree" class="accordion-collapse collapse" data-bs-parent="#accordionExample">
<div class="accordion-body">
<strong>This is the third item's accordion body.</strong> It is hidden by default, until the collapse plugin adds the appropriate classes that we use to style each element. These classes control the overall appearance, as well as the showing and hiding via CSS transitions. You can modify any of this with custom CSS or overriding our default variables. It's also worth noting that just about any HTML can go within the <code>.accordion-body</code>, though the transition does limit overflow.
</div>
@@ -820,7 +820,7 @@ body_class: "bg-light"
<p class="card-text">Some quick example text to build on the card title and make up the bulk of the card's content.</p>
<a href="#" class="btn btn-primary">Go somewhere</a>
</div>
- <div class="card-footer text-muted">
+ <div class="card-footer text-body-secondary">
2 days ago
</div>
</div>
@@ -852,7 +852,7 @@ body_class: "bg-light"
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
</div>
@@ -1220,7 +1220,7 @@ body_class: "bg-light"
<div>
{{< example show_markup="false" >}}
- <nav class="navbar navbar-expand-lg bg-light">
+ <nav class="navbar navbar-expand-lg bg-body-tertiary">
<div class="container-fluid">
<a class="navbar-brand" href="#">
<img src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo-white.svg" width="38" height="30" class="d-inline-block align-top" alt="Bootstrap" loading="lazy"
@@ -1394,27 +1394,31 @@ body_class: "bg-light"
<div>
{{< example show_markup="false" >}}
- <div class="progress mb-3">
- <div class="progress-bar" role="progressbar" aria-label="Example with label" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">0%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="Example with label" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar">0%</div>
</div>
- <div class="progress mb-3">
- <div class="progress-bar bg-success w-25" role="progressbar" aria-label="Success example with label" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">25%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="Success example with label" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-success w-25">25%</div>
</div>
- <div class="progress mb-3">
- <div class="progress-bar text-bg-info w-50" role="progressbar" aria-label="Info example with label" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">50%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="Info example with label" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar text-bg-info w-50">50%</div>
</div>
- <div class="progress mb-3">
- <div class="progress-bar text-bg-warning w-75" role="progressbar" aria-label="Warning example with label" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">75%</div>
+ <div class="progress mb-3" role="progressbar" aria-label="Warning example with label" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar text-bg-warning w-75">75%</div>
</div>
- <div class="progress">
- <div class="progress-bar bg-danger w-100" role="progressbar" aria-label="Danger example with label" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">100%</div>
+ <div class="progress" role="progressbar" aria-label="Danger example with label" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar bg-danger w-100">100%</div>
</div>
{{< /example >}}
{{< example show_markup="false" >}}
- <div class="progress">
- <div class="progress-bar" role="progressbar" aria-label="Segment one - default example" style="width: 15%" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100"></div>
- <div class="progress-bar progress-bar-striped progress-bar-animated bg-success" role="progressbar" aria-label="Segment two - animated striped success example" style="width: 40%" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100"></div>
+ <div class="progress-stacked">
+ <div class="progress" role="progressbar" aria-label="Segment one - default example" style="width: 15%" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar"></div>
+ </div>
+ <div class="progress" role="progressbar" aria-label="Segment two - animated striped success example" style="width: 40%" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar progress-bar-striped progress-bar-animated bg-success"></div>
+ </div>
</div>
{{< /example >}}
</div>
@@ -1427,7 +1431,7 @@ body_class: "bg-light"
<div>
<div class="bd-example">
- <nav id="navbar-example2" class="navbar bg-light px-3">
+ <nav id="navbar-example2" class="navbar bg-body-tertiary px-3">
<a class="navbar-brand" href="#">Navbar</a>
<ul class="nav nav-pills">
<li class="nav-item">
@@ -1502,7 +1506,7 @@ body_class: "bg-light"
<div class="toast-header">
{{< placeholder width="20" height="20" background="#007aff" class="rounded me-2" text="false" title="false" >}}
<strong class="me-auto">Bootstrap</strong>
- <small class="text-muted">11 mins ago</small>
+ <small class="text-body-secondary">11 mins ago</small>
<button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
</div>
<div class="toast-body">
diff --git a/site/content/docs/5.2/examples/checkout-rtl/index.html b/site/content/docs/5.3/examples/checkout-rtl/index.html
index e0ca621..6516efe 100644
--- a/site/content/docs/5.2/examples/checkout-rtl/index.html
+++ b/site/content/docs/5.3/examples/checkout-rtl/index.html
@@ -3,10 +3,10 @@ layout: examples
title: مثال إتمام الشراء
direction: rtl
extra_css:
- - "../checkout/form-validation.css"
+ - "../checkout/checkout.css"
extra_js:
- - src: "../checkout/form-validation.js"
-body_class: "bg-light"
+ - src: "../checkout/checkout.js"
+body_class: "bg-body-tertiary"
---
<div class="container">
@@ -20,32 +20,32 @@ body_class: "bg-light"
<div class="row g-3">
<div class="col-md-5 col-lg-4 order-md-last">
<h4 class="d-flex justify-content-between align-items-center mb-3">
- <span class="text-muted">عربة التسوق</span>
+ <span class="text-body-secondary">عربة التسوق</span>
<span class="badge bg-secondary rounded-pill">3</span>
</h4>
<ul class="list-group mb-3">
<li class="list-group-item d-flex justify-content-between lh-sm">
<div>
<h6 class="my-0">اسم المنتج</h6>
- <small class="text-muted">وصف مختصر</small>
+ <small class="text-body-secondary">وصف مختصر</small>
</div>
- <span class="text-muted">$12</span>
+ <span class="text-body-secondary">$12</span>
</li>
<li class="list-group-item d-flex justify-content-between lh-sm">
<div>
<h6 class="my-0">المنتج الثاني</h6>
- <small class="text-muted">وصف مختصر</small>
+ <small class="text-body-secondary">وصف مختصر</small>
</div>
- <span class="text-muted">$8</span>
+ <span class="text-body-secondary">$8</span>
</li>
<li class="list-group-item d-flex justify-content-between lh-sm">
<div>
<h6 class="my-0">البند الثالث</h6>
- <small class="text-muted">وصف مختصر</small>
+ <small class="text-body-secondary">وصف مختصر</small>
</div>
- <span class="text-muted">$5</span>
+ <span class="text-body-secondary">$5</span>
</li>
- <li class="list-group-item d-flex justify-content-between bg-light">
+ <li class="list-group-item d-flex justify-content-between bg-body-tertiary">
<div class="text-success">
<h6 class="my-0">رمز ترويجي</h6>
<small>EXAMPLECODE</small>
@@ -97,7 +97,7 @@ body_class: "bg-light"
</div>
<div class="col-12">
- <label for="email" class="form-label">البريد الإلكتروني <span class="text-muted">(اختياري)</span></label>
+ <label for="email" class="form-label">البريد الإلكتروني <span class="text-body-secondary">(اختياري)</span></label>
<input type="email" class="form-control" id="email" placeholder="you@example.com">
<div class="invalid-feedback">
يرجى إدخال عنوان بريد إلكتروني صحيح لتصلكم تحديثات الشحن.
@@ -113,7 +113,7 @@ body_class: "bg-light"
</div>
<div class="col-12">
- <label for="address2" class="form-label">عنوان 2 <span class="text-muted">(اختياري)</span></label>
+ <label for="address2" class="form-label">عنوان 2 <span class="text-body-secondary">(اختياري)</span></label>
<input type="text" class="form-control" id="address2" placeholder="شقة 24">
</div>
@@ -183,7 +183,7 @@ body_class: "bg-light"
<div class="col-md-6">
<label for="cc-name" class="form-label">الاسم على البطاقة</label>
<input type="text" class="form-control" id="cc-name" placeholder="" required>
- <small class="text-muted">الاسم الكامل كما هو معروض على البطاقة</small>
+ <small class="text-body-secondary">الاسم الكامل كما هو معروض على البطاقة</small>
<div class="invalid-feedback">
الاسم على البطاقة مطلوب
</div>
@@ -221,7 +221,7 @@ body_class: "bg-light"
</div>
</div>
</main>
- <footer class="my-5 pt-5 text-muted text-center text-small">
+ <footer class="my-5 pt-5 text-body-secondary text-center text-small">
<p class="mb-1">&copy; {{< year >}}-2017 اسم الشركة</p>
<ul class="list-inline">
<li class="list-inline-item"><a href="#">سياسة الخصوصية</a></li>
diff --git a/site/content/docs/5.2/examples/checkout/form-validation.css b/site/content/docs/5.3/examples/checkout/checkout.css
index e5ea31c..e5ea31c 100644
--- a/site/content/docs/5.2/examples/checkout/form-validation.css
+++ b/site/content/docs/5.3/examples/checkout/checkout.css
diff --git a/site/content/docs/5.2/examples/checkout/form-validation.js b/site/content/docs/5.3/examples/checkout/checkout.js
index 30ea0aa..30ea0aa 100644
--- a/site/content/docs/5.2/examples/checkout/form-validation.js
+++ b/site/content/docs/5.3/examples/checkout/checkout.js
diff --git a/site/content/docs/5.2/examples/checkout/index.html b/site/content/docs/5.3/examples/checkout/index.html
index 4809dc4..d39f0f2 100644
--- a/site/content/docs/5.2/examples/checkout/index.html
+++ b/site/content/docs/5.3/examples/checkout/index.html
@@ -2,10 +2,10 @@
layout: examples
title: Checkout example
extra_css:
- - "form-validation.css"
+ - "checkout.css"
extra_js:
- - src: "form-validation.js"
-body_class: "bg-light"
+ - src: "checkout.js"
+body_class: "bg-body-tertiary"
---
<div class="container">
@@ -26,25 +26,25 @@ body_class: "bg-light"
<li class="list-group-item d-flex justify-content-between lh-sm">
<div>
<h6 class="my-0">Product name</h6>
- <small class="text-muted">Brief description</small>
+ <small class="text-body-secondary">Brief description</small>
</div>
- <span class="text-muted">$12</span>
+ <span class="text-body-secondary">$12</span>
</li>
<li class="list-group-item d-flex justify-content-between lh-sm">
<div>
<h6 class="my-0">Second product</h6>
- <small class="text-muted">Brief description</small>
+ <small class="text-body-secondary">Brief description</small>
</div>
- <span class="text-muted">$8</span>
+ <span class="text-body-secondary">$8</span>
</li>
<li class="list-group-item d-flex justify-content-between lh-sm">
<div>
<h6 class="my-0">Third item</h6>
- <small class="text-muted">Brief description</small>
+ <small class="text-body-secondary">Brief description</small>
</div>
- <span class="text-muted">$5</span>
+ <span class="text-body-secondary">$5</span>
</li>
- <li class="list-group-item d-flex justify-content-between bg-light">
+ <li class="list-group-item d-flex justify-content-between bg-body-tertiary">
<div class="text-success">
<h6 class="my-0">Promo code</h6>
<small>EXAMPLECODE</small>
@@ -96,7 +96,7 @@ body_class: "bg-light"
</div>
<div class="col-12">
- <label for="email" class="form-label">Email <span class="text-muted">(Optional)</span></label>
+ <label for="email" class="form-label">Email <span class="text-body-secondary">(Optional)</span></label>
<input type="email" class="form-control" id="email" placeholder="you@example.com">
<div class="invalid-feedback">
Please enter a valid email address for shipping updates.
@@ -112,7 +112,7 @@ body_class: "bg-light"
</div>
<div class="col-12">
- <label for="address2" class="form-label">Address 2 <span class="text-muted">(Optional)</span></label>
+ <label for="address2" class="form-label">Address 2 <span class="text-body-secondary">(Optional)</span></label>
<input type="text" class="form-control" id="address2" placeholder="Apartment or suite">
</div>
@@ -182,7 +182,7 @@ body_class: "bg-light"
<div class="col-md-6">
<label for="cc-name" class="form-label">Name on card</label>
<input type="text" class="form-control" id="cc-name" placeholder="" required>
- <small class="text-muted">Full name as displayed on card</small>
+ <small class="text-body-secondary">Full name as displayed on card</small>
<div class="invalid-feedback">
Name on card is required
</div>
@@ -221,7 +221,7 @@ body_class: "bg-light"
</div>
</main>
- <footer class="my-5 pt-5 text-muted text-center text-small">
+ <footer class="my-5 pt-5 text-body-secondary text-center text-small">
<p class="mb-1">&copy; 2017–{{< year >}} Company Name</p>
<ul class="list-inline">
<li class="list-inline-item"><a href="#">Privacy</a></li>
diff --git a/site/content/docs/5.2/examples/cover/cover.css b/site/content/docs/5.3/examples/cover/cover.css
index 1b1c540..2e7aef8 100644
--- a/site/content/docs/5.2/examples/cover/cover.css
+++ b/site/content/docs/5.3/examples/cover/cover.css
@@ -4,9 +4,9 @@
/* Custom default button */
-.btn-secondary,
-.btn-secondary:hover,
-.btn-secondary:focus {
+.btn-light,
+.btn-light:hover,
+.btn-light:focus {
color: #333;
text-shadow: none; /* Prevent inheritance from `body` */
}
diff --git a/site/content/docs/5.2/examples/cover/index.html b/site/content/docs/5.3/examples/cover/index.html
index 34dc1c2..002a5c3 100644
--- a/site/content/docs/5.2/examples/cover/index.html
+++ b/site/content/docs/5.3/examples/cover/index.html
@@ -5,7 +5,6 @@ extra_css:
- "cover.css"
html_class: "h-100"
body_class: "d-flex h-100 text-center text-bg-dark"
-include_js: false
---
<div class="cover-container d-flex w-100 h-100 p-3 mx-auto flex-column">
@@ -24,7 +23,7 @@ include_js: false
<h1>Cover your page.</h1>
<p class="lead">Cover is a one-page template for building simple and beautiful home pages. Download, edit the text, and add your own fullscreen background photo to make it your own.</p>
<p class="lead">
- <a href="#" class="btn btn-lg btn-secondary fw-bold border-white bg-white">Learn more</a>
+ <a href="#" class="btn btn-lg btn-light fw-bold border-white bg-white">Learn more</a>
</p>
</main>
diff --git a/site/content/docs/5.2/examples/dashboard-rtl/dashboard.js b/site/content/docs/5.3/examples/dashboard-rtl/dashboard.js
index 96e0895..bdb3029 100644
--- a/site/content/docs/5.2/examples/dashboard-rtl/dashboard.js
+++ b/site/content/docs/5.3/examples/dashboard-rtl/dashboard.js
@@ -1,10 +1,8 @@
-/* globals Chart:false, feather:false */
+/* globals Chart:false */
(() => {
'use strict'
- feather.replace({ 'aria-hidden': 'true' })
-
// Graphs
const ctx = document.getElementById('myChart')
// eslint-disable-next-line no-unused-vars
@@ -38,15 +36,13 @@
}]
},
options: {
- scales: {
- yAxes: [{
- ticks: {
- beginAtZero: false
- }
- }]
- },
- legend: {
- display: false
+ plugins: {
+ legend: {
+ display: false
+ },
+ tooltip: {
+ boxPadding: 3
+ }
}
}
})
diff --git a/site/content/docs/5.3/examples/dashboard-rtl/index.html b/site/content/docs/5.3/examples/dashboard-rtl/index.html
new file mode 100644
index 0000000..252b775
--- /dev/null
+++ b/site/content/docs/5.3/examples/dashboard-rtl/index.html
@@ -0,0 +1,333 @@
+---
+layout: examples
+title: قالب لوحة القيادة
+direction: rtl
+extra_css:
+ - "https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.3/font/bootstrap-icons.css"
+ - "../dashboard/dashboard.rtl.css"
+extra_js:
+ - src: "https://cdn.jsdelivr.net/npm/chart.js@4.2.1/dist/chart.umd.min.js"
+ integrity: "sha384-gdQErvCNWvHQZj6XZM0dNsAoY4v+j5P1XDpNkcM3HJG1Yx04ecqIHk7+4VBOCHOG"
+ - src: "dashboard.js"
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="calendar3" viewBox="0 0 16 16">
+ <path d="M14 0H2a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V2a2 2 0 0 0-2-2zM1 3.857C1 3.384 1.448 3 2 3h12c.552 0 1 .384 1 .857v10.286c0 .473-.448.857-1 .857H2c-.552 0-1-.384-1-.857V3.857z"/>
+ <path d="M6.5 7a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2z"/>
+ </symbol>
+ <symbol id="cart" viewBox="0 0 16 16">
+ <path d="M0 1.5A.5.5 0 0 1 .5 1H2a.5.5 0 0 1 .485.379L2.89 3H14.5a.5.5 0 0 1 .49.598l-1 5a.5.5 0 0 1-.465.401l-9.397.472L4.415 11H13a.5.5 0 0 1 0 1H4a.5.5 0 0 1-.491-.408L2.01 3.607 1.61 2H.5a.5.5 0 0 1-.5-.5zM3.102 4l.84 4.479 9.144-.459L13.89 4H3.102zM5 12a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm7 0a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm-7 1a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm7 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
+ </symbol>
+ <symbol id="chevron-right" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z"/>
+ </symbol>
+ <symbol id="door-closed" viewBox="0 0 16 16">
+ <path d="M3 2a1 1 0 0 1 1-1h8a1 1 0 0 1 1 1v13h1.5a.5.5 0 0 1 0 1h-13a.5.5 0 0 1 0-1H3V2zm1 13h8V2H4v13z"/>
+ <path d="M9 9a1 1 0 1 0 2 0 1 1 0 0 0-2 0z"/>
+ </symbol>
+ <symbol id="file-earmark" viewBox="0 0 16 16">
+ <path d="M14 4.5V14a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V2a2 2 0 0 1 2-2h5.5L14 4.5zm-3 0A1.5 1.5 0 0 1 9.5 3V1H4a1 1 0 0 0-1 1v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1V4.5h-2z"/>
+ </symbol>
+ <symbol id="file-earmark-text" viewBox="0 0 16 16">
+ <path d="M5.5 7a.5.5 0 0 0 0 1h5a.5.5 0 0 0 0-1h-5zM5 9.5a.5.5 0 0 1 .5-.5h5a.5.5 0 0 1 0 1h-5a.5.5 0 0 1-.5-.5zm0 2a.5.5 0 0 1 .5-.5h2a.5.5 0 0 1 0 1h-2a.5.5 0 0 1-.5-.5z"/>
+ <path d="M9.5 0H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V4.5L9.5 0zm0 1v2A1.5 1.5 0 0 0 11 4.5h2V14a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V2a1 1 0 0 1 1-1h5.5z"/>
+ </symbol>
+ <symbol id="gear-wide-connected" viewBox="0 0 16 16">
+ <path d="M7.068.727c.243-.97 1.62-.97 1.864 0l.071.286a.96.96 0 0 0 1.622.434l.205-.211c.695-.719 1.888-.03 1.613.931l-.08.284a.96.96 0 0 0 1.187 1.187l.283-.081c.96-.275 1.65.918.931 1.613l-.211.205a.96.96 0 0 0 .434 1.622l.286.071c.97.243.97 1.62 0 1.864l-.286.071a.96.96 0 0 0-.434 1.622l.211.205c.719.695.03 1.888-.931 1.613l-.284-.08a.96.96 0 0 0-1.187 1.187l.081.283c.275.96-.918 1.65-1.613.931l-.205-.211a.96.96 0 0 0-1.622.434l-.071.286c-.243.97-1.62.97-1.864 0l-.071-.286a.96.96 0 0 0-1.622-.434l-.205.211c-.695.719-1.888.03-1.613-.931l.08-.284a.96.96 0 0 0-1.186-1.187l-.284.081c-.96.275-1.65-.918-.931-1.613l.211-.205a.96.96 0 0 0-.434-1.622l-.286-.071c-.97-.243-.97-1.62 0-1.864l.286-.071a.96.96 0 0 0 .434-1.622l-.211-.205c-.719-.695-.03-1.888.931-1.613l.284.08a.96.96 0 0 0 1.187-1.186l-.081-.284c-.275-.96.918-1.65 1.613-.931l.205.211a.96.96 0 0 0 1.622-.434l.071-.286zM12.973 8.5H8.25l-2.834 3.779A4.998 4.998 0 0 0 12.973 8.5zm0-1a4.998 4.998 0 0 0-7.557-3.779l2.834 3.78h4.723zM5.048 3.967c-.03.021-.058.043-.087.065l.087-.065zm-.431.355A4.984 4.984 0 0 0 3.002 8c0 1.455.622 2.765 1.615 3.678L7.375 8 4.617 4.322zm.344 7.646.087.065-.087-.065z"/>
+ </symbol>
+ <symbol id="graph-up" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M0 0h1v15h15v1H0V0Zm14.817 3.113a.5.5 0 0 1 .07.704l-4.5 5.5a.5.5 0 0 1-.74.037L7.06 6.767l-3.656 5.027a.5.5 0 0 1-.808-.588l4-5.5a.5.5 0 0 1 .758-.06l2.609 2.61 4.15-5.073a.5.5 0 0 1 .704-.07Z"/>
+ </symbol>
+ <symbol id="house-fill" viewBox="0 0 16 16">
+ <path d="M8.707 1.5a1 1 0 0 0-1.414 0L.646 8.146a.5.5 0 0 0 .708.708L8 2.207l6.646 6.647a.5.5 0 0 0 .708-.708L13 5.793V2.5a.5.5 0 0 0-.5-.5h-1a.5.5 0 0 0-.5.5v1.293L8.707 1.5Z"/>
+ <path d="m8 3.293 6 6V13.5a1.5 1.5 0 0 1-1.5 1.5h-9A1.5 1.5 0 0 1 2 13.5V9.293l6-6Z"/>
+ </symbol>
+ <symbol id="list" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M2.5 12a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5z"/>
+ </symbol>
+ <symbol id="people" viewBox="0 0 16 16">
+ <path d="M15 14s1 0 1-1-1-4-5-4-5 3-5 4 1 1 1 1h8Zm-7.978-1A.261.261 0 0 1 7 12.996c.001-.264.167-1.03.76-1.72C8.312 10.629 9.282 10 11 10c1.717 0 2.687.63 3.24 1.276.593.69.758 1.457.76 1.72l-.008.002a.274.274 0 0 1-.014.002H7.022ZM11 7a2 2 0 1 0 0-4 2 2 0 0 0 0 4Zm3-2a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM6.936 9.28a5.88 5.88 0 0 0-1.23-.247A7.35 7.35 0 0 0 5 9c-4 0-5 3-5 4 0 .667.333 1 1 1h4.216A2.238 2.238 0 0 1 5 13c0-1.01.377-2.042 1.09-2.904.243-.294.526-.569.846-.816ZM4.92 10A5.493 5.493 0 0 0 4 13H1c0-.26.164-1.03.76-1.724.545-.636 1.492-1.256 3.16-1.275ZM1.5 5.5a3 3 0 1 1 6 0 3 3 0 0 1-6 0Zm3-2a2 2 0 1 0 0 4 2 2 0 0 0 0-4Z"/>
+ </symbol>
+ <symbol id="plus-circle" viewBox="0 0 16 16">
+ <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
+ <path d="M8 4a.5.5 0 0 1 .5.5v3h3a.5.5 0 0 1 0 1h-3v3a.5.5 0 0 1-1 0v-3h-3a.5.5 0 0 1 0-1h3v-3A.5.5 0 0 1 8 4z"/>
+ </symbol>
+ <symbol id="puzzle" viewBox="0 0 16 16">
+ <path d="M3.112 3.645A1.5 1.5 0 0 1 4.605 2H7a.5.5 0 0 1 .5.5v.382c0 .696-.497 1.182-.872 1.469a.459.459 0 0 0-.115.118.113.113 0 0 0-.012.025L6.5 4.5v.003l.003.01c.004.01.014.028.036.053a.86.86 0 0 0 .27.194C7.09 4.9 7.51 5 8 5c.492 0 .912-.1 1.19-.24a.86.86 0 0 0 .271-.194.213.213 0 0 0 .039-.063v-.009a.112.112 0 0 0-.012-.025.459.459 0 0 0-.115-.118c-.375-.287-.872-.773-.872-1.469V2.5A.5.5 0 0 1 9 2h2.395a1.5 1.5 0 0 1 1.493 1.645L12.645 6.5h.237c.195 0 .42-.147.675-.48.21-.274.528-.52.943-.52.568 0 .947.447 1.154.862C15.877 6.807 16 7.387 16 8s-.123 1.193-.346 1.638c-.207.415-.586.862-1.154.862-.415 0-.733-.246-.943-.52-.255-.333-.48-.48-.675-.48h-.237l.243 2.855A1.5 1.5 0 0 1 11.395 14H9a.5.5 0 0 1-.5-.5v-.382c0-.696.497-1.182.872-1.469a.459.459 0 0 0 .115-.118.113.113 0 0 0 .012-.025L9.5 11.5v-.003a.214.214 0 0 0-.039-.064.859.859 0 0 0-.27-.193C8.91 11.1 8.49 11 8 11c-.491 0-.912.1-1.19.24a.859.859 0 0 0-.271.194.214.214 0 0 0-.039.063v.003l.001.006a.113.113 0 0 0 .012.025c.016.027.05.068.115.118.375.287.872.773.872 1.469v.382a.5.5 0 0 1-.5.5H4.605a1.5 1.5 0 0 1-1.493-1.645L3.356 9.5h-.238c-.195 0-.42.147-.675.48-.21.274-.528.52-.943.52-.568 0-.947-.447-1.154-.862C.123 9.193 0 8.613 0 8s.123-1.193.346-1.638C.553 5.947.932 5.5 1.5 5.5c.415 0 .733.246.943.52.255.333.48.48.675.48h.238l-.244-2.855zM4.605 3a.5.5 0 0 0-.498.55l.001.007.29 3.4A.5.5 0 0 1 3.9 7.5h-.782c-.696 0-1.182-.497-1.469-.872a.459.459 0 0 0-.118-.115.112.112 0 0 0-.025-.012L1.5 6.5h-.003a.213.213 0 0 0-.064.039.86.86 0 0 0-.193.27C1.1 7.09 1 7.51 1 8c0 .491.1.912.24 1.19.07.14.14.225.194.271a.213.213 0 0 0 .063.039H1.5l.006-.001a.112.112 0 0 0 .025-.012.459.459 0 0 0 .118-.115c.287-.375.773-.872 1.469-.872H3.9a.5.5 0 0 1 .498.542l-.29 3.408a.5.5 0 0 0 .497.55h1.878c-.048-.166-.195-.352-.463-.557-.274-.21-.52-.528-.52-.943 0-.568.447-.947.862-1.154C6.807 10.123 7.387 10 8 10s1.193.123 1.638.346c.415.207.862.586.862 1.154 0 .415-.246.733-.52.943-.268.205-.415.39-.463.557h1.878a.5.5 0 0 0 .498-.55l-.001-.007-.29-3.4A.5.5 0 0 1 12.1 8.5h.782c.696 0 1.182.497 1.469.872.05.065.091.099.118.115.013.008.021.01.025.012a.02.02 0 0 0 .006.001h.003a.214.214 0 0 0 .064-.039.86.86 0 0 0 .193-.27c.14-.28.24-.7.24-1.191 0-.492-.1-.912-.24-1.19a.86.86 0 0 0-.194-.271.215.215 0 0 0-.063-.039H14.5l-.006.001a.113.113 0 0 0-.025.012.459.459 0 0 0-.118.115c-.287.375-.773.872-1.469.872H12.1a.5.5 0 0 1-.498-.543l.29-3.407a.5.5 0 0 0-.497-.55H9.517c.048.166.195.352.463.557.274.21.52.528.52.943 0 .568-.447.947-.862 1.154C9.193 5.877 8.613 6 8 6s-1.193-.123-1.638-.346C5.947 5.447 5.5 5.068 5.5 4.5c0-.415.246-.733.52-.943.268-.205.415-.39.463-.557H4.605z"/>
+ </symbol>
+ <symbol id="search" viewBox="0 0 16 16">
+ <path d="M11.742 10.344a6.5 6.5 0 1 0-1.397 1.398h-.001c.03.04.062.078.098.115l3.85 3.85a1 1 0 0 0 1.415-1.414l-3.85-3.85a1.007 1.007 0 0 0-.115-.1zM12 6.5a5.5 5.5 0 1 1-11 0 5.5 5.5 0 0 1 11 0z"/>
+ </symbol>
+</svg>
+
+<header class="navbar sticky-top bg-dark flex-md-nowrap p-0 shadow" data-bs-theme="dark">
+ <a class="navbar-brand col-md-3 col-lg-2 me-0 px-3 fs-6 text-white" href="#">اسم الشركة</a>
+
+ <ul class="navbar-nav flex-row d-md-none">
+ <li class="nav-item text-nowrap">
+ <button class="nav-link px-3 text-white" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSearch" aria-controls="navbarSearch" aria-expanded="false" aria-label="تبديل البحث">
+ <svg class="bi"><use xlink:href="#search"/></svg>
+ </button>
+ </li>
+ <li class="nav-item text-nowrap">
+ <button class="nav-link px-3 text-white" type="button" data-bs-toggle="offcanvas" data-bs-target="#sidebarMenu" aria-controls="sidebarMenu" aria-expanded="false" aria-label="تبديل التنقل">
+ <svg class="bi"><use xlink:href="#list"/></svg>
+ </button>
+ </li>
+ </ul>
+
+ <div id="navbarSearch" class="navbar-search w-100 collapse">
+ <input class="form-control w-100 rounded-0 border-0" type="text" placeholder="بحث" aria-label="بحث">
+ </div>
+</header>
+
+<div class="container-fluid">
+ <div class="row">
+ <div class="sidebar border border-right col-md-3 col-lg-2 p-0 bg-body-tertiary">
+ <div class="offcanvas-lg offcanvas-end bg-body-tertiary" tabindex="-1" id="sidebarMenu" aria-labelledby="sidebarMenuLabel">
+ <div class="offcanvas-header">
+ <h5 class="offcanvas-title" id="sidebarMenuLabel">Company name</h5>
+ <button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#sidebarMenu" aria-label="يغلق"></button>
+ </div>
+ <div class="offcanvas-body d-md-flex flex-column p-0 pt-lg-3 overflow-y-auto">
+ <ul class="nav flex-column">
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2 active" aria-current="page" href="#">
+ <svg class="bi"><use xlink:href="#house-fill"/></svg>
+ لوحة القيادة
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark"/></svg>
+ الطلبات
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#cart"/></svg>
+ المنتجات
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#people"/></svg>
+ الزبائن
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#graph-up"/></svg>
+ التقارير
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#puzzle"/></svg>
+ التكاملات
+ </a>
+ </li>
+ </ul>
+
+ <h6 class="sidebar-heading d-flex justify-content-between align-items-center px-3 mt-4 mb-1 text-body-secondary text-uppercase">
+ <span>التقارير المحفوظة</span>
+ <a class="link-secondary" href="#" aria-label="إضافة تقرير جديد">
+ <svg class="bi"><use xlink:href="#plus-circle"/></svg>
+ </a>
+ </h6>
+ <ul class="nav flex-column mb-auto">
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ الشهر الحالي
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ الربع الأخير
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ التفاعل الإجتماعي
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ مبيعات نهاية العام
+ </a>
+ </li>
+ </ul>
+
+ <hr class="my-3">
+
+ <ul class="nav flex-column mb-auto">
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#gear-wide-connected"/></svg>
+ إعدادات
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#door-closed"/></svg>
+ خروج
+ </a>
+ </li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <main class="col-md-9 ms-sm-auto col-lg-10 px-md-4">
+ <div class="d-flex justify-content-between flex-wrap flex-md-nowrap align-items-center pt-3 pb-2 mb-3 border-bottom">
+ <h1 class="h2">لوحة القيادة</h1>
+ <div class="btn-toolbar mb-2 mb-md-0">
+ <div class="btn-group me-2">
+ <button type="button" class="btn btn-sm btn-outline-secondary">مشاركة</button>
+ <button type="button" class="btn btn-sm btn-outline-secondary">تصدير</button>
+ </div>
+ <button type="button" class="btn btn-sm btn-outline-secondary dropdown-toggle d-flex align-items-center gap-1">
+ <svg class="bi"><use xlink:href="#calendar3"/></svg>
+ هذا الأسبوع
+ </button>
+ </div>
+ </div>
+
+ <canvas class="my-4 w-100" id="myChart" width="900" height="380"></canvas>
+
+ <h2>عنوان القسم</h2>
+ <div class="table-responsive small">
+ <table class="table table-striped table-sm">
+ <thead>
+ <tr>
+ <th scope="col">#</th>
+ <th scope="col">عنوان</th>
+ <th scope="col">عنوان</th>
+ <th scope="col">عنوان</th>
+ <th scope="col">عنوان</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>1,001</td>
+ <td>بيانات</td>
+ <td>عشوائية</td>
+ <td>تثري</td>
+ <td>الجدول</td>
+ </tr>
+ <tr>
+ <td>1,002</td>
+ <td>تثري</td>
+ <td>مبهة</td>
+ <td>تصميم</td>
+ <td>تنسيق</td>
+ </tr>
+ <tr>
+ <td>1,003</td>
+ <td>عشوائية</td>
+ <td>غنية</td>
+ <td>قيمة</td>
+ <td>مفيدة</td>
+ </tr>
+ <tr>
+ <td>1,003</td>
+ <td>معلومات</td>
+ <td>تثري</td>
+ <td>توضيحية</td>
+ <td>عشوائية</td>
+ </tr>
+ <tr>
+ <td>1,004</td>
+ <td>الجدول</td>
+ <td>بيانات</td>
+ <td>تنسيق</td>
+ <td>قيمة</td>
+ </tr>
+ <tr>
+ <td>1,005</td>
+ <td>قيمة</td>
+ <td>مبهة</td>
+ <td>الجدول</td>
+ <td>تثري</td>
+ </tr>
+ <tr>
+ <td>1,006</td>
+ <td>قيمة</td>
+ <td>توضيحية</td>
+ <td>غنية</td>
+ <td>عشوائية</td>
+ </tr>
+ <tr>
+ <td>1,007</td>
+ <td>تثري</td>
+ <td>مفيدة</td>
+ <td>معلومات</td>
+ <td>مبهة</td>
+ </tr>
+ <tr>
+ <td>1,008</td>
+ <td>بيانات</td>
+ <td>عشوائية</td>
+ <td>تثري</td>
+ <td>الجدول</td>
+ </tr>
+ <tr>
+ <td>1,009</td>
+ <td>تثري</td>
+ <td>مبهة</td>
+ <td>تصميم</td>
+ <td>تنسيق</td>
+ </tr>
+ <tr>
+ <td>1,010</td>
+ <td>عشوائية</td>
+ <td>غنية</td>
+ <td>قيمة</td>
+ <td>مفيدة</td>
+ </tr>
+ <tr>
+ <td>1,011</td>
+ <td>معلومات</td>
+ <td>تثري</td>
+ <td>توضيحية</td>
+ <td>عشوائية</td>
+ </tr>
+ <tr>
+ <td>1,012</td>
+ <td>الجدول</td>
+ <td>تثري</td>
+ <td>تنسيق</td>
+ <td>قيمة</td>
+ </tr>
+ <tr>
+ <td>1,013</td>
+ <td>قيمة</td>
+ <td>مبهة</td>
+ <td>الجدول</td>
+ <td>تصميم</td>
+ </tr>
+ <tr>
+ <td>1,014</td>
+ <td>قيمة</td>
+ <td>توضيحية</td>
+ <td>غنية</td>
+ <td>عشوائية</td>
+ </tr>
+ <tr>
+ <td>1,015</td>
+ <td>بيانات</td>
+ <td>مفيدة</td>
+ <td>معلومات</td>
+ <td>الجدول</td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ </main>
+ </div>
+</div>
diff --git a/site/content/docs/5.3/examples/dashboard/dashboard.css b/site/content/docs/5.3/examples/dashboard/dashboard.css
new file mode 100644
index 0000000..154940c
--- /dev/null
+++ b/site/content/docs/5.3/examples/dashboard/dashboard.css
@@ -0,0 +1,48 @@
+.bi {
+ display: inline-block;
+ width: 1rem;
+ height: 1rem;
+}
+
+/*
+ * Sidebar
+ */
+
+@media (min-width: 768px) {
+ .sidebar .offcanvas-lg {
+ position: -webkit-sticky;
+ position: sticky;
+ top: 48px;
+ }
+ .navbar-search {
+ display: block;
+ }
+}
+
+.sidebar .nav-link {
+ font-size: .875rem;
+ font-weight: 500;
+}
+
+.sidebar .nav-link.active {
+ color: #2470dc;
+}
+
+.sidebar-heading {
+ font-size: .75rem;
+}
+
+/*
+ * Navbar
+ */
+
+.navbar-brand {
+ padding-top: .75rem;
+ padding-bottom: .75rem;
+ background-color: rgba(0, 0, 0, .25);
+ box-shadow: inset -1px 0 0 rgba(0, 0, 0, .25);
+}
+
+.navbar .form-control {
+ padding: .75rem 1rem;
+}
diff --git a/site/content/docs/5.2/examples/dashboard/dashboard.js b/site/content/docs/5.3/examples/dashboard/dashboard.js
index e137975..a60b393 100644
--- a/site/content/docs/5.2/examples/dashboard/dashboard.js
+++ b/site/content/docs/5.3/examples/dashboard/dashboard.js
@@ -1,10 +1,8 @@
-/* globals Chart:false, feather:false */
+/* globals Chart:false */
(() => {
'use strict'
- feather.replace({ 'aria-hidden': 'true' })
-
// Graphs
const ctx = document.getElementById('myChart')
// eslint-disable-next-line no-unused-vars
@@ -38,15 +36,13 @@
}]
},
options: {
- scales: {
- yAxes: [{
- ticks: {
- beginAtZero: false
- }
- }]
- },
- legend: {
- display: false
+ plugins: {
+ legend: {
+ display: false
+ },
+ tooltip: {
+ boxPadding: 3
+ }
}
}
})
diff --git a/site/content/docs/5.3/examples/dashboard/dashboard.rtl.css b/site/content/docs/5.3/examples/dashboard/dashboard.rtl.css
new file mode 100644
index 0000000..5c8a7e2
--- /dev/null
+++ b/site/content/docs/5.3/examples/dashboard/dashboard.rtl.css
@@ -0,0 +1,48 @@
+.bi {
+ display: inline-block;
+ width: 1rem;
+ height: 1rem;
+}
+
+/*
+ * Sidebar
+ */
+
+@media (min-width: 768px) {
+ .sidebar .offcanvas-lg {
+ position: -webkit-sticky;
+ position: sticky;
+ top: 48px;
+ }
+ .navbar-search {
+ display: block;
+ }
+}
+
+.sidebar .nav-link {
+ font-size: .875rem;
+ font-weight: 500;
+}
+
+.sidebar .nav-link.active {
+ color: #2470dc;
+}
+
+.sidebar-heading {
+ font-size: .75rem;
+}
+
+/*
+ * Navbar
+ */
+
+.navbar-brand {
+ padding-top: .75rem;
+ padding-bottom: .75rem;
+ background-color: rgba(0, 0, 0, .25);
+ box-shadow: inset 1px 0 0 rgba(0, 0, 0, .25);
+}
+
+.navbar .form-control {
+ padding: .75rem 1rem;
+}
diff --git a/site/content/docs/5.3/examples/dashboard/index.html b/site/content/docs/5.3/examples/dashboard/index.html
new file mode 100644
index 0000000..4ae3f6f
--- /dev/null
+++ b/site/content/docs/5.3/examples/dashboard/index.html
@@ -0,0 +1,332 @@
+---
+layout: examples
+title: Dashboard Template
+extra_css:
+ - "https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.3/font/bootstrap-icons.css"
+ - "dashboard.css"
+extra_js:
+ - src: "https://cdn.jsdelivr.net/npm/chart.js@4.2.1/dist/chart.umd.min.js"
+ integrity: "sha384-gdQErvCNWvHQZj6XZM0dNsAoY4v+j5P1XDpNkcM3HJG1Yx04ecqIHk7+4VBOCHOG"
+ - src: "dashboard.js"
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="calendar3" viewBox="0 0 16 16">
+ <path d="M14 0H2a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V2a2 2 0 0 0-2-2zM1 3.857C1 3.384 1.448 3 2 3h12c.552 0 1 .384 1 .857v10.286c0 .473-.448.857-1 .857H2c-.552 0-1-.384-1-.857V3.857z"/>
+ <path d="M6.5 7a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2z"/>
+ </symbol>
+ <symbol id="cart" viewBox="0 0 16 16">
+ <path d="M0 1.5A.5.5 0 0 1 .5 1H2a.5.5 0 0 1 .485.379L2.89 3H14.5a.5.5 0 0 1 .49.598l-1 5a.5.5 0 0 1-.465.401l-9.397.472L4.415 11H13a.5.5 0 0 1 0 1H4a.5.5 0 0 1-.491-.408L2.01 3.607 1.61 2H.5a.5.5 0 0 1-.5-.5zM3.102 4l.84 4.479 9.144-.459L13.89 4H3.102zM5 12a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm7 0a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm-7 1a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm7 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
+ </symbol>
+ <symbol id="chevron-right" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z"/>
+ </symbol>
+ <symbol id="door-closed" viewBox="0 0 16 16">
+ <path d="M3 2a1 1 0 0 1 1-1h8a1 1 0 0 1 1 1v13h1.5a.5.5 0 0 1 0 1h-13a.5.5 0 0 1 0-1H3V2zm1 13h8V2H4v13z"/>
+ <path d="M9 9a1 1 0 1 0 2 0 1 1 0 0 0-2 0z"/>
+ </symbol>
+ <symbol id="file-earmark" viewBox="0 0 16 16">
+ <path d="M14 4.5V14a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V2a2 2 0 0 1 2-2h5.5L14 4.5zm-3 0A1.5 1.5 0 0 1 9.5 3V1H4a1 1 0 0 0-1 1v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1V4.5h-2z"/>
+ </symbol>
+ <symbol id="file-earmark-text" viewBox="0 0 16 16">
+ <path d="M5.5 7a.5.5 0 0 0 0 1h5a.5.5 0 0 0 0-1h-5zM5 9.5a.5.5 0 0 1 .5-.5h5a.5.5 0 0 1 0 1h-5a.5.5 0 0 1-.5-.5zm0 2a.5.5 0 0 1 .5-.5h2a.5.5 0 0 1 0 1h-2a.5.5 0 0 1-.5-.5z"/>
+ <path d="M9.5 0H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V4.5L9.5 0zm0 1v2A1.5 1.5 0 0 0 11 4.5h2V14a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V2a1 1 0 0 1 1-1h5.5z"/>
+ </symbol>
+ <symbol id="gear-wide-connected" viewBox="0 0 16 16">
+ <path d="M7.068.727c.243-.97 1.62-.97 1.864 0l.071.286a.96.96 0 0 0 1.622.434l.205-.211c.695-.719 1.888-.03 1.613.931l-.08.284a.96.96 0 0 0 1.187 1.187l.283-.081c.96-.275 1.65.918.931 1.613l-.211.205a.96.96 0 0 0 .434 1.622l.286.071c.97.243.97 1.62 0 1.864l-.286.071a.96.96 0 0 0-.434 1.622l.211.205c.719.695.03 1.888-.931 1.613l-.284-.08a.96.96 0 0 0-1.187 1.187l.081.283c.275.96-.918 1.65-1.613.931l-.205-.211a.96.96 0 0 0-1.622.434l-.071.286c-.243.97-1.62.97-1.864 0l-.071-.286a.96.96 0 0 0-1.622-.434l-.205.211c-.695.719-1.888.03-1.613-.931l.08-.284a.96.96 0 0 0-1.186-1.187l-.284.081c-.96.275-1.65-.918-.931-1.613l.211-.205a.96.96 0 0 0-.434-1.622l-.286-.071c-.97-.243-.97-1.62 0-1.864l.286-.071a.96.96 0 0 0 .434-1.622l-.211-.205c-.719-.695-.03-1.888.931-1.613l.284.08a.96.96 0 0 0 1.187-1.186l-.081-.284c-.275-.96.918-1.65 1.613-.931l.205.211a.96.96 0 0 0 1.622-.434l.071-.286zM12.973 8.5H8.25l-2.834 3.779A4.998 4.998 0 0 0 12.973 8.5zm0-1a4.998 4.998 0 0 0-7.557-3.779l2.834 3.78h4.723zM5.048 3.967c-.03.021-.058.043-.087.065l.087-.065zm-.431.355A4.984 4.984 0 0 0 3.002 8c0 1.455.622 2.765 1.615 3.678L7.375 8 4.617 4.322zm.344 7.646.087.065-.087-.065z"/>
+ </symbol>
+ <symbol id="graph-up" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M0 0h1v15h15v1H0V0Zm14.817 3.113a.5.5 0 0 1 .07.704l-4.5 5.5a.5.5 0 0 1-.74.037L7.06 6.767l-3.656 5.027a.5.5 0 0 1-.808-.588l4-5.5a.5.5 0 0 1 .758-.06l2.609 2.61 4.15-5.073a.5.5 0 0 1 .704-.07Z"/>
+ </symbol>
+ <symbol id="house-fill" viewBox="0 0 16 16">
+ <path d="M8.707 1.5a1 1 0 0 0-1.414 0L.646 8.146a.5.5 0 0 0 .708.708L8 2.207l6.646 6.647a.5.5 0 0 0 .708-.708L13 5.793V2.5a.5.5 0 0 0-.5-.5h-1a.5.5 0 0 0-.5.5v1.293L8.707 1.5Z"/>
+ <path d="m8 3.293 6 6V13.5a1.5 1.5 0 0 1-1.5 1.5h-9A1.5 1.5 0 0 1 2 13.5V9.293l6-6Z"/>
+ </symbol>
+ <symbol id="list" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M2.5 12a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h10a.5.5 0 0 1 0 1H3a.5.5 0 0 1-.5-.5z"/>
+ </symbol>
+ <symbol id="people" viewBox="0 0 16 16">
+ <path d="M15 14s1 0 1-1-1-4-5-4-5 3-5 4 1 1 1 1h8Zm-7.978-1A.261.261 0 0 1 7 12.996c.001-.264.167-1.03.76-1.72C8.312 10.629 9.282 10 11 10c1.717 0 2.687.63 3.24 1.276.593.69.758 1.457.76 1.72l-.008.002a.274.274 0 0 1-.014.002H7.022ZM11 7a2 2 0 1 0 0-4 2 2 0 0 0 0 4Zm3-2a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM6.936 9.28a5.88 5.88 0 0 0-1.23-.247A7.35 7.35 0 0 0 5 9c-4 0-5 3-5 4 0 .667.333 1 1 1h4.216A2.238 2.238 0 0 1 5 13c0-1.01.377-2.042 1.09-2.904.243-.294.526-.569.846-.816ZM4.92 10A5.493 5.493 0 0 0 4 13H1c0-.26.164-1.03.76-1.724.545-.636 1.492-1.256 3.16-1.275ZM1.5 5.5a3 3 0 1 1 6 0 3 3 0 0 1-6 0Zm3-2a2 2 0 1 0 0 4 2 2 0 0 0 0-4Z"/>
+ </symbol>
+ <symbol id="plus-circle" viewBox="0 0 16 16">
+ <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
+ <path d="M8 4a.5.5 0 0 1 .5.5v3h3a.5.5 0 0 1 0 1h-3v3a.5.5 0 0 1-1 0v-3h-3a.5.5 0 0 1 0-1h3v-3A.5.5 0 0 1 8 4z"/>
+ </symbol>
+ <symbol id="puzzle" viewBox="0 0 16 16">
+ <path d="M3.112 3.645A1.5 1.5 0 0 1 4.605 2H7a.5.5 0 0 1 .5.5v.382c0 .696-.497 1.182-.872 1.469a.459.459 0 0 0-.115.118.113.113 0 0 0-.012.025L6.5 4.5v.003l.003.01c.004.01.014.028.036.053a.86.86 0 0 0 .27.194C7.09 4.9 7.51 5 8 5c.492 0 .912-.1 1.19-.24a.86.86 0 0 0 .271-.194.213.213 0 0 0 .039-.063v-.009a.112.112 0 0 0-.012-.025.459.459 0 0 0-.115-.118c-.375-.287-.872-.773-.872-1.469V2.5A.5.5 0 0 1 9 2h2.395a1.5 1.5 0 0 1 1.493 1.645L12.645 6.5h.237c.195 0 .42-.147.675-.48.21-.274.528-.52.943-.52.568 0 .947.447 1.154.862C15.877 6.807 16 7.387 16 8s-.123 1.193-.346 1.638c-.207.415-.586.862-1.154.862-.415 0-.733-.246-.943-.52-.255-.333-.48-.48-.675-.48h-.237l.243 2.855A1.5 1.5 0 0 1 11.395 14H9a.5.5 0 0 1-.5-.5v-.382c0-.696.497-1.182.872-1.469a.459.459 0 0 0 .115-.118.113.113 0 0 0 .012-.025L9.5 11.5v-.003a.214.214 0 0 0-.039-.064.859.859 0 0 0-.27-.193C8.91 11.1 8.49 11 8 11c-.491 0-.912.1-1.19.24a.859.859 0 0 0-.271.194.214.214 0 0 0-.039.063v.003l.001.006a.113.113 0 0 0 .012.025c.016.027.05.068.115.118.375.287.872.773.872 1.469v.382a.5.5 0 0 1-.5.5H4.605a1.5 1.5 0 0 1-1.493-1.645L3.356 9.5h-.238c-.195 0-.42.147-.675.48-.21.274-.528.52-.943.52-.568 0-.947-.447-1.154-.862C.123 9.193 0 8.613 0 8s.123-1.193.346-1.638C.553 5.947.932 5.5 1.5 5.5c.415 0 .733.246.943.52.255.333.48.48.675.48h.238l-.244-2.855zM4.605 3a.5.5 0 0 0-.498.55l.001.007.29 3.4A.5.5 0 0 1 3.9 7.5h-.782c-.696 0-1.182-.497-1.469-.872a.459.459 0 0 0-.118-.115.112.112 0 0 0-.025-.012L1.5 6.5h-.003a.213.213 0 0 0-.064.039.86.86 0 0 0-.193.27C1.1 7.09 1 7.51 1 8c0 .491.1.912.24 1.19.07.14.14.225.194.271a.213.213 0 0 0 .063.039H1.5l.006-.001a.112.112 0 0 0 .025-.012.459.459 0 0 0 .118-.115c.287-.375.773-.872 1.469-.872H3.9a.5.5 0 0 1 .498.542l-.29 3.408a.5.5 0 0 0 .497.55h1.878c-.048-.166-.195-.352-.463-.557-.274-.21-.52-.528-.52-.943 0-.568.447-.947.862-1.154C6.807 10.123 7.387 10 8 10s1.193.123 1.638.346c.415.207.862.586.862 1.154 0 .415-.246.733-.52.943-.268.205-.415.39-.463.557h1.878a.5.5 0 0 0 .498-.55l-.001-.007-.29-3.4A.5.5 0 0 1 12.1 8.5h.782c.696 0 1.182.497 1.469.872.05.065.091.099.118.115.013.008.021.01.025.012a.02.02 0 0 0 .006.001h.003a.214.214 0 0 0 .064-.039.86.86 0 0 0 .193-.27c.14-.28.24-.7.24-1.191 0-.492-.1-.912-.24-1.19a.86.86 0 0 0-.194-.271.215.215 0 0 0-.063-.039H14.5l-.006.001a.113.113 0 0 0-.025.012.459.459 0 0 0-.118.115c-.287.375-.773.872-1.469.872H12.1a.5.5 0 0 1-.498-.543l.29-3.407a.5.5 0 0 0-.497-.55H9.517c.048.166.195.352.463.557.274.21.52.528.52.943 0 .568-.447.947-.862 1.154C9.193 5.877 8.613 6 8 6s-1.193-.123-1.638-.346C5.947 5.447 5.5 5.068 5.5 4.5c0-.415.246-.733.52-.943.268-.205.415-.39.463-.557H4.605z"/>
+ </symbol>
+ <symbol id="search" viewBox="0 0 16 16">
+ <path d="M11.742 10.344a6.5 6.5 0 1 0-1.397 1.398h-.001c.03.04.062.078.098.115l3.85 3.85a1 1 0 0 0 1.415-1.414l-3.85-3.85a1.007 1.007 0 0 0-.115-.1zM12 6.5a5.5 5.5 0 1 1-11 0 5.5 5.5 0 0 1 11 0z"/>
+ </symbol>
+</svg>
+
+<header class="navbar sticky-top bg-dark flex-md-nowrap p-0 shadow" data-bs-theme="dark">
+ <a class="navbar-brand col-md-3 col-lg-2 me-0 px-3 fs-6 text-white" href="#">Company name</a>
+
+ <ul class="navbar-nav flex-row d-md-none">
+ <li class="nav-item text-nowrap">
+ <button class="nav-link px-3 text-white" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSearch" aria-controls="navbarSearch" aria-expanded="false" aria-label="Toggle search">
+ <svg class="bi"><use xlink:href="#search"/></svg>
+ </button>
+ </li>
+ <li class="nav-item text-nowrap">
+ <button class="nav-link px-3 text-white" type="button" data-bs-toggle="offcanvas" data-bs-target="#sidebarMenu" aria-controls="sidebarMenu" aria-expanded="false" aria-label="Toggle navigation">
+ <svg class="bi"><use xlink:href="#list"/></svg>
+ </button>
+ </li>
+ </ul>
+
+ <div id="navbarSearch" class="navbar-search w-100 collapse">
+ <input class="form-control w-100 rounded-0 border-0" type="text" placeholder="Search" aria-label="Search">
+ </div>
+</header>
+
+<div class="container-fluid">
+ <div class="row">
+ <div class="sidebar border border-right col-md-3 col-lg-2 p-0 bg-body-tertiary">
+ <div class="offcanvas-lg offcanvas-end bg-body-tertiary" tabindex="-1" id="sidebarMenu" aria-labelledby="sidebarMenuLabel">
+ <div class="offcanvas-header">
+ <h5 class="offcanvas-title" id="sidebarMenuLabel">Company name</h5>
+ <button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#sidebarMenu" aria-label="Close"></button>
+ </div>
+ <div class="offcanvas-body d-md-flex flex-column p-0 pt-lg-3 overflow-y-auto">
+ <ul class="nav flex-column">
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2 active" aria-current="page" href="#">
+ <svg class="bi"><use xlink:href="#house-fill"/></svg>
+ Dashboard
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark"/></svg>
+ Orders
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#cart"/></svg>
+ Products
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#people"/></svg>
+ Customers
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#graph-up"/></svg>
+ Reports
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#puzzle"/></svg>
+ Integrations
+ </a>
+ </li>
+ </ul>
+
+ <h6 class="sidebar-heading d-flex justify-content-between align-items-center px-3 mt-4 mb-1 text-body-secondary text-uppercase">
+ <span>Saved reports</span>
+ <a class="link-secondary" href="#" aria-label="Add a new report">
+ <svg class="bi"><use xlink:href="#plus-circle"/></svg>
+ </a>
+ </h6>
+ <ul class="nav flex-column mb-auto">
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ Current month
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ Last quarter
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ Social engagement
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#file-earmark-text"/></svg>
+ Year-end sale
+ </a>
+ </li>
+ </ul>
+
+ <hr class="my-3">
+
+ <ul class="nav flex-column mb-auto">
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#gear-wide-connected"/></svg>
+ Settings
+ </a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link d-flex align-items-center gap-2" href="#">
+ <svg class="bi"><use xlink:href="#door-closed"/></svg>
+ Sign out
+ </a>
+ </li>
+ </ul>
+ </div>
+ </div>
+ </div>
+
+ <main class="col-md-9 ms-sm-auto col-lg-10 px-md-4">
+ <div class="d-flex justify-content-between flex-wrap flex-md-nowrap align-items-center pt-3 pb-2 mb-3 border-bottom">
+ <h1 class="h2">Dashboard</h1>
+ <div class="btn-toolbar mb-2 mb-md-0">
+ <div class="btn-group me-2">
+ <button type="button" class="btn btn-sm btn-outline-secondary">Share</button>
+ <button type="button" class="btn btn-sm btn-outline-secondary">Export</button>
+ </div>
+ <button type="button" class="btn btn-sm btn-outline-secondary dropdown-toggle d-flex align-items-center gap-1">
+ <svg class="bi"><use xlink:href="#calendar3"/></svg>
+ This week
+ </button>
+ </div>
+ </div>
+
+ <canvas class="my-4 w-100" id="myChart" width="900" height="380"></canvas>
+
+ <h2>Section title</h2>
+ <div class="table-responsive small">
+ <table class="table table-striped table-sm">
+ <thead>
+ <tr>
+ <th scope="col">#</th>
+ <th scope="col">Header</th>
+ <th scope="col">Header</th>
+ <th scope="col">Header</th>
+ <th scope="col">Header</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>1,001</td>
+ <td>random</td>
+ <td>data</td>
+ <td>placeholder</td>
+ <td>text</td>
+ </tr>
+ <tr>
+ <td>1,002</td>
+ <td>placeholder</td>
+ <td>irrelevant</td>
+ <td>visual</td>
+ <td>layout</td>
+ </tr>
+ <tr>
+ <td>1,003</td>
+ <td>data</td>
+ <td>rich</td>
+ <td>dashboard</td>
+ <td>tabular</td>
+ </tr>
+ <tr>
+ <td>1,003</td>
+ <td>information</td>
+ <td>placeholder</td>
+ <td>illustrative</td>
+ <td>data</td>
+ </tr>
+ <tr>
+ <td>1,004</td>
+ <td>text</td>
+ <td>random</td>
+ <td>layout</td>
+ <td>dashboard</td>
+ </tr>
+ <tr>
+ <td>1,005</td>
+ <td>dashboard</td>
+ <td>irrelevant</td>
+ <td>text</td>
+ <td>placeholder</td>
+ </tr>
+ <tr>
+ <td>1,006</td>
+ <td>dashboard</td>
+ <td>illustrative</td>
+ <td>rich</td>
+ <td>data</td>
+ </tr>
+ <tr>
+ <td>1,007</td>
+ <td>placeholder</td>
+ <td>tabular</td>
+ <td>information</td>
+ <td>irrelevant</td>
+ </tr>
+ <tr>
+ <td>1,008</td>
+ <td>random</td>
+ <td>data</td>
+ <td>placeholder</td>
+ <td>text</td>
+ </tr>
+ <tr>
+ <td>1,009</td>
+ <td>placeholder</td>
+ <td>irrelevant</td>
+ <td>visual</td>
+ <td>layout</td>
+ </tr>
+ <tr>
+ <td>1,010</td>
+ <td>data</td>
+ <td>rich</td>
+ <td>dashboard</td>
+ <td>tabular</td>
+ </tr>
+ <tr>
+ <td>1,011</td>
+ <td>information</td>
+ <td>placeholder</td>
+ <td>illustrative</td>
+ <td>data</td>
+ </tr>
+ <tr>
+ <td>1,012</td>
+ <td>text</td>
+ <td>placeholder</td>
+ <td>layout</td>
+ <td>dashboard</td>
+ </tr>
+ <tr>
+ <td>1,013</td>
+ <td>dashboard</td>
+ <td>irrelevant</td>
+ <td>text</td>
+ <td>visual</td>
+ </tr>
+ <tr>
+ <td>1,014</td>
+ <td>dashboard</td>
+ <td>illustrative</td>
+ <td>rich</td>
+ <td>data</td>
+ </tr>
+ <tr>
+ <td>1,015</td>
+ <td>random</td>
+ <td>tabular</td>
+ <td>information</td>
+ <td>text</td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ </main>
+ </div>
+</div>
diff --git a/site/content/docs/5.2/examples/dropdowns/dropdowns.css b/site/content/docs/5.3/examples/dropdowns/dropdowns.css
index 556f310..f633e2c 100644
--- a/site/content/docs/5.2/examples/dropdowns/dropdowns.css
+++ b/site/content/docs/5.3/examples/dropdowns/dropdowns.css
@@ -1,7 +1,3 @@
-.dropdown-menu {
- margin: 4rem auto;
-}
-
.dropdown-item-danger {
color: var(--bs-red);
}
@@ -15,12 +11,13 @@
}
.btn-hover-light {
- background-color: var(--bs-white);
+ color: var(--bs-body-color);
+ background-color: var(--bs-body-bg);
}
.btn-hover-light:hover,
.btn-hover-light:focus {
- color: var(--bs-blue);
- background-color: var(--bs-light);
+ color: var(--bs-link-hover-color);
+ background-color: var(--bs-tertiary-bg);
}
.cal-month,
@@ -46,22 +43,17 @@
}
.cal-btn:not([disabled]) {
font-weight: 500;
+ color: var(--bs-emphasis-color);
}
.cal-btn:hover,
.cal-btn:focus {
- background-color: rgba(0, 0, 0, .05);
+ background-color: var(--bs-secondary-bg);
}
.cal-btn[disabled] {
border: 0;
opacity: .5;
}
-.form-control-dark {
- background-color: rgba(255, 255, 255, .05);
- border-color: rgba(255, 255, 255, .15);
-}
-
-
.w-220px {
width: 220px;
}
@@ -74,6 +66,6 @@
width: 340px;
}
-.w-600px {
- width: 600px;
+.opacity-10 {
+ opacity: .1;
}
diff --git a/site/content/docs/5.3/examples/dropdowns/index.html b/site/content/docs/5.3/examples/dropdowns/index.html
new file mode 100644
index 0000000..3dac768
--- /dev/null
+++ b/site/content/docs/5.3/examples/dropdowns/index.html
@@ -0,0 +1,462 @@
+---
+layout: examples
+title: Dropdowns
+extra_css:
+ - "dropdowns.css"
+body_class: ""
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="film" viewBox="0 0 16 16">
+ <path d="M0 1a1 1 0 0 1 1-1h14a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H1a1 1 0 0 1-1-1V1zm4 0v6h8V1H4zm8 8H4v6h8V9zM1 1v2h2V1H1zm2 3H1v2h2V4zM1 7v2h2V7H1zm2 3H1v2h2v-2zm-2 3v2h2v-2H1zM15 1h-2v2h2V1zm-2 3v2h2V4h-2zm2 3h-2v2h2V7zm-2 3v2h2v-2h-2zm2 3h-2v2h2v-2z"/>
+ </symbol>
+
+ <symbol id="joystick" viewBox="0 0 16 16">
+ <path d="M10 2a2 2 0 0 1-1.5 1.937v5.087c.863.083 1.5.377 1.5.726 0 .414-.895.75-2 .75s-2-.336-2-.75c0-.35.637-.643 1.5-.726V3.937A2 2 0 1 1 10 2z"/>
+ <path d="M0 9.665v1.717a1 1 0 0 0 .553.894l6.553 3.277a2 2 0 0 0 1.788 0l6.553-3.277a1 1 0 0 0 .553-.894V9.665c0-.1-.06-.19-.152-.23L9.5 6.715v.993l5.227 2.178a.125.125 0 0 1 .001.23l-5.94 2.546a2 2 0 0 1-1.576 0l-5.94-2.546a.125.125 0 0 1 .001-.23L6.5 7.708l-.013-.988L.152 9.435a.25.25 0 0 0-.152.23z"/>
+ </symbol>
+
+ <symbol id="music-note-beamed" viewBox="0 0 16 16">
+ <path d="M6 13c0 1.105-1.12 2-2.5 2S1 14.105 1 13c0-1.104 1.12-2 2.5-2s2.5.896 2.5 2zm9-2c0 1.105-1.12 2-2.5 2s-2.5-.895-2.5-2 1.12-2 2.5-2 2.5.895 2.5 2z"/>
+ <path fill-rule="evenodd" d="M14 11V2h1v9h-1zM6 3v10H5V3h1z"/>
+ <path d="M5 2.905a1 1 0 0 1 .9-.995l8-.8a1 1 0 0 1 1.1.995V3L5 4V2.905z"/>
+ </symbol>
+
+ <symbol id="files" viewBox="0 0 16 16">
+ <path d="M13 0H6a2 2 0 0 0-2 2 2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h7a2 2 0 0 0 2-2 2 2 0 0 0 2-2V2a2 2 0 0 0-2-2zm0 13V4a2 2 0 0 0-2-2H5a1 1 0 0 1 1-1h7a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1zM3 4a1 1 0 0 1 1-1h7a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V4z"/>
+ </symbol>
+
+ <symbol id="image-fill" viewBox="0 0 16 16">
+ <path d="M.002 3a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2h-12a2 2 0 0 1-2-2V3zm1 9v1a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1V9.5l-3.777-1.947a.5.5 0 0 0-.577.093l-3.71 3.71-2.66-1.772a.5.5 0 0 0-.63.062L1.002 12zm5-6.5a1.5 1.5 0 1 0-3 0 1.5 1.5 0 0 0 3 0z"/>
+ </symbol>
+
+ <symbol id="trash" viewBox="0 0 16 16">
+ <path d="M5.5 5.5A.5.5 0 0 1 6 6v6a.5.5 0 0 1-1 0V6a.5.5 0 0 1 .5-.5zm2.5 0a.5.5 0 0 1 .5.5v6a.5.5 0 0 1-1 0V6a.5.5 0 0 1 .5-.5zm3 .5a.5.5 0 0 0-1 0v6a.5.5 0 0 0 1 0V6z"/>
+ <path fill-rule="evenodd" d="M14.5 3a1 1 0 0 1-1 1H13v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V4h-.5a1 1 0 0 1-1-1V2a1 1 0 0 1 1-1H6a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1h3.5a1 1 0 0 1 1 1v1zM4.118 4 4 4.059V13a1 1 0 0 0 1 1h6a1 1 0 0 0 1-1V4.059L11.882 4H4.118zM2.5 3V2h11v1h-11z"/>
+ </symbol>
+
+ <symbol id="question-circle" viewBox="0 0 16 16">
+ <path d="M8 15A7 7 0 1 1 8 1a7 7 0 0 1 0 14zm0 1A8 8 0 1 0 8 0a8 8 0 0 0 0 16z"/>
+ <path d="M5.255 5.786a.237.237 0 0 0 .241.247h.825c.138 0 .248-.113.266-.25.09-.656.54-1.134 1.342-1.134.686 0 1.314.343 1.314 1.168 0 .635-.374.927-.965 1.371-.673.489-1.206 1.06-1.168 1.987l.003.217a.25.25 0 0 0 .25.246h.811a.25.25 0 0 0 .25-.25v-.105c0-.718.273-.927 1.01-1.486.609-.463 1.244-.977 1.244-2.056 0-1.511-1.276-2.241-2.673-2.241-1.267 0-2.655.59-2.75 2.286zm1.557 5.763c0 .533.425.927 1.01.927.609 0 1.028-.394 1.028-.927 0-.552-.42-.94-1.029-.94-.584 0-1.009.388-1.009.94z"/>
+ </symbol>
+
+ <symbol id="arrow-left-short" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M12 8a.5.5 0 0 1-.5.5H5.707l2.147 2.146a.5.5 0 0 1-.708.708l-3-3a.5.5 0 0 1 0-.708l3-3a.5.5 0 1 1 .708.708L5.707 7.5H11.5a.5.5 0 0 1 .5.5z"/>
+ </symbol>
+
+ <symbol id="arrow-right-short" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4 8a.5.5 0 0 1 .5-.5h5.793L8.146 5.354a.5.5 0 1 1 .708-.708l3 3a.5.5 0 0 1 0 .708l-3 3a.5.5 0 0 1-.708-.708L10.293 8.5H4.5A.5.5 0 0 1 4 8z"/>
+ </symbol>
+</svg>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <ul class="dropdown-menu position-static d-grid gap-1 p-2 rounded-3 mx-0 shadow w-220px" data-bs-theme="light">
+ <li><a class="dropdown-item rounded-2 active" href="#">Action</a></li>
+ <li><a class="dropdown-item rounded-2" href="#">Another action</a></li>
+ <li><a class="dropdown-item rounded-2" href="#">Something else here</a></li>
+ <li><hr class="dropdown-divider"></li>
+ <li><a class="dropdown-item rounded-2" href="#">Separated link</a></li>
+ </ul>
+ <ul class="dropdown-menu position-static d-grid gap-1 p-2 rounded-3 mx-0 border-0 shadow w-220px" data-bs-theme="dark">
+ <li><a class="dropdown-item rounded-2 active" href="#">Action</a></li>
+ <li><a class="dropdown-item rounded-2" href="#">Another action</a></li>
+ <li><a class="dropdown-item rounded-2" href="#">Something else here</a></li>
+ <li><hr class="dropdown-divider"></li>
+ <li><a class="dropdown-item rounded-2" href="#">Separated link</a></li>
+ </ul>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="dropdown-menu d-block position-static pt-0 mx-0 rounded-3 shadow overflow-hidden w-280px" data-bs-theme="light">
+ <form class="p-2 mb-2 bg-body-tertiary border-bottom">
+ <input type="search" class="form-control" autocomplete="false" placeholder="Type to filter...">
+ </form>
+ <ul class="list-unstyled mb-0">
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-success rounded-circle p-1"></span>
+ Action
+ </a></li>
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-primary rounded-circle p-1"></span>
+ Another action
+ </a></li>
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-danger rounded-circle p-1"></span>
+ Something else here
+ </a></li>
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-info rounded-circle p-1"></span>
+ Separated link
+ </a></li>
+ </ul>
+ </div>
+
+ <div class="dropdown-menu d-block position-static border-0 pt-0 mx-0 rounded-3 shadow overflow-hidden w-280px" data-bs-theme="dark">
+ <form class="p-2 mb-2 bg-dark border-bottom border-dark">
+ <input type="search" class="form-control bg-dark" autocomplete="false" placeholder="Type to filter...">
+ </form>
+ <ul class="list-unstyled mb-0">
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-success rounded-circle p-1"></span>
+ Action
+ </a></li>
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-primary rounded-circle p-1"></span>
+ Another action
+ </a></li>
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-danger rounded-circle p-1"></span>
+ Something else here
+ </a></li>
+ <li><a class="dropdown-item d-flex align-items-center gap-2 py-2" href="#">
+ <span class="d-inline-block bg-info rounded-circle p-1"></span>
+ Separated link
+ </a></li>
+ </ul>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <ul class="dropdown-menu d-block position-static mx-0 shadow w-220px" data-bs-theme="light">
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#files"/></svg>
+ Documents
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#image-fill"/></svg>
+ Photos
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#film"/></svg>
+ Movies
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#music-note-beamed"/></svg>
+ Music
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#joystick"/></svg>
+ Games
+ </a>
+ </li>
+ <li><hr class="dropdown-divider"></li>
+ <li>
+ <a class="dropdown-item dropdown-item-danger d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#trash"/></svg>
+ Trash
+ </a>
+ </li>
+ </ul>
+ <ul class="dropdown-menu d-block position-static mx-0 border-0 shadow w-220px" data-bs-theme="dark">
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#files"/></svg>
+ Documents
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#image-fill"/></svg>
+ Photos
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#film"/></svg>
+ Movies
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#music-note-beamed"/></svg>
+ Music
+ </a>
+ </li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#joystick"/></svg>
+ Games
+ </a>
+ </li>
+ <li><hr class="dropdown-divider"></li>
+ <li>
+ <a class="dropdown-item d-flex gap-2 align-items-center" href="#">
+ <svg class="bi" width="16" height="16"><use xlink:href="#trash"/></svg>
+ Trash
+ </a>
+ </li>
+ </ul>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="dropdown-menu d-block position-static p-2 mx-0 shadow rounded-3 w-340px" data-bs-theme="light">
+ <div class="d-grid gap-1">
+ <div class="cal">
+ <div class="cal-month">
+ <button class="btn cal-btn" type="button">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-left-short"/></svg>
+ </button>
+ <strong class="cal-month-name">June</strong>
+ <select class="form-select cal-month-name d-none">
+ <option value="January">January</option>
+ <option value="February">February</option>
+ <option value="March">March</option>
+ <option value="April">April</option>
+ <option value="May">May</option>
+ <option selected value="June">June</option>
+ <option value="July">July</option>
+ <option value="August">August</option>
+ <option value="September">September</option>
+ <option value="October">October</option>
+ <option value="November">November</option>
+ <option value="December">December</option>
+ </select>
+ <button class="btn cal-btn" type="button">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-short"/></svg>
+ </button>
+ </div>
+ <div class="cal-weekdays text-body-secondary">
+ <div class="cal-weekday">Sun</div>
+ <div class="cal-weekday">Mon</div>
+ <div class="cal-weekday">Tue</div>
+ <div class="cal-weekday">Wed</div>
+ <div class="cal-weekday">Thu</div>
+ <div class="cal-weekday">Fri</div>
+ <div class="cal-weekday">Sat</div>
+ </div>
+ <div class="cal-days">
+ <button class="btn cal-btn" disabled type="button">30</button>
+ <button class="btn cal-btn" disabled type="button">31</button>
+
+ <button class="btn cal-btn" type="button">1</button>
+ <button class="btn cal-btn" type="button">2</button>
+ <button class="btn cal-btn" type="button">3</button>
+ <button class="btn cal-btn" type="button">4</button>
+ <button class="btn cal-btn" type="button">5</button>
+ <button class="btn cal-btn" type="button">6</button>
+ <button class="btn cal-btn" type="button">7</button>
+
+ <button class="btn cal-btn" type="button">8</button>
+ <button class="btn cal-btn" type="button">9</button>
+ <button class="btn cal-btn" type="button">10</button>
+ <button class="btn cal-btn" type="button">11</button>
+ <button class="btn cal-btn" type="button">12</button>
+ <button class="btn cal-btn" type="button">13</button>
+ <button class="btn cal-btn" type="button">14</button>
+
+ <button class="btn cal-btn" type="button">15</button>
+ <button class="btn cal-btn" type="button">16</button>
+ <button class="btn cal-btn" type="button">17</button>
+ <button class="btn cal-btn" type="button">18</button>
+ <button class="btn cal-btn" type="button">19</button>
+ <button class="btn cal-btn" type="button">20</button>
+ <button class="btn cal-btn" type="button">21</button>
+
+ <button class="btn cal-btn" type="button">22</button>
+ <button class="btn cal-btn" type="button">23</button>
+ <button class="btn cal-btn" type="button">24</button>
+ <button class="btn cal-btn" type="button">25</button>
+ <button class="btn cal-btn" type="button">26</button>
+ <button class="btn cal-btn" type="button">27</button>
+ <button class="btn cal-btn" type="button">28</button>
+
+ <button class="btn cal-btn" type="button">29</button>
+ <button class="btn cal-btn" type="button">30</button>
+ <button class="btn cal-btn" type="button">31</button>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ <div class="dropdown-menu d-block position-static p-2 mx-0 shadow rounded-3 w-340px" data-bs-theme="dark">
+ <div class="d-grid gap-1">
+ <div class="cal">
+ <div class="cal-month">
+ <button class="btn cal-btn" type="button">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-left-short"/></svg>
+ </button>
+ <strong class="cal-month-name">June</strong>
+ <select class="form-select cal-month-name d-none">
+ <option value="January">January</option>
+ <option value="February">February</option>
+ <option value="March">March</option>
+ <option value="April">April</option>
+ <option value="May">May</option>
+ <option selected value="June">June</option>
+ <option value="July">July</option>
+ <option value="August">August</option>
+ <option value="September">September</option>
+ <option value="October">October</option>
+ <option value="November">November</option>
+ <option value="December">December</option>
+ </select>
+ <button class="btn cal-btn" type="button">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-short"/></svg>
+ </button>
+ </div>
+ <div class="cal-weekdays text-body-secondary">
+ <div class="cal-weekday">Sun</div>
+ <div class="cal-weekday">Mon</div>
+ <div class="cal-weekday">Tue</div>
+ <div class="cal-weekday">Wed</div>
+ <div class="cal-weekday">Thu</div>
+ <div class="cal-weekday">Fri</div>
+ <div class="cal-weekday">Sat</div>
+ </div>
+ <div class="cal-days">
+ <button class="btn cal-btn" disabled type="button">30</button>
+ <button class="btn cal-btn" disabled type="button">31</button>
+
+ <button class="btn cal-btn" type="button">1</button>
+ <button class="btn cal-btn" type="button">2</button>
+ <button class="btn cal-btn" type="button">3</button>
+ <button class="btn cal-btn" type="button">4</button>
+ <button class="btn cal-btn" type="button">5</button>
+ <button class="btn cal-btn" type="button">6</button>
+ <button class="btn cal-btn" type="button">7</button>
+
+ <button class="btn cal-btn" type="button">8</button>
+ <button class="btn cal-btn" type="button">9</button>
+ <button class="btn cal-btn" type="button">10</button>
+ <button class="btn cal-btn" type="button">11</button>
+ <button class="btn cal-btn" type="button">12</button>
+ <button class="btn cal-btn" type="button">13</button>
+ <button class="btn cal-btn" type="button">14</button>
+
+ <button class="btn cal-btn" type="button">15</button>
+ <button class="btn cal-btn" type="button">16</button>
+ <button class="btn cal-btn" type="button">17</button>
+ <button class="btn cal-btn" type="button">18</button>
+ <button class="btn cal-btn" type="button">19</button>
+ <button class="btn cal-btn" type="button">20</button>
+ <button class="btn cal-btn" type="button">21</button>
+
+ <button class="btn cal-btn" type="button">22</button>
+ <button class="btn cal-btn" type="button">23</button>
+ <button class="btn cal-btn" type="button">24</button>
+ <button class="btn cal-btn" type="button">25</button>
+ <button class="btn cal-btn" type="button">26</button>
+ <button class="btn cal-btn" type="button">27</button>
+ <button class="btn cal-btn" type="button">28</button>
+
+ <button class="btn cal-btn" type="button">29</button>
+ <button class="btn cal-btn" type="button">30</button>
+ <button class="btn cal-btn" type="button">31</button>
+ </div>
+ </div>
+ </div>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="dropdown-menu position-static d-flex flex-column flex-lg-row align-items-stretch justify-content-start p-3 rounded-3 shadow-lg" data-bs-theme="light">
+ <nav class="col-lg-8">
+ <ul class="list-unstyled d-flex flex-column gap-2">
+ <li>
+ <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-start gap-2 py-2 px-3 lh-sm text-start">
+ <svg class="bi" width="24" height="24"><use xlink:href="#image-fill"/></svg>
+ <div>
+ <strong class="d-block">Main product</strong>
+ <small>Take a tour through the product</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-start gap-2 py-2 px-3 lh-sm text-start">
+ <svg class="bi" width="24" height="24"><use xlink:href="#music-note-beamed"/></svg>
+ <div>
+ <strong class="d-block">Another product</strong>
+ <small>Explore this other product we offer</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-start gap-2 py-2 px-3 lh-sm text-start">
+ <svg class="bi" width="24" height="24"><use xlink:href="#question-circle"/></svg>
+ <div>
+ <strong class="d-block">Support</strong>
+ <small>Get help from our support crew</small>
+ </div>
+ </a>
+ </li>
+ </ul>
+ </nav>
+ <div class="d-none d-lg-block vr mx-4 opacity-10">&nbsp;</div>
+ <hr class="d-lg-none">
+ <div class="col-lg-auto pe-3">
+ <nav>
+ <ul class="d-flex flex-column gap-2 list-unstyled small">
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Documentation</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Use cases</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">API status</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Partners</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Resources</a></li>
+ </ul>
+ </nav>
+ </div>
+ </div>
+
+ <div class="dropdown-menu position-static d-flex flex-column flex-lg-row align-items-stretch justify-content-start p-3 rounded-3 shadow-lg" data-bs-theme="dark">
+ <nav class="col-lg-8">
+ <ul class="list-unstyled d-flex flex-column gap-2">
+ <li>
+ <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-start gap-2 py-2 px-3 lh-sm text-start">
+ <svg class="bi" width="24" height="24"><use xlink:href="#image-fill"/></svg>
+ <div>
+ <strong class="d-block">Main product</strong>
+ <small>Take a tour through the product</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-start gap-2 py-2 px-3 lh-sm text-start">
+ <svg class="bi" width="24" height="24"><use xlink:href="#music-note-beamed"/></svg>
+ <div>
+ <strong class="d-block">Another product</strong>
+ <small>Explore this other product we offer</small>
+ </div>
+ </a>
+ </li>
+ <li>
+ <a href="#" class="btn btn-hover-light rounded-2 d-flex align-items-start gap-2 py-2 px-3 lh-sm text-start">
+ <svg class="bi" width="24" height="24"><use xlink:href="#question-circle"/></svg>
+ <div>
+ <strong class="d-block">Support</strong>
+ <small>Get help from our support crew</small>
+ </div>
+ </a>
+ </li>
+ </ul>
+ </nav>
+ <div class="d-none d-lg-block vr mx-4 opacity-10">&nbsp;</div>
+ <hr class="d-lg-none">
+ <div class="col-lg-auto pe-3">
+ <nav>
+ <ul class="d-flex flex-column gap-2 list-unstyled small">
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Documentation</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Use cases</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">API status</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Partners</a></li>
+ <li><a href="#" class="link-offset-2 link-underline link-underline-opacity-25 link-underline-opacity-75-hover">Resources</a></li>
+ </ul>
+ </nav>
+ </div>
+ </div>
+</div>
diff --git a/site/content/docs/5.2/examples/features/features.css b/site/content/docs/5.3/examples/features/features.css
index b5d658f..debc263 100644
--- a/site/content/docs/5.2/examples/features/features.css
+++ b/site/content/docs/5.3/examples/features/features.css
@@ -4,16 +4,6 @@
border-radius: .75rem;
}
-.icon-link > .bi {
- margin-top: .125rem;
- margin-left: .125rem;
- fill: currentcolor;
- transition: transform .25s ease-in-out;
-}
-.icon-link:hover > .bi {
- transform: translate(.25rem);
-}
-
.icon-square {
width: 3rem;
height: 3rem;
diff --git a/site/content/docs/5.2/examples/features/index.html b/site/content/docs/5.3/examples/features/index.html
index c134a0a..02fad75 100644
--- a/site/content/docs/5.2/examples/features/index.html
+++ b/site/content/docs/5.3/examples/features/index.html
@@ -25,9 +25,6 @@ body_class: ""
<path d="M11 6a3 3 0 1 1-6 0 3 3 0 0 1 6 0z"/>
<path fill-rule="evenodd" d="M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8zm8-7a7 7 0 0 0-5.468 11.37C3.242 11.226 4.805 10 8 10s4.757 1.225 5.468 2.37A7 7 0 0 0 8 1z"/>
</symbol>
- <symbol id="grid" viewBox="0 0 16 16">
- <path d="M1 2.5A1.5 1.5 0 0 1 2.5 1h3A1.5 1.5 0 0 1 7 2.5v3A1.5 1.5 0 0 1 5.5 7h-3A1.5 1.5 0 0 1 1 5.5v-3zM2.5 2a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3zm6.5.5A1.5 1.5 0 0 1 10.5 1h3A1.5 1.5 0 0 1 15 2.5v3A1.5 1.5 0 0 1 13.5 7h-3A1.5 1.5 0 0 1 9 5.5v-3zm1.5-.5a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3zM1 10.5A1.5 1.5 0 0 1 2.5 9h3A1.5 1.5 0 0 1 7 10.5v3A1.5 1.5 0 0 1 5.5 15h-3A1.5 1.5 0 0 1 1 13.5v-3zm1.5-.5a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3zm6.5.5A1.5 1.5 0 0 1 10.5 9h3a1.5 1.5 0 0 1 1.5 1.5v3a1.5 1.5 0 0 1-1.5 1.5h-3A1.5 1.5 0 0 1 9 13.5v-3zm1.5-.5a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3z"/>
- </symbol>
<symbol id="collection" viewBox="0 0 16 16">
<path d="M2.5 3.5a.5.5 0 0 1 0-1h11a.5.5 0 0 1 0 1h-11zm2-2a.5.5 0 0 1 0-1h7a.5.5 0 0 1 0 1h-7zM0 13a1.5 1.5 0 0 0 1.5 1.5h13A1.5 1.5 0 0 0 16 13V6a1.5 1.5 0 0 0-1.5-1.5h-13A1.5 1.5 0 0 0 0 6v7zm1.5.5A.5.5 0 0 1 1 13V6a.5.5 0 0 1 .5-.5h13a.5.5 0 0 1 .5.5v7a.5.5 0 0 1-.5.5h-13z"/>
</symbol>
@@ -35,9 +32,6 @@ body_class: ""
<path d="M14 0H2a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V2a2 2 0 0 0-2-2zM1 3.857C1 3.384 1.448 3 2 3h12c.552 0 1 .384 1 .857v10.286c0 .473-.448.857-1 .857H2c-.552 0-1-.384-1-.857V3.857z"/>
<path d="M6.5 7a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2z"/>
</symbol>
- <symbol id="chat-quote-fill" viewBox="0 0 16 16">
- <path d="M16 8c0 3.866-3.582 7-8 7a9.06 9.06 0 0 1-2.347-.306c-.584.296-1.925.864-4.181 1.234-.2.032-.352-.176-.273-.362.354-.836.674-1.95.77-2.966C.744 11.37 0 9.76 0 8c0-3.866 3.582-7 8-7s8 3.134 8 7zM7.194 6.766a1.688 1.688 0 0 0-.227-.272 1.467 1.467 0 0 0-.469-.324l-.008-.004A1.785 1.785 0 0 0 5.734 6C4.776 6 4 6.746 4 7.667c0 .92.776 1.666 1.734 1.666.343 0 .662-.095.931-.26-.137.389-.39.804-.81 1.22a.405.405 0 0 0 .011.59c.173.16.447.155.614-.01 1.334-1.329 1.37-2.758.941-3.706a2.461 2.461 0 0 0-.227-.4zM11 9.073c-.136.389-.39.804-.81 1.22a.405.405 0 0 0 .012.59c.172.16.446.155.613-.01 1.334-1.329 1.37-2.758.942-3.706a2.466 2.466 0 0 0-.228-.4 1.686 1.686 0 0 0-.227-.273 1.466 1.466 0 0 0-.469-.324l-.008-.004A1.785 1.785 0 0 0 10.07 6c-.957 0-1.734.746-1.734 1.667 0 .92.777 1.666 1.734 1.666.343 0 .662-.095.931-.26z"/>
- </symbol>
<symbol id="cpu-fill" viewBox="0 0 16 16">
<path d="M6.5 6a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3z"/>
<path d="M5.5.5a.5.5 0 0 0-1 0V2A2.5 2.5 0 0 0 2 4.5H.5a.5.5 0 0 0 0 1H2v1H.5a.5.5 0 0 0 0 1H2v1H.5a.5.5 0 0 0 0 1H2v1H.5a.5.5 0 0 0 0 1H2A2.5 2.5 0 0 0 4.5 14v1.5a.5.5 0 0 0 1 0V14h1v1.5a.5.5 0 0 0 1 0V14h1v1.5a.5.5 0 0 0 1 0V14h1v1.5a.5.5 0 0 0 1 0V14a2.5 2.5 0 0 0 2.5-2.5h1.5a.5.5 0 0 0 0-1H14v-1h1.5a.5.5 0 0 0 0-1H14v-1h1.5a.5.5 0 0 0 0-1H14v-1h1.5a.5.5 0 0 0 0-1H14A2.5 2.5 0 0 0 11.5 2V.5a.5.5 0 0 0-1 0V2h-1V.5a.5.5 0 0 0-1 0V2h-1V.5a.5.5 0 0 0-1 0V2h-1V.5zm1 4.5h3A1.5 1.5 0 0 1 11 6.5v3A1.5 1.5 0 0 1 9.5 11h-3A1.5 1.5 0 0 1 5 9.5v-3A1.5 1.5 0 0 1 6.5 5z"/>
@@ -74,33 +68,33 @@ body_class: ""
<div class="feature-icon d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-2 mb-3">
<svg class="bi" width="1em" height="1em"><use xlink:href="#collection"/></svg>
</div>
- <h3 class="fs-2">Featured title</h3>
+ <h3 class="fs-2 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
- <a href="#" class="icon-link d-inline-flex align-items-center">
+ <a href="#" class="icon-link">
Call to action
- <svg class="bi" width="1em" height="1em"><use xlink:href="#chevron-right"/></svg>
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
</a>
</div>
<div class="feature col">
<div class="feature-icon d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-2 mb-3">
<svg class="bi" width="1em" height="1em"><use xlink:href="#people-circle"/></svg>
</div>
- <h3 class="fs-2">Featured title</h3>
+ <h3 class="fs-2 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
- <a href="#" class="icon-link d-inline-flex align-items-center">
+ <a href="#" class="icon-link">
Call to action
- <svg class="bi" width="1em" height="1em"><use xlink:href="#chevron-right"/></svg>
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
</a>
</div>
<div class="feature col">
<div class="feature-icon d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-2 mb-3">
<svg class="bi" width="1em" height="1em"><use xlink:href="#toggles2"/></svg>
</div>
- <h3 class="fs-2">Featured title</h3>
+ <h3 class="fs-2 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
- <a href="#" class="icon-link d-inline-flex align-items-center">
+ <a href="#" class="icon-link">
Call to action
- <svg class="bi" width="1em" height="1em"><use xlink:href="#chevron-right"/></svg>
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
</a>
</div>
</div>
@@ -112,11 +106,11 @@ body_class: ""
<h2 class="pb-2 border-bottom">Hanging icons</h2>
<div class="row g-4 py-5 row-cols-1 row-cols-lg-3">
<div class="col d-flex align-items-start">
- <div class="icon-square text-bg-light d-inline-flex align-items-center justify-content-center fs-4 flex-shrink-0 me-3">
+ <div class="icon-square text-body-emphasis bg-body-secondary d-inline-flex align-items-center justify-content-center fs-4 flex-shrink-0 me-3">
<svg class="bi" width="1em" height="1em"><use xlink:href="#toggles2"/></svg>
</div>
<div>
- <h3 class="fs-2">Featured title</h3>
+ <h3 class="fs-2 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
<a href="#" class="btn btn-primary">
Primary button
@@ -124,11 +118,11 @@ body_class: ""
</div>
</div>
<div class="col d-flex align-items-start">
- <div class="icon-square text-bg-light d-inline-flex align-items-center justify-content-center fs-4 flex-shrink-0 me-3">
+ <div class="icon-square text-body-emphasis bg-body-secondary d-inline-flex align-items-center justify-content-center fs-4 flex-shrink-0 me-3">
<svg class="bi" width="1em" height="1em"><use xlink:href="#cpu-fill"/></svg>
</div>
<div>
- <h3 class="fs-2">Featured title</h3>
+ <h3 class="fs-2 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
<a href="#" class="btn btn-primary">
Primary button
@@ -136,11 +130,11 @@ body_class: ""
</div>
</div>
<div class="col d-flex align-items-start">
- <div class="icon-square text-bg-light d-inline-flex align-items-center justify-content-center fs-4 flex-shrink-0 me-3">
+ <div class="icon-square text-body-emphasis bg-body-secondary d-inline-flex align-items-center justify-content-center fs-4 flex-shrink-0 me-3">
<svg class="bi" width="1em" height="1em"><use xlink:href="#tools"/></svg>
</div>
<div>
- <h3 class="fs-2">Featured title</h3>
+ <h3 class="fs-2 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
<a href="#" class="btn btn-primary">
Primary button
@@ -228,58 +222,58 @@ body_class: ""
<div class="row row-cols-1 row-cols-sm-2 row-cols-md-3 row-cols-lg-4 g-4 py-5">
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#bootstrap"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#bootstrap"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#cpu-fill"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#cpu-fill"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#calendar3"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#calendar3"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#home"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#home"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#speedometer2"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#speedometer2"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#toggles2"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#toggles2"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#geo-fill"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#geo-fill"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
<div class="col d-flex align-items-start">
- <svg class="bi text-muted flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#tools"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0 me-3" width="1.75em" height="1.75em"><use xlink:href="#tools"/></svg>
<div>
- <h3 class="fw-bold mb-0 fs-4">Featured title</h3>
+ <h3 class="fw-bold mb-0 fs-4 text-body-emphasis">Featured title</h3>
<p>Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
@@ -292,54 +286,53 @@ body_class: ""
<h2 class="pb-2 border-bottom">Features with title</h2>
<div class="row row-cols-1 row-cols-md-2 align-items-md-center g-5 py-5">
- <div class="d-flex flex-column align-items-start gap-2">
- <h3 class="fw-bold">Left-aligned title explaining these awesome features</h3>
- <p class="text-muted">Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
+ <div class="col d-flex flex-column align-items-start gap-2">
+ <h2 class="fw-bold text-body-emphasis">Left-aligned title explaining these awesome features</h2>
+ <p class="text-body-secondary">Paragraph of text beneath the heading to explain the heading. We'll add onto it with another sentence and probably just keep going until we run out of words.</p>
<a href="#" class="btn btn-primary btn-lg">Primary button</a>
</div>
- <div class="row row-cols-1 row-cols-sm-2 g-4">
- <div class="d-flex flex-column gap-2">
- <div
- class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
- <svg class="bi" width="1em" height="1em">
- <use xlink:href="#collection" />
- </svg>
+
+ <div class="col">
+ <div class="row row-cols-1 row-cols-sm-2 g-4">
+ <div class="col d-flex flex-column gap-2">
+ <div class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
+ <svg class="bi" width="1em" height="1em">
+ <use xlink:href="#collection" />
+ </svg>
+ </div>
+ <h4 class="fw-semibold mb-0 text-body-emphasis">Featured title</h4>
+ <p class="text-body-secondary">Paragraph of text beneath the heading to explain the heading.</p>
</div>
- <h4 class="fw-semibold mb-0">Featured title</h4>
- <p class="text-muted">Paragraph of text beneath the heading to explain the heading.</p>
- </div>
- <div class="d-flex flex-column gap-2">
- <div
- class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
- <svg class="bi" width="1em" height="1em">
- <use xlink:href="#gear-fill" />
- </svg>
+ <div class="col d-flex flex-column gap-2">
+ <div class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
+ <svg class="bi" width="1em" height="1em">
+ <use xlink:href="#gear-fill" />
+ </svg>
+ </div>
+ <h4 class="fw-semibold mb-0 text-body-emphasis">Featured title</h4>
+ <p class="text-body-secondary">Paragraph of text beneath the heading to explain the heading.</p>
</div>
- <h4 class="fw-semibold mb-0">Featured title</h4>
- <p class="text-muted">Paragraph of text beneath the heading to explain the heading.</p>
- </div>
- <div class="d-flex flex-column gap-2">
- <div
- class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
- <svg class="bi" width="1em" height="1em">
- <use xlink:href="#speedometer" />
- </svg>
+ <div class="col d-flex flex-column gap-2">
+ <div class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
+ <svg class="bi" width="1em" height="1em">
+ <use xlink:href="#speedometer" />
+ </svg>
+ </div>
+ <h4 class="fw-semibold mb-0 text-body-emphasis">Featured title</h4>
+ <p class="text-body-secondary">Paragraph of text beneath the heading to explain the heading.</p>
</div>
- <h4 class="fw-semibold mb-0">Featured title</h4>
- <p class="text-muted">Paragraph of text beneath the heading to explain the heading.</p>
- </div>
- <div class="d-flex flex-column gap-2">
- <div
- class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
- <svg class="bi" width="1em" height="1em">
- <use xlink:href="#table" />
- </svg>
+ <div class="col d-flex flex-column gap-2">
+ <div class="feature-icon-small d-inline-flex align-items-center justify-content-center text-bg-primary bg-gradient fs-4 rounded-3">
+ <svg class="bi" width="1em" height="1em">
+ <use xlink:href="#table" />
+ </svg>
+ </div>
+ <h4 class="fw-semibold mb-0 text-body-emphasis">Featured title</h4>
+ <p class="text-body-secondary">Paragraph of text beneath the heading to explain the heading.</p>
</div>
- <h4 class="fw-semibold mb-0">Featured title</h4>
- <p class="text-muted">Paragraph of text beneath the heading to explain the heading.</p>
</div>
</div>
</div>
diff --git a/site/content/docs/5.2/examples/features/unsplash-photo-1.jpg b/site/content/docs/5.3/examples/features/unsplash-photo-1.jpg
index ed2e36a..ed2e36a 100644
--- a/site/content/docs/5.2/examples/features/unsplash-photo-1.jpg
+++ b/site/content/docs/5.3/examples/features/unsplash-photo-1.jpg
Binary files differ
diff --git a/site/content/docs/5.2/examples/features/unsplash-photo-2.jpg b/site/content/docs/5.3/examples/features/unsplash-photo-2.jpg
index b66864a..b66864a 100644
--- a/site/content/docs/5.2/examples/features/unsplash-photo-2.jpg
+++ b/site/content/docs/5.3/examples/features/unsplash-photo-2.jpg
Binary files differ
diff --git a/site/content/docs/5.2/examples/features/unsplash-photo-3.jpg b/site/content/docs/5.3/examples/features/unsplash-photo-3.jpg
index c411b17..c411b17 100644
--- a/site/content/docs/5.2/examples/features/unsplash-photo-3.jpg
+++ b/site/content/docs/5.3/examples/features/unsplash-photo-3.jpg
Binary files differ
diff --git a/site/content/docs/5.2/examples/footers/index.html b/site/content/docs/5.3/examples/footers/index.html
index 827c242..83c2409 100644
--- a/site/content/docs/5.2/examples/footers/index.html
+++ b/site/content/docs/5.3/examples/footers/index.html
@@ -22,18 +22,18 @@ body_class: ""
<div class="container">
<footer class="d-flex flex-wrap justify-content-between align-items-center py-3 my-4 border-top">
- <p class="col-md-4 mb-0 text-muted">&copy; {{< year >}} Company, Inc</p>
+ <p class="col-md-4 mb-0 text-body-secondary">&copy; {{< year >}} Company, Inc</p>
- <a href="/" class="col-md-4 d-flex align-items-center justify-content-center mb-3 mb-md-0 me-md-auto link-dark text-decoration-none">
+ <a href="/" class="col-md-4 d-flex align-items-center justify-content-center mb-3 mb-md-0 me-md-auto link-body-emphasis text-decoration-none">
<svg class="bi me-2" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
</a>
<ul class="nav col-md-4 justify-content-end">
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">Home</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">Features</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">Pricing</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">FAQs</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">About</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">Home</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">Features</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">Pricing</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">FAQs</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">About</a></li>
</ul>
</footer>
</div>
@@ -43,16 +43,16 @@ body_class: ""
<div class="container">
<footer class="d-flex flex-wrap justify-content-between align-items-center py-3 my-4 border-top">
<div class="col-md-4 d-flex align-items-center">
- <a href="/" class="mb-3 me-2 mb-md-0 text-muted text-decoration-none lh-1">
+ <a href="/" class="mb-3 me-2 mb-md-0 text-body-secondary text-decoration-none lh-1">
<svg class="bi" width="30" height="24"><use xlink:href="#bootstrap"/></svg>
</a>
- <span class="mb-3 mb-md-0 text-muted">&copy; {{< year >}} Company, Inc</span>
+ <span class="mb-3 mb-md-0 text-body-secondary">&copy; {{< year >}} Company, Inc</span>
</div>
<ul class="nav col-md-4 justify-content-end list-unstyled d-flex">
- <li class="ms-3"><a class="text-muted" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#twitter"/></svg></a></li>
- <li class="ms-3"><a class="text-muted" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#instagram"/></svg></a></li>
- <li class="ms-3"><a class="text-muted" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#facebook"/></svg></a></li>
+ <li class="ms-3"><a class="text-body-secondary" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#twitter"/></svg></a></li>
+ <li class="ms-3"><a class="text-body-secondary" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#instagram"/></svg></a></li>
+ <li class="ms-3"><a class="text-body-secondary" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#facebook"/></svg></a></li>
</ul>
</footer>
</div>
@@ -62,13 +62,13 @@ body_class: ""
<div class="container">
<footer class="py-3 my-4">
<ul class="nav justify-content-center border-bottom pb-3 mb-3">
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">Home</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">Features</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">Pricing</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">FAQs</a></li>
- <li class="nav-item"><a href="#" class="nav-link px-2 text-muted">About</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">Home</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">Features</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">Pricing</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">FAQs</a></li>
+ <li class="nav-item"><a href="#" class="nav-link px-2 text-body-secondary">About</a></li>
</ul>
- <p class="text-center text-muted">&copy; {{< year >}} Company, Inc</p>
+ <p class="text-center text-body-secondary">&copy; {{< year >}} Company, Inc</p>
</footer>
</div>
@@ -77,10 +77,10 @@ body_class: ""
<div class="container">
<footer class="row row-cols-1 row-cols-sm-2 row-cols-md-5 py-5 my-5 border-top">
<div class="col mb-3">
- <a href="/" class="d-flex align-items-center mb-3 link-dark text-decoration-none">
+ <a href="/" class="d-flex align-items-center mb-3 link-body-emphasis text-decoration-none">
<svg class="bi me-2" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
</a>
- <p class="text-muted">&copy; {{< year >}}</p>
+ <p class="text-body-secondary">&copy; {{< year >}}</p>
</div>
<div class="col mb-3">
@@ -90,33 +90,33 @@ body_class: ""
<div class="col mb-3">
<h5>Section</h5>
<ul class="nav flex-column">
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Home</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Features</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Pricing</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">FAQs</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">About</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Home</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Features</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Pricing</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">FAQs</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">About</a></li>
</ul>
</div>
<div class="col mb-3">
<h5>Section</h5>
<ul class="nav flex-column">
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Home</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Features</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Pricing</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">FAQs</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">About</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Home</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Features</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Pricing</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">FAQs</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">About</a></li>
</ul>
</div>
<div class="col mb-3">
<h5>Section</h5>
<ul class="nav flex-column">
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Home</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Features</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Pricing</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">FAQs</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">About</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Home</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Features</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Pricing</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">FAQs</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">About</a></li>
</ul>
</div>
</footer>
@@ -131,33 +131,33 @@ body_class: ""
<div class="col-6 col-md-2 mb-3">
<h5>Section</h5>
<ul class="nav flex-column">
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Home</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Features</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Pricing</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">FAQs</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">About</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Home</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Features</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Pricing</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">FAQs</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">About</a></li>
</ul>
</div>
<div class="col-6 col-md-2 mb-3">
<h5>Section</h5>
<ul class="nav flex-column">
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Home</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Features</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Pricing</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">FAQs</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">About</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Home</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Features</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Pricing</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">FAQs</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">About</a></li>
</ul>
</div>
<div class="col-6 col-md-2 mb-3">
<h5>Section</h5>
<ul class="nav flex-column">
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Home</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Features</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">Pricing</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">FAQs</a></li>
- <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-muted">About</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Home</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Features</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">Pricing</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">FAQs</a></li>
+ <li class="nav-item mb-2"><a href="#" class="nav-link p-0 text-body-secondary">About</a></li>
</ul>
</div>
@@ -177,9 +177,9 @@ body_class: ""
<div class="d-flex flex-column flex-sm-row justify-content-between py-4 my-4 border-top">
<p>&copy; {{< year >}} Company, Inc. All rights reserved.</p>
<ul class="list-unstyled d-flex">
- <li class="ms-3"><a class="link-dark" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#twitter"/></svg></a></li>
- <li class="ms-3"><a class="link-dark" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#instagram"/></svg></a></li>
- <li class="ms-3"><a class="link-dark" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#facebook"/></svg></a></li>
+ <li class="ms-3"><a class="link-body-emphasis" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#twitter"/></svg></a></li>
+ <li class="ms-3"><a class="link-body-emphasis" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#instagram"/></svg></a></li>
+ <li class="ms-3"><a class="link-body-emphasis" href="#"><svg class="bi" width="24" height="24"><use xlink:href="#facebook"/></svg></a></li>
</ul>
</div>
</footer>
diff --git a/site/content/docs/5.3/examples/grid/grid.css b/site/content/docs/5.3/examples/grid/grid.css
new file mode 100644
index 0000000..cbc7c31
--- /dev/null
+++ b/site/content/docs/5.3/examples/grid/grid.css
@@ -0,0 +1,13 @@
+.themed-grid-col {
+ padding-top: .75rem;
+ padding-bottom: .75rem;
+ background-color: rgba(112.520718, 44.062154, 249.437846, .15);
+ border: 1px solid rgba(112.520718, 44.062154, 249.437846, .3);
+}
+
+.themed-container {
+ padding: .75rem;
+ margin-bottom: 1.5rem;
+ background-color: rgba(112.520718, 44.062154, 249.437846, .15);
+ border: 1px solid rgba(112.520718, 44.062154, 249.437846, .3);
+}
diff --git a/site/content/docs/5.2/examples/grid/index.html b/site/content/docs/5.3/examples/grid/index.html
index 7c4f1d3..8a61582 100644
--- a/site/content/docs/5.2/examples/grid/index.html
+++ b/site/content/docs/5.3/examples/grid/index.html
@@ -4,7 +4,6 @@ title: Grid Template
extra_css:
- "grid.css"
body_class: "py-4"
-include_js: false
---
<main>
diff --git a/site/content/docs/5.2/examples/headers/headers.css b/site/content/docs/5.3/examples/headers/headers.css
index 8230c9a..f887573 100644
--- a/site/content/docs/5.2/examples/headers/headers.css
+++ b/site/content/docs/5.3/examples/headers/headers.css
@@ -10,6 +10,6 @@
font-size: 85%;
}
-.dropdown-toggle {
+.dropdown-toggle:not(:focus) {
outline: 0;
}
diff --git a/site/content/docs/5.2/examples/headers/index.html b/site/content/docs/5.3/examples/headers/index.html
index b8fc8b2..d47597f 100644
--- a/site/content/docs/5.2/examples/headers/index.html
+++ b/site/content/docs/5.3/examples/headers/index.html
@@ -35,7 +35,7 @@ body_class: ""
<div class="container">
<header class="d-flex flex-wrap justify-content-center py-3 mb-4 border-bottom">
- <a href="/" class="d-flex align-items-center mb-3 mb-md-0 me-md-auto text-dark text-decoration-none">
+ <a href="/" class="d-flex align-items-center mb-3 mb-md-0 me-md-auto link-body-emphasis text-decoration-none">
<svg class="bi me-2" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
<span class="fs-4">Simple header</span>
</a>
@@ -68,16 +68,18 @@ body_class: ""
<div class="container">
<header class="d-flex flex-wrap align-items-center justify-content-center justify-content-md-between py-3 mb-4 border-bottom">
- <a href="/" class="d-flex align-items-center col-md-3 mb-2 mb-md-0 text-dark text-decoration-none">
- <svg class="bi me-2" width="40" height="32" role="img" aria-label="Bootstrap"><use xlink:href="#bootstrap"/></svg>
- </a>
+ <div class="col-md-3 mb-2 mb-md-0">
+ <a href="/" class="d-inline-flex link-body-emphasis text-decoration-none">
+ <svg class="bi" width="40" height="32" role="img" aria-label="Bootstrap"><use xlink:href="#bootstrap"/></svg>
+ </a>
+ </div>
<ul class="nav col-12 col-md-auto mb-2 justify-content-center mb-md-0">
<li><a href="#" class="nav-link px-2 link-secondary">Home</a></li>
- <li><a href="#" class="nav-link px-2 link-dark">Features</a></li>
- <li><a href="#" class="nav-link px-2 link-dark">Pricing</a></li>
- <li><a href="#" class="nav-link px-2 link-dark">FAQs</a></li>
- <li><a href="#" class="nav-link px-2 link-dark">About</a></li>
+ <li><a href="#" class="nav-link px-2">Features</a></li>
+ <li><a href="#" class="nav-link px-2">Pricing</a></li>
+ <li><a href="#" class="nav-link px-2">FAQs</a></li>
+ <li><a href="#" class="nav-link px-2">About</a></li>
</ul>
<div class="col-md-3 text-end">
@@ -121,15 +123,15 @@ body_class: ""
<header class="p-3 mb-3 border-bottom">
<div class="container">
<div class="d-flex flex-wrap align-items-center justify-content-center justify-content-lg-start">
- <a href="/" class="d-flex align-items-center mb-2 mb-lg-0 text-dark text-decoration-none">
+ <a href="/" class="d-flex align-items-center mb-2 mb-lg-0 link-body-emphasis text-decoration-none">
<svg class="bi me-2" width="40" height="32" role="img" aria-label="Bootstrap"><use xlink:href="#bootstrap"/></svg>
</a>
<ul class="nav col-12 col-lg-auto me-lg-auto mb-2 justify-content-center mb-md-0">
<li><a href="#" class="nav-link px-2 link-secondary">Overview</a></li>
- <li><a href="#" class="nav-link px-2 link-dark">Inventory</a></li>
- <li><a href="#" class="nav-link px-2 link-dark">Customers</a></li>
- <li><a href="#" class="nav-link px-2 link-dark">Products</a></li>
+ <li><a href="#" class="nav-link px-2 link-body-emphasis">Inventory</a></li>
+ <li><a href="#" class="nav-link px-2 link-body-emphasis">Customers</a></li>
+ <li><a href="#" class="nav-link px-2 link-body-emphasis">Products</a></li>
</ul>
<form class="col-12 col-lg-auto mb-3 mb-lg-0 me-lg-3" role="search">
@@ -137,7 +139,7 @@ body_class: ""
</form>
<div class="dropdown text-end">
- <a href="#" class="d-block link-dark text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
+ <a href="#" class="d-block link-body-emphasis text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
<img src="https://github.com/mdo.png" alt="mdo" width="32" height="32" class="rounded-circle">
</a>
<ul class="dropdown-menu text-small">
@@ -157,7 +159,7 @@ body_class: ""
<header class="py-3 mb-3 border-bottom">
<div class="container-fluid d-grid gap-3 align-items-center" style="grid-template-columns: 1fr 2fr;">
<div class="dropdown">
- <a href="#" class="d-flex align-items-center col-lg-4 mb-2 mb-lg-0 link-dark text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
+ <a href="#" class="d-flex align-items-center col-lg-4 mb-2 mb-lg-0 link-body-emphasis text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
<svg class="bi me-2" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
</a>
<ul class="dropdown-menu text-small shadow">
@@ -177,7 +179,7 @@ body_class: ""
</form>
<div class="flex-shrink-0 dropdown">
- <a href="#" class="d-block link-dark text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
+ <a href="#" class="d-block link-body-emphasis text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
<img src="https://github.com/mdo.png" alt="mdo" width="32" height="32" class="rounded-circle">
</a>
<ul class="dropdown-menu text-small shadow">
@@ -194,10 +196,10 @@ body_class: ""
<div class="container-fluid pb-3">
<div class="d-grid gap-3" style="grid-template-columns: 1fr 2fr;">
- <div class="bg-light border rounded-3">
+ <div class="bg-body-tertiary border rounded-3">
<br><br><br><br><br><br><br><br><br><br>
</div>
- <div class="bg-light border rounded-3">
+ <div class="bg-body-tertiary border rounded-3">
<br><br><br><br><br><br><br><br><br><br>
</div>
</div>
@@ -205,24 +207,24 @@ body_class: ""
<div class="b-example-divider"></div>
- <nav class="py-2 bg-light border-bottom">
+ <nav class="py-2 bg-body-tertiary border-bottom">
<div class="container d-flex flex-wrap">
<ul class="nav me-auto">
- <li class="nav-item"><a href="#" class="nav-link link-dark px-2 active" aria-current="page">Home</a></li>
- <li class="nav-item"><a href="#" class="nav-link link-dark px-2">Features</a></li>
- <li class="nav-item"><a href="#" class="nav-link link-dark px-2">Pricing</a></li>
- <li class="nav-item"><a href="#" class="nav-link link-dark px-2">FAQs</a></li>
- <li class="nav-item"><a href="#" class="nav-link link-dark px-2">About</a></li>
+ <li class="nav-item"><a href="#" class="nav-link link-body-emphasis px-2 active" aria-current="page">Home</a></li>
+ <li class="nav-item"><a href="#" class="nav-link link-body-emphasis px-2">Features</a></li>
+ <li class="nav-item"><a href="#" class="nav-link link-body-emphasis px-2">Pricing</a></li>
+ <li class="nav-item"><a href="#" class="nav-link link-body-emphasis px-2">FAQs</a></li>
+ <li class="nav-item"><a href="#" class="nav-link link-body-emphasis px-2">About</a></li>
</ul>
<ul class="nav">
- <li class="nav-item"><a href="#" class="nav-link link-dark px-2">Login</a></li>
- <li class="nav-item"><a href="#" class="nav-link link-dark px-2">Sign up</a></li>
+ <li class="nav-item"><a href="#" class="nav-link link-body-emphasis px-2">Login</a></li>
+ <li class="nav-item"><a href="#" class="nav-link link-body-emphasis px-2">Sign up</a></li>
</ul>
</div>
</nav>
<header class="py-3 mb-4 border-bottom">
<div class="container d-flex flex-wrap justify-content-center">
- <a href="/" class="d-flex align-items-center mb-3 mb-lg-0 me-lg-auto text-dark text-decoration-none">
+ <a href="/" class="d-flex align-items-center mb-3 mb-lg-0 me-lg-auto link-body-emphasis text-decoration-none">
<svg class="bi me-2" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
<span class="fs-4">Double header</span>
</a>
@@ -235,7 +237,7 @@ body_class: ""
<div class="b-example-divider"></div>
<header>
- <div class="px-3 py-2 text-bg-dark">
+ <div class="px-3 py-2 text-bg-dark border-bottom">
<div class="container">
<div class="d-flex flex-wrap align-items-center justify-content-center justify-content-lg-start">
<a href="/" class="d-flex align-items-center my-2 my-lg-0 me-lg-auto text-white text-decoration-none">
diff --git a/site/content/docs/5.2/examples/heroes/bootstrap-docs.png b/site/content/docs/5.3/examples/heroes/bootstrap-docs.png
index 471a9ed..471a9ed 100644
--- a/site/content/docs/5.2/examples/heroes/bootstrap-docs.png
+++ b/site/content/docs/5.3/examples/heroes/bootstrap-docs.png
Binary files differ
diff --git a/site/content/docs/5.2/examples/heroes/bootstrap-themes.png b/site/content/docs/5.3/examples/heroes/bootstrap-themes.png
index 13c3233..13c3233 100644
--- a/site/content/docs/5.2/examples/heroes/bootstrap-themes.png
+++ b/site/content/docs/5.3/examples/heroes/bootstrap-themes.png
Binary files differ
diff --git a/site/content/docs/5.2/examples/heroes/heroes.css b/site/content/docs/5.3/examples/heroes/heroes.css
index e9deaf7..e9deaf7 100644
--- a/site/content/docs/5.2/examples/heroes/heroes.css
+++ b/site/content/docs/5.3/examples/heroes/heroes.css
diff --git a/site/content/docs/5.2/examples/heroes/index.html b/site/content/docs/5.3/examples/heroes/index.html
index ef621fd..7f5daa9 100644
--- a/site/content/docs/5.2/examples/heroes/index.html
+++ b/site/content/docs/5.3/examples/heroes/index.html
@@ -11,7 +11,7 @@ body_class: ""
<div class="px-4 py-5 my-5 text-center">
<img class="d-block mx-auto mb-4" src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo.svg" alt="" width="72" height="57">
- <h1 class="display-5 fw-bold">Centered hero</h1>
+ <h1 class="display-5 fw-bold text-body-emphasis">Centered hero</h1>
<div class="col-lg-6 mx-auto">
<p class="lead mb-4">Quickly design and customize responsive mobile-first sites with Bootstrap, the world’s most popular front-end open source toolkit, featuring Sass variables and mixins, responsive grid system, extensive prebuilt components, and powerful JavaScript plugins.</p>
<div class="d-grid gap-2 d-sm-flex justify-content-sm-center">
@@ -24,7 +24,7 @@ body_class: ""
<div class="b-example-divider"></div>
<div class="px-4 pt-5 my-5 text-center border-bottom">
- <h1 class="display-4 fw-bold">Centered screenshot</h1>
+ <h1 class="display-4 fw-bold text-body-emphasis">Centered screenshot</h1>
<div class="col-lg-6 mx-auto">
<p class="lead mb-4">Quickly design and customize responsive mobile-first sites with Bootstrap, the world’s most popular front-end open source toolkit, featuring Sass variables and mixins, responsive grid system, extensive prebuilt components, and powerful JavaScript plugins.</p>
<div class="d-grid gap-2 d-sm-flex justify-content-sm-center mb-5">
@@ -47,7 +47,7 @@ body_class: ""
<img src="bootstrap-themes.png" class="d-block mx-lg-auto img-fluid" alt="Bootstrap Themes" width="700" height="500" loading="lazy">
</div>
<div class="col-lg-6">
- <h1 class="display-5 fw-bold lh-1 mb-3">Responsive left-aligned hero with image</h1>
+ <h1 class="display-5 fw-bold text-body-emphasis lh-1 mb-3">Responsive left-aligned hero with image</h1>
<p class="lead">Quickly design and customize responsive mobile-first sites with Bootstrap, the world’s most popular front-end open source toolkit, featuring Sass variables and mixins, responsive grid system, extensive prebuilt components, and powerful JavaScript plugins.</p>
<div class="d-grid gap-2 d-md-flex justify-content-md-start">
<button type="button" class="btn btn-primary btn-lg px-4 me-md-2">Primary</button>
@@ -62,11 +62,11 @@ body_class: ""
<div class="container col-xl-10 col-xxl-8 px-4 py-5">
<div class="row align-items-center g-lg-5 py-5">
<div class="col-lg-7 text-center text-lg-start">
- <h1 class="display-4 fw-bold lh-1 mb-3">Vertically centered hero sign-up form</h1>
+ <h1 class="display-4 fw-bold lh-1 text-body-emphasis mb-3">Vertically centered hero sign-up form</h1>
<p class="col-lg-10 fs-4">Below is an example form built entirely with Bootstrap’s form controls. Each required form group has a validation state that can be triggered by attempting to submit the form without completing it.</p>
</div>
<div class="col-md-10 mx-auto col-lg-5">
- <form class="p-4 p-md-5 border rounded-3 bg-light">
+ <form class="p-4 p-md-5 border rounded-3 bg-body-tertiary">
<div class="form-floating mb-3">
<input type="email" class="form-control" id="floatingInput" placeholder="name@example.com">
<label for="floatingInput">Email address</label>
@@ -82,7 +82,7 @@ body_class: ""
</div>
<button class="w-100 btn btn-lg btn-primary" type="submit">Sign up</button>
<hr class="my-4">
- <small class="text-muted">By clicking Sign up, you agree to the terms of use.</small>
+ <small class="text-body-secondary">By clicking Sign up, you agree to the terms of use.</small>
</form>
</div>
</div>
@@ -93,7 +93,7 @@ body_class: ""
<div class="container my-5">
<div class="row p-4 pb-0 pe-lg-0 pt-lg-5 align-items-center rounded-3 border shadow-lg">
<div class="col-lg-7 p-3 p-lg-5 pt-lg-3">
- <h1 class="display-4 fw-bold lh-1">Border hero with cropped image and shadows</h1>
+ <h1 class="display-4 fw-bold lh-1 text-body-emphasis">Border hero with cropped image and shadows</h1>
<p class="lead">Quickly design and customize responsive mobile-first sites with Bootstrap, the world’s most popular front-end open source toolkit, featuring Sass variables and mixins, responsive grid system, extensive prebuilt components, and powerful JavaScript plugins.</p>
<div class="d-grid gap-2 d-md-flex justify-content-md-start mb-4 mb-lg-3">
<button type="button" class="btn btn-primary btn-lg px-4 me-md-2 fw-bold">Primary</button>
@@ -110,7 +110,7 @@ body_class: ""
<div class="bg-dark text-secondary px-4 py-5 text-center">
<div class="py-5">
- <h1 class="display-5 fw-bold text-white">Dark mode hero</h1>
+ <h1 class="display-5 fw-bold text-white">Dark color hero</h1>
<div class="col-lg-6 mx-auto">
<p class="fs-5 mb-4">Quickly design and customize responsive mobile-first sites with Bootstrap, the world’s most popular front-end open source toolkit, featuring Sass variables and mixins, responsive grid system, extensive prebuilt components, and powerful JavaScript plugins.</p>
<div class="d-grid gap-2 d-sm-flex justify-content-sm-center">
diff --git a/site/content/docs/5.2/examples/jumbotron/index.html b/site/content/docs/5.3/examples/jumbotron/index.html
index 8131d19..049684d 100644
--- a/site/content/docs/5.2/examples/jumbotron/index.html
+++ b/site/content/docs/5.3/examples/jumbotron/index.html
@@ -1,19 +1,18 @@
---
layout: examples
title: Jumbotron example
-include_js: false
---
<main>
<div class="container py-4">
<header class="pb-3 mb-4 border-bottom">
- <a href="/" class="d-flex align-items-center text-dark text-decoration-none">
+ <a href="/" class="d-flex align-items-center text-body-emphasis text-decoration-none">
<svg xmlns="http://www.w3.org/2000/svg" width="40" height="32" class="me-2" viewBox="0 0 118 94" role="img"><title>Bootstrap</title><path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z" fill="currentColor"></path></svg>
<span class="fs-4">Jumbotron example</span>
</a>
</header>
- <div class="p-5 mb-4 bg-light rounded-3">
+ <div class="p-5 mb-4 bg-body-tertiary rounded-3">
<div class="container-fluid py-5">
<h1 class="display-5 fw-bold">Custom jumbotron</h1>
<p class="col-md-8 fs-4">Using a series of utilities, you can create this jumbotron, just like the one in previous versions of Bootstrap. Check out the examples below for how you can remix and restyle it to your liking.</p>
@@ -30,7 +29,7 @@ include_js: false
</div>
</div>
<div class="col-md-6">
- <div class="h-100 p-5 bg-light border rounded-3">
+ <div class="h-100 p-5 bg-body-tertiary border rounded-3">
<h2>Add borders</h2>
<p>Or, keep it light and add a border for some added definition to the boundaries of your content. Be sure to look under the hood at the source HTML here as we've adjusted the alignment and sizing of both column's content for equal-height.</p>
<button class="btn btn-outline-secondary" type="button">Example button</button>
@@ -38,7 +37,7 @@ include_js: false
</div>
</div>
- <footer class="pt-3 mt-4 text-muted border-top">
+ <footer class="pt-3 mt-4 text-body-secondary border-top">
&copy; {{< year >}}
</footer>
</div>
diff --git a/site/content/docs/5.3/examples/jumbotrons/index.html b/site/content/docs/5.3/examples/jumbotrons/index.html
new file mode 100644
index 0000000..ded1144
--- /dev/null
+++ b/site/content/docs/5.3/examples/jumbotrons/index.html
@@ -0,0 +1,82 @@
+---
+layout: examples
+title: Jumbotrons
+extra_css:
+ - "jumbotrons.css"
+body_class: ""
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="bootstrap" viewBox="0 0 118 94">
+ <title>Bootstrap</title>
+ <path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z"></path>
+ </symbol>
+ <symbol id="arrow-right-short" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4 8a.5.5 0 0 1 .5-.5h5.793L8.146 5.354a.5.5 0 1 1 .708-.708l3 3a.5.5 0 0 1 0 .708l-3 3a.5.5 0 0 1-.708-.708L10.293 8.5H4.5A.5.5 0 0 1 4 8z"/>
+ </symbol>
+ <symbol id="check2-circle" viewBox="0 0 16 16">
+ <path d="M2.5 8a5.5 5.5 0 0 1 8.25-4.764.5.5 0 0 0 .5-.866A6.5 6.5 0 1 0 14.5 8a.5.5 0 0 0-1 0 5.5 5.5 0 1 1-11 0z"/>
+ <path d="M15.354 3.354a.5.5 0 0 0-.708-.708L8 9.293 5.354 6.646a.5.5 0 1 0-.708.708l3 3a.5.5 0 0 0 .708 0l7-7z"/>
+ </symbol>
+</svg>
+
+<div class="container my-5">
+ <div class="p-5 text-center bg-body-tertiary rounded-3">
+ <svg class="bi mt-4 mb-3" style="color: var(--bs-indigo);" width="100" height="100"><use xlink:href="#bootstrap"/></svg>
+ <h1 class="text-body-emphasis">Jumbotron with icon</h1>
+ <p class="col-lg-8 mx-auto fs-5 text-muted">
+ This is a custom jumbotron featuring an SVG image at the top, some longer text that wraps early thanks to a responsive <code>.col-*</code> class, and a customized call to action.
+ </p>
+ <div class="d-inline-flex gap-2 mb-5">
+ <button class="d-inline-flex align-items-center btn btn-primary btn-lg px-4 rounded-pill" type="button">
+ Call to action
+ <svg class="bi ms-2" width="24" height="24"><use xlink:href="#arrow-right-short"/></svg>
+ </button>
+ <button class="btn btn-outline-secondary btn-lg px-4 rounded-pill" type="button">
+ Secondary link
+ </button>
+ </div>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="container my-5">
+ <div class="position-relative p-5 text-center text-muted bg-body border border-dashed rounded-5">
+ <button type="button" class="position-absolute top-0 end-0 p-3 m-3 btn-close bg-secondary bg-opacity-10 rounded-pill" aria-label="Close"></button>
+ <svg class="bi mt-5 mb-3" width="48" height="48"><use xlink:href="#check2-circle"/></svg>
+ <h1 class="text-body-emphasis">Placeholder jumbotron</h1>
+ <p class="col-lg-6 mx-auto mb-4">
+ This faded back jumbotron is useful for placeholder content. It's also a great way to add a bit of context to a page or section when no content is available and to encourage visitors to take a specific action.
+ </p>
+ <button class="btn btn-primary px-5 mb-5" type="button">
+ Call to action
+ </button>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="my-5">
+ <div class="p-5 text-center bg-body-tertiary">
+ <div class="container py-5">
+ <h1 class="text-body-emphasis">Full-width jumbotron</h1>
+ <p class="col-lg-8 mx-auto lead">
+ This takes the basic jumbotron above and makes its background edge-to-edge with a <code>.container</code> inside to align content. Similar to above, it's been recreated with built-in grid and utility classes.
+ </p>
+ </div>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="container my-5">
+ <div class="p-5 text-center bg-body-tertiary rounded-3">
+ <h1 class="text-body-emphasis">Basic jumbotron</h1>
+ <p class="lead">
+ This is a simple Bootstrap jumbotron that sits within a <code>.container</code>, recreated with built-in utility classes.
+ </p>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
diff --git a/site/content/docs/5.3/examples/jumbotrons/jumbotrons.css b/site/content/docs/5.3/examples/jumbotrons/jumbotrons.css
new file mode 100644
index 0000000..d7d065e
--- /dev/null
+++ b/site/content/docs/5.3/examples/jumbotrons/jumbotrons.css
@@ -0,0 +1 @@
+.border-dashed { --bs-border-style: dashed; }
diff --git a/site/content/docs/5.3/examples/list-groups/index.html b/site/content/docs/5.3/examples/list-groups/index.html
new file mode 100644
index 0000000..1a6e5e8
--- /dev/null
+++ b/site/content/docs/5.3/examples/list-groups/index.html
@@ -0,0 +1,225 @@
+---
+layout: examples
+title: List groups
+extra_css:
+ - "list-groups.css"
+body_class: ""
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="calendar-event" viewBox="0 0 16 16">
+ <path d="M11 6.5a.5.5 0 0 1 .5-.5h1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-1a.5.5 0 0 1-.5-.5v-1z"/>
+ <path d="M3.5 0a.5.5 0 0 1 .5.5V1h8V.5a.5.5 0 0 1 1 0V1h1a2 2 0 0 1 2 2v11a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2V3a2 2 0 0 1 2-2h1V.5a.5.5 0 0 1 .5-.5zM1 4v10a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1V4H1z"/>
+ </symbol>
+
+ <symbol id="alarm" viewBox="0 0 16 16">
+ <path d="M8.5 5.5a.5.5 0 0 0-1 0v3.362l-1.429 2.38a.5.5 0 1 0 .858.515l1.5-2.5A.5.5 0 0 0 8.5 9V5.5z"/>
+ <path d="M6.5 0a.5.5 0 0 0 0 1H7v1.07a7.001 7.001 0 0 0-3.273 12.474l-.602.602a.5.5 0 0 0 .707.708l.746-.746A6.97 6.97 0 0 0 8 16a6.97 6.97 0 0 0 3.422-.892l.746.746a.5.5 0 0 0 .707-.708l-.601-.602A7.001 7.001 0 0 0 9 2.07V1h.5a.5.5 0 0 0 0-1h-3zm1.038 3.018a6.093 6.093 0 0 1 .924 0 6 6 0 1 1-.924 0zM0 3.5c0 .753.333 1.429.86 1.887A8.035 8.035 0 0 1 4.387 1.86 2.5 2.5 0 0 0 0 3.5zM13.5 1c-.753 0-1.429.333-1.887.86a8.035 8.035 0 0 1 3.527 3.527A2.5 2.5 0 0 0 13.5 1z"/>
+ </symbol>
+
+ <symbol id="list-check" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M5 11.5a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zM3.854 2.146a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 1 1 .708-.708L2 3.293l1.146-1.147a.5.5 0 0 1 .708 0zm0 4a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 1 1 .708-.708L2 7.293l1.146-1.147a.5.5 0 0 1 .708 0zm0 4a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 0 1 .708-.708l.146.147 1.146-1.147a.5.5 0 0 1 .708 0z"/>
+ </symbol>
+</svg>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="list-group">
+ <a href="#" class="list-group-item list-group-item-action d-flex gap-3 py-3" aria-current="true">
+ <img src="https://github.com/twbs.png" alt="twbs" width="32" height="32" class="rounded-circle flex-shrink-0">
+ <div class="d-flex gap-2 w-100 justify-content-between">
+ <div>
+ <h6 class="mb-0">List group item heading</h6>
+ <p class="mb-0 opacity-75">Some placeholder content in a paragraph.</p>
+ </div>
+ <small class="opacity-50 text-nowrap">now</small>
+ </div>
+ </a>
+ <a href="#" class="list-group-item list-group-item-action d-flex gap-3 py-3" aria-current="true">
+ <img src="https://github.com/twbs.png" alt="twbs" width="32" height="32" class="rounded-circle flex-shrink-0">
+ <div class="d-flex gap-2 w-100 justify-content-between">
+ <div>
+ <h6 class="mb-0">Another title here</h6>
+ <p class="mb-0 opacity-75">Some placeholder content in a paragraph that goes a little longer so it wraps to a new line.</p>
+ </div>
+ <small class="opacity-50 text-nowrap">3d</small>
+ </div>
+ </a>
+ <a href="#" class="list-group-item list-group-item-action d-flex gap-3 py-3" aria-current="true">
+ <img src="https://github.com/twbs.png" alt="twbs" width="32" height="32" class="rounded-circle flex-shrink-0">
+ <div class="d-flex gap-2 w-100 justify-content-between">
+ <div>
+ <h6 class="mb-0">Third heading</h6>
+ <p class="mb-0 opacity-75">Some placeholder content in a paragraph.</p>
+ </div>
+ <small class="opacity-50 text-nowrap">1w</small>
+ </div>
+ </a>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="list-group">
+ <label class="list-group-item d-flex gap-2">
+ <input class="form-check-input flex-shrink-0" type="checkbox" value="" checked>
+ <span>
+ First checkbox
+ <small class="d-block text-body-secondary">With support text underneath to add more detail</small>
+ </span>
+ </label>
+ <label class="list-group-item d-flex gap-2">
+ <input class="form-check-input flex-shrink-0" type="checkbox" value="">
+ <span>
+ Second checkbox
+ <small class="d-block text-body-secondary">Some other text goes here</small>
+ </span>
+ </label>
+ <label class="list-group-item d-flex gap-2">
+ <input class="form-check-input flex-shrink-0" type="checkbox" value="">
+ <span>
+ Third checkbox
+ <small class="d-block text-body-secondary">And we end with another snippet of text</small>
+ </span>
+ </label>
+ </div>
+
+ <div class="list-group">
+ <label class="list-group-item d-flex gap-2">
+ <input class="form-check-input flex-shrink-0" type="radio" name="listGroupRadios" id="listGroupRadios1" value="" checked>
+ <span>
+ First radio
+ <small class="d-block text-body-secondary">With support text underneath to add more detail</small>
+ </span>
+ </label>
+ <label class="list-group-item d-flex gap-2">
+ <input class="form-check-input flex-shrink-0" type="radio" name="listGroupRadios" id="listGroupRadios2" value="">
+ <span>
+ Second radio
+ <small class="d-block text-body-secondary">Some other text goes here</small>
+ </span>
+ </label>
+ <label class="list-group-item d-flex gap-2">
+ <input class="form-check-input flex-shrink-0" type="radio" name="listGroupRadios" id="listGroupRadios3" value="">
+ <span>
+ Third radio
+ <small class="d-block text-body-secondary">And we end with another snippet of text</small>
+ </span>
+ </label>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="list-group">
+ <label class="list-group-item d-flex gap-3">
+ <input class="form-check-input flex-shrink-0" type="checkbox" value="" checked style="font-size: 1.375em;">
+ <span class="pt-1 form-checked-content">
+ <strong>Finish sales report</strong>
+ <small class="d-block text-body-secondary">
+ <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#calendar-event"/></svg>
+ 1:00–2:00pm
+ </small>
+ </span>
+ </label>
+ <label class="list-group-item d-flex gap-3">
+ <input class="form-check-input flex-shrink-0" type="checkbox" value="" style="font-size: 1.375em;">
+ <span class="pt-1 form-checked-content">
+ <strong>Weekly All Hands</strong>
+ <small class="d-block text-body-secondary">
+ <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#calendar-event"/></svg>
+ 2:00–2:30pm
+ </small>
+ </span>
+ </label>
+ <label class="list-group-item d-flex gap-3">
+ <input class="form-check-input flex-shrink-0" type="checkbox" value="" style="font-size: 1.375em;">
+ <span class="pt-1 form-checked-content">
+ <strong>Out of office</strong>
+ <small class="d-block text-body-secondary">
+ <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#alarm"/></svg>
+ Tomorrow
+ </small>
+ </span>
+ </label>
+ <label class="list-group-item d-flex gap-3 bg-body-tertiary">
+ <input class="form-check-input form-check-input-placeholder bg-body-tertiary flex-shrink-0 pe-none" disabled type="checkbox" value="" style="font-size: 1.375em;">
+ <span class="pt-1 form-checked-content">
+ <span contenteditable="true" class="w-100">Add new task...</span>
+ <small class="d-block text-body-secondary">
+ <svg class="bi me-1" width="1em" height="1em"><use xlink:href="#list-check"/></svg>
+ Choose list...
+ </small>
+ </span>
+ </label>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="list-group list-group-checkable d-grid gap-2 border-0">
+ <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios1" value="" checked>
+ <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios1">
+ First radio
+ <span class="d-block small opacity-50">With support text underneath to add more detail</span>
+ </label>
+
+ <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios2" value="">
+ <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios2">
+ Second radio
+ <span class="d-block small opacity-50">Some other text goes here</span>
+ </label>
+
+ <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios3" value="">
+ <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios3">
+ Third radio
+ <span class="d-block small opacity-50">And we end with another snippet of text</span>
+ </label>
+
+ <input class="list-group-item-check pe-none" type="radio" name="listGroupCheckableRadios" id="listGroupCheckableRadios4" value="" disabled>
+ <label class="list-group-item rounded-3 py-3" for="listGroupCheckableRadios4">
+ Fourth disabled radio
+ <span class="d-block small opacity-50">This option is disabled</span>
+ </label>
+ </div>
+</div>
+
+<div class="b-example-divider"></div>
+
+<div class="d-flex flex-column flex-md-row p-4 gap-4 py-md-5 align-items-center justify-content-center">
+ <div class="list-group list-group-radio d-grid gap-2 border-0">
+ <div class="position-relative">
+ <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid1" value="" checked>
+ <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid1">
+ <strong class="fw-semibold">First radio</strong>
+ <span class="d-block small opacity-75">With support text underneath to add more detail</span>
+ </label>
+ </div>
+
+ <div class="position-relative">
+ <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid2" value="">
+ <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid2">
+ <strong class="fw-semibold">Second radio</strong>
+ <span class="d-block small opacity-75">Some other text goes here</span>
+ </label>
+ </div>
+
+ <div class="position-relative">
+ <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid3" value="">
+ <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid3">
+ <strong class="fw-semibold">Third radio</strong>
+ <span class="d-block small opacity-75">And we end with another snippet of text</span>
+ </label>
+ </div>
+
+ <div class="position-relative">
+ <input class="form-check-input position-absolute top-50 end-0 me-3 fs-5" type="radio" name="listGroupRadioGrid" id="listGroupRadioGrid4" value="" disabled>
+ <label class="list-group-item py-3 pe-5" for="listGroupRadioGrid4">
+ <strong class="fw-semibold">Fourth disabled radio</strong>
+ <span class="d-block small opacity-75">This option is disabled</span>
+ </label>
+ </div>
+ </div>
+</div>
diff --git a/site/content/docs/5.2/examples/list-groups/list-groups.css b/site/content/docs/5.3/examples/list-groups/list-groups.css
index 2185084..b90cfa0 100644
--- a/site/content/docs/5.2/examples/list-groups/list-groups.css
+++ b/site/content/docs/5.3/examples/list-groups/list-groups.css
@@ -1,6 +1,7 @@
.list-group {
+ width: 100%;
max-width: 460px;
- margin: 4rem auto;
+ margin-inline: 1.5rem;
}
.form-check-input:checked + .form-checked-content {
@@ -22,11 +23,12 @@
clip: rect(0, 0, 0, 0);
}
.list-group-item-check:hover + .list-group-item {
- background-color: var(--bs-light);
+ background-color: var(--bs-secondary-bg);
}
.list-group-item-check:checked + .list-group-item {
color: #fff;
- background-color: var(--bs-blue);
+ background-color: var(--bs-primary);
+ border-color: var(--bs-primary);
}
.list-group-item-check[disabled] + .list-group-item,
.list-group-item-check:disabled + .list-group-item {
@@ -45,13 +47,13 @@
}
.list-group-radio .list-group-item:hover,
.list-group-radio .list-group-item:focus {
- background-color: var(--bs-light);
+ background-color: var(--bs-secondary-bg);
}
.list-group-radio .form-check-input:checked + .list-group-item {
background-color: var(--bs-body);
- border-color: var(--bs-blue);
- box-shadow: 0 0 0 2px var(--bs-blue);
+ border-color: var(--bs-primary);
+ box-shadow: 0 0 0 2px var(--bs-primary);
}
.list-group-radio .form-check-input[disabled] + .list-group-item,
.list-group-radio .form-check-input:disabled + .list-group-item {
diff --git a/site/content/docs/5.2/examples/masonry/index.html b/site/content/docs/5.3/examples/masonry/index.html
index b4aecaa..c554deb 100644
--- a/site/content/docs/5.2/examples/masonry/index.html
+++ b/site/content/docs/5.3/examples/masonry/index.html
@@ -37,7 +37,7 @@ extra_js:
<blockquote class="blockquote">
<p>A well-known quote, contained in a blockquote element.</p>
</blockquote>
- <figcaption class="blockquote-footer mb-0 text-muted">
+ <figcaption class="blockquote-footer mb-0 text-body-secondary">
Someone famous in <cite title="Source Title">Source Title</cite>
</figcaption>
</figure>
@@ -49,7 +49,7 @@ extra_js:
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This card has supporting text below as a natural lead-in to additional content.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
</div>
@@ -70,7 +70,7 @@ extra_js:
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This card has a regular title and short paragraph of text below it.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
</div>
@@ -85,7 +85,7 @@ extra_js:
<blockquote class="blockquote">
<p>A well-known quote, contained in a blockquote element.</p>
</blockquote>
- <figcaption class="blockquote-footer mb-0 text-muted">
+ <figcaption class="blockquote-footer mb-0 text-body-secondary">
Someone famous in <cite title="Source Title">Source Title</cite>
</figcaption>
</figure>
@@ -96,7 +96,7 @@ extra_js:
<div class="card-body">
<h5 class="card-title">Card title</h5>
<p class="card-text">This is another card with title and supporting text below. This card has some additional content to make it slightly taller overall.</p>
- <p class="card-text"><small class="text-muted">Last updated 3 mins ago</small></p>
+ <p class="card-text"><small class="text-body-secondary">Last updated 3 mins ago</small></p>
</div>
</div>
</div>
diff --git a/site/content/docs/5.2/examples/modals/index.html b/site/content/docs/5.3/examples/modals/index.html
index a68bd41..5fcc2d2 100644
--- a/site/content/docs/5.2/examples/modals/index.html
+++ b/site/content/docs/5.3/examples/modals/index.html
@@ -7,24 +7,6 @@ body_class: ""
---
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
- <symbol id="bootstrap" viewBox="0 0 118 94">
- <title>Bootstrap</title>
- <path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z"></path>
- </symbol>
-
- <symbol id="exclamation-triangle-fill" viewBox="0 0 16 16">
- <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
- </symbol>
-
- <symbol id="check2" viewBox="0 0 16 16">
- <path d="M13.854 3.646a.5.5 0 0 1 0 .708l-7 7a.5.5 0 0 1-.708 0l-3.5-3.5a.5.5 0 1 1 .708-.708L6.5 10.293l6.646-6.647a.5.5 0 0 1 .708 0z"/>
- </symbol>
-
- <symbol id="check2-circle" viewBox="0 0 16 16">
- <path d="M2.5 8a5.5 5.5 0 0 1 8.25-4.764.5.5 0 0 0 .5-.866A6.5 6.5 0 1 0 14.5 8a.5.5 0 0 0-1 0 5.5 5.5 0 1 1-11 0z"/>
- <path d="M15.354 3.354a.5.5 0 0 0-.708-.708L8 9.293 5.354 6.646a.5.5 0 1 0-.708.708l3 3a.5.5 0 0 0 .708 0l7-7z"/>
- </symbol>
-
<symbol id="bookmark-star" viewBox="0 0 16 16">
<path d="M7.84 4.1a.178.178 0 0 1 .32 0l.634 1.285a.178.178 0 0 0 .134.098l1.42.206c.145.021.204.2.098.303L9.42 6.993a.178.178 0 0 0-.051.158l.242 1.414a.178.178 0 0 1-.258.187l-1.27-.668a.178.178 0 0 0-.165 0l-1.27.668a.178.178 0 0 1-.257-.187l.242-1.414a.178.178 0 0 0-.05-.158l-1.03-1.001a.178.178 0 0 1 .098-.303l1.42-.206a.178.178 0 0 0 .134-.098L7.84 4.1z"/>
<path d="M2 2a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v13.5a.5.5 0 0 1-.777.416L8 13.101l-5.223 2.815A.5.5 0 0 1 2 15.5V2zm2-1a1 1 0 0 0-1 1v12.566l4.723-2.482a.5.5 0 0 1 .554 0L13 14.566V2a1 1 0 0 0-1-1H4z"/>
@@ -34,10 +16,6 @@ body_class: ""
<path d="M1 2.5A1.5 1.5 0 0 1 2.5 1h3A1.5 1.5 0 0 1 7 2.5v3A1.5 1.5 0 0 1 5.5 7h-3A1.5 1.5 0 0 1 1 5.5v-3zm8 0A1.5 1.5 0 0 1 10.5 1h3A1.5 1.5 0 0 1 15 2.5v3A1.5 1.5 0 0 1 13.5 7h-3A1.5 1.5 0 0 1 9 5.5v-3zm-8 8A1.5 1.5 0 0 1 2.5 9h3A1.5 1.5 0 0 1 7 10.5v3A1.5 1.5 0 0 1 5.5 15h-3A1.5 1.5 0 0 1 1 13.5v-3zm8 0A1.5 1.5 0 0 1 10.5 9h3a1.5 1.5 0 0 1 1.5 1.5v3a1.5 1.5 0 0 1-1.5 1.5h-3A1.5 1.5 0 0 1 9 13.5v-3z"/>
</symbol>
- <symbol id="stars" viewBox="0 0 16 16">
- <path d="M7.657 6.247c.11-.33.576-.33.686 0l.645 1.937a2.89 2.89 0 0 0 1.829 1.828l1.936.645c.33.11.33.576 0 .686l-1.937.645a2.89 2.89 0 0 0-1.828 1.829l-.645 1.936a.361.361 0 0 1-.686 0l-.645-1.937a2.89 2.89 0 0 0-1.828-1.828l-1.937-.645a.361.361 0 0 1 0-.686l1.937-.645a2.89 2.89 0 0 0 1.828-1.828l.645-1.937zM3.794 1.148a.217.217 0 0 1 .412 0l.387 1.162c.173.518.579.924 1.097 1.097l1.162.387a.217.217 0 0 1 0 .412l-1.162.387A1.734 1.734 0 0 0 4.593 5.69l-.387 1.162a.217.217 0 0 1-.412 0L3.407 5.69A1.734 1.734 0 0 0 2.31 4.593l-1.162-.387a.217.217 0 0 1 0-.412l1.162-.387A1.734 1.734 0 0 0 3.407 2.31l.387-1.162zM10.863.099a.145.145 0 0 1 .274 0l.258.774c.115.346.386.617.732.732l.774.258a.145.145 0 0 1 0 .274l-.774.258a1.156 1.156 0 0 0-.732.732l-.258.774a.145.145 0 0 1-.274 0l-.258-.774a1.156 1.156 0 0 0-.732-.732L9.1 2.137a.145.145 0 0 1 0-.274l.774-.258c.346-.115.617-.386.732-.732L10.863.1z"/>
- </symbol>
-
<symbol id="film" viewBox="0 0 16 16">
<path d="M0 1a1 1 0 0 1 1-1h14a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H1a1 1 0 0 1-1-1V1zm4 0v6h8V1H4zm8 8H4v6h8V9zM1 1v2h2V1H1zm2 3H1v2h2V4zM1 7v2h2V7H1zm2 3H1v2h2v-2zm-2 3v2h2v-2H1zM15 1h-2v2h2V1zm-2 3v2h2V4h-2zm2 3h-2v2h2V7zm-2 3v2h2v-2h-2zm2 3h-2v2h2v-2z"/>
</symbol>
@@ -55,7 +33,7 @@ body_class: ""
</symbol>
</svg>
-<div class="modal modal-sheet position-static d-block bg-secondary py-5" tabindex="-1" role="dialog" id="modalSheet">
+<div class="modal modal-sheet position-static d-block bg-body-secondary p-4 py-md-5" tabindex="-1" role="dialog" id="modalSheet">
<div class="modal-dialog" role="document">
<div class="modal-content rounded-4 shadow">
<div class="modal-header border-bottom-0">
@@ -65,9 +43,9 @@ body_class: ""
<div class="modal-body py-0">
<p>This is a modal sheet, a variation of the modal that docs itself to the bottom of the viewport like the newer share sheets in iOS.</p>
</div>
- <div class="modal-footer flex-column border-top-0">
- <button type="button" class="btn btn-lg btn-primary w-100 mx-0 mb-2">Save changes</button>
- <button type="button" class="btn btn-lg btn-light w-100 mx-0" data-bs-dismiss="modal">Close</button>
+ <div class="modal-footer flex-column align-items-stretch w-100 gap-2 pb-3 border-top-0">
+ <button type="button" class="btn btn-lg btn-primary">Save changes</button>
+ <button type="button" class="btn btn-lg btn-secondary" data-bs-dismiss="modal">Close</button>
</div>
</div>
</div>
@@ -75,7 +53,7 @@ body_class: ""
<div class="b-example-divider"></div>
-<div class="modal modal-alert position-static d-block bg-secondary py-5" tabindex="-1" role="dialog" id="modalChoice">
+<div class="modal modal-sheet position-static d-block bg-body-secondary p-4 py-md-5" tabindex="-1" role="dialog" id="modalChoice">
<div class="modal-dialog" role="document">
<div class="modal-content rounded-3 shadow">
<div class="modal-body p-4 text-center">
@@ -83,8 +61,8 @@ body_class: ""
<p class="mb-0">You can always change your mind in your account settings.</p>
</div>
<div class="modal-footer flex-nowrap p-0">
- <button type="button" class="btn btn-lg btn-link fs-6 text-decoration-none col-6 m-0 rounded-0 border-end"><strong>Yes, enable</strong></button>
- <button type="button" class="btn btn-lg btn-link fs-6 text-decoration-none col-6 m-0 rounded-0" data-bs-dismiss="modal">No thanks</button>
+ <button type="button" class="btn btn-lg btn-link fs-6 text-decoration-none col-6 py-3 m-0 rounded-0 border-end"><strong>Yes, enable</strong></button>
+ <button type="button" class="btn btn-lg btn-link fs-6 text-decoration-none col-6 py-3 m-0 rounded-0" data-bs-dismiss="modal">No thanks</button>
</div>
</div>
</div>
@@ -92,15 +70,15 @@ body_class: ""
<div class="b-example-divider"></div>
-<div class="modal modal-tour position-static d-block bg-secondary py-5" tabindex="-1" role="dialog" id="modalTour">
+<div class="modal modal-sheet position-static d-block bg-body-secondary p-4 py-md-5" tabindex="-1" role="dialog" id="modalTour">
<div class="modal-dialog" role="document">
<div class="modal-content rounded-4 shadow">
<div class="modal-body p-5">
<h2 class="fw-bold mb-0">What's new</h2>
- <ul class="d-grid gap-4 my-5 list-unstyled">
+ <ul class="d-grid gap-4 my-5 list-unstyled small">
<li class="d-flex gap-4">
- <svg class="bi text-muted flex-shrink-0" width="48" height="48"><use xlink:href="#grid-fill"/></svg>
+ <svg class="bi text-body-secondary flex-shrink-0" width="48" height="48"><use xlink:href="#grid-fill"/></svg>
<div>
<h5 class="mb-0">Grid view</h5>
Not into lists? Try the new grid view.
@@ -129,11 +107,10 @@ body_class: ""
<div class="b-example-divider"></div>
-<div class="modal modal-signin position-static d-block bg-secondary py-5" tabindex="-1" role="dialog" id="modalSignin">
+<div class="modal modal-sheet position-static d-block bg-body-secondary p-4 py-md-5" tabindex="-1" role="dialog" id="modalSignin">
<div class="modal-dialog" role="document">
<div class="modal-content rounded-4 shadow">
<div class="modal-header p-5 pb-4 border-bottom-0">
- <!-- <h1 class="modal-title fs-5" >Modal title</h1> -->
<h1 class="fw-bold mb-0 fs-2">Sign up for free</h1>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
@@ -149,10 +126,10 @@ body_class: ""
<label for="floatingPassword">Password</label>
</div>
<button class="w-100 mb-2 btn btn-lg rounded-3 btn-primary" type="submit">Sign up</button>
- <small class="text-muted">By clicking Sign up, you agree to the terms of use.</small>
+ <small class="text-body-secondary">By clicking Sign up, you agree to the terms of use.</small>
<hr class="my-4">
<h2 class="fs-5 fw-bold mb-3">Or use a third-party</h2>
- <button class="w-100 py-2 mb-2 btn btn-outline-dark rounded-3" type="submit">
+ <button class="w-100 py-2 mb-2 btn btn-outline-secondary rounded-3" type="submit">
<svg class="bi me-1" width="16" height="16"><use xlink:href="#twitter"/></svg>
Sign up with Twitter
</button>
diff --git a/site/content/docs/5.2/examples/modals/modals.css b/site/content/docs/5.3/examples/modals/modals.css
index 51ad2c4..924952a 100644
--- a/site/content/docs/5.2/examples/modals/modals.css
+++ b/site/content/docs/5.3/examples/modals/modals.css
@@ -6,10 +6,3 @@
padding-bottom: 2rem;
}
-.modal-alert .modal-dialog {
- width: 380px;
-}
-
-.modal-tour .modal-dialog {
- width: 380px;
-}
diff --git a/site/content/docs/5.2/examples/navbar-bottom/index.html b/site/content/docs/5.3/examples/navbar-bottom/index.html
index c0e859a..92eed64 100644
--- a/site/content/docs/5.2/examples/navbar-bottom/index.html
+++ b/site/content/docs/5.3/examples/navbar-bottom/index.html
@@ -4,7 +4,7 @@ title: Bottom navbar example
---
<main class="container">
- <div class="bg-light p-5 rounded mt-3">
+ <div class="bg-body-tertiary p-5 rounded mt-3">
<h1>Bottom Navbar example</h1>
<p class="lead">This example is a quick exercise to illustrate how the bottom navbar works.</p>
<a class="btn btn-lg btn-primary" href="{{< docsref "/components/navbar" >}}" role="button">View navbar docs &raquo;</a>
diff --git a/site/content/docs/5.2/examples/navbar-fixed/index.html b/site/content/docs/5.3/examples/navbar-fixed/index.html
index b0d9986..a2a1c75 100644
--- a/site/content/docs/5.2/examples/navbar-fixed/index.html
+++ b/site/content/docs/5.3/examples/navbar-fixed/index.html
@@ -2,7 +2,7 @@
layout: examples
title: Fixed top navbar example
extra_css:
- - "navbar-top-fixed.css"
+ - "navbar-fixed.css"
---
<nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark">
@@ -32,7 +32,7 @@ extra_css:
</nav>
<main class="container">
- <div class="bg-light p-5 rounded">
+ <div class="bg-body-tertiary p-5 rounded">
<h1>Navbar example</h1>
<p class="lead">This example is a quick exercise to illustrate how fixed to top navbar works. As you scroll, it will remain fixed to the top of your browser’s viewport.</p>
<a class="btn btn-lg btn-primary" href="{{< docsref "/components/navbar" >}}" role="button">View navbar docs &raquo;</a>
diff --git a/site/content/docs/5.2/examples/navbar-fixed/navbar-top-fixed.css b/site/content/docs/5.3/examples/navbar-fixed/navbar-fixed.css
index c77c0c1..c77c0c1 100644
--- a/site/content/docs/5.2/examples/navbar-fixed/navbar-top-fixed.css
+++ b/site/content/docs/5.3/examples/navbar-fixed/navbar-fixed.css
diff --git a/site/content/docs/5.2/examples/navbar-static/index.html b/site/content/docs/5.3/examples/navbar-static/index.html
index b6c26c9..2b1b308 100644
--- a/site/content/docs/5.2/examples/navbar-static/index.html
+++ b/site/content/docs/5.3/examples/navbar-static/index.html
@@ -2,7 +2,7 @@
layout: examples
title: Top navbar example
extra_css:
- - "navbar-top.css"
+ - "navbar-static.css"
---
<nav class="navbar navbar-expand-md navbar-dark bg-dark mb-4">
@@ -32,7 +32,7 @@ extra_css:
</nav>
<main class="container">
- <div class="bg-light p-5 rounded">
+ <div class="bg-body-tertiary p-5 rounded">
<h1>Navbar example</h1>
<p class="lead">This example is a quick exercise to illustrate how the top-aligned navbar works. As you scroll, this navbar remains in its original position and moves with the rest of the page.</p>
<a class="btn btn-lg btn-primary" href="{{< docsref "/components/navbar" >}}" role="button">View navbar docs &raquo;</a>
diff --git a/site/content/docs/5.2/examples/navbar-static/navbar-top.css b/site/content/docs/5.3/examples/navbar-static/navbar-static.css
index 25bbdde..25bbdde 100644
--- a/site/content/docs/5.2/examples/navbar-static/navbar-top.css
+++ b/site/content/docs/5.3/examples/navbar-static/navbar-static.css
diff --git a/site/content/docs/5.2/examples/navbars-offcanvas/index.html b/site/content/docs/5.3/examples/navbars-offcanvas/index.html
index 9099dc9..858998f 100644
--- a/site/content/docs/5.2/examples/navbars-offcanvas/index.html
+++ b/site/content/docs/5.3/examples/navbars-offcanvas/index.html
@@ -2,14 +2,14 @@
layout: examples
title: Navbar Template
extra_css:
- - "navbar.css"
+ - "navbars-offcanvas.css"
---
<main>
<nav class="navbar navbar-dark bg-dark" aria-label="Dark offcanvas navbar">
<div class="container-fluid">
<a class="navbar-brand" href="#">Dark offcanvas navbar</a>
- <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbarDark" aria-controls="offcanvasNavbarDark">
+ <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbarDark" aria-controls="offcanvasNavbarDark" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="offcanvas offcanvas-end text-bg-dark" tabindex="-1" id="offcanvasNavbarDark" aria-labelledby="offcanvasNavbarDarkLabel">
@@ -48,10 +48,10 @@ extra_css:
</div>
</nav>
- <nav class="navbar bg-light" aria-label="Light offcanvas navbar">
+ <nav class="navbar bg-body-tertiary" aria-label="Light offcanvas navbar">
<div class="container-fluid">
<a class="navbar-brand" href="#">Light offcanvas navbar</a>
- <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbarLight" aria-controls="offcanvasNavbarLight">
+ <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbarLight" aria-controls="offcanvasNavbarLight" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="offcanvas offcanvas-end" tabindex="-1" id="offcanvasNavbarLight" aria-labelledby="offcanvasNavbarLightLabel">
@@ -93,7 +93,7 @@ extra_css:
<nav class="navbar navbar-expand-lg navbar-dark bg-dark" aria-label="Offcanvas navbar large">
<div class="container-fluid">
<a class="navbar-brand" href="#">Responsive offcanvas navbar</a>
- <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbar2" aria-controls="offcanvasNavbar2">
+ <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbar2" aria-controls="offcanvasNavbar2" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="offcanvas offcanvas-end text-bg-dark" tabindex="-1" id="offcanvasNavbar2" aria-labelledby="offcanvasNavbar2Label">
@@ -133,7 +133,7 @@ extra_css:
</nav>
<div class="container my-5">
- <div class="bg-light p-5 rounded">
+ <div class="bg-body-tertiary p-5 rounded">
<div class="col-sm-8 py-5 mx-auto">
<h1 class="display-5 fw-normal">Navbar with offcanvas examples</h1>
<p class="fs-5">This example shows how responsive offcanvas menus work within the navbar. For positioning of navbars, checkout the <a href="{{< docsref "/examples/navbar-static" >}}">top</a> and <a href="{{< docsref "/examples/navbar-fixed" >}}">fixed top</a> examples.</p>
diff --git a/site/content/docs/5.2/examples/navbars-offcanvas/navbar.css b/site/content/docs/5.3/examples/navbars-offcanvas/navbars-offcanvas.css
index 70d2094..70d2094 100644
--- a/site/content/docs/5.2/examples/navbars-offcanvas/navbar.css
+++ b/site/content/docs/5.3/examples/navbars-offcanvas/navbars-offcanvas.css
diff --git a/site/content/docs/5.2/examples/navbars/index.html b/site/content/docs/5.3/examples/navbars/index.html
index cc90b8c..4c903bb 100644
--- a/site/content/docs/5.2/examples/navbars/index.html
+++ b/site/content/docs/5.3/examples/navbars/index.html
@@ -2,7 +2,7 @@
layout: examples
title: Navbar Template
extra_css:
- - "navbar.css"
+ - "navbars.css"
---
<main>
@@ -336,7 +336,7 @@ extra_css:
</nav>
<div class="container">
- <nav class="navbar navbar-expand-lg bg-light rounded" aria-label="Eleventh navbar example">
+ <nav class="navbar navbar-expand-lg bg-body-tertiary rounded" aria-label="Eleventh navbar example">
<div class="container-fluid">
<a class="navbar-brand" href="#">Navbar</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarsExample09" aria-controls="navbarsExample09" aria-expanded="false" aria-label="Toggle navigation">
@@ -370,7 +370,7 @@ extra_css:
</div>
</nav>
- <nav class="navbar navbar-expand-lg bg-light rounded" aria-label="Twelfth navbar example">
+ <nav class="navbar navbar-expand-lg bg-body-tertiary rounded" aria-label="Twelfth navbar example">
<div class="container-fluid">
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarsExample10" aria-controls="navbarsExample10" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
@@ -400,8 +400,42 @@ extra_css:
</div>
</nav>
+ <nav class="navbar navbar-expand-lg bg-body-tertiary rounded" aria-label="Thirteenth navbar example">
+ <div class="container-fluid">
+ <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarsExample11" aria-controls="navbarsExample11" aria-expanded="false" aria-label="Toggle navigation">
+ <span class="navbar-toggler-icon"></span>
+ </button>
+
+ <div class="collapse navbar-collapse d-lg-flex" id="navbarsExample11">
+ <a class="navbar-brand col-lg-3 me-0" href="#">Centered nav</a>
+ <ul class="navbar-nav col-lg-6 justify-content-lg-center">
+ <li class="nav-item">
+ <a class="nav-link active" aria-current="page" href="#">Home</a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link" href="#">Link</a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link disabled">Disabled</a>
+ </li>
+ <li class="nav-item dropdown">
+ <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" aria-expanded="false">Dropdown</a>
+ <ul class="dropdown-menu">
+ <li><a class="dropdown-item" href="#">Action</a></li>
+ <li><a class="dropdown-item" href="#">Another action</a></li>
+ <li><a class="dropdown-item" href="#">Something else here</a></li>
+ </ul>
+ </li>
+ </ul>
+ <div class="d-lg-flex col-lg-3 justify-content-lg-end">
+ <button class="btn btn-primary">Button</button>
+ </div>
+ </div>
+ </div>
+ </nav>
+
<div>
- <div class="bg-light p-5 rounded">
+ <div class="bg-body-tertiaryp-5 rounded">
<div class="col-sm-8 mx-auto">
<h1>Navbar examples</h1>
<p>This example is a quick exercise to illustrate how the navbar and its contents work. Some navbars extend the width of the viewport, others are confined within a <code>.container</code>. For positioning of navbars, checkout the <a href="{{< docsref "/examples/navbar-static" >}}">top</a> and <a href="{{< docsref "/examples/navbar-fixed" >}}">fixed top</a> examples.</p>
diff --git a/site/content/docs/5.2/examples/navbars/navbar.css b/site/content/docs/5.3/examples/navbars/navbars.css
index 70d2094..70d2094 100644
--- a/site/content/docs/5.2/examples/navbars/navbar.css
+++ b/site/content/docs/5.3/examples/navbars/navbars.css
diff --git a/site/content/docs/5.2/examples/offcanvas-navbar/index.html b/site/content/docs/5.3/examples/offcanvas-navbar/index.html
index 81c9bb4..f72583f 100644
--- a/site/content/docs/5.2/examples/offcanvas-navbar/index.html
+++ b/site/content/docs/5.3/examples/offcanvas-navbar/index.html
@@ -2,11 +2,11 @@
layout: examples
title: Offcanvas navbar template
extra_css:
- - "offcanvas.css"
+ - "offcanvas-navbar.css"
extra_js:
- - src: "offcanvas.js"
-body_class: "bg-light"
-aliases: "/docs/5.2/examples/offcanvas/"
+ - src: "offcanvas-navbar.js"
+body_class: "bg-body-tertiary"
+aliases: "/docs/5.3/examples/offcanvas/"
---
<nav class="navbar navbar-expand-lg fixed-top navbar-dark bg-dark" aria-label="Main navigation">
@@ -75,21 +75,21 @@ aliases: "/docs/5.2/examples/offcanvas/"
<div class="my-3 p-3 bg-body rounded shadow-sm">
<h6 class="border-bottom pb-2 mb-0">Recent updates</h6>
- <div class="d-flex text-muted pt-3">
+ <div class="d-flex text-body-secondary pt-3">
{{< placeholder width="32" height="32" background="#007bff" color="#007bff" class="flex-shrink-0 me-2 rounded" >}}
<p class="pb-3 mb-0 small lh-sm border-bottom">
<strong class="d-block text-gray-dark">@username</strong>
Some representative placeholder content, with some information about this user. Imagine this being some sort of status update, perhaps?
</p>
</div>
- <div class="d-flex text-muted pt-3">
+ <div class="d-flex text-body-secondary pt-3">
{{< placeholder width="32" height="32" background="#e83e8c" color="#e83e8c" class="flex-shrink-0 me-2 rounded" >}}
<p class="pb-3 mb-0 small lh-sm border-bottom">
<strong class="d-block text-gray-dark">@username</strong>
Some more representative placeholder content, related to this other user. Another status update, perhaps.
</p>
</div>
- <div class="d-flex text-muted pt-3">
+ <div class="d-flex text-body-secondary pt-3">
{{< placeholder width="32" height="32" background="#6f42c1" color="#6f42c1" class="flex-shrink-0 me-2 rounded" >}}
<p class="pb-3 mb-0 small lh-sm border-bottom">
<strong class="d-block text-gray-dark">@username</strong>
@@ -103,7 +103,7 @@ aliases: "/docs/5.2/examples/offcanvas/"
<div class="my-3 p-3 bg-body rounded shadow-sm">
<h6 class="border-bottom pb-2 mb-0">Suggestions</h6>
- <div class="d-flex text-muted pt-3">
+ <div class="d-flex text-body-secondary pt-3">
{{< placeholder width="32" height="32" background="#007bff" color="#007bff" class="flex-shrink-0 me-2 rounded" >}}
<div class="pb-3 mb-0 small lh-sm border-bottom w-100">
<div class="d-flex justify-content-between">
@@ -113,7 +113,7 @@ aliases: "/docs/5.2/examples/offcanvas/"
<span class="d-block">@username</span>
</div>
</div>
- <div class="d-flex text-muted pt-3">
+ <div class="d-flex text-body-secondary pt-3">
{{< placeholder width="32" height="32" background="#007bff" color="#007bff" class="flex-shrink-0 me-2 rounded" >}}
<div class="pb-3 mb-0 small lh-sm border-bottom w-100">
<div class="d-flex justify-content-between">
@@ -123,7 +123,7 @@ aliases: "/docs/5.2/examples/offcanvas/"
<span class="d-block">@username</span>
</div>
</div>
- <div class="d-flex text-muted pt-3">
+ <div class="d-flex text-body-secondary pt-3">
{{< placeholder width="32" height="32" background="#007bff" color="#007bff" class="flex-shrink-0 me-2 rounded" >}}
<div class="pb-3 mb-0 small lh-sm border-bottom w-100">
<div class="d-flex justify-content-between">
diff --git a/site/content/docs/5.2/examples/offcanvas-navbar/offcanvas.css b/site/content/docs/5.3/examples/offcanvas-navbar/offcanvas-navbar.css
index f855b96..f855b96 100644
--- a/site/content/docs/5.2/examples/offcanvas-navbar/offcanvas.css
+++ b/site/content/docs/5.3/examples/offcanvas-navbar/offcanvas-navbar.css
diff --git a/site/content/docs/5.2/examples/offcanvas-navbar/offcanvas.js b/site/content/docs/5.3/examples/offcanvas-navbar/offcanvas-navbar.js
index b97a171..b97a171 100644
--- a/site/content/docs/5.2/examples/offcanvas-navbar/offcanvas.js
+++ b/site/content/docs/5.3/examples/offcanvas-navbar/offcanvas-navbar.js
diff --git a/site/content/docs/5.2/examples/pricing/index.html b/site/content/docs/5.3/examples/pricing/index.html
index 64b856a..e4e7b8a 100644
--- a/site/content/docs/5.2/examples/pricing/index.html
+++ b/site/content/docs/5.3/examples/pricing/index.html
@@ -3,7 +3,6 @@ layout: examples
title: Pricing example
extra_css:
- "pricing.css"
-include_js: false
---
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
@@ -16,22 +15,22 @@ include_js: false
<div class="container py-3">
<header>
<div class="d-flex flex-column flex-md-row align-items-center pb-3 mb-4 border-bottom">
- <a href="/" class="d-flex align-items-center text-dark text-decoration-none">
+ <a href="/" class="d-flex align-items-center link-body-emphasis text-decoration-none">
<svg xmlns="http://www.w3.org/2000/svg" width="40" height="32" class="me-2" viewBox="0 0 118 94" role="img"><title>Bootstrap</title><path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z" fill="currentColor"></path></svg>
<span class="fs-4">Pricing example</span>
</a>
<nav class="d-inline-flex mt-2 mt-md-0 ms-md-auto">
- <a class="me-3 py-2 text-dark text-decoration-none" href="#">Features</a>
- <a class="me-3 py-2 text-dark text-decoration-none" href="#">Enterprise</a>
- <a class="me-3 py-2 text-dark text-decoration-none" href="#">Support</a>
- <a class="py-2 text-dark text-decoration-none" href="#">Pricing</a>
+ <a class="me-3 py-2 link-body-emphasis text-decoration-none" href="#">Features</a>
+ <a class="me-3 py-2 link-body-emphasis text-decoration-none" href="#">Enterprise</a>
+ <a class="me-3 py-2 link-body-emphasis text-decoration-none" href="#">Support</a>
+ <a class="py-2 link-body-emphasis text-decoration-none" href="#">Pricing</a>
</nav>
</div>
<div class="pricing-header p-3 pb-md-4 mx-auto text-center">
- <h1 class="display-4 fw-normal">Pricing</h1>
- <p class="fs-5 text-muted">Quickly build an effective pricing table for your potential customers with this Bootstrap example. It’s built with default Bootstrap components and utilities with little customization.</p>
+ <h1 class="display-4 fw-normal text-body-emphasis">Pricing</h1>
+ <p class="fs-5 text-body-secondary">Quickly build an effective pricing table for your potential customers with this Bootstrap example. It’s built with default Bootstrap components and utilities with little customization.</p>
</div>
</header>
@@ -43,7 +42,7 @@ include_js: false
<h4 class="my-0 fw-normal">Free</h4>
</div>
<div class="card-body">
- <h1 class="card-title pricing-card-title">$0<small class="text-muted fw-light">/mo</small></h1>
+ <h1 class="card-title pricing-card-title">$0<small class="text-body-secondary fw-light">/mo</small></h1>
<ul class="list-unstyled mt-3 mb-4">
<li>10 users included</li>
<li>2 GB of storage</li>
@@ -60,7 +59,7 @@ include_js: false
<h4 class="my-0 fw-normal">Pro</h4>
</div>
<div class="card-body">
- <h1 class="card-title pricing-card-title">$15<small class="text-muted fw-light">/mo</small></h1>
+ <h1 class="card-title pricing-card-title">$15<small class="text-body-secondary fw-light">/mo</small></h1>
<ul class="list-unstyled mt-3 mb-4">
<li>20 users included</li>
<li>10 GB of storage</li>
@@ -77,7 +76,7 @@ include_js: false
<h4 class="my-0 fw-normal">Enterprise</h4>
</div>
<div class="card-body">
- <h1 class="card-title pricing-card-title">$29<small class="text-muted fw-light">/mo</small></h1>
+ <h1 class="card-title pricing-card-title">$29<small class="text-body-secondary fw-light">/mo</small></h1>
<ul class="list-unstyled mt-3 mb-4">
<li>30 users included</li>
<li>15 GB of storage</li>
@@ -151,7 +150,7 @@ include_js: false
<div class="row">
<div class="col-12 col-md">
<img class="mb-2" src="/docs/{{< param docs_version >}}/assets/brand/bootstrap-logo.svg" alt="" width="24" height="19">
- <small class="d-block mb-3 text-muted">&copy; 2017–{{< year >}}</small>
+ <small class="d-block mb-3 text-body-secondary">&copy; 2017–{{< year >}}</small>
</div>
<div class="col-6 col-md">
<h5>Features</h5>
diff --git a/site/content/docs/5.3/examples/pricing/pricing.css b/site/content/docs/5.3/examples/pricing/pricing.css
new file mode 100644
index 0000000..c65d020
--- /dev/null
+++ b/site/content/docs/5.3/examples/pricing/pricing.css
@@ -0,0 +1,11 @@
+body {
+ background-image: linear-gradient(180deg, var(--bs-secondary-bg), var(--bs-body-bg) 100px, var(--bs-body-bg));
+}
+
+.container {
+ max-width: 960px;
+}
+
+.pricing-header {
+ max-width: 700px;
+}
diff --git a/site/content/docs/5.3/examples/product/index.html b/site/content/docs/5.3/examples/product/index.html
new file mode 100644
index 0000000..a0ae98e
--- /dev/null
+++ b/site/content/docs/5.3/examples/product/index.html
@@ -0,0 +1,189 @@
+---
+layout: examples
+title: Product example
+extra_css:
+ - "product.css"
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="aperture" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24">
+ <circle cx="12" cy="12" r="10"/>
+ <path d="M14.31 8l5.74 9.94M9.69 8h11.48M7.38 12l5.74-9.94M9.69 16L3.95 6.06M14.31 16H2.83m13.79-4l-5.74 9.94"/>
+ </symbol>
+ <symbol id="cart" viewBox="0 0 16 16">
+ <path d="M0 1.5A.5.5 0 0 1 .5 1H2a.5.5 0 0 1 .485.379L2.89 3H14.5a.5.5 0 0 1 .49.598l-1 5a.5.5 0 0 1-.465.401l-9.397.472L4.415 11H13a.5.5 0 0 1 0 1H4a.5.5 0 0 1-.491-.408L2.01 3.607 1.61 2H.5a.5.5 0 0 1-.5-.5zM3.102 4l.84 4.479 9.144-.459L13.89 4H3.102zM5 12a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm7 0a2 2 0 1 0 0 4 2 2 0 0 0 0-4zm-7 1a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm7 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
+ </symbol>
+ <symbol id="chevron-right" viewBox="0 0 16 16">
+ <path fill-rule="evenodd" d="M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z"/>
+ </symbol>
+</svg>
+
+<nav class="navbar navbar-expand-md bg-dark sticky-top border-bottom" data-bs-theme="dark">
+ <div class="container">
+ <a class="navbar-brand d-md-none" href="#">
+ <svg class="bi" width="24" height="24"><use xlink:href="#aperture"/></svg>
+ Aperture
+ </a>
+ <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvas" aria-controls="#offcanvas" aria-label="Toggle navigation">
+ <span class="navbar-toggler-icon"></span>
+ </button>
+ <div class="offcanvas offcanvas-end" tabindex="-1" id="#offcanvas" aria-labelledby="#offcanvasLabel">
+ <div class="offcanvas-header">
+ <h5 class="offcanvas-title" id="#offcanvasLabel">Aperture</h5>
+ <button type="button" class="btn-close" data-bs-dismiss="offcanvas" aria-label="Close"></button>
+ </div>
+ <div class="offcanvas-body">
+ <ul class="navbar-nav flex-grow-1 justify-content-between">
+ <li class="nav-item"><a class="nav-link" href="#">
+ <svg class="bi" width="24" height="24"><use xlink:href="#aperture"/></svg>
+ </a></li>
+ <li class="nav-item"><a class="nav-link" href="#">Tour</a></li>
+ <li class="nav-item"><a class="nav-link" href="#">Product</a></li>
+ <li class="nav-item"><a class="nav-link" href="#">Features</a></li>
+ <li class="nav-item"><a class="nav-link" href="#">Enterprise</a></li>
+ <li class="nav-item"><a class="nav-link" href="#">Support</a></li>
+ <li class="nav-item"><a class="nav-link" href="#">Pricing</a></li>
+ <li class="nav-item"><a class="nav-link" href="#">
+ <svg class="bi" width="24" height="24"><use xlink:href="#cart"/></svg>
+ </a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+</nav>
+
+<main>
+ <div class="position-relative overflow-hidden p-3 p-md-5 m-md-3 text-center bg-body-tertiary">
+ <div class="col-md-6 p-lg-5 mx-auto my-5">
+ <h1 class="display-3 fw-bold">Designed for engineers</h1>
+ <h3 class="fw-normal text-muted mb-3">Build anything you want with Aperture</h3>
+ <div class="d-flex gap-3 justify-content-center lead fw-normal">
+ <a class="icon-link" href="#">
+ Learn more
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
+ </a>
+ <a class="icon-link" href="#">
+ Buy
+ <svg class="bi"><use xlink:href="#chevron-right"/></svg>
+ </a>
+ </div>
+ </div>
+ <div class="product-device shadow-sm d-none d-md-block"></div>
+ <div class="product-device product-device-2 shadow-sm d-none d-md-block"></div>
+ </div>
+
+ <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
+ <div class="text-bg-dark me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 py-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-body-tertiary shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ <div class="bg-body-tertiary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 p-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-dark shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ </div>
+
+ <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
+ <div class="bg-body-tertiary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 p-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-dark shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ <div class="text-bg-primary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 py-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-body-tertiary shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ </div>
+
+ <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
+ <div class="bg-body-tertiary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 p-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ <div class="bg-body-tertiary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 py-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ </div>
+
+ <div class="d-md-flex flex-md-equal w-100 my-md-3 ps-md-3">
+ <div class="bg-body-tertiary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 p-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ <div class="bg-body-tertiary me-md-3 pt-3 px-3 pt-md-5 px-md-5 text-center overflow-hidden">
+ <div class="my-3 py-3">
+ <h2 class="display-5">Another headline</h2>
+ <p class="lead">And an even wittier subheading.</p>
+ </div>
+ <div class="bg-body shadow-sm mx-auto" style="width: 80%; height: 300px; border-radius: 21px 21px 0 0;"></div>
+ </div>
+ </div>
+</main>
+
+<footer class="container py-5">
+ <div class="row">
+ <div class="col-12 col-md">
+ <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" class="d-block mb-2" role="img" viewBox="0 0 24 24"><title>Product</title><circle cx="12" cy="12" r="10"/><path d="M14.31 8l5.74 9.94M9.69 8h11.48M7.38 12l5.74-9.94M9.69 16L3.95 6.06M14.31 16H2.83m13.79-4l-5.74 9.94"/></svg>
+ <small class="d-block mb-3 text-body-secondary">&copy; 2017–{{< year >}}</small>
+ </div>
+ <div class="col-6 col-md">
+ <h5>Features</h5>
+ <ul class="list-unstyled text-small">
+ <li><a class="link-secondary text-decoration-none" href="#">Cool stuff</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Random feature</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Team feature</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Stuff for developers</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Another one</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Last time</a></li>
+ </ul>
+ </div>
+ <div class="col-6 col-md">
+ <h5>Resources</h5>
+ <ul class="list-unstyled text-small">
+ <li><a class="link-secondary text-decoration-none" href="#">Resource name</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Resource</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Another resource</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Final resource</a></li>
+ </ul>
+ </div>
+ <div class="col-6 col-md">
+ <h5>Resources</h5>
+ <ul class="list-unstyled text-small">
+ <li><a class="link-secondary text-decoration-none" href="#">Business</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Education</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Government</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Gaming</a></li>
+ </ul>
+ </div>
+ <div class="col-6 col-md">
+ <h5>About</h5>
+ <ul class="list-unstyled text-small">
+ <li><a class="link-secondary text-decoration-none" href="#">Team</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Locations</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Privacy</a></li>
+ <li><a class="link-secondary text-decoration-none" href="#">Terms</a></li>
+ </ul>
+ </div>
+ </div>
+</footer>
diff --git a/site/content/docs/5.2/examples/product/product.css b/site/content/docs/5.3/examples/product/product.css
index 5fcb582..6c90ae5 100644
--- a/site/content/docs/5.2/examples/product/product.css
+++ b/site/content/docs/5.3/examples/product/product.css
@@ -2,6 +2,11 @@
max-width: 960px;
}
+.icon-link > .bi {
+ width: .75em;
+ height: .75em;
+}
+
/*
* Custom translucent site header
*/
diff --git a/site/content/docs/5.2/examples/sidebars/index.html b/site/content/docs/5.3/examples/sidebars/index.html
index 48889fa..ee1edc1 100644
--- a/site/content/docs/5.2/examples/sidebars/index.html
+++ b/site/content/docs/5.3/examples/sidebars/index.html
@@ -30,41 +30,6 @@ body_class: ""
<symbol id="grid" viewBox="0 0 16 16">
<path d="M1 2.5A1.5 1.5 0 0 1 2.5 1h3A1.5 1.5 0 0 1 7 2.5v3A1.5 1.5 0 0 1 5.5 7h-3A1.5 1.5 0 0 1 1 5.5v-3zM2.5 2a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3zm6.5.5A1.5 1.5 0 0 1 10.5 1h3A1.5 1.5 0 0 1 15 2.5v3A1.5 1.5 0 0 1 13.5 7h-3A1.5 1.5 0 0 1 9 5.5v-3zm1.5-.5a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3zM1 10.5A1.5 1.5 0 0 1 2.5 9h3A1.5 1.5 0 0 1 7 10.5v3A1.5 1.5 0 0 1 5.5 15h-3A1.5 1.5 0 0 1 1 13.5v-3zm1.5-.5a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3zm6.5.5A1.5 1.5 0 0 1 10.5 9h3a1.5 1.5 0 0 1 1.5 1.5v3a1.5 1.5 0 0 1-1.5 1.5h-3A1.5 1.5 0 0 1 9 13.5v-3zm1.5-.5a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3z"/>
</symbol>
- <symbol id="collection" viewBox="0 0 16 16">
- <path d="M2.5 3.5a.5.5 0 0 1 0-1h11a.5.5 0 0 1 0 1h-11zm2-2a.5.5 0 0 1 0-1h7a.5.5 0 0 1 0 1h-7zM0 13a1.5 1.5 0 0 0 1.5 1.5h13A1.5 1.5 0 0 0 16 13V6a1.5 1.5 0 0 0-1.5-1.5h-13A1.5 1.5 0 0 0 0 6v7zm1.5.5A.5.5 0 0 1 1 13V6a.5.5 0 0 1 .5-.5h13a.5.5 0 0 1 .5.5v7a.5.5 0 0 1-.5.5h-13z"/>
- </symbol>
- <symbol id="calendar3" viewBox="0 0 16 16">
- <path d="M14 0H2a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V2a2 2 0 0 0-2-2zM1 3.857C1 3.384 1.448 3 2 3h12c.552 0 1 .384 1 .857v10.286c0 .473-.448.857-1 .857H2c-.552 0-1-.384-1-.857V3.857z"/>
- <path d="M6.5 7a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm-9 3a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2zm3 0a1 1 0 1 0 0-2 1 1 0 0 0 0 2z"/>
- </symbol>
- <symbol id="chat-quote-fill" viewBox="0 0 16 16">
- <path d="M16 8c0 3.866-3.582 7-8 7a9.06 9.06 0 0 1-2.347-.306c-.584.296-1.925.864-4.181 1.234-.2.032-.352-.176-.273-.362.354-.836.674-1.95.77-2.966C.744 11.37 0 9.76 0 8c0-3.866 3.582-7 8-7s8 3.134 8 7zM7.194 6.766a1.688 1.688 0 0 0-.227-.272 1.467 1.467 0 0 0-.469-.324l-.008-.004A1.785 1.785 0 0 0 5.734 6C4.776 6 4 6.746 4 7.667c0 .92.776 1.666 1.734 1.666.343 0 .662-.095.931-.26-.137.389-.39.804-.81 1.22a.405.405 0 0 0 .011.59c.173.16.447.155.614-.01 1.334-1.329 1.37-2.758.941-3.706a2.461 2.461 0 0 0-.227-.4zM11 9.073c-.136.389-.39.804-.81 1.22a.405.405 0 0 0 .012.59c.172.16.446.155.613-.01 1.334-1.329 1.37-2.758.942-3.706a2.466 2.466 0 0 0-.228-.4 1.686 1.686 0 0 0-.227-.273 1.466 1.466 0 0 0-.469-.324l-.008-.004A1.785 1.785 0 0 0 10.07 6c-.957 0-1.734.746-1.734 1.667 0 .92.777 1.666 1.734 1.666.343 0 .662-.095.931-.26z"/>
- </symbol>
- <symbol id="cpu-fill" viewBox="0 0 16 16">
- <path d="M6.5 6a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3z"/>
- <path d="M5.5.5a.5.5 0 0 0-1 0V2A2.5 2.5 0 0 0 2 4.5H.5a.5.5 0 0 0 0 1H2v1H.5a.5.5 0 0 0 0 1H2v1H.5a.5.5 0 0 0 0 1H2v1H.5a.5.5 0 0 0 0 1H2A2.5 2.5 0 0 0 4.5 14v1.5a.5.5 0 0 0 1 0V14h1v1.5a.5.5 0 0 0 1 0V14h1v1.5a.5.5 0 0 0 1 0V14h1v1.5a.5.5 0 0 0 1 0V14a2.5 2.5 0 0 0 2.5-2.5h1.5a.5.5 0 0 0 0-1H14v-1h1.5a.5.5 0 0 0 0-1H14v-1h1.5a.5.5 0 0 0 0-1H14v-1h1.5a.5.5 0 0 0 0-1H14A2.5 2.5 0 0 0 11.5 2V.5a.5.5 0 0 0-1 0V2h-1V.5a.5.5 0 0 0-1 0V2h-1V.5a.5.5 0 0 0-1 0V2h-1V.5zm1 4.5h3A1.5 1.5 0 0 1 11 6.5v3A1.5 1.5 0 0 1 9.5 11h-3A1.5 1.5 0 0 1 5 9.5v-3A1.5 1.5 0 0 1 6.5 5z"/>
- </symbol>
- <symbol id="gear-fill" viewBox="0 0 16 16">
- <path d="M9.405 1.05c-.413-1.4-2.397-1.4-2.81 0l-.1.34a1.464 1.464 0 0 1-2.105.872l-.31-.17c-1.283-.698-2.686.705-1.987 1.987l.169.311c.446.82.023 1.841-.872 2.105l-.34.1c-1.4.413-1.4 2.397 0 2.81l.34.1a1.464 1.464 0 0 1 .872 2.105l-.17.31c-.698 1.283.705 2.686 1.987 1.987l.311-.169a1.464 1.464 0 0 1 2.105.872l.1.34c.413 1.4 2.397 1.4 2.81 0l.1-.34a1.464 1.464 0 0 1 2.105-.872l.31.17c1.283.698 2.686-.705 1.987-1.987l-.169-.311a1.464 1.464 0 0 1 .872-2.105l.34-.1c1.4-.413 1.4-2.397 0-2.81l-.34-.1a1.464 1.464 0 0 1-.872-2.105l.17-.31c.698-1.283-.705-2.686-1.987-1.987l-.311.169a1.464 1.464 0 0 1-2.105-.872l-.1-.34zM8 10.93a2.929 2.929 0 1 1 0-5.86 2.929 2.929 0 0 1 0 5.858z"/>
- </symbol>
- <symbol id="speedometer" viewBox="0 0 16 16">
- <path d="M8 2a.5.5 0 0 1 .5.5V4a.5.5 0 0 1-1 0V2.5A.5.5 0 0 1 8 2zM3.732 3.732a.5.5 0 0 1 .707 0l.915.914a.5.5 0 1 1-.708.708l-.914-.915a.5.5 0 0 1 0-.707zM2 8a.5.5 0 0 1 .5-.5h1.586a.5.5 0 0 1 0 1H2.5A.5.5 0 0 1 2 8zm9.5 0a.5.5 0 0 1 .5-.5h1.5a.5.5 0 0 1 0 1H12a.5.5 0 0 1-.5-.5zm.754-4.246a.389.389 0 0 0-.527-.02L7.547 7.31A.91.91 0 1 0 8.85 8.569l3.434-4.297a.389.389 0 0 0-.029-.518z"/>
- <path fill-rule="evenodd" d="M6.664 15.889A8 8 0 1 1 9.336.11a8 8 0 0 1-2.672 15.78zm-4.665-4.283A11.945 11.945 0 0 1 8 10c2.186 0 4.236.585 6.001 1.606a7 7 0 1 0-12.002 0z"/>
- </symbol>
- <symbol id="toggles2" viewBox="0 0 16 16">
- <path d="M9.465 10H12a2 2 0 1 1 0 4H9.465c.34-.588.535-1.271.535-2 0-.729-.195-1.412-.535-2z"/>
- <path d="M6 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6zm0 1a4 4 0 1 1 0-8 4 4 0 0 1 0 8zm.535-10a3.975 3.975 0 0 1-.409-1H4a1 1 0 0 1 0-2h2.126c.091-.355.23-.69.41-1H4a2 2 0 1 0 0 4h2.535z"/>
- <path d="M14 4a4 4 0 1 1-8 0 4 4 0 0 1 8 0z"/>
- </symbol>
- <symbol id="tools" viewBox="0 0 16 16">
- <path d="M1 0L0 1l2.2 3.081a1 1 0 0 0 .815.419h.07a1 1 0 0 1 .708.293l2.675 2.675-2.617 2.654A3.003 3.003 0 0 0 0 13a3 3 0 1 0 5.878-.851l2.654-2.617.968.968-.305.914a1 1 0 0 0 .242 1.023l3.356 3.356a1 1 0 0 0 1.414 0l1.586-1.586a1 1 0 0 0 0-1.414l-3.356-3.356a1 1 0 0 0-1.023-.242L10.5 9.5l-.96-.96 2.68-2.643A3.005 3.005 0 0 0 16 3c0-.269-.035-.53-.102-.777l-2.14 2.141L12 4l-.364-1.757L13.777.102a3 3 0 0 0-3.675 3.68L7.462 6.46 4.793 3.793a1 1 0 0 1-.293-.707v-.071a1 1 0 0 0-.419-.814L1 0zm9.646 10.646a.5.5 0 0 1 .708 0l3 3a.5.5 0 0 1-.708.708l-3-3a.5.5 0 0 1 0-.708zM3 11l.471.242.529.026.287.445.445.287.026.529L5 13l-.242.471-.026.529-.445.287-.287.445-.529.026L3 15l-.471-.242L2 14.732l-.287-.445L1.268 14l-.026-.529L1 13l.242-.471.026-.529.445-.287.287-.445.529-.026L3 11z"/>
- </symbol>
- <symbol id="chevron-right" viewBox="0 0 16 16">
- <path fill-rule="evenodd" d="M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z"/>
- </symbol>
- <symbol id="geo-fill" viewBox="0 0 16 16">
- <path fill-rule="evenodd" d="M4 4a4 4 0 1 1 4.5 3.969V13.5a.5.5 0 0 1-1 0V7.97A4 4 0 0 1 4 3.999zm2.493 8.574a.5.5 0 0 1-.411.575c-.712.118-1.28.295-1.655.493a1.319 1.319 0 0 0-.37.265.301.301 0 0 0-.057.09V14l.002.008a.147.147 0 0 0 .016.033.617.617 0 0 0 .145.15c.165.13.435.27.813.395.751.25 1.82.414 3.024.414s2.273-.163 3.024-.414c.378-.126.648-.265.813-.395a.619.619 0 0 0 .146-.15.148.148 0 0 0 .015-.033L12 14v-.004a.301.301 0 0 0-.057-.09 1.318 1.318 0 0 0-.37-.264c-.376-.198-.943-.375-1.655-.493a.5.5 0 1 1 .164-.986c.77.127 1.452.328 1.957.594C12.5 13 13 13.4 13 14c0 .426-.26.752-.544.977-.29.228-.68.413-1.116.558-.878.293-2.059.465-3.34.465-1.281 0-2.462-.172-3.34-.465-.436-.145-.826-.33-1.116-.558C3.26 14.752 3 14.426 3 14c0-.599.5-1 .961-1.243.505-.266 1.187-.467 1.957-.594a.5.5 0 0 1 .575.411z"/>
- </symbol>
</svg>
<main class="d-flex flex-nowrap">
@@ -126,8 +91,8 @@ body_class: ""
<div class="b-example-divider b-example-vr"></div>
- <div class="d-flex flex-column flex-shrink-0 p-3 bg-light" style="width: 280px;">
- <a href="/" class="d-flex align-items-center mb-3 mb-md-0 me-md-auto link-dark text-decoration-none">
+ <div class="d-flex flex-column flex-shrink-0 p-3 bg-body-tertiary" style="width: 280px;">
+ <a href="/" class="d-flex align-items-center mb-3 mb-md-0 me-md-auto link-body-emphasis text-decoration-none">
<svg class="bi pe-none me-2" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
<span class="fs-4">Sidebar</span>
</a>
@@ -140,25 +105,25 @@ body_class: ""
</a>
</li>
<li>
- <a href="#" class="nav-link link-dark">
+ <a href="#" class="nav-link link-body-emphasis">
<svg class="bi pe-none me-2" width="16" height="16"><use xlink:href="#speedometer2"/></svg>
Dashboard
</a>
</li>
<li>
- <a href="#" class="nav-link link-dark">
+ <a href="#" class="nav-link link-body-emphasis">
<svg class="bi pe-none me-2" width="16" height="16"><use xlink:href="#table"/></svg>
Orders
</a>
</li>
<li>
- <a href="#" class="nav-link link-dark">
+ <a href="#" class="nav-link link-body-emphasis">
<svg class="bi pe-none me-2" width="16" height="16"><use xlink:href="#grid"/></svg>
Products
</a>
</li>
<li>
- <a href="#" class="nav-link link-dark">
+ <a href="#" class="nav-link link-body-emphasis">
<svg class="bi pe-none me-2" width="16" height="16"><use xlink:href="#people-circle"/></svg>
Customers
</a>
@@ -166,7 +131,7 @@ body_class: ""
</ul>
<hr>
<div class="dropdown">
- <a href="#" class="d-flex align-items-center link-dark text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
+ <a href="#" class="d-flex align-items-center link-body-emphasis text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
<img src="https://github.com/mdo.png" alt="" width="32" height="32" class="rounded-circle me-2">
<strong>mdo</strong>
</a>
@@ -182,8 +147,8 @@ body_class: ""
<div class="b-example-divider b-example-vr"></div>
- <div class="d-flex flex-column flex-shrink-0 bg-light" style="width: 4.5rem;">
- <a href="/" class="d-block p-3 link-dark text-decoration-none" title="Icon-only" data-bs-toggle="tooltip" data-bs-placement="right">
+ <div class="d-flex flex-column flex-shrink-0 bg-body-tertiary" style="width: 4.5rem;">
+ <a href="/" class="d-block p-3 link-body-emphasis text-decoration-none" title="Icon-only" data-bs-toggle="tooltip" data-bs-placement="right">
<svg class="bi pe-none" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
<span class="visually-hidden">Icon-only</span>
</a>
@@ -215,7 +180,7 @@ body_class: ""
</li>
</ul>
<div class="dropdown border-top">
- <a href="#" class="d-flex align-items-center justify-content-center p-3 link-dark text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
+ <a href="#" class="d-flex align-items-center justify-content-center p-3 link-body-emphasis text-decoration-none dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
<img src="https://github.com/mdo.png" alt="mdo" width="24" height="24" class="rounded-circle">
</a>
<ul class="dropdown-menu text-small shadow">
@@ -230,8 +195,8 @@ body_class: ""
<div class="b-example-divider b-example-vr"></div>
- <div class="flex-shrink-0 p-3 bg-white" style="width: 280px;">
- <a href="/" class="d-flex align-items-center pb-3 mb-3 link-dark text-decoration-none border-bottom">
+ <div class="flex-shrink-0 p-3" style="width: 280px;">
+ <a href="/" class="d-flex align-items-center pb-3 mb-3 link-body-emphasis text-decoration-none border-bottom">
<svg class="bi pe-none me-2" width="30" height="24"><use xlink:href="#bootstrap"/></svg>
<span class="fs-5 fw-semibold">Collapsible</span>
</a>
@@ -242,9 +207,9 @@ body_class: ""
</button>
<div class="collapse show" id="home-collapse">
<ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small">
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Overview</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Updates</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Reports</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Overview</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Updates</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Reports</a></li>
</ul>
</div>
</li>
@@ -254,10 +219,10 @@ body_class: ""
</button>
<div class="collapse" id="dashboard-collapse">
<ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small">
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Overview</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Weekly</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Monthly</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Annually</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Overview</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Weekly</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Monthly</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Annually</a></li>
</ul>
</div>
</li>
@@ -267,10 +232,10 @@ body_class: ""
</button>
<div class="collapse" id="orders-collapse">
<ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small">
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">New</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Processed</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Shipped</a></li>
- <li><a href="#" class="link-dark d-inline-flex text-decoration-none rounded">Returned</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">New</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Processed</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Shipped</a></li>
+ <li><a href="#" class="link-body-emphasis d-inline-flex text-decoration-none rounded">Returned</a></li>
</ul>
</div>
</li>
@@ -293,8 +258,8 @@ body_class: ""
<div class="b-example-divider b-example-vr"></div>
- <div class="d-flex flex-column align-items-stretch flex-shrink-0 bg-white" style="width: 380px;">
- <a href="/" class="d-flex align-items-center flex-shrink-0 p-3 link-dark text-decoration-none border-bottom">
+ <div class="d-flex flex-column align-items-stretch flex-shrink-0 bg-body-tertiary" style="width: 380px;">
+ <a href="/" class="d-flex align-items-center flex-shrink-0 p-3 link-body-emphasis text-decoration-none border-bottom">
<svg class="bi pe-none me-2" width="30" height="24"><use xlink:href="#bootstrap"/></svg>
<span class="fs-5 fw-semibold">List group</span>
</a>
@@ -309,14 +274,14 @@ body_class: ""
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Tues</small>
+ <small class="text-body-secondary">Tues</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Mon</small>
+ <small class="text-body-secondary">Mon</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
@@ -324,63 +289,63 @@ body_class: ""
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm" aria-current="true">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Wed</small>
+ <small class="text-body-secondary">Wed</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Tues</small>
+ <small class="text-body-secondary">Tues</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Mon</small>
+ <small class="text-body-secondary">Mon</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm" aria-current="true">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Wed</small>
+ <small class="text-body-secondary">Wed</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Tues</small>
+ <small class="text-body-secondary">Tues</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Mon</small>
+ <small class="text-body-secondary">Mon</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm" aria-current="true">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Wed</small>
+ <small class="text-body-secondary">Wed</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Tues</small>
+ <small class="text-body-secondary">Tues</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
<a href="#" class="list-group-item list-group-item-action py-3 lh-sm">
<div class="d-flex w-100 align-items-center justify-content-between">
<strong class="mb-1">List group item heading</strong>
- <small class="text-muted">Mon</small>
+ <small class="text-body-secondary">Mon</small>
</div>
<div class="col-10 mb-1 small">Some placeholder content in a paragraph below the heading and date.</div>
</a>
diff --git a/site/content/docs/5.2/examples/sidebars/sidebars.css b/site/content/docs/5.3/examples/sidebars/sidebars.css
index 5dc9fba..f6a8f1c 100644
--- a/site/content/docs/5.2/examples/sidebars/sidebars.css
+++ b/site/content/docs/5.3/examples/sidebars/sidebars.css
@@ -20,13 +20,13 @@ main {
.btn-toggle {
padding: .25rem .5rem;
font-weight: 600;
- color: rgba(0, 0, 0, .65);
+ color: var(--bs-emphasis-color);
background-color: transparent;
}
.btn-toggle:hover,
.btn-toggle:focus {
- color: rgba(0, 0, 0, .85);
- background-color: #d2f4ea;
+ color: rgba(var(--bs-emphasis-color-rgb), .85);
+ background-color: var(--bs-tertiary-bg);
}
.btn-toggle::before {
@@ -37,8 +37,12 @@ main {
transform-origin: .5em 50%;
}
+[data-bs-theme="dark"] .btn-toggle::before {
+ content: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%28255,255,255,.5%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e");
+}
+
.btn-toggle[aria-expanded="true"] {
- color: rgba(0, 0, 0, .85);
+ color: rgba(var(--bs-emphasis-color-rgb), .85);
}
.btn-toggle[aria-expanded="true"]::before {
transform: rotate(90deg);
@@ -51,7 +55,7 @@ main {
}
.btn-toggle-nav a:hover,
.btn-toggle-nav a:focus {
- background-color: #d2f4ea;
+ background-color: var(--bs-tertiary-bg);
}
.scrollarea {
diff --git a/site/content/docs/5.2/examples/sidebars/sidebars.js b/site/content/docs/5.3/examples/sidebars/sidebars.js
index 4075f1f..4075f1f 100644
--- a/site/content/docs/5.2/examples/sidebars/sidebars.js
+++ b/site/content/docs/5.3/examples/sidebars/sidebars.js
diff --git a/site/content/docs/5.2/examples/sign-in/index.html b/site/content/docs/5.3/examples/sign-in/index.html
index 8772ba3..8420c45 100644
--- a/site/content/docs/5.2/examples/sign-in/index.html
+++ b/site/content/docs/5.3/examples/sign-in/index.html
@@ -2,9 +2,8 @@
layout: examples
title: Signin Template
extra_css:
- - "signin.css"
-body_class: "text-center"
-include_js: false
+ - "sign-in.css"
+body_class: "d-flex align-items-center py-4 bg-body-tertiary"
---
<main class="form-signin w-100 m-auto">
@@ -21,12 +20,13 @@ include_js: false
<label for="floatingPassword">Password</label>
</div>
- <div class="checkbox mb-3">
- <label>
- <input type="checkbox" value="remember-me"> Remember me
+ <div class="form-check text-start my-3">
+ <input class="form-check-input" type="checkbox" value="remember-me" id="flexCheckDefault">
+ <label class="form-check-label" for="flexCheckDefault">
+ Remember me
</label>
</div>
- <button class="w-100 btn btn-lg btn-primary" type="submit">Sign in</button>
- <p class="mt-5 mb-3 text-muted">&copy; 2017–{{< year >}}</p>
+ <button class="btn btn-primary w-100 py-2" type="submit">Sign in</button>
+ <p class="mt-5 mb-3 text-body-secondary">&copy; 2017–{{< year >}}</p>
</form>
</main>
diff --git a/site/content/docs/5.2/examples/sign-in/signin.css b/site/content/docs/5.3/examples/sign-in/sign-in.css
index 89deea4..641f6d9 100644
--- a/site/content/docs/5.2/examples/sign-in/signin.css
+++ b/site/content/docs/5.3/examples/sign-in/sign-in.css
@@ -3,17 +3,9 @@ body {
height: 100%;
}
-body {
- display: flex;
- align-items: center;
- padding-top: 40px;
- padding-bottom: 40px;
- background-color: #f5f5f5;
-}
-
.form-signin {
max-width: 330px;
- padding: 15px;
+ padding: 1rem;
}
.form-signin .form-floating:focus-within {
diff --git a/site/content/docs/5.3/examples/starter-template/index.html b/site/content/docs/5.3/examples/starter-template/index.html
new file mode 100644
index 0000000..0a24a1e
--- /dev/null
+++ b/site/content/docs/5.3/examples/starter-template/index.html
@@ -0,0 +1,107 @@
+---
+layout: examples
+title: Starter Template
+---
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+ <symbol id="arrow-right-circle" viewBox="0 0 16 16">
+ <path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0zM4.5 7.5a.5.5 0 0 0 0 1h5.793l-2.147 2.146a.5.5 0 0 0 .708.708l3-3a.5.5 0 0 0 0-.708l-3-3a.5.5 0 1 0-.708.708L10.293 7.5H4.5z"/>
+ </symbol>
+ <symbol id="bootstrap" viewBox="0 0 118 94">
+ <title>Bootstrap</title>
+ <path fill-rule="evenodd" clip-rule="evenodd" d="M24.509 0c-6.733 0-11.715 5.893-11.492 12.284.214 6.14-.064 14.092-2.066 20.577C8.943 39.365 5.547 43.485 0 44.014v5.972c5.547.529 8.943 4.649 10.951 11.153 2.002 6.485 2.28 14.437 2.066 20.577C12.794 88.106 17.776 94 24.51 94H93.5c6.733 0 11.714-5.893 11.491-12.284-.214-6.14.064-14.092 2.066-20.577 2.009-6.504 5.396-10.624 10.943-11.153v-5.972c-5.547-.529-8.934-4.649-10.943-11.153-2.002-6.484-2.28-14.437-2.066-20.577C105.214 5.894 100.233 0 93.5 0H24.508zM80 57.863C80 66.663 73.436 72 62.543 72H44a2 2 0 01-2-2V24a2 2 0 012-2h18.437c9.083 0 15.044 4.92 15.044 12.474 0 5.302-4.01 10.049-9.119 10.88v.277C75.317 46.394 80 51.21 80 57.863zM60.521 28.34H49.948v14.934h8.905c6.884 0 10.68-2.772 10.68-7.727 0-4.643-3.264-7.207-9.012-7.207zM49.948 49.2v16.458H60.91c7.167 0 10.964-2.876 10.964-8.281 0-5.406-3.903-8.178-11.425-8.178H49.948z"></path>
+ </symbol>
+</svg>
+
+<div class="col-lg-8 mx-auto p-4 py-md-5">
+ <header class="d-flex align-items-center pb-3 mb-5 border-bottom">
+ <a href="/" class="d-flex align-items-center text-body-emphasis text-decoration-none">
+ <svg class="bi me-2" width="40" height="32"><use xlink:href="#bootstrap"/></svg>
+ <span class="fs-4">Starter template</span>
+ </a>
+ </header>
+
+ <main>
+ <h1 class="text-body-emphasis">Get started with Bootstrap</h1>
+ <p class="fs-5 col-md-8">Quickly and easily get started with Bootstrap's compiled, production-ready files with this barebones example featuring some basic HTML and helpful links. Download all our examples to get started.</p>
+
+ <div class="mb-5">
+ <a href="{{< docsref "/examples" >}}" class="btn btn-primary btn-lg px-4">Download examples</a>
+ </div>
+
+ <hr class="col-3 col-md-2 mb-5">
+
+ <div class="row g-5">
+ <div class="col-md-6">
+ <h2 class="text-body-emphasis">Starter projects</h2>
+ <p>Ready to beyond the starter template? Check out these open source projects that you can quickly duplicate to a new GitHub repository.</p>
+ <ul class="list-unstyled ps-0">
+ <li>
+ <a class="icon-link mb-1" href="https://github.com/twbs/examples/tree/main/icons-font" rel="noopener" target="_blank">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap npm starter
+ </a>
+ </li>
+ <li>
+ <a class="icon-link mb-1" href="https://github.com/twbs/examples/tree/main/parcel" rel="noopener" target="_blank">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap Parcel starter
+ </a>
+ </li>
+ <li>
+ <a class="icon-link mb-1" href="https://github.com/twbs/examples/tree/main/vite" rel="noopener" target="_blank">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap Vite starter
+ </a>
+ </li>
+ <li>
+ <a class="icon-link mb-1" href="https://github.com/twbs/examples/tree/main/webpack" rel="noopener" target="_blank">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap Webpack starter
+ </a>
+ </li>
+ </ul>
+ </div>
+
+ <div class="col-md-6">
+ <h2 class="text-body-emphasis">Guides</h2>
+ <p>Read more detailed instructions and documentation on using or contributing to Bootstrap.</p>
+ <ul class="list-unstyled ps-0">
+ <li>
+ <a class="icon-link mb-1" href="{{< docsref "/getting-started/introduction" >}}">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap quick start guide
+ </a>
+ </li>
+ <li>
+ <a class="icon-link mb-1" href="{{< docsref "/getting-started/webpack" >}}">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap Webpack guide
+ </a>
+ </li>
+ <li>
+ <a class="icon-link mb-1" href="{{< docsref "/getting-started/parcel" >}}">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap Parcel guide
+ </a>
+ </li>
+ <li>
+ <a class="icon-link mb-1" href="{{< docsref "/getting-started/vite" >}}">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Bootstrap Vite guide
+ </a>
+ </li>
+ <li>
+ <a class="icon-link mb-1" href="{{< docsref "/getting-started/contribute" >}}">
+ <svg class="bi" width="16" height="16"><use xlink:href="#arrow-right-circle"/></svg>
+ Contributing to Bootstrap
+ </a>
+ </li>
+ </ul>
+ </div>
+ </div>
+ </main>
+ <footer class="pt-5 my-5 text-body-secondary border-top">
+ Created by the Bootstrap team &middot; &copy; {{< year >}}
+ </footer>
+</div>
diff --git a/site/content/docs/5.2/examples/sticky-footer-navbar/index.html b/site/content/docs/5.3/examples/sticky-footer-navbar/index.html
index 1f807a6..75b99cd 100644
--- a/site/content/docs/5.2/examples/sticky-footer-navbar/index.html
+++ b/site/content/docs/5.3/examples/sticky-footer-navbar/index.html
@@ -45,8 +45,8 @@ body_class: "d-flex flex-column h-100"
</div>
</main>
-<footer class="footer mt-auto py-3 bg-light">
+<footer class="footer mt-auto py-3 bg-body-tertiary">
<div class="container">
- <span class="text-muted">Place sticky footer content here.</span>
+ <span class="text-body-secondary">Place sticky footer content here.</span>
</div>
</footer>
diff --git a/site/content/docs/5.2/examples/sticky-footer-navbar/sticky-footer-navbar.css b/site/content/docs/5.3/examples/sticky-footer-navbar/sticky-footer-navbar.css
index 3087ead..3087ead 100644
--- a/site/content/docs/5.2/examples/sticky-footer-navbar/sticky-footer-navbar.css
+++ b/site/content/docs/5.3/examples/sticky-footer-navbar/sticky-footer-navbar.css
diff --git a/site/content/docs/5.2/examples/sticky-footer/index.html b/site/content/docs/5.3/examples/sticky-footer/index.html
index 7a6e127..631adda 100644
--- a/site/content/docs/5.2/examples/sticky-footer/index.html
+++ b/site/content/docs/5.3/examples/sticky-footer/index.html
@@ -5,7 +5,6 @@ extra_css:
- "sticky-footer.css"
html_class: "h-100"
body_class: "d-flex flex-column h-100"
-include_js: false
---
<!-- Begin page content -->
@@ -17,8 +16,8 @@ include_js: false
</div>
</main>
-<footer class="footer mt-auto py-3 bg-light">
+<footer class="footer mt-auto py-3 bg-body-tertiary">
<div class="container">
- <span class="text-muted">Place sticky footer content here.</span>
+ <span class="text-body-secondary">Place sticky footer content here.</span>
</div>
</footer>
diff --git a/site/content/docs/5.2/examples/sticky-footer/sticky-footer.css b/site/content/docs/5.3/examples/sticky-footer/sticky-footer.css
index f8be437..f8be437 100644
--- a/site/content/docs/5.2/examples/sticky-footer/sticky-footer.css
+++ b/site/content/docs/5.3/examples/sticky-footer/sticky-footer.css
diff --git a/site/content/docs/5.2/extend/approach.md b/site/content/docs/5.3/extend/approach.md
index 4a4cc72..392aef4 100644
--- a/site/content/docs/5.2/extend/approach.md
+++ b/site/content/docs/5.3/extend/approach.md
@@ -4,7 +4,7 @@ title: Approach
description: Learn about the guiding principles, strategies, and techniques used to build and maintain Bootstrap so you can more easily customize and extend it yourself.
group: extend
aliases:
- - "/docs/5.2/extend/"
+ - "/docs/5.3/extend/"
---
While the getting started pages provide an introductory tour of the project and what it offers, this document focuses on _why_ we do the things we do in Bootstrap. It explains our philosophy to building on the web so that others can learn from us, contribute with us, and help us improve.
@@ -18,7 +18,7 @@ We'll dive into each of these more throughout, but at a high level, here's what
- Components should be responsive and mobile-first
- Components should be built with a base class and extended via modifier classes
- Component states should obey a common z-index scale
-- Whenever possible, prefer a HTML and CSS implementation over JavaScript
+- Whenever possible, prefer an HTML and CSS implementation over JavaScript
- Whenever possible, use utilities over custom styles
- Whenever possible, avoid enforcing strict HTML requirements (children selectors)
@@ -65,7 +65,7 @@ This principle is our first-class JavaScript API using `data` attributes. You do
Lastly, our styles build on the fundamental behaviors of common web elements. Whenever possible, we prefer to use what the browser provides. For example, you can put a `.btn` class on nearly any element, but most elements don't provide any semantic value or browser functionality. So instead, we use `<button>`s and `<a>`s.
-The same goes for more complex components. While we *could* write our own form validation plugin to add classes to a parent element based on an input's state, thereby allowing us to style the text say red, we prefer using the `:valid`/`:invalid` pseudo-elements every browser provides us.
+The same goes for more complex components. While we _could_ write our own form validation plugin to add classes to a parent element based on an input's state, thereby allowing us to style the text say red, we prefer using the `:valid`/`:invalid` pseudo-elements every browser provides us.
## Utilities
diff --git a/site/content/docs/5.2/extend/icons.md b/site/content/docs/5.3/extend/icons.md
index 1e26503..1e26503 100644
--- a/site/content/docs/5.2/extend/icons.md
+++ b/site/content/docs/5.3/extend/icons.md
diff --git a/site/content/docs/5.2/forms/checks-radios.md b/site/content/docs/5.3/forms/checks-radios.md
index 12f8b00..13a5091 100644
--- a/site/content/docs/5.2/forms/checks-radios.md
+++ b/site/content/docs/5.3/forms/checks-radios.md
@@ -3,7 +3,7 @@ layout: docs
title: Checks and radios
description: Create consistent cross-browser and cross-device checkboxes and radios with our completely rewritten checks component.
group: forms
-aliases: "/docs/5.2/forms/checks/"
+aliases: "/docs/5.3/forms/checks/"
toc: true
---
@@ -300,8 +300,14 @@ Different variants of `.btn`, such at the various outlined styles, are supported
<label class="btn btn-outline-danger" for="danger-outlined">Danger radio</label>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
+
+Variables for checks:
{{< scss-docs name="form-check-variables" file="scss/_variables.scss" >}}
+
+Variables for switches:
+
+{{< scss-docs name="form-switch-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/forms/floating-labels.md b/site/content/docs/5.3/forms/floating-labels.md
index 9ec4fcd..a65a857 100644
--- a/site/content/docs/5.2/forms/floating-labels.md
+++ b/site/content/docs/5.3/forms/floating-labels.md
@@ -75,6 +75,34 @@ Other than `.form-control`, floating labels are only available on `.form-select`
</div>
{{< /example >}}
+## Disabled
+
+Add the `disabled` boolean attribute on an input, a textarea or a select to give it a grayed out appearance, remove pointer events, and prevent focusing.
+
+{{< example >}}
+<div class="form-floating mb-3">
+ <input type="email" class="form-control" id="floatingInputDisabled" placeholder="name@example.com" disabled>
+ <label for="floatingInputDisabled">Email address</label>
+</div>
+<div class="form-floating mb-3">
+ <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextareaDisabled" disabled></textarea>
+ <label for="floatingTextareaDisabled">Comments</label>
+</div>
+<div class="form-floating mb-3">
+ <textarea class="form-control" placeholder="Leave a comment here" id="floatingTextarea2Disabled" style="height: 100px" disabled></textarea>
+ <label for="floatingTextarea2Disabled">Comments</label>
+</div>
+<div class="form-floating">
+ <select class="form-select" id="floatingSelectDisabled" aria-label="Floating label disabled select example" disabled>
+ <option selected>Open this select menu</option>
+ <option value="1">One</option>
+ <option value="2">Two</option>
+ <option value="3">Three</option>
+ </select>
+ <label for="floatingSelectDisabled">Works with selects</label>
+</div>
+{{< /example >}}
+
## Readonly plaintext
Floating labels also support `.form-control-plaintext`, which can be helpful for toggling from an editable `<input>` to a plaintext value without affecting the page layout.
@@ -145,8 +173,8 @@ When working with the Bootstrap grid system, be sure to place form elements with
</div>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="form-floating-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/forms/form-control.md b/site/content/docs/5.3/forms/form-control.md
index 4d6972d..0c6b599 100644
--- a/site/content/docs/5.2/forms/form-control.md
+++ b/site/content/docs/5.3/forms/form-control.md
@@ -8,6 +8,8 @@ toc: true
## Example
+Form controls are styled with a mix of Sass and CSS variables, allowing them to adapt to color modes and support any customization method.
+
{{< example >}}
<div class="mb-3">
<label for="exampleFormControlInput1" class="form-label">Email address</label>
@@ -29,6 +31,42 @@ Set heights using classes like `.form-control-lg` and `.form-control-sm`.
<input class="form-control form-control-sm" type="text" placeholder=".form-control-sm" aria-label=".form-control-sm example">
{{< /example >}}
+## Form text
+
+Block-level or inline-level form text can be created using `.form-text`.
+
+{{< callout warning >}}
+Form text should be explicitly associated with the form control it relates to using the `aria-labelledby` (for mandatory information such as data format) or `aria-describedby` (for complementary information) attribute. This will ensure that assistive technologies—such as screen readers—will announce this form text when the user focuses or enters the control.
+{{< /callout >}}
+
+Form text below inputs can be styled with `.form-text`. If a block-level element will be used, a top margin is added for easy spacing from the inputs above.
+
+{{< example >}}
+<label for="inputPassword5" class="form-label">Password</label>
+<input type="password" id="inputPassword5" class="form-control" aria-labelledby="passwordHelpBlock">
+<div id="passwordHelpBlock" class="form-text">
+ Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
+</div>
+{{< /example >}}
+
+Inline text can use any typical inline HTML element (be it a `<span>`, `<small>`, or something else) with nothing more than the `.form-text` class.
+
+{{< example >}}
+<div class="row g-3 align-items-center">
+ <div class="col-auto">
+ <label for="inputPassword6" class="col-form-label">Password</label>
+ </div>
+ <div class="col-auto">
+ <input type="password" id="inputPassword6" class="form-control" aria-labelledby="passwordHelpInline">
+ </div>
+ <div class="col-auto">
+ <span id="passwordHelpInline" class="form-text">
+ Must be 8-20 characters long.
+ </span>
+ </div>
+</div>
+{{< /example >}}
+
## Disabled
Add the `disabled` boolean attribute on an input to give it a grayed out appearance, remove pointer events, and prevent focusing.
@@ -133,9 +171,9 @@ Learn more about [support for datalist elements](https://caniuse.com/datalist).
</datalist>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
`$input-*` are shared across most of our form controls (and not buttons).
diff --git a/site/content/docs/5.2/forms/input-group.md b/site/content/docs/5.3/forms/input-group.md
index 00e9eee..d984a48 100644
--- a/site/content/docs/5.2/forms/input-group.md
+++ b/site/content/docs/5.3/forms/input-group.md
@@ -21,10 +21,13 @@ Place one add-on or button on either side of an input. You may also place one on
<span class="input-group-text" id="basic-addon2">@example.com</span>
</div>
-<label for="basic-url" class="form-label">Your vanity URL</label>
-<div class="input-group mb-3">
- <span class="input-group-text" id="basic-addon3">https://example.com/users/</span>
- <input type="text" class="form-control" id="basic-url" aria-describedby="basic-addon3">
+<div class="mb-3">
+ <label for="basic-url" class="form-label">Your vanity URL</label>
+ <div class="input-group">
+ <span class="input-group-text" id="basic-addon3">https://example.com/users/</span>
+ <input type="text" class="form-control" id="basic-url" aria-describedby="basic-addon3 basic-addon4">
+ </div>
+ <div class="form-text" id="basic-addon4">Example help text goes outside the input group.</div>
</div>
<div class="input-group mb-3">
@@ -309,8 +312,8 @@ Input groups include support for custom selects and custom file inputs. Browser
</div>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="input-group-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/forms/layout.md b/site/content/docs/5.3/forms/layout.md
index 3b27e3f..3b27e3f 100644
--- a/site/content/docs/5.2/forms/layout.md
+++ b/site/content/docs/5.3/forms/layout.md
diff --git a/site/content/docs/5.2/forms/overview.md b/site/content/docs/5.3/forms/overview.md
index f38ad90..f4d2f63 100644
--- a/site/content/docs/5.2/forms/overview.md
+++ b/site/content/docs/5.3/forms/overview.md
@@ -4,7 +4,7 @@ title: Forms
description: Examples and usage guidelines for form control styles, layout options, and custom components for creating a wide variety of forms.
group: forms
toc: true
-aliases: "/docs/5.2/forms/"
+aliases: "/docs/5.3/forms/"
sections:
- title: Form control
description: Style textual inputs and textareas with support for multiple states.
@@ -51,44 +51,6 @@ Here's a quick example to demonstrate Bootstrap's form styles. Keep reading for
</form>
{{< /example >}}
-## Form text
-
-Block-level or inline-level form text can be created using `.form-text`.
-
-{{< callout warning >}}
-##### Associating form text with form controls
-
-Form text should be explicitly associated with the form control it relates to using the `aria-describedby` attribute. This will ensure that assistive technologies—such as screen readers—will announce this form text when the user focuses or enters the control.
-{{< /callout >}}
-
-Form text below inputs can be styled with `.form-text`. If a block-level element will be used, a top margin is added for easy spacing from the inputs above.
-
-{{< example >}}
-<label for="inputPassword5" class="form-label">Password</label>
-<input type="password" id="inputPassword5" class="form-control" aria-describedby="passwordHelpBlock">
-<div id="passwordHelpBlock" class="form-text">
- Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
-</div>
-{{< /example >}}
-
-Inline text can use any typical inline HTML element (be it a `<span>`, `<small>`, or something else) with nothing more than the `.form-text` class.
-
-{{< example >}}
-<div class="row g-3 align-items-center">
- <div class="col-auto">
- <label for="inputPassword6" class="col-form-label">Password</label>
- </div>
- <div class="col-auto">
- <input type="password" id="inputPassword6" class="form-control" aria-describedby="passwordHelpInline">
- </div>
- <div class="col-auto">
- <span id="passwordHelpInline" class="form-text">
- Must be 8-20 characters long.
- </span>
- </div>
-</div>
-{{< /example >}}
-
## Disabled forms
Add the `disabled` boolean attribute on an input to prevent user interactions and make it appear lighter.
@@ -143,11 +105,11 @@ If none of these are present, assistive technologies may resort to using the `pl
While using visually hidden content (`.visually-hidden`, `aria-label`, and even `placeholder` content, which disappears once a form field has content) will benefit assistive technology users, a lack of visible label text may still be problematic for certain users. Some form of visible label is generally the best approach, both for accessibility and usability.
-## Sass
+## CSS
Many form variables are set at a general level to be re-used and extended by individual form components. You'll see these most often as `$input-btn-*` and `$input-*` variables.
-### Variables
+### Sass variables
`$input-btn-*` variables are shared global variables between our [buttons]({{< docsref "/components/buttons" >}}) and our form components. You'll find these frequently reassigned as values to other component-specific variables.
diff --git a/site/content/docs/5.2/forms/range.md b/site/content/docs/5.3/forms/range.md
index 5c4f026..31edb0a 100644
--- a/site/content/docs/5.2/forms/range.md
+++ b/site/content/docs/5.3/forms/range.md
@@ -42,8 +42,8 @@ By default, range inputs "snap" to integer values. To change this, you can speci
<input type="range" class="form-range" min="0" max="5" step="0.5" id="customRange3">
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="form-range-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/forms/select.md b/site/content/docs/5.3/forms/select.md
index 7f0c255..07ee8c8 100644
--- a/site/content/docs/5.2/forms/select.md
+++ b/site/content/docs/5.3/forms/select.md
@@ -74,8 +74,8 @@ Add the `disabled` boolean attribute on a select to give it a grayed out appeara
</select>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="form-select-variables" file="scss/_variables.scss" >}}
diff --git a/site/content/docs/5.2/forms/validation.md b/site/content/docs/5.3/forms/validation.md
index d6d6266..c66bbaf 100644
--- a/site/content/docs/5.2/forms/validation.md
+++ b/site/content/docs/5.3/forms/validation.md
@@ -5,7 +5,7 @@ description: Provide valuable, actionable feedback to your users with HTML5 form
group: forms
toc: true
extra_js:
- - src: "/docs/5.2/assets/js/validate-forms.js"
+ - src: "/docs/5.3/assets/js/validate-forms.js"
async: true
---
@@ -19,7 +19,7 @@ Here's how form validation works with Bootstrap:
- HTML form validation is applied via CSS's two pseudo-classes, `:invalid` and `:valid`. It applies to `<input>`, `<select>`, and `<textarea>` elements.
- Bootstrap scopes the `:invalid` and `:valid` styles to parent `.was-validated` class, usually applied to the `<form>`. Otherwise, any required field without a value shows up as invalid on page load. This way, you may choose when to activate them (typically after form submission is attempted).
-- To reset the appearance of the form (for instance, in the case of dynamic form submissions using AJAX), remove the `.was-validated` class from the `<form>` again after submission.
+- To reset the appearance of the form (for instance, in the case of dynamic form submissions using Ajax), remove the `.was-validated` class from the `<form>` again after submission.
- As a fallback, `.is-invalid` and `.is-valid` classes may be used instead of the pseudo-classes for [server-side validation](#server-side). They do not require a `.was-validated` parent class.
- Due to constraints in how CSS works, we cannot (at present) apply styles to a `<label>` that comes before a form control in the DOM without the help of custom JavaScript.
- All modern browsers support the [constraint validation API](https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#the-constraint-validation-api), a series of JavaScript methods for validating form controls.
@@ -127,7 +127,7 @@ While these feedback styles cannot be styled with CSS, you can still customize t
<label for="validationDefaultUsername" class="form-label">Username</label>
<div class="input-group">
<span class="input-group-text" id="inputGroupPrepend2">@</span>
- <input type="text" class="form-control" id="validationDefaultUsername" aria-describedby="inputGroupPrepend2" required>
+ <input type="text" class="form-control" id="validationDefaultUsername" aria-describedby="inputGroupPrepend2" required>
</div>
</div>
<div class="col-md-6">
@@ -159,7 +159,7 @@ While these feedback styles cannot be styled with CSS, you can still customize t
</form>
{{< /example >}}
-## Server side
+## Server-side
We recommend using client-side validation, but in case you require server-side validation, you can indicate invalid and valid form fields with `.is-invalid` and `.is-valid`. Note that `.invalid-feedback` is also supported with these classes.
@@ -349,19 +349,33 @@ If your form layout allows it, you can swap the `.{valid|invalid}-feedback` clas
</form>
{{< /example >}}
-## Sass
+## CSS
### Variables
+{{< added-in "5.3.0" >}}
+
+As part of Bootstrap's evolving CSS variables approach, forms now use local CSS variables for validation for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.
+
+{{< scss-docs name="root-form-validation-variables" file="scss/_root.scss" >}}
+
+These variables are also color mode adaptive, meaning they change color while in dark mode.
+
+### Sass variables
+
{{< scss-docs name="form-feedback-variables" file="scss/_variables.scss" >}}
-### Mixins
+{{< scss-docs name="form-validation-colors" file="scss/_variables.scss" >}}
+
+{{< scss-docs name="form-validation-colors-dark" file="scss/_variables-dark.scss" >}}
+
+### Sass mixins
-Two mixins are combined together, through our [loop](#loop), to generate our form validation feedback styles.
+Two mixins are combined, through our [loop](#sass-loops), to generate our form validation feedback styles.
{{< scss-docs name="form-validation-mixins" file="scss/mixins/_forms.scss" >}}
-### Map
+### Sass maps
This is the validation Sass map from `_variables.scss`. Override or extend this to generate different or additional states.
@@ -369,7 +383,7 @@ This is the validation Sass map from `_variables.scss`. Override or extend this
Maps of `$form-validation-states` can contain three optional parameters to override tooltips and focus styles.
-### Loop
+### Sass loops
Used to iterate over `$form-validation-states` map values to generate our validation styles. Any modifications to the above Sass map will be reflected in your compiled CSS via this loop.
diff --git a/site/content/docs/5.2/getting-started/accessibility.md b/site/content/docs/5.3/getting-started/accessibility.md
index e9f1cb3..e9f1cb3 100644
--- a/site/content/docs/5.2/getting-started/accessibility.md
+++ b/site/content/docs/5.3/getting-started/accessibility.md
diff --git a/site/content/docs/5.2/getting-started/best-practices.md b/site/content/docs/5.3/getting-started/best-practices.md
index 449d02a..449d02a 100644
--- a/site/content/docs/5.2/getting-started/best-practices.md
+++ b/site/content/docs/5.3/getting-started/best-practices.md
diff --git a/site/content/docs/5.2/getting-started/browsers-devices.md b/site/content/docs/5.3/getting-started/browsers-devices.md
index dc550ec..f75fed8 100644
--- a/site/content/docs/5.2/getting-started/browsers-devices.md
+++ b/site/content/docs/5.3/getting-started/browsers-devices.md
@@ -29,8 +29,8 @@ Generally speaking, Bootstrap supports the latest versions of each major platfor
{{< bs-table "table" >}}
| | Chrome | Firefox | Safari | Android Browser &amp; WebView |
| --- | --- | --- | --- | --- |
-| **Android** | Supported | Supported | <span class="text-muted">&mdash;</span> | v6.0+ |
-| **iOS** | Supported | Supported | Supported | <span class="text-muted">&mdash;</span> |
+| **Android** | Supported | Supported | <span class="text-body-secondary">&mdash;</span> | v6.0+ |
+| **iOS** | Supported | Supported | Supported | <span class="text-body-secondary">&mdash;</span> |
{{< /bs-table >}}
### Desktop browsers
@@ -41,7 +41,7 @@ Similarly, the latest versions of most desktop browsers are supported.
| | Chrome | Firefox | Microsoft Edge | Opera | Safari |
| --- | --- | --- | --- | --- | --- |
| **Mac** | Supported | Supported | Supported | Supported | Supported |
-| **Windows** | Supported | Supported | Supported | Supported | <span class="text-muted">&mdash;</span> |
+| **Windows** | Supported | Supported | Supported | Supported | <span class="text-body-secondary">&mdash;</span> |
{{< /bs-table >}}
For Firefox, in addition to the latest normal stable release, we also support the latest [Extended Support Release (ESR)](https://www.mozilla.org/en-US/firefox/enterprise/) version of Firefox.
diff --git a/site/content/docs/5.2/getting-started/contents.md b/site/content/docs/5.3/getting-started/contents.md
index 88632b6..88632b6 100644
--- a/site/content/docs/5.2/getting-started/contents.md
+++ b/site/content/docs/5.3/getting-started/contents.md
diff --git a/site/content/docs/5.2/getting-started/contribute.md b/site/content/docs/5.3/getting-started/contribute.md
index 6b3de43..4d6d405 100644
--- a/site/content/docs/5.2/getting-started/contribute.md
+++ b/site/content/docs/5.3/getting-started/contribute.md
@@ -4,7 +4,7 @@ title: Contribute
description: Help develop Bootstrap with our documentation build scripts and tests.
group: getting-started
toc: true
-aliases: "/docs/5.2/getting-started/build-tools/"
+aliases: "/docs/5.3/getting-started/build-tools/"
---
## Tooling setup
@@ -14,7 +14,7 @@ Bootstrap uses [npm scripts](https://docs.npmjs.com/misc/scripts/) to build the
To use our build system and run our documentation locally, you'll need a copy of Bootstrap's source files and Node. Follow these steps and you should be ready to rock:
1. [Download and install Node.js](https://nodejs.org/en/download/), which we use to manage our dependencies.
-2. Either [download Bootstrap's sources]({{< param "download.source" >}}) or fork [Bootstrap's repository]({{< param repo >}}).
+2. Either [download Bootstrap's sources]({{< param "download.source" >}}) or fork and clone [Bootstrap's repository]({{< param repo >}}).
3. Navigate to the root `/bootstrap` directory and run `npm install` to install our local dependencies listed in [package.json]({{< param repo >}}/blob/v{{< param current_version >}}/package.json).
When completed, you'll be able to run the various commands provided from the command line.
@@ -33,7 +33,7 @@ Our [package.json]({{< param repo >}}/blob/v{{< param current_version >}}/packag
{{< /bs-table >}}
{{< callout info >}}
-{{< partial "callout-info-npm-starter.md" >}}
+{{< partial "callouts/info-npm-starter.md" >}}
{{< /callout >}}
## Sass
diff --git a/site/content/docs/5.2/getting-started/download.md b/site/content/docs/5.3/getting-started/download.md
index b06c055..a1b8bfd 100644
--- a/site/content/docs/5.2/getting-started/download.md
+++ b/site/content/docs/5.3/getting-started/download.md
@@ -71,7 +71,7 @@ Bootstrap's `package.json` contains some additional metadata under the following
- `style` - path to Bootstrap's non-minified CSS that's been compiled using the default settings (no customization)
{{< callout info >}}
-{{< partial "callout-info-npm-starter.md" >}}
+{{< partial "callouts/info-npm-starter.md" >}}
{{< /callout >}}
### yarn
@@ -96,7 +96,7 @@ Alternatively, if you're not using Bundler, you can install the gem by running t
gem install bootstrap -v {{< param current_ruby_version >}}
```
-[See the gem's README](https://github.com/twbs/bootstrap-rubygem/blob/master/README.md) for further details.
+[See the gem's README](https://github.com/twbs/bootstrap-rubygem/blob/main/README.md) for further details.
### Composer
diff --git a/site/content/docs/5.2/getting-started/introduction.md b/site/content/docs/5.3/getting-started/introduction.md
index f0072bf..d296d18 100644
--- a/site/content/docs/5.2/getting-started/introduction.md
+++ b/site/content/docs/5.3/getting-started/introduction.md
@@ -4,7 +4,7 @@ title: Get started with Bootstrap
description: Bootstrap is a powerful, feature-packed frontend toolkit. Build anything—from prototype to production—in minutes.
group: getting-started
aliases:
- - "/docs/5.2/getting-started/"
+ - "/docs/5.3/getting-started/"
- "/docs/getting-started/"
- "/getting-started/"
toc: true
@@ -87,7 +87,7 @@ You can also use the CDN to fetch any of our [additional builds listed in the Co
Curious which components explicitly require our JavaScript and Popper? Click the show components link below. If you're at all unsure about the general page structure, keep reading for an example page template.
<details>
-<summary class="text-primary mb-3">Show components requiring JavaScript</summary>
+<summary class="bd-summary-link mb-3">Show components requiring JavaScript</summary>
{{< markdown >}}
- Alerts for dismissing
- Buttons for toggling states and checkbox/radio functionality
@@ -119,7 +119,7 @@ Bootstrap requires the use of the HTML5 doctype. Without it, you'll see some fun
</html>
```
-### Responsive meta tag
+### Viewport meta
Bootstrap is developed *mobile first*, a strategy in which we optimize code for mobile devices first and then scale up components as necessary using CSS media queries. To ensure proper rendering and touch zooming for all devices, add the responsive viewport meta tag to your `<head>`.
diff --git a/site/content/docs/5.2/getting-started/javascript.md b/site/content/docs/5.3/getting-started/javascript.md
index c4ba6b0..8efb2fb 100644
--- a/site/content/docs/5.2/getting-started/javascript.md
+++ b/site/content/docs/5.3/getting-started/javascript.md
@@ -19,6 +19,9 @@ While the Bootstrap CSS can be used with any framework, **the Bootstrap JavaScri
A better alternative for those using this type of frameworks is to use a framework-specific package **instead of** the Bootstrap JavaScript. Here are some of the most popular options:
- React: [React Bootstrap](https://react-bootstrap.github.io/)
+ {{< callout >}}
+ **Try it yourself!** Download the source code and working demo for using Bootstrap with React, Next.js, and React Bootstrap from the [twbs/examples repository](https://github.com/twbs/examples/tree/main/react-nextjs). You can also [open the example in StackBlitz](https://stackblitz.com/github/twbs/examples/tree/main/react-nextjs?file=src%2Fpages%2Findex.tsx).
+ {{< /callout >}}
- Vue: [BootstrapVue](https://bootstrap-vue.org/) (currently only supports Vue 2 and Bootstrap 4)
- Angular: [ng-bootstrap](https://ng-bootstrap.github.io/)
@@ -30,6 +33,7 @@ A better alternative for those using this type of frameworks is to use a framewo
We provide a version of Bootstrap built as `ESM` (`bootstrap.esm.js` and `bootstrap.esm.min.js`) which allows you to use Bootstrap as a module in the browser, if your [targeted browsers support it](https://caniuse.com/es6-module).
+<!-- eslint-skip -->
```html
<script type="module">
import { Toast } from 'bootstrap.esm.min.js'
@@ -54,6 +58,7 @@ Uncaught TypeError: Failed to resolve module specifier "@popperjs/core". Relativ
To fix this, you can use an `importmap` to resolve the arbitrary module names to complete paths. If your [targeted browsers](https://caniuse.com/?search=importmap) do not support `importmap`, you'll need to use the [es-module-shims](https://github.com/guybedford/es-module-shims) project. Here's how it works for Bootstrap and Popper:
+<!-- eslint-skip -->
```html
<!doctype html>
<html lang="en">
@@ -65,13 +70,13 @@ To fix this, you can use an `importmap` to resolve the arbitrary module names to
</head>
<body>
<h1>Hello, modularity!</h1>
- <button id="popoverButton" type="button" class="btn btn-primary btn-lg" class="btn btn-lg btn-danger" data-bs-toggle="popover" title="ESM in Browser" data-bs-content="Bang!">Custom popover</button>
+ <button id="popoverButton" type="button" class="btn btn-primary btn-lg" data-bs-toggle="popover" title="ESM in Browser" data-bs-content="Bang!">Custom popover</button>
<script async src="https://cdn.jsdelivr.net/npm/es-module-shims@1/dist/es-module-shims.min.js" crossorigin="anonymous"></script>
<script type="importmap">
{
"imports": {
- "@popperjs/core": "{{< param "cdn.popper" >}}",
+ "@popperjs/core": "{{< param "cdn.popper_esm" >}}",
"bootstrap": "https://cdn.jsdelivr.net/npm/bootstrap@{{< param "current_version" >}}/dist/js/bootstrap.esm.min.js"
}
}
@@ -125,7 +130,6 @@ All constructors accept an optional options object or nothing (which initiates a
```js
const myModalEl = document.querySelector('#myModal')
-
const modal = new bootstrap.Modal(myModalEl) // initialized with defaults
const configObject = { keyboard: false }
@@ -232,42 +236,7 @@ Tooltips and Popovers use our built-in sanitizer to sanitize options which accep
The default `allowList` value is the following:
-```js
-const ARIA_ATTRIBUTE_PATTERN = /^aria-[\w-]*$/i
-const DefaultAllowlist = {
- // Global attributes allowed on any supplied element below.
- '*': ['class', 'dir', 'id', 'lang', 'role', ARIA_ATTRIBUTE_PATTERN],
- a: ['target', 'href', 'title', 'rel'],
- area: [],
- b: [],
- br: [],
- col: [],
- code: [],
- div: [],
- em: [],
- hr: [],
- h1: [],
- h2: [],
- h3: [],
- h4: [],
- h5: [],
- h6: [],
- i: [],
- img: ['src', 'srcset', 'alt', 'title', 'width', 'height'],
- li: [],
- ol: [],
- p: [],
- pre: [],
- s: [],
- small: [],
- span: [],
- sub: [],
- sup: [],
- strong: [],
- u: [],
- ul: []
-}
-```
+{{< js-docs name="allow-list" file="js/src/util/sanitizer.js" >}}
If you want to add new values to this default `allowList` you can do the following:
@@ -302,11 +271,17 @@ const tooltip = new bootstrap.Tooltip(yourTooltipEl, {
**You don't need jQuery in Bootstrap 5**, but it's still possible to use our components with jQuery. If Bootstrap detects `jQuery` in the `window` object, it'll add all of our components in jQuery's plugin system. This allows you to do the following:
```js
-$('[data-bs-toggle="tooltip"]').tooltip() // to enable tooltips, with default configuration
+// to enable tooltips with the default configuration
+$('[data-bs-toggle="tooltip"]').tooltip()
-$('[data-bs-toggle="tooltip"]').tooltip({ boundary: 'clippingParents', customClass: 'myClass' }) // to initialize tooltips with given configuration
+// to initialize tooltips with given configuration
+$('[data-bs-toggle="tooltip"]').tooltip({
+ boundary: 'clippingParents',
+ customClass: 'myClass'
+})
-$('#myTooltip').tooltip('show') // to trigger `show` method
+// to trigger the `show` method
+$('#myTooltip').tooltip('show')
```
The same goes for our other components.
diff --git a/site/content/docs/5.2/getting-started/parcel.md b/site/content/docs/5.3/getting-started/parcel.md
index d28f923..36619e7 100644
--- a/site/content/docs/5.2/getting-started/parcel.md
+++ b/site/content/docs/5.3/getting-started/parcel.md
@@ -1,6 +1,6 @@
---
layout: docs
-title: "Bootstrap & Parcel"
+title: Bootstrap and Parcel
description: The official guide for how to include and bundle Bootstrap's CSS and JavaScript in your project using Parcel.
group: getting-started
toc: true
@@ -88,7 +88,7 @@ With dependencies installed and our project folder ready for us to start coding,
</html>
```
- We're including a little bit of Bootstrap styling here with the `div class="container"` and `<button>` so that we see when Bootstrap's CSS is loaded by Webpack.
+ We're including a little bit of Bootstrap styling here with the `div class="container"` and `<button>` so that we see when Bootstrap's CSS is loaded by Parcel.
Parcel will automatically detect we're using Sass and install the [Sass Parcel plugin](https://parceljs.org/languages/sass/) to support it. However, if you wish, you can also manually run `npm i --save-dev @parcel/transformer-sass`.
@@ -123,7 +123,7 @@ Importing Bootstrap into Parcel requires two imports, one into our `styles.scss`
```scss
// Import all of Bootstrap's CSS
- @import "~bootstrap/scss/bootstrap";
+ @import "bootstrap/scss/bootstrap";
```
*You can also import our stylesheets individually if you want. [Read our Sass import docs]({{< docsref "/customize/sass#importing" >}}) for details.*
diff --git a/site/content/docs/5.2/getting-started/rfs.md b/site/content/docs/5.3/getting-started/rfs.md
index 5aa6840..5aa6840 100644
--- a/site/content/docs/5.2/getting-started/rfs.md
+++ b/site/content/docs/5.3/getting-started/rfs.md
diff --git a/site/content/docs/5.2/getting-started/rtl.md b/site/content/docs/5.3/getting-started/rtl.md
index f4abf05..156f205 100644
--- a/site/content/docs/5.2/getting-started/rtl.md
+++ b/site/content/docs/5.3/getting-started/rtl.md
@@ -13,9 +13,7 @@ We recommend getting familiar with Bootstrap first by reading through our [Getti
You may also want to read up on [the RTLCSS project](https://rtlcss.com/), as it powers our approach to RTL.
{{< callout warning >}}
-### Experimental feature
-
-The RTL feature is still **experimental** and will probably evolve according to user feedback. Spotted something or have an improvement to suggest? [Open an issue]({{< param repo >}}/issues/new/choose), we'd love to get your insights.
+**Bootstrap's RTL feature is still experimental** and will evolve based on user feedback. Spotted something or have an improvement to suggest? [Open an issue]({{< param repo >}}/issues/new/choose), we'd love to get your insights.
{{< /callout >}}
## Required HTML
@@ -163,9 +161,7 @@ Need both LTR and RTL on the same page? Thanks to [RTLCSS String Maps](https://r
After running Sass then RTLCSS, each selector in your CSS files will be prepended by `.ltr`, and `.rtl` for RTL files. Now you're able to use both files on the same page, and simply use `.ltr` or `.rtl` on your components wrappers to use one or the other direction.
{{< callout warning >}}
-#### Edge cases and known limitations
-
-While this approach is understandable, please pay attention to the following:
+**Edge cases and known limitations** to consider when working with a combined LTR and RTL implementation:
1. When switching `.ltr` and `.rtl`, make sure you add `dir` and `lang` attributes accordingly.
2. Loading both files can be a real performance bottleneck: consider some [optimization]({{< docsref "/customize/optimize" >}}), and maybe try to [load one of those files asynchronously](https://www.filamentgroup.com/lab/load-css-simpler/).
diff --git a/site/content/docs/5.2/getting-started/vite.md b/site/content/docs/5.3/getting-started/vite.md
index b203eef..9c2be9f 100644
--- a/site/content/docs/5.2/getting-started/vite.md
+++ b/site/content/docs/5.3/getting-started/vite.md
@@ -1,6 +1,6 @@
---
layout: docs
-title: "Bootstrap & Vite"
+title: Bootstrap and Vite
description: The official guide for how to include and bundle Bootstrap's CSS and JavaScript in your project using Vite.
group: getting-started
toc: true
@@ -35,6 +35,7 @@ We're building a Vite project with Bootstrap from scratch, so there are some pre
```sh
npm i --save bootstrap @popperjs/core
```
+
4. **Install additional dependency.** In addition to Vite and Bootstrap, we need another dependency (Sass) to properly import and bundle Bootstrap's CSS.
```sh
@@ -81,9 +82,11 @@ With dependencies installed and our project folder ready for us to start coding,
export default {
root: path.resolve(__dirname, 'src'),
+ build: {
+ outDir: '../dist'
+ },
server: {
- port: 8080,
- hot: true
+ port: 8080
}
}
```
@@ -97,13 +100,13 @@ With dependencies installed and our project folder ready for us to start coding,
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Bootstrap w/ Vite</title>
+ <script type="module" src="./js/main.js"></script>
</head>
<body>
<div class="container py-4 px-3 mx-auto">
<h1>Hello, Bootstrap and Vite!</h1>
<button class="btn btn-primary">Primary button</button>
</div>
- <script type="module" src="./js/main.js"></script>
</body>
</html>
```
@@ -135,36 +138,16 @@ In the next and final section to this guide, we’ll import all of Bootstrap’s
## Import Bootstrap
-1. **Set up Bootstrap's Sass import in `vite.config.js`.** Your configuration file is now complete and should match the snippet below. The only new part here is the `resolve` section—we use this to add an alias to our source files inside `node_modules` to keep imports as simple as possible.
-
- <!-- eslint-skip -->
- ```js
- const path = require('path')
-
- export default {
- root: path.resolve(__dirname, 'src'),
- resolve: {
- alias: {
- '~bootstrap': path.resolve(__dirname, 'node_modules/bootstrap'),
- }
- },
- server: {
- port: 8080,
- hot: true
- }
- }
- ```
-
-2. **Now, let's import Bootstrap's CSS.** Add the following to `src/scss/styles.scss` to import all of Bootstrap's source Sass.
+1. **Import Bootstrap's CSS.** Add the following to `src/scss/styles.scss` to import all of Bootstrap's source Sass.
```scss
// Import all of Bootstrap's CSS
- @import "~bootstrap/scss/bootstrap";
+ @import "bootstrap/scss/bootstrap";
```
*You can also import our stylesheets individually if you want. [Read our Sass import docs]({{< docsref "/customize/sass#importing" >}}) for details.*
-3. **Next we load the CSS and import Bootstrap's JavaScript.** Add the following to `src/js/main.js` to load the CSS and import all of Bootstrap's JS. Popper will be imported automatically through Bootstrap.
+2. **Next we load the CSS and import Bootstrap's JavaScript.** Add the following to `src/js/main.js` to load the CSS and import all of Bootstrap's JS. Popper will be imported automatically through Bootstrap.
<!-- eslint-skip -->
```js
@@ -187,7 +170,7 @@ In the next and final section to this guide, we’ll import all of Bootstrap’s
*[Read our JavaScript docs]({{< docsref "/getting-started/javascript/" >}}) for more information on how to use Bootstrap's plugins.*
-4. **And you're done! 🎉** With Bootstrap's source Sass and JS fully loaded, your local development server should now look like this.
+3. **And you're done! 🎉** With Bootstrap's source Sass and JS fully loaded, your local development server should now look like this.
<img class="img-fluid" src="/docs/{{< param docs_version >}}/assets/img/guides/vite-dev-server-bootstrap.png" alt="Vite dev server running with Bootstrap">
diff --git a/site/content/docs/5.2/getting-started/webpack.md b/site/content/docs/5.3/getting-started/webpack.md
index 870e070..bd539b8 100644
--- a/site/content/docs/5.2/getting-started/webpack.md
+++ b/site/content/docs/5.3/getting-started/webpack.md
@@ -1,6 +1,6 @@
---
layout: docs
-title: "Bootstrap & Webpack"
+title: Bootstrap and Webpack
description: The official guide for how to include and bundle Bootstrap's CSS and JavaScript in your project using Webpack.
group: getting-started
toc: true
@@ -24,10 +24,10 @@ We're building a Webpack project with Bootstrap from scratch, so there are some
npm init -y
```
-2. **Install Webpack.** Next we need to install our Webpack development dependencies: `webpack` for the core of Webpack, `webpack-cli` so we can run Webpack commands from the terminal, and `webpack-dev-server` so we can run a local development server. We use `--save-dev` to signal that these dependencies are only for development use and not for production.
+2. **Install Webpack.** Next we need to install our Webpack development dependencies: `webpack` for the core of Webpack, `webpack-cli` so we can run Webpack commands from the terminal, and `webpack-dev-server` so we can run a local development server. Additionally, we'll install `html-webpack-plugin` to be able to store our `index.html` in `src` directory instead of the default `dist` one. We use `--save-dev` to signal that these dependencies are only for development use and not for production.
```sh
- npm i --save-dev webpack webpack-cli webpack-dev-server
+ npm i --save-dev webpack webpack-cli webpack-dev-server html-webpack-plugin
```
3. **Install Bootstrap.** Now we can install Bootstrap. We'll also install Popper since our dropdowns, popovers, and tooltips depend on it for their positioning. If you don't plan on using those components, you can omit Popper here.
@@ -49,21 +49,20 @@ Now that we have all the necessary dependencies installed, we can get to work cr
We've already created the `my-project` folder and initialized npm. Now we'll also create our `src` and `dist` folders to round out the project structure. Run the following from `my-project`, or manually create the folder and file structure shown below.
```sh
-mkdir {dist,src,src/js,src/scss}
-touch dist/index.html src/js/main.js src/scss/styles.scss webpack.config.js
+mkdir {src,src/js,src/scss}
+touch src/index.html src/js/main.js src/scss/styles.scss webpack.config.js
```
When you're done, your complete project should look like this:
```text
my-project/
-├── dist/
-│ └── index.html
├── src/
│ ├── js/
│ │ └── main.js
-│ └── scss/
-│ └── styles.scss
+│ ├── scss/
+│ │ └── styles.scss
+│ └── index.html
├── package-lock.json
├── package.json
└── webpack.config.js
@@ -78,9 +77,13 @@ With dependencies installed and our project folder ready for us to start coding,
1. **Open `webpack.config.js` in your editor.** Since it's blank, we'll need to add some boilerplate config to it so we can start our server. This part of the config tells Webpack where to look for our project's JavaScript, where to output the compiled code to (`dist`), and how the development server should behave (pulling from the `dist` folder with hot reload).
```js
+ 'use strict'
+
const path = require('path')
+ const HtmlWebpackPlugin = require('html-webpack-plugin')
module.exports = {
+ mode: 'development',
entry: './src/js/main.js',
output: {
filename: 'main.js',
@@ -90,11 +93,14 @@ With dependencies installed and our project folder ready for us to start coding,
static: path.resolve(__dirname, 'dist'),
port: 8080,
hot: true
- }
+ },
+ plugins: [
+ new HtmlWebpackPlugin({ template: './src/index.html' })
+ ]
}
```
-2. **Next we fill in our `dist/index.html`.** This is the HTML page Webpack will load in the browser to utilize the bundled CSS and JS we'll add to it in later steps. Before we can do that, we have to give it something to render and include the `output` JS from the previous step.
+2. **Next we fill in our `src/index.html`.** This is the HTML page Webpack will load in the browser to utilize the bundled CSS and JS we'll add to it in later steps. Before we can do that, we have to give it something to render and include the `output` JS from the previous step.
```html
<!doctype html>
@@ -109,20 +115,20 @@ With dependencies installed and our project folder ready for us to start coding,
<h1>Hello, Bootstrap and Webpack!</h1>
<button class="btn btn-primary">Primary button</button>
</div>
- <script src="./main.js"></script>
</body>
</html>
```
We're including a little bit of Bootstrap styling here with the `div class="container"` and `<button>` so that we see when Bootstrap's CSS is loaded by Webpack.
-3. **Now we need an npm script to run Webpack.** Open `package.json` and add the `start` script shown below (you should already have the test script). We'll use this script to start our local Webpack dev server.
+3. **Now we need an npm script to run Webpack.** Open `package.json` and add the `start` script shown below (you should already have the test script). We'll use this script to start our local Webpack dev server. You can also add a `build` script shown below to build your project.
```json
{
// ...
"scripts": {
- "start": "webpack serve --mode development",
+ "start": "webpack serve",
+ "build": "webpack build --mode=production",
"test": "echo \"Error: no test specified\" && exit 1"
},
// ...
@@ -146,9 +152,14 @@ Importing Bootstrap into Webpack requires the loaders we installed in the first
1. **Set up the loaders in `webpack.config.js`.** Your configuration file is now complete and should match the snippet below. The only new part here is the `module` section.
```js
+ 'use strict'
+
const path = require('path')
+ const autoprefixer = require('autoprefixer')
+ const HtmlWebpackPlugin = require('html-webpack-plugin')
module.exports = {
+ mode: 'development',
entry: './src/js/main.js',
output: {
filename: 'main.js',
@@ -159,28 +170,35 @@ Importing Bootstrap into Webpack requires the loaders we installed in the first
port: 8080,
hot: true
},
+ plugins: [
+ new HtmlWebpackPlugin({ template: './src/index.html' })
+ ],
module: {
rules: [
{
test: /\.(scss)$/,
use: [
{
+ // Adds CSS to the DOM by injecting a `<style>` tag
loader: 'style-loader'
},
{
+ // Interprets `@import` and `url()` like `import/require()` and will resolve them
loader: 'css-loader'
},
{
+ // Loader for webpack to process CSS with PostCSS
loader: 'postcss-loader',
options: {
postcssOptions: {
plugins: () => [
- require('autoprefixer')
+ autoprefixer
]
}
}
},
{
+ // Loads a SASS/SCSS file and compiles it to CSS
loader: 'sass-loader'
}
]
@@ -196,7 +214,7 @@ Importing Bootstrap into Webpack requires the loaders we installed in the first
```scss
// Import all of Bootstrap's CSS
- @import "~bootstrap/scss/bootstrap";
+ @import "bootstrap/scss/bootstrap";
```
*You can also import our stylesheets individually if you want. [Read our Sass import docs]({{< docsref "/customize/sass#importing" >}}) for details.*
@@ -249,20 +267,27 @@ npm install --save-dev mini-css-extract-plugin
Then instantiate and use the plugin in the Webpack configuration:
```diff
---- a/webpack/webpack.config.js
-+++ b/webpack/webpack.config.js
-@@ -1,8 +1,10 @@
-+const miniCssExtractPlugin = require('mini-css-extract-plugin')
+--- a/webpack.config.js
++++ b/webpack.config.js
+@@ -3,6 +3,7 @@
const path = require('path')
-
+ const autoprefixer = require('autoprefixer')
+ const HtmlWebpackPlugin = require('html-webpack-plugin')
++const miniCssExtractPlugin = require('mini-css-extract-plugin')
+
module.exports = {
mode: 'development',
- entry: './src/js/main.js',
-+ plugins: [new miniCssExtractPlugin()],
- output: {
- filename: "main.js",
- path: path.resolve(__dirname, "dist"),
-@@ -18,8 +20,8 @@ module.exports = {
+@@ -17,7 +18,8 @@ module.exports = {
+ hot: true
+ },
+ plugins: [
+- new HtmlWebpackPlugin({ template: './src/index.html' })
++ new HtmlWebpackPlugin({ template: './src/index.html' }),
++ new miniCssExtractPlugin()
+ ],
+ module: {
+ rules: [
+@@ -25,8 +27,8 @@ module.exports = {
test: /\.(scss)$/,
use: [
{
@@ -277,8 +302,8 @@ Then instantiate and use the plugin in the Webpack configuration:
After running `npm run build` again, there will be a new file `dist/main.css`, which will contain all of the CSS imported by `src/js/main.js`. If you view `dist/index.html` in your browser now, the style will be missing, as it is now in `dist/main.css`. You can include the generated CSS in `dist/index.html` like this:
```diff
---- a/webpack/dist/index.html
-+++ b/webpack/dist/index.html
+--- a/dist/index.html
++++ b/dist/index.html
@@ -3,6 +3,7 @@
<head>
<meta charset="utf-8">
@@ -296,9 +321,9 @@ Bootstrap's CSS includes multiple references to SVG files via inline `data:` URI
Configure Webpack to extract inline SVG files like this:
```diff
---- a/webpack/webpack.config.js
-+++ b/webpack/webpack.config.js
-@@ -16,6 +16,14 @@ module.exports = {
+--- a/webpack.config.js
++++ b/webpack.config.js
+@@ -23,6 +23,14 @@ module.exports = {
},
module: {
rules: [
diff --git a/site/content/docs/5.2/helpers/clearfix.md b/site/content/docs/5.3/helpers/clearfix.md
index c888610..3aa6187 100644
--- a/site/content/docs/5.2/helpers/clearfix.md
+++ b/site/content/docs/5.3/helpers/clearfix.md
@@ -3,7 +3,7 @@ layout: docs
title: Clearfix
description: Quickly and easily clear floated content within a container by adding a clearfix utility.
group: helpers
-aliases: "/docs/5.2/helpers/"
+aliases: "/docs/5.3/helpers/"
---
Easily clear `float`s by adding `.clearfix` **to the parent element**. Can also be used as a mixin.
diff --git a/site/content/docs/5.2/helpers/color-background.md b/site/content/docs/5.3/helpers/color-background.md
index c417484..d64ca43 100644
--- a/site/content/docs/5.2/helpers/color-background.md
+++ b/site/content/docs/5.3/helpers/color-background.md
@@ -1,6 +1,6 @@
---
layout: docs
-title: Color & background
+title: Color and background
description: Set a background color with contrasting foreground color.
group: helpers
toc: true
@@ -9,8 +9,6 @@ added: "5.2"
## Overview
-{{< added-in "5.2.0" >}}
-
Color and background helpers combine the power of our [`.text-*` utilities]({{< docsref "/utilities/colors" >}}) and [`.bg-*` utilities]({{< docsref "/utilities/background" >}}) in one class. Using our Sass `color-contrast()` function, we automatically determine a contrasting `color` for a particular `background-color`.
{{< callout warning >}}
@@ -25,6 +23,10 @@ Color and background helpers combine the power of our [`.text-*` utilities]({{<
{{< /text-bg.inline >}}
{{< /example >}}
+{{< callout info >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
+{{< /callout >}}
+
## With components
Use them in place of combined `.text-*` and `.bg-*` classes, like on [badges]({{< docsref "/components/badge#background-colors" >}}):
diff --git a/site/content/docs/5.3/helpers/colored-links.md b/site/content/docs/5.3/helpers/colored-links.md
new file mode 100644
index 0000000..6a3dbe4
--- /dev/null
+++ b/site/content/docs/5.3/helpers/colored-links.md
@@ -0,0 +1,43 @@
+---
+layout: docs
+title: Colored links
+description: Colored links with hover states
+group: helpers
+toc: true
+---
+
+## Link colors
+
+You can use the `.link-*` classes to colorize links. Unlike the [`.text-*` classes]({{< docsref "/utilities/colors" >}}), these classes have a `:hover` and `:focus` state. Some of the link styles use a relatively light foreground color, and should only be used on a dark background in order to have sufficient contrast.
+
+{{< callout info >}}
+**Heads up!** `.link-body-emphasis` is currently the only colored link that adapts to color modes. It's treated as a special case until v6 arrives and we can more thoroughly rebuild our theme colors for color modes. Until then, it's a unique, high-contrast link color with custom `:hover` and `:focus` styles. However, it still responds to the new link utilities.
+{{< /callout >}}
+
+{{< example >}}
+{{< colored-links.inline >}}
+{{- range (index $.Site.Data "theme-colors") }}
+<p><a href="#" class="link-{{ .name }}">{{ .name | title }} link</a></p>
+{{- end -}}
+{{< /colored-links.inline >}}
+<p><a href="#" class="link-body-emphasis">Emphasis link</a></p>
+{{< /example >}}
+
+{{< callout info >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
+{{< /callout >}}
+
+## Link utilities
+
+{{< added-in "5.3.0" >}}
+
+Colored links can also be modified by our [link utilities]({{< docsref "/utilities/link/" >}}).
+
+{{< example >}}
+{{< colored-links.inline >}}
+{{- range (index $.Site.Data "theme-colors") }}
+<p><a href="#" class="link-{{ .name }} link-offset-2 link-underline-opacity-25 link-underline-opacity-100-hover">{{ .name | title }} link</a></p>
+{{- end -}}
+{{< /colored-links.inline >}}
+<p><a href="#" class="link-body-emphasis link-offset-2 link-underline-opacity-25 link-underline-opacity-75-hover">Emphasis link</a></p>
+{{< /example >}}
diff --git a/site/content/docs/5.3/helpers/focus-ring.md b/site/content/docs/5.3/helpers/focus-ring.md
new file mode 100644
index 0000000..fa36bf8
--- /dev/null
+++ b/site/content/docs/5.3/helpers/focus-ring.md
@@ -0,0 +1,68 @@
+---
+layout: docs
+title: Focus ring
+description: Utility classes that allows you to add and modify custom focus ring styles to elements and components.
+group: helpers
+toc: true
+added: "5.3"
+---
+
+The `.focus-ring` helper removes the default `outline` on `:focus`, replacing it with a `box-shadow` that can be more broadly customized. The new shadow is made up of a series of CSS variables, inherited from the `:root` level, that can be modified for any element or component.
+
+## Example
+
+Click directly on the link below to see the focus ring in action, or into the example below and then press <kbd>Tab</kbd>.
+
+{{< example >}}
+<a href="#" class="d-inline-flex focus-ring py-1 px-2 text-decoration-none border rounded-2">
+ Custom focus ring
+</a>
+{{< /example >}}
+
+## Customize
+
+Modify the styling of a focus ring with our CSS variables, Sass variables, utilities, or custom styles.
+
+### CSS variables
+
+Modify the `--bs-focus-ring-*` CSS variables as needed to change the default appearance.
+
+{{< example >}}
+<a href="#" class="d-inline-flex focus-ring py-1 px-2 text-decoration-none border rounded-2" style="--bs-focus-ring-color: rgba(var(--bs-success-rgb), .25)">
+ Green focus ring
+</a>
+{{< /example >}}
+
+`.focus-ring` sets styles via global CSS variables that can be overridden on any parent element, as shown above. These variables are generated from their Sass variable counterparts.
+
+{{< scss-docs name="root-focus-variables" file="scss/_root.scss" >}}
+
+By default, there is no `--bs-focus-ring-x`, `--bs-focus-ring-y`, or `--bs-focus-ring-blur`, but we provide CSS variables with fallbacks to initial `0` values. Modify them to change the default appearance.
+
+{{< example >}}
+<a href="#" class="d-inline-flex focus-ring py-1 px-2 text-decoration-none border rounded-2" style="--bs-focus-ring-x: 10px; --bs-focus-ring-y: 10px; --bs-focus-ring-blur: 4px">
+ Blurry offset focus ring
+</a>
+{{< /example >}}
+
+### Sass variables
+
+Customize the focus ring Sass variables to modify all usage of the focus ring styles across your Bootstrap-powered project.
+
+{{< scss-docs name="focus-ring-variables" file="scss/_variables.scss" >}}
+
+### Sass utilities API
+
+In addition to `.focus-ring`, we have several `.focus-ring-*` utilities to modify the helper class defaults. Modify the color with any of our [theme colors]({{< docsref "/customize/color#theme-colors" >}}). Note that the light and dark variants may not be visible on all background colors given current color mode support.
+
+{{< example >}}
+{{< focus-ring.inline >}}
+{{- range (index $.Site.Data "theme-colors") }}
+<p><a href="#" class="d-inline-flex focus-ring focus-ring-{{ .name }} py-1 px-2 text-decoration-none border rounded-2">{{ title .name }} focus</a></p>
+{{- end -}}
+{{< /focus-ring.inline >}}
+{{< /example >}}
+
+Focus ring utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-focus-ring" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/5.3/helpers/icon-link.md b/site/content/docs/5.3/helpers/icon-link.md
new file mode 100644
index 0000000..ec63c5b
--- /dev/null
+++ b/site/content/docs/5.3/helpers/icon-link.md
@@ -0,0 +1,88 @@
+---
+layout: docs
+title: Icon link
+description: Quickly create stylized hyperlinks with Bootstrap Icons or other icons.
+group: helpers
+toc: true
+added: 5.3
+---
+
+The icon link helper component modifies our default link styles to enhance their appearance and quickly align any pairing of icon and text. Alignment is set via inline flexbox styling and a default `gap` value. We stylize the underline with a custom offset and color. Icons are automatically sized to `1em` to best match their associated text's `font-size`.
+
+Icon links assume [Bootstrap Icons](https://icons.getbootstrap.com) are being used, but you can use any icon or image you like.
+
+{{< callout >}}
+When icons are purely decorative, they should be hidden from assistive technologies using `aria-hidden="true"`, as we've done in our examples. For icons that convey meaning, provide an appropriate text alternative by adding `role="img"` and an appropriate `aria-label="..."` to the SVGs.
+{{< /callout >}}
+
+## Example
+
+Take a regular `<a>` element, add `.icon-link`, and insert an icon on either the left or right of your link text. The icon is automatically sized, placed, and colored.
+
+{{< example >}}
+<a class="icon-link" href="#">
+ <svg class="bi" aria-hidden="true"><use xlink:href="#box-seam"></use></svg>
+ Icon link
+</a>
+{{< /example >}}
+
+{{< example >}}
+<a class="icon-link" href="#">
+ Icon link
+ <svg class="bi" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
+</a>
+{{< /example >}}
+
+## Style on hover
+
+Add `.icon-link-hover` to move the icon to the right on hover.
+
+{{< example >}}
+<a class="icon-link icon-link-hover" href="#">
+ Icon link
+ <svg class="bi" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
+</a>
+{{< /example >}}
+
+## Customize
+
+Modify the styling of an icon link with our link CSS variables, Sass variables, utilities, or custom styles.
+
+### CSS variables
+
+Modify the `--bs-link-*` and `--bs-icon-link-*` CSS variables as needed to change the default appearance.
+
+Customize the hover `transform` by overriding the `--bs-icon-link-transform` CSS variable:
+
+{{< example >}}
+<a class="icon-link icon-link-hover" style="--bs-icon-link-transform: translate3d(0, -.125rem, 0);" href="#">
+ <svg class="bi" aria-hidden="true"><use xlink:href="#clipboard"></use></svg>
+ Icon link
+</a>
+{{< /example >}}
+
+Customize the color by overriding the `--bs-link-*` CSS variable:
+
+{{< example >}}
+<a class="icon-link icon-link-hover" style="--bs-link-hover-color-rgb: 25, 135, 84;" href="#">
+ Icon link
+ <svg class="bi" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
+</a>
+{{< /example >}}
+
+### Sass variables
+
+Customize the icon link Sass variables to modify all icon link styles across your Bootstrap-powered project.
+
+{{< scss-docs name="icon-link-variables" file="scss/_variables.scss" >}}
+
+### Sass utilities API
+
+Modify icon links with any of [our link utilities]({{< docsref "/utilities/link/" >}}) for modifying underline color and offset.
+
+{{< example >}}
+<a class="icon-link icon-link-hover link-success link-underline-success link-underline-opacity-25" href="#">
+ Icon link
+ <svg class="bi" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
+</a>
+{{< /example >}}
diff --git a/site/content/docs/5.2/helpers/position.md b/site/content/docs/5.3/helpers/position.md
index b4e1f71..b4e1f71 100644
--- a/site/content/docs/5.2/helpers/position.md
+++ b/site/content/docs/5.3/helpers/position.md
diff --git a/site/content/docs/5.2/helpers/ratio.md b/site/content/docs/5.3/helpers/ratio.md
index 771bc07..04b6eef 100644
--- a/site/content/docs/5.2/helpers/ratio.md
+++ b/site/content/docs/5.3/helpers/ratio.md
@@ -74,7 +74,7 @@ This CSS variable makes it easy to modify the aspect ratio across breakpoints. T
{{< /example >}}
-## Sass map
+## Sass maps
Within `_variables.scss`, you can change the aspect ratios you want to use. Here's our default `$ratio-aspect-ratios` map. Modify the map as you like and recompile your Sass to put them to use.
diff --git a/site/content/docs/5.2/helpers/stacks.md b/site/content/docs/5.3/helpers/stacks.md
index e1960c5..2be6b30 100644
--- a/site/content/docs/5.2/helpers/stacks.md
+++ b/site/content/docs/5.3/helpers/stacks.md
@@ -17,11 +17,11 @@ Heads up! Support for gap utilities with flexbox was recently added to Safari, s
Use `.vstack` to create vertical layouts. Stacked items are full-width by default. Use `.gap-*` utilities to add space between items.
-{{< example >}}
+{{< example class="bd-example-flex" >}}
<div class="vstack gap-3">
- <div class="bg-light border">First item</div>
- <div class="bg-light border">Second item</div>
- <div class="bg-light border">Third item</div>
+ <div class="p-2">First item</div>
+ <div class="p-2">Second item</div>
+ <div class="p-2">Third item</div>
</div>
{{< /example >}}
@@ -29,32 +29,32 @@ Use `.vstack` to create vertical layouts. Stacked items are full-width by defaul
Use `.hstack` for horizontal layouts. Stacked items are vertically centered by default and only take up their necessary width. Use `.gap-*` utilities to add space between items.
-{{< example >}}
+{{< example class="bd-example-flex" >}}
<div class="hstack gap-3">
- <div class="bg-light border">First item</div>
- <div class="bg-light border">Second item</div>
- <div class="bg-light border">Third item</div>
+ <div class="p-2">First item</div>
+ <div class="p-2">Second item</div>
+ <div class="p-2">Third item</div>
</div>
{{< /example >}}
Using horizontal margin utilities like `.ms-auto` as spacers:
-{{< example >}}
+{{< example class="bd-example-flex" >}}
<div class="hstack gap-3">
- <div class="bg-light border">First item</div>
- <div class="bg-light border ms-auto">Second item</div>
- <div class="bg-light border">Third item</div>
+ <div class="p-2">First item</div>
+ <div class="p-2">Second item</div>
+ <div class="p-2">Third item</div>
</div>
{{< /example >}}
And with [vertical rules]({{< docsref "/helpers/vertical-rule" >}}):
-{{< example >}}
+{{< example class="bd-example-flex" >}}
<div class="hstack gap-3">
- <div class="bg-light border">First item</div>
- <div class="bg-light border ms-auto">Second item</div>
+ <div class="p-2">First item</div>
+ <div class="p-2">Second item</div>
<div class="vr"></div>
- <div class="bg-light border">Third item</div>
+ <div class="p-2">Third item</div>
</div>
{{< /example >}}
@@ -80,6 +80,6 @@ Create an inline form with `.hstack`:
</div>
{{< /example >}}
-## Sass
+## CSS
{{< scss-docs name="stacks" file="scss/helpers/_stacks.scss" >}}
diff --git a/site/content/docs/5.2/helpers/stretched-link.md b/site/content/docs/5.3/helpers/stretched-link.md
index 93bffeb..21a11c0 100644
--- a/site/content/docs/5.2/helpers/stretched-link.md
+++ b/site/content/docs/5.3/helpers/stretched-link.md
@@ -36,7 +36,7 @@ Most custom components do not have `position: relative` by default, so we need t
{{< /example >}}
{{< example >}}
-<div class="row g-0 bg-light position-relative">
+<div class="row g-0 bg-body-secondary position-relative">
<div class="col-md-6 mb-md-0 p-md-4">
{{< placeholder width="100%" height="200" class="w-100" text="false" title="Generic placeholder image" >}}
</div>
@@ -66,7 +66,7 @@ If the stretched link doesn't seem to work, the [containing block](https://devel
<p class="card-text">
<a href="#" class="stretched-link text-danger" style="position: relative;">Stretched link will not work here, because <code>position: relative</code> is added to the link</a>
</p>
- <p class="card-text bg-light" style="transform: rotate(0);">
+ <p class="card-text bg-body-tertiary" style="transform: rotate(0);">
This <a href="#" class="text-warning stretched-link">stretched link</a> will only be spread over the <code>p</code>-tag, because a transform is applied to it.
</p>
</div>
diff --git a/site/content/docs/5.2/helpers/text-truncation.md b/site/content/docs/5.3/helpers/text-truncation.md
index 799f205..799f205 100644
--- a/site/content/docs/5.2/helpers/text-truncation.md
+++ b/site/content/docs/5.3/helpers/text-truncation.md
diff --git a/site/content/docs/5.2/helpers/vertical-rule.md b/site/content/docs/5.3/helpers/vertical-rule.md
index b734f61..334eb3e 100644
--- a/site/content/docs/5.2/helpers/vertical-rule.md
+++ b/site/content/docs/5.3/helpers/vertical-rule.md
@@ -35,11 +35,11 @@ Vertical rules scale their height in flex layouts:
They can also be used in [stacks]({{< docsref "/helpers/stacks" >}}):
-{{< example >}}
+{{< example class="bd-example-flex" >}}
<div class="hstack gap-3">
- <div class="bg-light border">First item</div>
- <div class="bg-light border ms-auto">Second item</div>
+ <div class="p-2">First item</div>
+ <div class="p-2 ms-auto">Second item</div>
<div class="vr"></div>
- <div class="bg-light border">Third item</div>
+ <div class="p-2">Third item</div>
</div>
{{< /example >}}
diff --git a/site/content/docs/5.2/helpers/visually-hidden.md b/site/content/docs/5.3/helpers/visually-hidden.md
index 1124065..9177560 100644
--- a/site/content/docs/5.2/helpers/visually-hidden.md
+++ b/site/content/docs/5.3/helpers/visually-hidden.md
@@ -3,7 +3,7 @@ layout: docs
title: Visually hidden
description: Use these helpers to visually hide elements but keep them accessible to assistive technologies.
group: helpers
-aliases: "/docs/5.2/helpers/screen-readers/"
+aliases: "/docs/5.3/helpers/screen-readers/"
---
Visually hide an element while still allowing it to be exposed to assistive technologies (such as screen readers) with `.visually-hidden`. Use `.visually-hidden-focusable` to visually hide an element by default, but to display it when it's focused (e.g. by a keyboard-only user). `.visually-hidden-focusable` can also be applied to a container–thanks to `:focus-within`, the container will be displayed when any child element of the container receives focus.
diff --git a/site/content/docs/5.2/layout/breakpoints.md b/site/content/docs/5.3/layout/breakpoints.md
index e773b8f..1667fd9 100644
--- a/site/content/docs/5.2/layout/breakpoints.md
+++ b/site/content/docs/5.3/layout/breakpoints.md
@@ -3,7 +3,7 @@ layout: docs
title: Breakpoints
description: Breakpoints are customizable widths that determine how your responsive layout behaves across device or viewport sizes in Bootstrap.
group: layout
-aliases: "/docs/5.2/layout/"
+aliases: "/docs/5.3/layout/"
toc: true
---
@@ -37,7 +37,7 @@ These breakpoints are customizable via Sass—you'll find them in a Sass map in
{{< scss-docs name="grid-breakpoints" file="scss/_variables.scss" >}}
-For more information and examples on how to modify our Sass maps and variables, please refer to [the Sass section of the Grid documentation]({{< docsref "/layout/grid#sass" >}}).
+For more information and examples on how to modify our Sass maps and variables, please refer to [the CSS section of the Grid documentation]({{< docsref "/layout/grid#css" >}}).
## Media queries
@@ -94,7 +94,7 @@ These Sass mixins translate in our compiled CSS using the values declared in our
### Max-width
-We occasionally use media queries that go in the other direction (the given screen size *or smaller*):
+We occasionally use media queries that go in the other direction (the given screen size _or smaller_):
```scss
// No media query necessary for xs breakpoint as it's effectively `@media (max-width: 0) { ... }`
@@ -135,7 +135,7 @@ These mixins take those declared breakpoints, subtract `.02px` from them, and us
```
{{< callout warning >}}
-{{< partial "callout-info-mediaqueries-breakpoints.md" >}}
+{{< partial "callouts/info-mediaqueries-breakpoints.md" >}}
{{< /callout >}}
### Single breakpoint
diff --git a/site/content/docs/5.2/layout/columns.md b/site/content/docs/5.3/layout/columns.md
index e2dbd3f..e6f5255 100644
--- a/site/content/docs/5.2/layout/columns.md
+++ b/site/content/docs/5.3/layout/columns.md
@@ -24,6 +24,8 @@ Use flexbox alignment utilities to vertically and horizontally align columns.
### Vertical alignment
+Change the vertical alignment with any of the responsive `align-items-*` classes.
+
{{< example class="bd-example-row bd-example-row-flex-cols" >}}
<div class="container text-center">
<div class="row align-items-start">
@@ -37,6 +39,11 @@ Use flexbox alignment utilities to vertically and horizontally align columns.
One of three columns
</div>
</div>
+</div>
+{{< /example >}}
+
+{{< example class="bd-example-row bd-example-row-flex-cols" >}}
+<div class="container text-center">
<div class="row align-items-center">
<div class="col">
One of three columns
@@ -48,6 +55,11 @@ Use flexbox alignment utilities to vertically and horizontally align columns.
One of three columns
</div>
</div>
+</div>
+{{< /example >}}
+
+{{< example class="bd-example-row bd-example-row-flex-cols" >}}
+<div class="container text-center">
<div class="row align-items-end">
<div class="col">
One of three columns
@@ -62,6 +74,8 @@ Use flexbox alignment utilities to vertically and horizontally align columns.
</div>
{{< /example >}}
+Or, change the alignment of each column individually with any of the responsive `.align-self-*` classes.
+
{{< example class="bd-example-row bd-example-row-flex-cols" >}}
<div class="container text-center">
<div class="row">
@@ -80,6 +94,8 @@ Use flexbox alignment utilities to vertically and horizontally align columns.
### Horizontal alignment
+Change the horizontal alignment with any of the responsive `justify-content-*` classes.
+
{{< example class="bd-example-row" >}}
<div class="container text-center">
<div class="row justify-content-start">
@@ -187,7 +203,7 @@ You may also apply this break at specific breakpoints with our [responsive displ
### Order classes
-Use `.order-` classes for controlling the **visual order** of your content. These classes are responsive, so you can set the `order` by breakpoint (e.g., `.order-1.order-md-2`). Includes support for `1` through `5` across all six grid tiers.
+Use `.order-` classes for controlling the **visual order** of your content. These classes are responsive, so you can set the `order` by breakpoint (e.g., `.order-1.order-md-2`). Includes support for `1` through `5` across all six grid tiers. If you need more `.order-*` classes, you can modify the default number via Sass variable.
{{< example class="bd-example-row" >}}
<div class="container text-center">
@@ -287,11 +303,12 @@ With the move to flexbox in v4, you can use margin utilities like `.me-auto` to
The `.col-*` classes can also be used outside a `.row` to give an element a specific width. Whenever column classes are used as non-direct children of a row, the paddings are omitted.
-{{< example >}}
-<div class="col-3 bg-light p-3 border">
+{{< example class="bd-example-row" >}}
+<div class="col-3 p-3 mb-2">
.col-3: width of 25%
</div>
-<div class="col-sm-9 bg-light p-3 border">
+
+<div class="col-sm-9 p-3">
.col-sm-9: width of 75% above sm breakpoint
</div>
{{< /example >}}
diff --git a/site/content/docs/5.2/layout/containers.md b/site/content/docs/5.3/layout/containers.md
index 6801aca..e0e8d9a 100644
--- a/site/content/docs/5.2/layout/containers.md
+++ b/site/content/docs/5.3/layout/containers.md
@@ -23,13 +23,13 @@ See them in action and compare them in our [Grid example]({{< docsref "/examples
{{< bs-table "table" >}}
| | Extra small<div class="fw-normal">&lt;576px</div> | Small<div class="fw-normal">&ge;576px</div> | Medium<div class="fw-normal">&ge;768px</div> | Large<div class="fw-normal">&ge;992px</div> | X-Large<div class="fw-normal">&ge;1200px</div> | XX-Large<div class="fw-normal">&ge;1400px</div> |
| --- | --- | --- | --- | --- | --- | --- |
-| `.container` | <span class="text-muted">100%</span> | 540px | 720px | 960px | 1140px | 1320px |
-| `.container-sm` | <span class="text-muted">100%</span> | 540px | 720px | 960px | 1140px | 1320px |
-| `.container-md` | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | 720px | 960px | 1140px | 1320px |
-| `.container-lg` | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | 960px | 1140px | 1320px |
-| `.container-xl` | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | 1140px | 1320px |
-| `.container-xxl` | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | 1320px |
-| `.container-fluid` | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> | <span class="text-muted">100%</span> |
+| `.container` | <span class="text-body-secondary">100%</span> | 540px | 720px | 960px | 1140px | 1320px |
+| `.container-sm` | <span class="text-body-secondary">100%</span> | 540px | 720px | 960px | 1140px | 1320px |
+| `.container-md` | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | 720px | 960px | 1140px | 1320px |
+| `.container-lg` | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | 960px | 1140px | 1320px |
+| `.container-xl` | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | 1140px | 1320px |
+| `.container-xxl` | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | 1320px |
+| `.container-fluid` | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> | <span class="text-body-secondary">100%</span> |
{{< /bs-table >}}
## Default container
@@ -64,12 +64,18 @@ Use `.container-fluid` for a full width container, spanning the entire width of
</div>
```
-## Sass
+## CSS
+
+### Sass variables
As shown above, Bootstrap generates a series of predefined container classes to help you build the layouts you desire. You may customize these predefined container classes by modifying the Sass map (found in `_variables.scss`) that powers them:
{{< scss-docs name="container-max-widths" file="scss/_variables.scss" >}}
+For more information and examples on how to modify our Sass maps and variables, please refer to [the Sass section of the Grid documentation]({{< docsref "/layout/grid#css" >}}).
+
+### Sass mixins
+
In addition to customizing the Sass, you can also create your own containers with our Sass mixin.
```scss
@@ -87,5 +93,3 @@ In addition to customizing the Sass, you can also create your own containers wit
@include make-container();
}
```
-
-For more information and examples on how to modify our Sass maps and variables, please refer to [the Sass section of the Grid documentation]({{< docsref "/layout/grid#sass" >}}).
diff --git a/site/content/docs/5.2/layout/css-grid.md b/site/content/docs/5.3/layout/css-grid.md
index 397733c..397733c 100644
--- a/site/content/docs/5.2/layout/css-grid.md
+++ b/site/content/docs/5.3/layout/css-grid.md
diff --git a/site/content/docs/5.2/layout/grid.md b/site/content/docs/5.3/layout/grid.md
index a9d0037..1783410 100644
--- a/site/content/docs/5.2/layout/grid.md
+++ b/site/content/docs/5.3/layout/grid.md
@@ -46,7 +46,7 @@ Breaking it down, here's how the grid system comes together:
- **Gutters are also responsive and customizable.** [Gutter classes are available]({{< docsref "/layout/gutters" >}}) across all breakpoints, with all the same sizes as our [margin and padding spacing]({{< docsref "/utilities/spacing" >}}). Change horizontal gutters with `.gx-*` classes, vertical gutters with `.gy-*`, or all gutters with `.g-*` classes. `.g-0` is also available to remove gutters.
-- **Sass variables, maps, and mixins power the grid.** If you don't want to use the predefined grid classes in Bootstrap, you can use our [grid's source Sass](#sass) to create your own with more semantic markup. We also include some CSS custom properties to consume these Sass variables for even greater flexibility for you.
+- **Sass variables, maps, and mixins power the grid.** If you don't want to use the predefined grid classes in Bootstrap, you can use our [grid's source Sass](#sass-variables) to create your own with more semantic markup. We also include some CSS custom properties to consume these Sass variables for even greater flexibility for you.
Be aware of the limitations and [bugs around flexbox](https://github.com/philipwalton/flexbugs), like the [inability to use some HTML elements as flex containers](https://github.com/philipwalton/flexbugs#flexbug-9).
@@ -409,11 +409,11 @@ To nest your content with the default grid, add a new `.row` and set of `.col-sm
</div>
{{< /example >}}
-## Sass
+## CSS
When using Bootstrap's source Sass files, you have the option of using Sass variables and mixins to create custom, semantic, and responsive page layouts. Our predefined grid classes use these same variables and mixins to provide a whole suite of ready-to-use classes for fast responsive layouts.
-### Variables
+### Sass variables
Variables and maps determine the number of columns, the gutter width, and the media query point at which to begin floating columns. We use these to generate the predefined grid classes documented above, as well as for the custom mixins listed below.
@@ -427,7 +427,7 @@ $grid-row-columns: 6;
{{< scss-docs name="container-max-widths" file="scss/_variables.scss" >}}
-### Mixins
+### Sass mixins
Mixins are used in conjunction with the grid variables to generate semantic CSS for individual grid columns.
diff --git a/site/content/docs/5.2/layout/gutters.md b/site/content/docs/5.3/layout/gutters.md
index 5862094..a5b0772 100644
--- a/site/content/docs/5.2/layout/gutters.md
+++ b/site/content/docs/5.3/layout/gutters.md
@@ -18,14 +18,14 @@ toc: true
`.gx-*` classes can be used to control the horizontal gutter widths. The `.container` or `.container-fluid` parent may need to be adjusted if larger gutters are used too to avoid unwanted overflow, using a matching padding utility. For example, in the following example we've increased the padding with `.px-4`:
-{{< example >}}
+{{< example class="bd-example-cols" >}}
<div class="container px-4 text-center">
<div class="row gx-5">
<div class="col">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
</div>
</div>
@@ -33,14 +33,14 @@ toc: true
An alternative solution is to add a wrapper around the `.row` with the `.overflow-hidden` class:
-{{< example >}}
+{{< example class="bd-example-cols" >}}
<div class="container overflow-hidden text-center">
<div class="row gx-5">
<div class="col">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
</div>
</div>
@@ -50,20 +50,20 @@ An alternative solution is to add a wrapper around the `.row` with the `.overflo
`.gy-*` classes can be used to control the vertical gutter widths within a row when columns wrap to new lines. Like the horizontal gutters, the vertical gutters can cause some overflow below the `.row` at the end of a page. If this occurs, you add a wrapper around `.row` with the `.overflow-hidden` class:
-{{< example >}}
+{{< example class="bd-example-cols" >}}
<div class="container overflow-hidden text-center">
<div class="row gy-5">
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
</div>
</div>
@@ -71,22 +71,22 @@ An alternative solution is to add a wrapper around the `.row` with the `.overflo
## Horizontal & vertical gutters
-`.g-*` classes can be used to control the horizontal gutter widths, for the following example we use a smaller gutter width, so there won't be a need to add the `.overflow-hidden` wrapper class.
+Use `.g-*` classes to control the horizontal and vertical grid gutters. In the example below, we use a smaller gutter width, so there isn't a need for the `.overflow-hidden` wrapper class.
-{{< example >}}
+{{< example class="bd-example-cols" >}}
<div class="container text-center">
<div class="row g-2">
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
<div class="col-6">
- <div class="p-3 border bg-light">Custom column padding</div>
+ <div class="p-3">Custom column padding</div>
</div>
</div>
</div>
@@ -96,38 +96,38 @@ An alternative solution is to add a wrapper around the `.row` with the `.overflo
Gutter classes can also be added to [row columns]({{< docsref "/layout/grid#row-columns" >}}). In the following example, we use responsive row columns and responsive gutter classes.
-{{< example >}}
+{{< example class="bd-example-cols" >}}
<div class="container text-center">
<div class="row row-cols-2 row-cols-lg-5 g-2 g-lg-3">
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
<div class="col">
- <div class="p-3 border bg-light">Row column</div>
+ <div class="p-3">Row column</div>
</div>
</div>
</div>
diff --git a/site/content/docs/5.2/layout/utilities.md b/site/content/docs/5.3/layout/utilities.md
index 009d241..009d241 100644
--- a/site/content/docs/5.2/layout/utilities.md
+++ b/site/content/docs/5.3/layout/utilities.md
diff --git a/site/content/docs/5.2/layout/z-index.md b/site/content/docs/5.3/layout/z-index.md
index 1870d05..1870d05 100644
--- a/site/content/docs/5.2/layout/z-index.md
+++ b/site/content/docs/5.3/layout/z-index.md
diff --git a/site/content/docs/5.2/migration.md b/site/content/docs/5.3/migration.md
index dbeb8f6..99575b5 100644
--- a/site/content/docs/5.2/migration.md
+++ b/site/content/docs/5.3/migration.md
@@ -7,6 +7,239 @@ aliases: "/migration/"
toc: true
---
+## v5.3.0
+
+If you're migrating from our previous alpha releases of v5.3.0, please review their changes in addition to this section.
+
+### Helpers
+
+- [Colored links]({{< docsref "/helpers/colored-links" >}}) once again have `!important` so they work better with our newly added link utilities.
+
+### Utilities
+
+- Added new `.d-inline-grid` [display utility]({{< docsref "/utilities/display" >}}).
+
+## v5.3.0-alpha2
+
+If you're migrating from our previous alpha release of v5.3.0, please review the changes listed below.
+
+### CSS variables
+
+- Removed several duplicate and unused root CSS variables.
+
+### Color modes
+
+- Dark mode colors are now derived from our theme colors (e.g., `$primary`) in Sass, rather than color specific tints or shades (e.g., `$blue-300`). This allows for a more automated dark mode when customizing the default theme colors.
+
+- Added Sass maps for generating theme colors for dark mode text, subtle background, and subtle border.
+
+- [Snippet examples]({{< docsref "/examples#snippets" >}}) are now ready for dark mode with updated markup and reduced custom styles.
+
+- Added `color-scheme: dark` to dark mode CSS to change OS level controls like scrollbars
+
+- Form validation `border-color` and text `color` states now respond to dark mode, thanks to new Sass and CSS variables.
+
+- Dropped recently added form control background CSS variables and reassigned the Sass variables to use CSS variables instead. This simplifies the styling across color modes and avoids an issue where form controls in dark mode wouldn't update properly.
+
+- Our `box-shadow`s will once again always stay dark instead of inverting to white when in dark mode.
+
+- Improved HTML and JavaScript for our color mode toggle script. The selector for changing the active SVG has been improved, and the markup made more accessible with ARIA attributes.
+
+- Improved docs code syntax colors and more across light and dark modes.
+
+### Typography
+
+- We no longer set a color for `$headings-color-dark` or `--bs-heading-color` for dark mode. To avoid several problems of headings within components appearing the wrong color, we've set the Sass variable to `null` and added a `null` check like we use on the default light mode.
+
+### Components
+
+- Cards now have a `color` set on them to improve rendering across color modes.
+
+- Added new `.nav-underline` variant for our navigation with a simpler bottom border under the active nav link. [See the docs for an example.]({{< docsref "/components/navs-tabs#underline" >}})
+
+- Navs now have new `:focus-visible` styles that better match our custom button focus styles.
+
+### Helpers
+
+- Added new `.icon-link` helper to quickly place and align Bootstrap Icons alongside a textual link. Icon links support our new link utilities, too.
+
+- Added new focus ring helper for removing the default `outline` and setting a custom `box-shadow` focus ring.
+
+### Utilities
+
+- Renamed Sass and CSS variables `${color}-text` to `${color}-text-emphasis` to match their associated utilities.
+
+- Added new `.link-body-emphasis` helper alongside our [colored links]({{< docsref "/helpers/colored-links" >}}). This creates a colored link using our color mode responsive emphasis color.
+
+- Added new link utilities for link color opacity, underline offset, underline color, and underline opacity. [Explore the new links utilities.]({{< docsref "/utilities/link" >}})
+
+- CSS variable based `border-width` utilities have been reverted to set their property directly (as was done prior to v5.2.0). This avoids inheritance issues across nested elements, including tables.
+
+- Added new `.border-black` utility to match our `.text-black` and `.bg-black` utilities.
+
+- <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> Deprecated the `.text-muted` utility and `$text-muted` Sass variable. It's been replaced by `.text-body-secondary` and `$body-secondary-color`.
+
+### Docs
+
+- Examples are now displayed with the appropriate light or dark color mode as dictated by the setting in our docs. Each example has an individual color mode picker.
+
+- Improved included JavaScript for live Toast demo.
+
+- Added `twbs/examples` repo contents to the top of the Examples page.
+
+### Tooling
+
+- Added SCSS testing via True to help test our utilities API and other customizations.
+
+- Replaced instances of our bootstrap-npm-starter project with the newer and more complete [twbs/examples repo](https://github.com/twbs/examples).
+
+<hr class="mb-4">
+
+For a complete list of changes, [see the v5.3.0-alpha2 project on GitHub](https://github.com/orgs/twbs/projects/13).
+
+## v5.3.0-alpha1
+
+<hr class="mb-4">
+
+### Color modes!
+
+Learn more by reading the new [color modes documentation]({{< docsref "/customize/color-modes" >}}).
+
+- **Global support for light (default) and dark color modes.** Set color mode globally on the `:root` element, on groups of elements and components with a wrapper class, or directly on components, with `data-bs-theme="light|dark"`. Also included is a new `color-mode()` mixin that can output a ruleset with the `data-bs-theme` selector or a media query, depending on your preference.
+
+ <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> Color modes replace dark variants for components, so `.btn-close-white`, `.carousel-dark`, `.dropdown-menu-dark`, and `.navbar-dark` are deprecated.
+
+- **New extended color system.** We've added new theme colors (but not in `$theme-colors`) for a more nuanced, system-wide color palette with new secondary, tertiary, and emphasis colors for `color` and `background-color`. These new colors are available as Sass variables, CSS variables, and utilities.
+
+- We've also expanded our theme color Sass variables, CSS variables, and utilities to include text emphasis, subtle background colors, and subtle border colors. These are available as Sass variables, CSS variables, and utilities.
+
+- Adds new `_variables-dark.scss` stylesheet to house dark-mode specific overrides. This stylesheet should be imported immediately after the existing `_variables.scss` file in your import stack.
+
+ ```diff
+ diff --git a/scss/bootstrap.scss b/scss/bootstrap.scss
+ index 8f8296def..449d70487 100644
+ --- a/scss/bootstrap.scss
+ +++ b/scss/bootstrap.scss
+ @@ -6,6 +6,7 @@
+ // Configuration
+ @import "functions";
+ @import "variables";
+ +@import "variables-dark";
+ @import "maps";
+ @import "mixins";
+ @import "utilities";
+ ```
+
+### CSS variables
+
+- Restores CSS variables for breakpoints, though we don't use them in our media queries as they're not supported. However, these can be useful in JS-specific contexts.
+
+- Per the color modes update, we've added new utilities for new Sass CSS variables `secondary` and `tertiary` text and background colors, plus `{color}-bg-subtle`, `{color}-border-subtle`, and `{color}-text-emphasis` for our theme colors. These new colors are available through Sass and CSS variables (but not our color maps) with the express goal of making it easier to customize across multiple colors modes like light and dark.
+
+- Adds additional variables for alerts, `.btn-close`, and `.offcanvas`.
+
+- The `--bs-heading-color` variable is back with an update and dark mode support. First, we now check for a `null` value on the associated Sass variable, `$headings-color`, before trying to output the CSS variable, so by default it's not present in our compiled CSS. Second, we use the CSS variable with a fallback value, `inherit`, allowing the original behavior to persist, but also allowing for overrides.
+
+- Converts links to use CSS variables for styling `color`, but not `text-decoration`. Colors are now set with `--bs-link-color-rgb` and `--bs-link-opacity` as `rgba()` color, allowing you to customize the translucency with ease. The `a:hover` pseudo-class now overrides `--bs-link-color-rgb` instead of explicitly setting the `color` property.
+
+- `--bs-border-width` is now being used in more components for greater control over default global styling.
+
+- Adds new root CSS variables for our `box-shadow`s, including `--bs-box-shadow`, `--bs-box-shadow-sm`, `--bs-box-shadow-lg`, and `--bs-box-shadow-inset`.
+
+### Components
+
+#### Alert
+
+- Alert variants are now styled via CSS variables.
+
+- <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> The `.alert-variant()` mixin is now deprecated. We now [use a Sass loop]({{< docsref "/components/alerts#sass-loops" >}}) directly to modify the component's default CSS variables for each variant.
+
+#### List group
+
+- List group item variants are now styled via CSS variables.
+
+- <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> The `.list-group-variant()` mixin is now deprecated. We now [use a Sass loop]({{< docsref "/components/list-group#sass-loops" >}}) directly to modify the component's default CSS variables for each variant.
+
+#### Dropdowns
+
+- <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> The `.dropdown-menu-dark` class has been deprecated and replaced with `data-bs-theme="dark"` on the dropdown or any parent element. [See the docs for an example.]({{< docsref "/components/dropdowns#dark-dropdowns" >}})
+
+#### Close button
+
+- <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> The `.btn-close-white` class has been deprecated and replaced with `data-bs-theme="dark"` on the close button or any parent element. [See the docs for an example.]({{< docsref "/components/close-button#dark-variant" >}})
+
+#### Navbar
+
+- <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> The `.navbar-dark` class has been deprecated and replaced with `data-bs-theme="dark"` on the navbar or any parent element. [See the docs for updated examples.]({{< docsref "/components/navbar#color-schemes" >}})
+
+### Progress bars
+
+The markup for [progress bars]({{< docsref "/components/progress" >}}) has been updated in v5.3.0. Due to the placement of `role` and various `aria-` attributes on the inner `.progress-bar` element, **some screen readers were not announcing zero value progress bars**. Now, `role="progressbar"` and the relevant `aria-*` attributes are on the outer `.progress` element, leaving the `.progress-bar` purely for the visual presentation of the bar and optional label.
+
+While we recommend adopting the new markup for improved compatibility with all screen readers, note that the legacy progress bar structure will continue to work as before.
+
+```html
+<!-- Previous markup -->
+<div class="progress">
+ <div class="progress-bar" role="progressbar" aria-label="Basic example" style="width: 25%" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100"></div>
+</div>
+
+<!-- New markup -->
+<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
+ <div class="progress-bar" style="width: 25%"></div>
+</div>
+```
+
+We've also introduced a new `.progress-stacked` class to more logically wrap [multiple progress bars]({{< docsref "/components/progress#multiple-bars" >}}) into a single stacked progress bar.
+
+```html
+<!-- Previous markup -->
+<div class="progress">
+ <div class="progress-bar" role="progressbar" aria-label="Segment one" style="width: 15%" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100"></div>
+ <div class="progress-bar bg-success" role="progressbar" aria-label="Segment two" style="width: 30%" aria-valuenow="30" aria-valuemin="0" aria-valuemax="100"></div>
+ <div class="progress-bar bg-info" role="progressbar" aria-label="Segment three" style="width: 20%" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100"></div>
+</div>
+
+<!-- New markup -->
+<div class="progress-stacked">
+ <div class="progress" role="progressbar" aria-label="Segment one" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100" style="width: 15%">
+ <div class="progress-bar"></div>
+ </div>
+ <div class="progress" role="progressbar" aria-label="Segment two" aria-valuenow="30" aria-valuemin="0" aria-valuemax="100" style="width: 30%">
+ <div class="progress-bar bg-success"></div>
+ </div>
+ <div class="progress" role="progressbar" aria-label="Segment three" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
+ <div class="progress-bar bg-info"></div>
+ </div>
+</div>
+```
+
+### Forms
+
+- `.form-control` is now styled with CSS variables to support color modes. This includes the addition of two new root CSS variables for the default and disabled form control backgrounds.
+
+- `.form-check` and `.form-switch` components are now built with CSS variables for setting the `background-image`. The usage here differs from other components in that the various focus, active, etc states for each component aren't set on the base class. Instead, the states override one variable (e.g., `--bs-form-switch-bg`).
+
+- Floating form labels now have a `background-color` to fix support for `<textarea>` elements. Additional changes have been made to also support disabled states and more.
+
+- Fixed display of date and time inputs in WebKit based browsers.
+
+### Utilities
+
+- <span class="badge text-warning-emphasis bg-warning-subtle">Deprecated</span> `.text-muted` will be replaced by `.text-body-secondary` in v6.
+
+ With the addition of the expanded theme colors and variables, the `.text-muted` variables and utility have been deprecated with v5.3.0. Its default value has also been reassigned to the new `--bs-secondary-color` CSS variable to better support color modes. It will be removed in v6.0.0.
+
+- Adds new `.overflow-x`, `.overflow-y`, and several `.object-fit-*` utilities. _The object-fit property is used to specify how an `<img>` or `<video>` should be resized to fit its container, giving us a responsive alternative to using `background-image` for a resizable fill/fit image._
+
+- Adds new `.fw-medium` utility.
+
+- Added new [`.z-*` utilities]({{< docsref "/utilities/z-index" >}}) for `z-index`.
+
+- [Box shadow utilities]({{< docsref "/utilities/shadows" >}}) (and Sass variables) have been updated for dark mode. They now use `--bs-body-color-rgb` to generate the `rgba()` color values, allowing them to easily adapt to color modes based on the specified foreground color.
+
+For a complete list of changes, [see the v5.3.0 project on GitHub](https://github.com/twbs/bootstrap/projects/).
+
## v5.2.0
<hr class="mb-4">
@@ -150,7 +383,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co
- Renamed "Navs" component page to "Navs & Tabs".
- Renamed "Checks" page to "Checks & radios".
- Redesigned the navbar and added a new subnav to make it easier to get around our sites and docs versions.
-- Added new keyboard shortcut for the search field: <kbd>Ctrl + /</kbd>.
+- Added new keyboard shortcut for the search field: <kbd><kbd>Ctrl</kbd> + <kbd>/</kbd></kbd>.
## Sass
@@ -437,7 +670,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co
- Renamed `.rounded-left` and `.rounded-right` to `.rounded-start` and `.rounded-end`.
- Renamed `.ml-*` and `.mr-*` to `.ms-*` and `.me-*`.
- Renamed `.pl-*` and `.pr-*` to `.ps-*` and `.pe-*`.
- - Renamed `.text-left` and `.text-right` to `.text-start` and `.text-end`.
+ - Renamed `.text-*-left` and `.text-*-right` to `.text-*-start` and `.text-*-end`.
- <span class="badge bg-danger">Breaking</span> Disabled negative margins by default.
@@ -457,7 +690,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co
- <span class="badge bg-danger">Breaking</span> Renamed `.font-weight-*` utilities as `.fw-*` for brevity and consistency.
-- <span class="badge bg-danger">Breaking</span> Renamed `.font-style-*` utilities as `.fst-*` for brevity and consistency.
+- <span class="badge bg-danger">Breaking</span> Renamed `.font-italic` utility to `.fst-italic` for brevity and consistency with new `.fst-normal` utility.
- Added `.d-grid` to display utilities and new `gap` utilities (`.gap`) for CSS Grid and flexbox layouts.
diff --git a/site/content/docs/5.2/utilities/api.md b/site/content/docs/5.3/utilities/api.md
index 81017ee..aa7d6b8 100644
--- a/site/content/docs/5.2/utilities/api.md
+++ b/site/content/docs/5.3/utilities/api.md
@@ -3,7 +3,7 @@ layout: docs
title: Utility API
description: The utility API is a Sass-based tool to generate utility classes.
group: utilities
-aliases: "/docs/5.2/utilities/"
+aliases: "/docs/5.3/utilities/"
toc: true
---
@@ -389,6 +389,7 @@ New utilities can be added to the default `$utilities` map with a `map-merge`. M
```scss
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
@@ -415,6 +416,7 @@ Modify existing utilities in the default `$utilities` map with `map-get` and `ma
```scss
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
@@ -444,6 +446,7 @@ You can enable responsive classes for an existing set of utilities that are not
```scss
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
@@ -499,6 +502,7 @@ Missing v4 utilities, or used to another naming convention? The utilities API ca
```scss
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
@@ -522,6 +526,7 @@ Remove any of the default utilities with the [`map-remove()` Sass function](http
```scss
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
@@ -537,6 +542,7 @@ You can also use the [`map-merge()` Sass function](https://sass-lang.com/documen
```scss
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
@@ -558,6 +564,7 @@ You can add, remove, and modify many utilities all at once with the [`map-merge(
```scss
@import "bootstrap/scss/functions";
@import "bootstrap/scss/variables";
+@import "bootstrap/scss/variables-dark";
@import "bootstrap/scss/maps";
@import "bootstrap/scss/mixins";
@import "bootstrap/scss/utilities";
diff --git a/site/content/docs/5.2/utilities/background.md b/site/content/docs/5.3/utilities/background.md
index fe0bf57..c17ed84 100644
--- a/site/content/docs/5.2/utilities/background.md
+++ b/site/content/docs/5.3/utilities/background.md
@@ -6,19 +6,32 @@ group: utilities
toc: true
---
+{{< callout info >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
+{{< /callout >}}
+
## Background color
Similar to the contextual text color classes, set the background of an element to any contextual class. Background utilities **do not set `color`**, so in some cases you'll want to use `.text-*` [color utilities]({{< docsref "/utilities/colors" >}}).
+{{< callout info >}}
+Background utilities like `.bg-*` that generated from our original `$theme-colors` Sass map don't yet respond to color modes, however, any `.bg-*-subtle` utility will. This will be resolved in v6.
+{{< /callout >}}
+
{{< example >}}
{{< colors.inline >}}
{{- range (index $.Site.Data "theme-colors") }}
<div class="p-3 mb-2 bg-{{ .name }}{{ if .contrast_color }} text-{{ .contrast_color }}{{ else }} text-white{{ end }}">.bg-{{ .name }}</div>
+<div class="p-3 mb-2 bg-{{ .name }}-subtle text-emphasis-{{ .name }}">.bg-{{ .name }}-subtle</div>
{{- end -}}
{{< /colors.inline >}}
-<div class="p-3 mb-2 bg-body text-dark">.bg-body</div>
+<p class="p-3 mb-2 bg-body-secondary">.bg-body-secondary</p>
+<p class="p-3 mb-2 bg-body-tertiary">.bg-body-tertiary</p>
+
+<div class="p-3 mb-2 bg-body text-body">.bg-body</div>
+<div class="p-3 mb-2 bg-black text-white">.bg-black</div>
<div class="p-3 mb-2 bg-white text-dark">.bg-white</div>
-<div class="p-3 mb-2 bg-transparent text-dark">.bg-transparent</div>
+<div class="p-3 mb-2 bg-transparent text-body">.bg-transparent</div>
{{< /example >}}
## Background gradient
@@ -33,6 +46,7 @@ Do you need a gradient in your custom CSS? Just add `background-image: var(--bs-
<div class="p-3 mb-2 bg-{{ .name }} bg-gradient{{ with .contrast_color }} text-{{ . }}{{ else }} text-white{{ end }}">.bg-{{ .name }}.bg-gradient</div>
{{- end -}}
{{< /colors.inline >}}
+<div class="p-3 mb-2 bg-black bg-gradient text-white">.bg-black.bg-gradient</div>
{{< /markdown >}}
## Opacity
@@ -73,11 +87,11 @@ Or, choose from any of the `.bg-opacity` utilities:
<div class="bg-success p-2 text-dark bg-opacity-10">This is 10% opacity success background</div>
{{< /example >}}
-## Sass
+## CSS
In addition to the following Sass functionality, consider reading about our included [CSS custom properties]({{< docsref "/customize/css-variables" >}}) (aka CSS variables) for colors and more.
-### Variables
+### Sass variables
Most `background-color` utilities are generated by our theme colors, reassigned from our generic color palette variables.
@@ -91,7 +105,13 @@ Grayscale colors are also available, but only a subset are used to generate any
{{< scss-docs name="gray-color-variables" file="scss/_variables.scss" >}}
-### Map
+Variables for setting `background-color` in `.bg-*-subtle` utilities in light and dark mode:
+
+{{< scss-docs name="theme-bg-subtle-variables" file="scss/_variables.scss" >}}
+
+{{< scss-docs name="theme-bg-subtle-dark-variables" file="scss/_variables-dark.scss" >}}
+
+### Sass maps
Theme colors are then put into a Sass map so we can loop over them to generate our utilities, component modifiers, and more.
@@ -105,11 +125,17 @@ RGB colors are generated from a separate Sass map:
{{< scss-docs name="theme-colors-rgb" file="scss/_maps.scss" >}}
-And background color opacities build on that with their own map that's consumed by the utilities API:
+Background color opacities build on that with their own map that's consumed by the utilities API:
{{< scss-docs name="utilities-bg-colors" file="scss/_maps.scss" >}}
-### Mixins
+Color mode background colors are also available as a Sass map:
+
+{{< scss-docs name="theme-bg-subtle-map" file="scss/_maps.scss" >}}
+
+{{< scss-docs name="theme-bg-subtle-dark-map" file="scss/_maps.scss" >}}
+
+### Sass mixins
**No mixins are used to generate our background utilities**, but we do have some additional mixins for other situations where you'd like to create your own gradients.
@@ -117,7 +143,7 @@ And background color opacities build on that with their own map that's consumed
{{< scss-docs name="gradient-mixins" file="scss/mixins/_gradients.scss" >}}
-### Utilities API
+### Sass utilities API
Background utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/borders.md b/site/content/docs/5.3/utilities/borders.md
index 8d850a2..b4fa2f4 100644
--- a/site/content/docs/5.2/utilities/borders.md
+++ b/site/content/docs/5.3/utilities/borders.md
@@ -36,14 +36,20 @@ Or remove borders:
## Color
+{{< callout info >}}
+Border utilities like `.border-*` that generated from our original `$theme-colors` Sass map don't yet respond to color modes, however, any `.border-*-subtle` utility will. This will be resolved in v6.
+{{< /callout >}}
+
Change the border color using utilities built on our theme colors.
{{< example class="bd-example-border-utils" >}}
{{< border.inline >}}
{{- range (index $.Site.Data "theme-colors") }}
<span class="border border-{{ .name }}"></span>
+<span class="border border-{{ .name }}-subtle"></span>
{{- end -}}
{{< /border.inline >}}
+<span class="border border-black"></span>
<span class="border border-white"></span>
{{< /example >}}
@@ -139,6 +145,14 @@ Use the scaling classes for larger or smaller rounded corners. Sizes range from
{{< placeholder width="75" height="75" class="rounded-5" title="Example extra large rounded image" >}}
{{< /example >}}
+{{< example class="bd-example-rounded-utils" >}}
+{{< placeholder width="75" height="75" class="rounded-bottom-1" title="Example small rounded image" >}}
+{{< placeholder width="75" height="75" class="rounded-start-2" title="Example default left rounded image" >}}
+{{< placeholder width="75" height="75" class="rounded-end-circle" title="Example right completely round image" >}}
+{{< placeholder width="75" height="75" class="rounded-start-pill" title="Example left rounded pill image" >}}
+{{< placeholder width="75" height="75" class="rounded-5 rounded-top-0" title="Example extra large bottom rounded image" >}}
+{{< /example >}}
+
## CSS
### Variables
@@ -153,11 +167,25 @@ Use the scaling classes for larger or smaller rounded corners. Sizes range from
{{< scss-docs name="border-radius-variables" file="scss/_variables.scss" >}}
+Variables for setting `border-color` in `.border-*-subtle` utilities in light and dark mode:
+
+{{< scss-docs name="theme-border-subtle-variables" file="scss/_variables.scss" >}}
+
+{{< scss-docs name="theme-border-subtle-dark-variables" file="scss/_variables-dark.scss" >}}
+
+### Sass maps
+
+Color mode adaptive border colors are also available as a Sass map:
+
+{{< scss-docs name="theme-border-subtle-map" file="scss/_maps.scss" >}}
+
+{{< scss-docs name="theme-border-subtle-dark-map" file="scss/_maps.scss" >}}
+
### Sass mixins
{{< scss-docs name="border-radius-mixins" file="scss/mixins/_border-radius.scss" >}}
-### Utilities API
+### Sass utilities API
Border utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/colors.md b/site/content/docs/5.3/utilities/colors.md
index eb917f9..775457d 100644
--- a/site/content/docs/5.2/utilities/colors.md
+++ b/site/content/docs/5.3/utilities/colors.md
@@ -6,20 +6,34 @@ group: utilities
toc: true
---
+{{< callout info >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
+{{< /callout >}}
+
## Colors
Colorize text with color utilities. If you want to colorize links, you can use the [`.link-*` helper classes]({{< docsref "/helpers/colored-links" >}}) which have `:hover` and `:focus` states.
+{{< callout info >}}
+Color utilities like `.text-*` that generated from our original `$theme-colors` Sass map don't yet respond to color modes, however, any `.text-*-emphasis` utility will. This will be resolved in v6.
+{{< /callout >}}
+
{{< example >}}
{{< colors.inline >}}
{{- range (index $.Site.Data "theme-colors") }}
<p class="text-{{ .name }}{{ with .contrast_color }} bg-{{ . }}{{ end }}">.text-{{ .name }}</p>
+<p class="text-{{ .name }}-emphasis">.text-{{ .name }}-emphasis</p>
{{- end -}}
{{< /colors.inline >}}
+
<p class="text-body">.text-body</p>
-<p class="text-muted">.text-muted</p>
+<p class="text-body-emphasis">.text-body-emphasis</p>
+<p class="text-body-secondary">.text-body-secondary</p>
+<p class="text-body-tertiary">.text-body-tertiary</p>
+
+<p class="text-black bg-white">.text-black</p>
<p class="text-white bg-dark">.text-white</p>
-<p class="text-black-50">.text-black-50</p>
+<p class="text-black-50 bg-white">.text-black-50</p>
<p class="text-white-50 bg-dark">.text-white-50</p>
{{< /example >}}
@@ -27,8 +41,8 @@ Colorize text with color utilities. If you want to colorize links, you can use t
**Deprecation:** With the addition of `.text-opacity-*` utilities and CSS variables for text utilities, `.text-black-50` and `.text-white-50` are deprecated as of v5.1.0. They'll be removed in v6.0.0.
{{< /callout >}}
-{{< callout info >}}
-{{< partial "callout-warning-color-assistive-technologies.md" >}}
+{{< callout warning >}}
+**Deprecation:** With the addition of the expanded theme colors and variables, the `.text-muted` utility has been deprecated as of v5.3.0. Its default value has also been reassigned to the new `--bs-secondary-color` CSS variable to better support color modes. It will be removed in v6.0.0.
{{< /callout >}}
## Opacity
@@ -72,11 +86,11 @@ Or, choose from any of the `.text-opacity` utilities:
Sometimes contextual classes cannot be applied due to the specificity of another selector. In some cases, a sufficient workaround is to wrap your element's content in a `<div>` or more semantic element with the desired class.
-## Sass
+## CSS
In addition to the following Sass functionality, consider reading about our included [CSS custom properties]({{< docsref "/customize/css-variables" >}}) (aka CSS variables) for colors and more.
-### Variables
+### Sass variables
Most `color` utilities are generated by our theme colors, reassigned from our generic color palette variables.
@@ -88,7 +102,15 @@ Grayscale colors are also available, but only a subset are used to generate any
{{< scss-docs name="gray-color-variables" file="scss/_variables.scss" >}}
-### Map
+{{< scss-docs name="theme-text-map" file="scss/_maps.scss" >}}
+
+Variables for setting colors in `.text-*-emphasis` utilities in light and dark mode:
+
+{{< scss-docs name="theme-text-variables" file="scss/_variables.scss" >}}
+
+{{< scss-docs name="theme-text-dark-variables" file="scss/_variables-dark.scss" >}}
+
+### Sass maps
Theme colors are then put into a Sass map so we can loop over them to generate our utilities, component modifiers, and more.
@@ -102,11 +124,17 @@ RGB colors are generated from a separate Sass map:
{{< scss-docs name="theme-colors-rgb" file="scss/_maps.scss" >}}
-And color opacities build on that with their own map that's consumed by the utilities API:
+Color opacities build on that with their own map that's consumed by the utilities API:
{{< scss-docs name="utilities-text-colors" file="scss/_maps.scss" >}}
-### Utilities API
+Color mode adaptive text colors are also available as a Sass map:
+
+{{< scss-docs name="theme-text-map" file="scss/_maps.scss" >}}
+
+{{< scss-docs name="theme-text-dark-map" file="scss/_maps.scss" >}}
+
+### Sass utilities API
Color utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/display.md b/site/content/docs/5.3/utilities/display.md
index 5ed825a..41541b9 100644
--- a/site/content/docs/5.2/utilities/display.md
+++ b/site/content/docs/5.3/utilities/display.md
@@ -26,6 +26,7 @@ Where *value* is one of:
- `inline-block`
- `block`
- `grid`
+- `inline-grid`
- `table`
- `table-cell`
- `table-row`
@@ -64,8 +65,8 @@ To show an element only on a given interval of screen sizes you can combine one
| Hidden only on sm | `.d-sm-none .d-md-block` |
| Hidden only on md | `.d-md-none .d-lg-block` |
| Hidden only on lg | `.d-lg-none .d-xl-block` |
-| Hidden only on xl | `.d-xl-none` |
-| Hidden only on xxl | `.d-xxl-none .d-xxl-block` |
+| Hidden only on xl | `.d-xl-none .d-xxl-block` |
+| Hidden only on xxl | `.d-xxl-none` |
| Visible on all | `.d-block` |
| Visible only on xs | `.d-block .d-sm-none` |
| Visible only on sm | `.d-none .d-sm-block .d-md-none` |
@@ -89,6 +90,7 @@ Change the `display` value of elements when printing with our print display util
- `.d-print-inline-block`
- `.d-print-block`
- `.d-print-grid`
+- `.d-print-inline-grid`
- `.d-print-table`
- `.d-print-table-row`
- `.d-print-table-cell`
@@ -103,9 +105,9 @@ The print and display classes can be combined.
<div class="d-none d-lg-block d-print-block">Hide up to large on screen, but always show on print</div>
{{< /example >}}
-## Sass
+## CSS
-### Utilities API
+### Sass utilities API
Display utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/flex.md b/site/content/docs/5.3/utilities/flex.md
index 567befe..d0a92e5 100644
--- a/site/content/docs/5.2/utilities/flex.md
+++ b/site/content/docs/5.3/utilities/flex.md
@@ -82,34 +82,34 @@ Use `justify-content` utilities on flexbox containers to change the alignment of
<div class="bd-example bd-example-flex">
<div class="d-flex justify-content-start mb-3">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2 bd-highlight">Justify</div>
+ <div class="p-2 bd-highlight">Content</div>
+ <div class="p-2 bd-highlight">Start</div>
</div>
<div class="d-flex justify-content-end mb-3">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2 bd-highlight">Justify</div>
+ <div class="p-2 bd-highlight">Content</div>
+ <div class="p-2 bd-highlight">End</div>
</div>
<div class="d-flex justify-content-center mb-3">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2 bd-highlight">Justify</div>
+ <div class="p-2 bd-highlight">Content</div>
+ <div class="p-2 bd-highlight">Center</div>
</div>
<div class="d-flex justify-content-between mb-3">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2 bd-highlight">Justify</div>
+ <div class="p-2 bd-highlight">Content</div>
+ <div class="p-2 bd-highlight">Between</div>
</div>
<div class="d-flex justify-content-around mb-3">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2 bd-highlight">Justify</div>
+ <div class="p-2 bd-highlight">Content</div>
+ <div class="p-2 bd-highlight">Around</div>
</div>
<div class="d-flex justify-content-evenly">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2 bd-highlight">Justify</div>
+ <div class="p-2 bd-highlight">Content</div>
+ <div class="p-2 bd-highlight">Evenly</div>
</div>
</div>
@@ -363,21 +363,20 @@ Change how flex items wrap in a flex container. Choose from no wrapping at all (
<div class="bd-example bd-example-flex">
<div class="d-flex flex-wrap">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2">Flex item 1</div>
+ <div class="p-2">Flex item 2</div>
+ <div class="p-2">Flex item 3</div>
+ <div class="p-2">Flex item 4</div>
+ <div class="p-2">Flex item 5</div>
+ <div class="p-2">Flex item 6</div>
+ <div class="p-2">Flex item 7</div>
+ <div class="p-2">Flex item 8</div>
+ <div class="p-2">Flex item 9</div>
+ <div class="p-2">Flex item 10</div>
+ <div class="p-2">Flex item 11</div>
+ <div class="p-2">Flex item 12</div>
+ <div class="p-2">Flex item 13</div>
+ <div class="p-2">Flex item 14</div>
</div>
</div>
@@ -389,21 +388,20 @@ Change how flex items wrap in a flex container. Choose from no wrapping at all (
<div class="bd-example bd-example-flex">
<div class="d-flex flex-wrap-reverse">
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
- <div class="p-2">Flex item</div>
+ <div class="p-2">Flex item 1</div>
+ <div class="p-2">Flex item 2</div>
+ <div class="p-2">Flex item 3</div>
+ <div class="p-2">Flex item 4</div>
+ <div class="p-2">Flex item 5</div>
+ <div class="p-2">Flex item 6</div>
+ <div class="p-2">Flex item 7</div>
+ <div class="p-2">Flex item 8</div>
+ <div class="p-2">Flex item 9</div>
+ <div class="p-2">Flex item 10</div>
+ <div class="p-2">Flex item 11</div>
+ <div class="p-2">Flex item 12</div>
+ <div class="p-2">Flex item 13</div>
+ <div class="p-2">Flex item 14</div>
</div>
</div>
@@ -464,7 +462,7 @@ Additionally there are also responsive `.order-first` and `.order-last` classes
## Align content
-Use `align-content` utilities on flexbox containers to align flex items *together* on the cross axis. Choose from `start` (browser default), `end`, `center`, `between`, `around`, or `stretch`. To demonstrate these utilities, we've enforced `flex-wrap: wrap` and increased the number of flex items.
+Use `align-content` utilities on flexbox containers to align flex items _together_ on the cross axis. Choose from `start` (browser default), `end`, `center`, `between`, `around`, or `stretch`. To demonstrate these utilities, we've enforced `flex-wrap: wrap` and increased the number of flex items.
**Heads up!** This property has no effect on single rows of flex items.
@@ -657,9 +655,9 @@ And say you want to vertically center the content next to the image:
</div>
{{< /example >}}
-## Sass
+## CSS
-### Utilities API
+### Sass utilities API
Flexbox utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/float.md b/site/content/docs/5.3/utilities/float.md
index a18c214..a8d3efb 100644
--- a/site/content/docs/5.2/utilities/float.md
+++ b/site/content/docs/5.3/utilities/float.md
@@ -39,9 +39,9 @@ Here are all the support classes:
{{< /float.inline >}}
{{< /markdown >}}
-## Sass
+## CSS
-### Utilities API
+### Sass utilities API
Float utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/interactions.md b/site/content/docs/5.3/utilities/interactions.md
index 35ea2b9..d602850 100644
--- a/site/content/docs/5.2/utilities/interactions.md
+++ b/site/content/docs/5.3/utilities/interactions.md
@@ -31,11 +31,11 @@ The `.pe-none` class (and the `pointer-events` CSS property it sets) only preven
If possible, the simpler solution is:
- For form controls, add the `disabled` HTML attribute.
-* For links, remove the `href` attribute, making it a non-interactive anchor or placeholder link.
+- For links, remove the `href` attribute, making it a non-interactive anchor or placeholder link.
-## Sass
+## CSS
-### Utilities API
+### Sass utilities API
Interaction utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.3/utilities/link.md b/site/content/docs/5.3/utilities/link.md
new file mode 100644
index 0000000..668af8c
--- /dev/null
+++ b/site/content/docs/5.3/utilities/link.md
@@ -0,0 +1,105 @@
+---
+layout: docs
+title: Link
+description: Link utilities are used to stylize your anchors to adjust their color, opacity, underline offset, underline color, and more.
+group: utilities
+toc: true
+added: 5.3
+---
+
+## Link opacity
+
+Change the alpha opacity of the link `rgba()` color value with utilities. Please be aware that changes to a color's opacity can lead to links with [*insufficient* contrast]({{< docsref "getting-started/accessibility#color-contrast" >}}).
+
+{{< example >}}
+<p><a class="link-opacity-10" href="#">Link opacity 10</a></p>
+<p><a class="link-opacity-25" href="#">Link opacity 25</a></p>
+<p><a class="link-opacity-50" href="#">Link opacity 50</a></p>
+<p><a class="link-opacity-75" href="#">Link opacity 75</a></p>
+<p><a class="link-opacity-100" href="#">Link opacity 100</a></p>
+{{< /example >}}
+
+You can even change the opacity level on hover.
+
+{{< example >}}
+<p><a class="link-opacity-10-hover" href="#">Link hover opacity 10</a></p>
+<p><a class="link-opacity-25-hover" href="#">Link hover opacity 25</a></p>
+<p><a class="link-opacity-50-hover" href="#">Link hover opacity 50</a></p>
+<p><a class="link-opacity-75-hover" href="#">Link hover opacity 75</a></p>
+<p><a class="link-opacity-100-hover" href="#">Link hover opacity 100</a></p>
+{{< /example >}}
+
+## Link underlines
+
+### Underline color
+
+Change the underline's color independent of the link text color.
+
+{{< example >}}
+{{< link-underline-colors.inline >}}
+{{- range (index $.Site.Data "theme-colors") }}
+<p><a href="#" class="link-underline-{{ .name }}">{{ .name | title }} underline</a></p>
+{{- end -}}
+{{< /link-underline-colors.inline >}}
+{{< /example >}}
+
+### Underline offset
+
+Change the underline's distance from your text. Offset is set in `em` units to automatically scale with the element's current `font-size`.
+
+{{< example >}}
+<p><a href="#">Default link</a></p>
+<p><a class="link-offset-1" href="#">Offset 1 link</a></p>
+<p><a class="link-offset-2" href="#">Offset 2 link</a></p>
+<p><a class="link-offset-3" href="#">Offset 3 link</a></p>
+{{< /example >}}
+
+### Underline opacity
+
+Change the underline's opacity. Requires adding `.link-underline` to first set an `rgba()` color we use to then modify the alpha opacity.
+
+{{< example >}}
+<p><a class="link-offset-2 link-underline link-underline-opacity-0" href="#">Underline opacity 0</a></p>
+<p><a class="link-offset-2 link-underline link-underline-opacity-10" href="#">Underline opacity 10</a></p>
+<p><a class="link-offset-2 link-underline link-underline-opacity-25" href="#">Underline opacity 25</a></p>
+<p><a class="link-offset-2 link-underline link-underline-opacity-50" href="#">Underline opacity 50</a></p>
+<p><a class="link-offset-2 link-underline link-underline-opacity-75" href="#">Underline opacity 75</a></p>
+<p><a class="link-offset-2 link-underline link-underline-opacity-100" href="#">Underline opacity 100</a></p>
+{{< /example >}}
+
+### Hover variants
+
+Just like the `.link-opacity-*-hover` utilities, `.link-offset` and `.link-underline-opacity` utilities include `:hover` variants by default. Mix and match to create unique link styles.
+
+{{< example >}}
+<a class="link-offset-2 link-offset-3-hover link-underline link-underline-opacity-0 link-underline-opacity-75-hover" href="#">
+ Underline opacity 0
+</a>
+{{< /example >}}
+
+## Colored links
+
+[Colored link helpers]({{< docsref "/helpers/colored-links/" >}}) have been updated to pair with our link utilities. Use the new utilities to modify the link opacity, underline opacity, and underline offset.
+
+{{< example >}}
+{{< colored-links.inline >}}
+{{- range (index $.Site.Data "theme-colors") }}
+<p><a href="#" class="link-{{ .name }} link-offset-2 link-underline-opacity-25 link-underline-opacity-100-hover">{{ .name | title }} link</a></p>
+{{- end -}}
+{{< /colored-links.inline >}}
+<p><a href="#" class="link-body-emphasis link-offset-2 link-underline-opacity-25 link-underline-opacity-75-hover">Emphasis link</a></p>
+{{< /example >}}
+
+{{< callout info >}}
+{{< partial "callouts/warning-color-assistive-technologies.md" >}}
+{{< /callout >}}
+
+## CSS
+
+In addition to the following Sass functionality, consider reading about our included [CSS custom properties]({{< docsref "/customize/css-variables" >}}) (aka CSS variables) for colors and more.
+
+### Sass utilities API
+
+Link utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-links" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/5.3/utilities/object-fit.md b/site/content/docs/5.3/utilities/object-fit.md
new file mode 100644
index 0000000..babc70a
--- /dev/null
+++ b/site/content/docs/5.3/utilities/object-fit.md
@@ -0,0 +1,63 @@
+---
+layout: docs
+title: Object fit
+description: Use the object fit utilities to modify how the content of a [replaced element](https://developer.mozilla.org/en-US/docs/Web/CSS/Replaced_element), such as an `<img>` or `<video>`, should be resized to fit its container.
+group: utilities
+toc: true
+---
+
+## How it works
+
+Change the value of the [`object-fit` property](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) with our responsive `object-fit` utility classes. This property tells the content to fill the parent container in a variety of ways, such as preserving the aspect ratio or stretching to take up as much space as possible.
+
+Classes for the value of `object-fit` are named using the format `.object-fit-{value}`. Choose from the following values:
+
+- `contain`
+- `cover`
+- `fill`
+- `scale` (for scale-down)
+- `none`
+
+## Examples
+
+Add the `object-fit-{value}` class to the [replaced element](https://developer.mozilla.org/en-US/docs/Web/CSS/Replaced_element):
+
+{{< example class="d-flex overflow-auto" >}}
+{{< placeholder width="140" height="120" class="object-fit-contain border rounded" text="Object fit contain" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="120" class="object-fit-cover border rounded" text="Object fit cover" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="120" class="object-fit-fill border rounded" text="Object fit fill" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="120" class="object-fit-scale border rounded" text="Object fit scale down" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="120" class="object-fit-none border rounded" text="Object fit none" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< /example >}}
+
+## Responsive
+
+Responsive variations also exist for each `object-fit` value using the format `.object-fit-{breakpoint}-{value}`, for the following breakpoint abbreviations: `sm`, `md`, `lg`, `xl`, and `xxl`. Classes can be combined for various effects as you need.
+
+{{< example class="d-flex overflow-auto" >}}
+{{< placeholder width="140" height="80" class="object-fit-sm-contain border rounded" text="Contain on sm" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="80" class="object-fit-md-contain border rounded" text="Contain on md" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="80" class="object-fit-lg-contain border rounded" text="Contain on lg" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="80" class="object-fit-xl-contain border rounded" text="Contain on xl" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< placeholder width="140" height="80" class="object-fit-xxl-contain border rounded" text="Contain on xxl" markup="img" color="#868e96" background="#dee2e6" >}}
+{{< /example >}}
+
+## Video
+
+The `.object-fit-{value}` and responsive `.object-fit-{breakpoint}-{value}` utilities also work on `<video>` elements.
+
+```html
+<video src="..." class="object-fit-contain" autoplay></video>
+<video src="..." class="object-fit-cover" autoplay></video>
+<video src="..." class="object-fit-fill" autoplay></video>
+<video src="..." class="object-fit-scale" autoplay></video>
+<video src="..." class="object-fit-none" autoplay></video>
+```
+
+## CSS
+
+### Sass utilities API
+
+Object fit utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-object-fit" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/5.2/utilities/opacity.md b/site/content/docs/5.3/utilities/opacity.md
index 5cc4c22..5d253a7 100644
--- a/site/content/docs/5.2/utilities/opacity.md
+++ b/site/content/docs/5.3/utilities/opacity.md
@@ -24,7 +24,9 @@ Set the `opacity` of an element using `.opacity-{value}` utilities.
<div class="opacity-25">...</div>
```
-### Utilities API
+## CSS
+
+### Sass utilities API
Opacity utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.3/utilities/overflow.md b/site/content/docs/5.3/utilities/overflow.md
new file mode 100644
index 0000000..9c8573c
--- /dev/null
+++ b/site/content/docs/5.3/utilities/overflow.md
@@ -0,0 +1,99 @@
+---
+layout: docs
+title: Overflow
+description: Use these shorthand utilities for quickly configuring how content overflows an element.
+group: utilities
+toc: true
+---
+
+## Overflow
+
+Adjust the `overflow` property on the fly with four default values and classes. These classes are not responsive by default.
+
+<div class="bd-example d-md-flex">
+ <div class="overflow-auto p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary" style="max-width: 260px; max-height: 100px;">
+ This is an example of using <code>.overflow-auto</code> on an element with set width and height dimensions. By design, this content will vertically scroll.
+ </div>
+ <div class="overflow-hidden p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary" style="max-width: 260px; max-height: 100px;">
+ This is an example of using <code>.overflow-hidden</code> on an element with set width and height dimensions.
+ </div>
+ <div class="overflow-visible p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary" style="max-width: 260px; max-height: 100px;">
+ This is an example of using <code>.overflow-visible</code> on an element with set width and height dimensions.
+ </div>
+ <div class="overflow-scroll p-3 bg-body-tertiary" style="max-width: 260px; max-height: 100px;">
+ This is an example of using <code>.overflow-scroll</code> on an element with set width and height dimensions.
+ </div>
+</div>
+
+```html
+<div class="overflow-auto">...</div>
+<div class="overflow-hidden">...</div>
+<div class="overflow-visible">...</div>
+<div class="overflow-scroll">...</div>
+```
+
+### `overflow-x`
+
+Adjust the `overflow-x` property to affect the overflow of content horizontally.
+
+<div class="bd-example d-md-flex">
+ <div class="overflow-x-auto p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px; white-space: nowrap;">
+ <div><code>.overflow-x-auto</code> example on an element</div>
+ <div> with set width and height dimensions.</div>
+ </div>
+ <div class="overflow-x-hidden p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px;white-space: nowrap;">
+ <div><code>.overflow-x-hidden</code> example</div>
+ <div>on an element with set width and height dimensions.</div>
+ </div>
+ <div class="overflow-x-visible p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px;white-space: nowrap;">
+ <div><code>.overflow-x-visible</code> example </div>
+ <div>on an element with set width and height dimensions.</div>
+ </div>
+ <div class="overflow-x-scroll p-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px;white-space: nowrap;">
+ <div><code>.overflow-x-scroll</code> example on an element</div>
+ <div> with set width and height dimensions.</div>
+ </div>
+</div>
+
+```html
+<div class="overflow-x-auto">...</div>
+<div class="overflow-x-hidden">...</div>
+<div class="overflow-x-visible">...</div>
+<div class="overflow-x-scroll">...</div>
+```
+
+### `overflow-y`
+
+Adjust the `overflow-y` property to affect the overflow of content vertically.
+
+<div class="bd-example d-md-flex">
+ <div class="overflow-y-auto p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px;">
+ <code>.overflow-y-auto</code> example on an element with set width and height dimensions.
+ </div>
+ <div class="overflow-y-hidden p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px;">
+ <code>.overflow-y-hidden</code> example on an element with set width and height dimensions.
+ </div>
+ <div class="overflow-y-visible p-3 mb-3 mb-md-0 me-md-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px;">
+ <code>.overflow-y-visible</code> example on an element with set width and height dimensions.
+ </div>
+ <div class="overflow-y-scroll p-3 bg-body-tertiary w-100" style="max-width: 200px; max-height: 100px;">
+ <code>.overflow-y-scroll</code> example on an element with set width and height dimensions.
+ </div>
+</div>
+
+```html
+<div class="overflow-y-auto">...</div>
+<div class="overflow-y-hidden">...</div>
+<div class="overflow-y-visible">...</div>
+<div class="overflow-y-scroll">...</div>
+```
+
+Using Sass variables, you may customize the overflow utilities by changing the `$overflows` variable in `_variables.scss`.
+
+## CSS
+
+### Sass utilities API
+
+Overflow utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-overflow" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/5.2/utilities/position.md b/site/content/docs/5.3/utilities/position.md
index 5a6e849..a2ef4ec 100644
--- a/site/content/docs/5.2/utilities/position.md
+++ b/site/content/docs/5.3/utilities/position.md
@@ -88,14 +88,14 @@ By adding `.translate-middle-x` or `.translate-middle-y` classes, elements can b
Here are some real life examples of these classes:
-{{< example class="bd-example-position-examples d-flex justify-content-around" >}}
+{{< example class="bd-example-position-examples d-flex justify-content-around align-items-center" >}}
<button type="button" class="btn btn-primary position-relative">
Mails <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill bg-secondary">+99 <span class="visually-hidden">unread messages</span></span>
</button>
-<button type="button" class="btn btn-dark position-relative">
- Marker <svg width="1em" height="1em" viewBox="0 0 16 16" class="position-absolute top-100 start-50 translate-middle mt-1" fill="#212529" xmlns="http://www.w3.org/2000/svg"><path d="M7.247 11.14L2.451 5.658C1.885 5.013 2.345 4 3.204 4h9.592a1 1 0 0 1 .753 1.659l-4.796 5.48a1 1 0 0 1-1.506 0z"/></svg>
-</button>
+<div class="position-relative py-2 px-4 text-bg-secondary border border-secondary rounded-pill">
+ Marker <svg width="1em" height="1em" viewBox="0 0 16 16" class="position-absolute top-100 start-50 translate-middle mt-1" fill="var(--bs-secondary)" xmlns="http://www.w3.org/2000/svg"><path d="M7.247 11.14L2.451 5.658C1.885 5.013 2.345 4 3.204 4h9.592a1 1 0 0 1 .753 1.659l-4.796 5.48a1 1 0 0 1-1.506 0z"/></svg>
+</div>
<button type="button" class="btn btn-primary position-relative">
Alerts <span class="position-absolute top-0 start-100 translate-middle badge border border-light rounded-circle bg-danger p-2"><span class="visually-hidden">unread messages</span></span>
@@ -106,8 +106,8 @@ You can use these classes with existing components to create new ones. Remember
{{< example class="bd-example-position-examples" >}}
<div class="position-relative m-4">
- <div class="progress" style="height: 1px;">
- <div class="progress-bar" role="progressbar" aria-label="Progress" style="width: 50%;" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>
+ <div class="progress" role="progressbar" aria-label="Progress" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100" style="height: 1px;">
+ <div class="progress-bar" style="width: 50%"></div>
</div>
<button type="button" class="position-absolute top-0 start-0 translate-middle btn btn-sm btn-primary rounded-pill" style="width: 2rem; height:2rem;">1</button>
<button type="button" class="position-absolute top-0 start-50 translate-middle btn btn-sm btn-primary rounded-pill" style="width: 2rem; height:2rem;">2</button>
@@ -115,15 +115,15 @@ You can use these classes with existing components to create new ones. Remember
</div>
{{< /example >}}
-## Sass
+## CSS
-### Maps
+### Sass maps
Default position utility values are declared in a Sass map, then used to generate our utilities.
{{< scss-docs name="position-map" file="scss/_variables.scss" >}}
-### Utilities API
+### Sass utilities API
Position utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/shadows.md b/site/content/docs/5.3/utilities/shadows.md
index bb5ef44..94868a1 100644
--- a/site/content/docs/5.2/utilities/shadows.md
+++ b/site/content/docs/5.3/utilities/shadows.md
@@ -10,20 +10,20 @@ toc: true
While shadows on components are disabled by default in Bootstrap and can be enabled via `$enable-shadows`, you can also quickly add or remove a shadow with our `box-shadow` utility classes. Includes support for `.shadow-none` and three default sizes (which have associated variables to match).
-{{< example >}}
-<div class="shadow-none p-3 mb-5 bg-light rounded">No shadow</div>
-<div class="shadow-sm p-3 mb-5 bg-body rounded">Small shadow</div>
-<div class="shadow p-3 mb-5 bg-body rounded">Regular shadow</div>
-<div class="shadow-lg p-3 mb-5 bg-body rounded">Larger shadow</div>
+{{< example class="overflow-hidden" >}}
+<div class="shadow-none p-3 mb-5 bg-body-tertiary rounded">No shadow</div>
+<div class="shadow-sm p-3 mb-5 bg-body-tertiary rounded">Small shadow</div>
+<div class="shadow p-3 mb-5 bg-body-tertiary rounded">Regular shadow</div>
+<div class="shadow-lg p-3 mb-5 bg-body-tertiary rounded">Larger shadow</div>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
{{< scss-docs name="box-shadow-variables" file="scss/_variables.scss" >}}
-### Utilities API
+### Sass utilities API
Shadow utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.3/utilities/sizing.md b/site/content/docs/5.3/utilities/sizing.md
new file mode 100644
index 0000000..f588172
--- /dev/null
+++ b/site/content/docs/5.3/utilities/sizing.md
@@ -0,0 +1,62 @@
+---
+layout: docs
+title: Sizing
+description: Easily make an element as wide or as tall with our width and height utilities.
+group: utilities
+toc: true
+---
+
+## Relative to the parent
+
+Width and height utilities are generated from the utility API in `_utilities.scss`. Includes support for `25%`, `50%`, `75%`, `100%`, and `auto` by default. Modify those values as you need to generate different utilities here.
+
+{{< example class="bd-example-flex" >}}
+<div class="w-25 p-3">Width 25%</div>
+<div class="w-50 p-3">Width 50%</div>
+<div class="w-75 p-3">Width 75%</div>
+<div class="w-100 p-3">Width 100%</div>
+<div class="w-auto p-3">Width auto</div>
+{{< /example >}}
+
+{{< example class="bd-example-flex" >}}
+<div style="height: 100px;">
+ <div class="h-25 d-inline-block" style="width: 120px;">Height 25%</div>
+ <div class="h-50 d-inline-block" style="width: 120px;">Height 50%</div>
+ <div class="h-75 d-inline-block" style="width: 120px;">Height 75%</div>
+ <div class="h-100 d-inline-block" style="width: 120px;">Height 100%</div>
+ <div class="h-auto d-inline-block" style="width: 120px;">Height auto</div>
+</div>
+{{< /example >}}
+
+You can also use `max-width: 100%;` and `max-height: 100%;` utilities as needed.
+
+{{< example class="bd-example-flex" >}}
+<div style="width: 50%; height: 100px;">
+ <div class="mw-100" style="width: 200%;">Max-width 100%</div>
+</div>
+{{< /example >}}
+
+{{< example class="bd-example-flex" >}}
+<div style="height: 100px;">
+ <div class="mh-100" style="width: 100px; height: 200px;">Max-height 100%</div>
+</div>
+{{< /example >}}
+
+## Relative to the viewport
+
+You can also use utilities to set the width and height relative to the viewport.
+
+```html
+<div class="min-vw-100">Min-width 100vw</div>
+<div class="min-vh-100">Min-height 100vh</div>
+<div class="vw-100">Width 100vw</div>
+<div class="vh-100">Height 100vh</div>
+```
+
+## CSS
+
+### Sass utilities API
+
+Sizing utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-sizing" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/5.2/utilities/spacing.md b/site/content/docs/5.3/utilities/spacing.md
index 1e5f6d3..2562b8d 100644
--- a/site/content/docs/5.2/utilities/spacing.md
+++ b/site/content/docs/5.3/utilities/spacing.md
@@ -75,13 +75,13 @@ Here are some representative examples of these classes:
Additionally, Bootstrap also includes an `.mx-auto` class for horizontally centering fixed-width block level content—that is, content that has `display: block` and a `width` set—by setting the horizontal margins to `auto`.
<div class="bd-example">
- <div class="mx-auto" style="width: 200px; background-color: rgba(86,61,124,.15);">
+ <div class="mx-auto p-2" style="width: 200px; background-color: rgba(var(--bd-violet-rgb),.15); border: rgba(var(--bd-violet-rgb),.3) solid 1px;">
Centered element
</div>
</div>
```html
-<div class="mx-auto" style="width: 200px;">
+<div class="mx-auto p-2" style="width: 200px;">
Centered element
</div>
```
@@ -100,27 +100,54 @@ The syntax is nearly the same as the default, positive margin utilities, but wit
## Gap
-When using `display: grid`, you can make use of `gap` utilities on the parent grid container. This can save on having to add margin utilities to individual grid items (children of a `display: grid` container). Gap utilities are responsive by default, and are generated via our utilities API, based on the `$spacers` Sass map.
+When using `display: grid` or `display: flex`, you can make use of `gap` utilities on the parent element. This can save on having to add margin utilities to individual children of a grid or flex container. Gap utilities are responsive by default, and are generated via our utilities API, based on the `$spacers` Sass map.
-{{< example html >}}
-<div class="d-grid gap-3">
- <div class="p-2 bg-light border">Grid item 1</div>
- <div class="p-2 bg-light border">Grid item 2</div>
- <div class="p-2 bg-light border">Grid item 3</div>
+{{< example class="bd-example-cssgrid" >}}
+<div class="grid gap-3">
+ <div class="p-2 g-col-6">Grid item 1</div>
+ <div class="p-2 g-col-6">Grid item 2</div>
+ <div class="p-2 g-col-6">Grid item 3</div>
+ <div class="p-2 g-col-6">Grid item 4</div>
</div>
{{< /example >}}
Support includes responsive options for all of Bootstrap's grid breakpoints, as well as six sizes from the `$spacers` map (`0`–`5`). There is no `.gap-auto` utility class as it's effectively the same as `.gap-0`.
-## Sass
+### row-gap
-### Maps
+`row-gap` sets the vertical space between children items in the specified container.
+
+{{< example class="bd-example-cssgrid" >}}
+<div class="grid gap-0 row-gap-3">
+ <div class="p-2 g-col-6">Grid item 1</div>
+ <div class="p-2 g-col-6">Grid item 2</div>
+ <div class="p-2 g-col-6">Grid item 3</div>
+ <div class="p-2 g-col-6">Grid item 4</div>
+</div>
+{{< /example >}}
+
+### column-gap
+
+`column-gap` sets the horizontal space between children items in the specified container.
+
+{{< example class="bd-example-cssgrid" >}}
+<div class="grid gap-0 column-gap-3">
+ <div class="p-2 g-col-6">Grid item 1</div>
+ <div class="p-2 g-col-6">Grid item 2</div>
+ <div class="p-2 g-col-6">Grid item 3</div>
+ <div class="p-2 g-col-6">Grid item 4</div>
+</div>
+{{< /example >}}
+
+## CSS
+
+### Sass maps
Spacing utilities are declared via Sass map and then generated with our utilities API.
{{< scss-docs name="spacer-variables-maps" file="scss/_variables.scss" >}}
-### Utilities API
+### Sass utilities API
Spacing utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/text.md b/site/content/docs/5.3/utilities/text.md
index 060194f..5787f95 100644
--- a/site/content/docs/5.2/utilities/text.md
+++ b/site/content/docs/5.3/utilities/text.md
@@ -38,7 +38,7 @@ Wrap text with a `.text-wrap` class.
Prevent text from wrapping with a `.text-nowrap` class.
{{< example >}}
-<div class="text-nowrap bg-light border" style="width: 8rem;">
+<div class="text-nowrap bg-body-secondary border" style="width: 8rem;">
This text should overflow the parent.
</div>
{{< /example >}}
@@ -90,6 +90,7 @@ Quickly change the `font-weight` or `font-style` of text with these utilities. `
<p class="fw-bold">Bold text.</p>
<p class="fw-bolder">Bolder weight text (relative to the parent element).</p>
<p class="fw-semibold">Semibold weight text.</p>
+<p class="fw-medium">Medium weight text.</p>
<p class="fw-normal">Normal weight text.</p>
<p class="fw-light">Light weight text.</p>
<p class="fw-lighter">Lighter weight text (relative to the parent element).</p>
@@ -121,7 +122,7 @@ Change a selection to our monospace font stack with `.font-monospace`.
Reset a text or link's color with `.text-reset`, so that it inherits the color from its parent.
{{< example >}}
-<p class="text-muted">
+<p class="text-body-secondary">
Muted text with a <a href="#" class="text-reset">reset link</a>.
</p>
{{< /example >}}
@@ -136,19 +137,23 @@ Decorate text in components with text decoration classes.
<a href="#" class="text-decoration-none">This link has its text decoration removed</a>
{{< /example >}}
-## Sass
+## CSS
-### Variables
+### Sass variables
+
+Default type and font related Sass variables:
{{< scss-docs name="font-variables" file="scss/_variables.scss" >}}
-### Maps
+### Sass maps
Font-size utilities are generated from this map, in combination with our utilities API.
{{< scss-docs name="font-sizes" file="scss/_variables.scss" >}}
-### Utilities API
+{{< scss-docs name="theme-text-map" file="scss/_maps.scss" >}}
+
+### Sass utilities API
Font and text utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/vertical-align.md b/site/content/docs/5.3/utilities/vertical-align.md
index 9fe0eeb..c24e661 100644
--- a/site/content/docs/5.2/utilities/vertical-align.md
+++ b/site/content/docs/5.3/utilities/vertical-align.md
@@ -39,9 +39,9 @@ With table cells:
</table>
{{< /example >}}
-## Sass
+## CSS
-### Utilities API
+### Sass utilities API
Vertical align utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.2/utilities/visibility.md b/site/content/docs/5.3/utilities/visibility.md
index 61eb302..e2c6bb6 100644
--- a/site/content/docs/5.2/utilities/visibility.md
+++ b/site/content/docs/5.3/utilities/visibility.md
@@ -28,9 +28,9 @@ Apply `.visible` or `.invisible` as needed.
}
```
-## Sass
+## CSS
-### Utilities API
+### Sass utilities API
Visibility utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
diff --git a/site/content/docs/5.3/utilities/z-index.md b/site/content/docs/5.3/utilities/z-index.md
new file mode 100644
index 0000000..64ed84b
--- /dev/null
+++ b/site/content/docs/5.3/utilities/z-index.md
@@ -0,0 +1,50 @@
+---
+layout: docs
+title: Z-index
+description: Use our low-level `z-index` utilities to quickly change the stack level of an element or component.
+group: utilities
+toc: true
+added: "5.3"
+---
+
+## Example
+
+Use `z-index` utilities to stack elements on top of one another. Requires a `position` value other than `static`, which can be set with custom styles or using our [position utilities]({{< docsref "/utilities/position/" >}}).
+
+{{< callout >}}
+We call these "low-level" `z-index` utilities because of their default values of `-1` through `3`, which we use for the layout of overlapping components. High-level `z-index` values are used for overlay components like modals and tooltips.
+{{< /callout >}}
+
+{{< example class="bd-example-zindex-levels position-relative" >}}
+<div class="z-3 position-absolute p-5 rounded-3"><span>z-3</span></div>
+<div class="z-2 position-absolute p-5 rounded-3"><span>z-2</span></div>
+<div class="z-1 position-absolute p-5 rounded-3"><span>z-1</span></div>
+<div class="z-0 position-absolute p-5 rounded-3"><span>z-0</span></div>
+<div class="z-n1 position-absolute p-5 rounded-3"><span>z-n1</span></div>
+{{< /example >}}
+
+## Overlays
+
+Bootstrap overlay components—dropdown, modal, offcanvas, popover, toast, and tooltip—all have their own `z-index` values to ensure a usable experience with competing "layers" of an interface.
+
+Read about them in the [`z-index` layout page]({{< docsref "/layout/z-index" >}}).
+
+## Component approach
+
+On some components, we use our low-level `z-index` values to manage repeating elements that overlap one another (like buttons in a button group or items in a list group).
+
+Learn about our [`z-index` approach]({{< docsref "/extend/approach#z-index-scales" >}}).
+
+## CSS
+
+### Sass maps
+
+Customize this Sass map to change the available values and generated utilities.
+
+{{< scss-docs name="zindex-levels-map" file="scss/_variables.scss" >}}
+
+### Sass utilities API
+
+Position utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-zindex" file="scss/_utilities.scss" >}}
diff --git a/site/content/docs/_index.html b/site/content/docs/_index.html
index fe65dc3..b04e391 100644
--- a/site/content/docs/_index.html
+++ b/site/content/docs/_index.html
@@ -1,5 +1,5 @@
---
layout: redirect
sitemap_exclude: true
-redirect: "/docs/5.2/getting-started/introduction/"
+redirect: "/docs/5.3/getting-started/introduction/"
---
diff --git a/site/content/docs/versions.md b/site/content/docs/versions.md
index 2f1e335..312decc 100644
--- a/site/content/docs/versions.md
+++ b/site/content/docs/versions.md
@@ -9,13 +9,13 @@ description: An appendix of hosted documentation for nearly every release of Boo
<div class="col-md-6 col-lg-4 col-xl mb-4">
<h2>{{ $release.group }}</h2>
<p>{{ $release.description }}</p>
- {{- $versions := sort $release.versions "v" "desc" -}}
+ {{- $versions := sort $release.versions "" "desc" -}}
{{- range $i, $version := $versions }}
{{- $len := len $versions -}}
{{ if (eq $i 0) }}<div class="list-group">{{ end }}
- <a class="list-group-item list-group-item-action py-2 text-primary{{ if (eq $version.v $.Site.Params.docs_version) }} d-flex justify-content-between align-items-center{{ end }}" href="{{ $release.baseurl }}/{{ $version.v }}/">
- {{ $version.v }}
- {{ if (eq $version.v $.Site.Params.docs_version) -}}
+ <a class="list-group-item list-group-item-action py-2 text-primary{{ if (eq $version $.Site.Params.docs_version) }} d-flex justify-content-between align-items-center{{ end }}" href="{{ $release.baseurl }}/{{ $version }}/">
+ {{ $version }}
+ {{ if (eq $version $.Site.Params.docs_version) -}}
<span class="badge bg-primary">Latest</span>
{{- end }}
</a>