2021-03-02 18:10:10 +01:00
---
layout: docs
title: Offcanvas
description: Build hidden sidebars into your project for navigation, shopping carts, and more with a few classes and our JavaScript plugin.
group: components
toc: true
---
## How it works
2021-10-10 07:05:50 +02:00
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.
2021-03-02 18:10:10 +01:00
- 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.
- 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 " > }}
{{< / callout > }}
## Examples
### Offcanvas components
2021-03-23 07:22:59 +01:00
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.
2021-03-02 18:10:10 +01:00
2021-03-23 07:22:59 +01:00
{{< example class = "bd-example-offcanvas p-0 bg-light overflow-hidden" > }}
2021-03-23 18:06:11 +01:00
< div class = "offcanvas offcanvas-start" tabindex = "-1" id = "offcanvas" aria-labelledby = "offcanvasLabel" >
2021-03-02 18:10:10 +01:00
< div class = "offcanvas-header" >
< h5 class = "offcanvas-title" id = "offcanvasLabel" > Offcanvas< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-03-02 18:10:10 +01:00
< / div >
< div class = "offcanvas-body" >
Content for the offcanvas goes here. You can place just about any Bootstrap component or custom elements here.
< / div >
< / div >
{{< / example > }}
### Live demo
Use the buttons below to show and hide an offcanvas element via JavaScript that toggles the `.show` class on an element with the `.offcanvas` class.
- `.offcanvas` hides content (default)
- `.offcanvas.show` shows content
You can use a link with the `href` attribute, or a button with the `data-bs-target` attribute. In both cases, the `data-bs-toggle="offcanvas"` is required.
{{< example > }}
< a class = "btn btn-primary" data-bs-toggle = "offcanvas" href = "#offcanvasExample" role = "button" aria-controls = "offcanvasExample" >
Link with href
< / a >
< button class = "btn btn-primary" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#offcanvasExample" aria-controls = "offcanvasExample" >
Button with data-bs-target
< / button >
< div class = "offcanvas offcanvas-start" tabindex = "-1" id = "offcanvasExample" aria-labelledby = "offcanvasExampleLabel" >
< div class = "offcanvas-header" >
< h5 class = "offcanvas-title" id = "offcanvasExampleLabel" > Offcanvas< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-03-02 18:10:10 +01:00
< / div >
< div class = "offcanvas-body" >
< div class = "" >
Some text as placeholder. In real life you can have the elements you have chosen. Like, text, images, lists, etc.
< / div >
< div class = "dropdown mt-3" >
< button class = "btn btn-secondary dropdown-toggle" type = "button" id = "dropdownMenuButton" data-bs-toggle = "dropdown" >
Dropdown button
< / button >
< ul class = "dropdown-menu" aria-labelledby = "dropdownMenuButton" >
< 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 >
< / div >
< / div >
< / div >
{{< / example > }}
2022-03-02 01:20:37 +01:00
### Body scrolling
2021-03-02 18:10:10 +01:00
2022-03-02 01:20:37 +01:00
Scrolling the `<body>` element is disabled when an offcanvas and its backdrop are visible. Use the `data-bs-scroll` attribute to enable `<body>` scrolling.
2021-04-04 20:11:33 +02:00
{{< example > }}
2022-03-02 01:20:37 +01:00
< button class = "btn btn-primary" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#offcanvasScrolling" aria-controls = "offcanvasScrolling" > Enable body scrolling< / button >
2021-04-04 20:11:33 +02:00
2022-03-02 01:20:37 +01:00
< div class = "offcanvas offcanvas-start" data-bs-scroll = "true" data-bs-backdrop = "false" tabindex = "-1" id = "offcanvasScrolling" aria-labelledby = "offcanvasScrollingLabel" >
2021-04-04 20:11:33 +02:00
< div class = "offcanvas-header" >
2022-03-02 01:20:37 +01:00
< h5 class = "offcanvas-title" id = "offcanvasScrollingLabel" > Offcanvas with body scrolling< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-04-04 20:11:33 +02:00
< / div >
< div class = "offcanvas-body" >
2022-03-02 01:20:37 +01:00
< p > Try scrolling the rest of the page to see this option in action.< / p >
2021-04-04 20:11:33 +02:00
< / div >
< / div >
{{< / example > }}
2021-03-02 18:10:10 +01:00
2022-03-02 01:20:37 +01:00
### Body scrolling and backdrop
You can also enable `<body>` scrolling with a visible backdrop.
2021-03-02 18:10:10 +01:00
{{< example > }}
2022-03-02 01:20:37 +01:00
< button class = "btn btn-primary" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#offcanvasWithBothOptions" aria-controls = "offcanvasWithBothOptions" > Enable both scrolling & backdrop< / button >
2021-03-02 18:10:10 +01:00
2022-03-02 01:20:37 +01:00
< div class = "offcanvas offcanvas-start" data-bs-scroll = "true" tabindex = "-1" id = "offcanvasWithBothOptions" aria-labelledby = "offcanvasWithBothOptionsLabel" >
2021-03-02 18:10:10 +01:00
< div class = "offcanvas-header" >
2022-03-02 01:20:37 +01:00
< h5 class = "offcanvas-title" id = "offcanvasWithBothOptionsLabel" > Backdrop with scrolling< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-03-02 18:10:10 +01:00
< / div >
< div class = "offcanvas-body" >
2022-03-02 01:20:37 +01:00
< p > Try scrolling the rest of the page to see this option in action.< / p >
2021-03-02 18:10:10 +01:00
< / div >
< / div >
{{< / example > }}
2022-03-02 01:20:37 +01:00
### Static backdrop
When backdrop is set to static, the offcanvas will not close when clicking outside of it.
2021-03-02 18:10:10 +01:00
{{< example > }}
2022-03-02 01:20:37 +01:00
< button class = "btn btn-primary" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#staticBackdrop" aria-controls = "staticBackdrop" >
Toggle static offcanvas
< / button >
2021-03-02 18:10:10 +01:00
2022-03-02 01:20:37 +01:00
< div class = "offcanvas offcanvas-start" data-bs-backdrop = "static" tabindex = "-1" id = "staticBackdrop" aria-labelledby = "staticBackdropLabel" >
2021-03-02 18:10:10 +01:00
< div class = "offcanvas-header" >
2022-03-02 01:20:37 +01:00
< h5 class = "offcanvas-title" id = "staticBackdropLabel" > Offcanvas< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-03-02 18:10:10 +01:00
< / div >
2022-03-02 01:20:37 +01:00
< div class = "offcanvas-body" >
< div >
I will not close if you click outside of me.
< / div >
2021-03-02 18:10:10 +01:00
< / div >
< / div >
{{< / example > }}
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
## Responsive
< small class = "d-inline-flex px-2 py-1 fw-semibold text-success bg-success bg-opacity-10 rounded-2" > Added in v5.2.0< / small >
Responsive offcanvas classes hide content outside the viewport from a specified breakpoint and down. Above that breakpoint, the contents within will behave as usual. For example, `.offcanvas-lg` hides content in an offcanvas below the `lg` breakpoint, but shows the content above the `lg` breakpoint.
2022-04-19 05:56:18 +02:00
{{< example > }}
< button class = "btn btn-primary d-lg-none" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#offcanvasResponsive" aria-controls = "offcanvasResponsive" > Toggle offcanvas< / button >
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
2022-04-19 05:56:18 +02:00
< div class = "alert alert-info d-none d-lg-block" > Resize your browser to show the responsive offcanvas toggle.< / div >
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
< div class = "offcanvas-lg offcanvas-end" tabindex = "-1" id = "offcanvasResponsive" aria-labelledby = "offcanvasResponsiveLabel" >
< div class = "offcanvas-header" >
< h5 class = "offcanvas-title" id = "offcanvasResponsiveLabel" > Responsive offcanvas< / h5 >
2022-04-19 20:21:43 +02:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" data-bs-target = "#offcanvasResponsive" aria-label = "Close" > < / button >
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
< / div >
< div class = "offcanvas-body" >
< p class = "mb-0" > This is content within an < code > .offcanvas-lg< / code > .< / p >
< / div >
< / div >
2022-04-19 05:56:18 +02:00
{{< / example > }}
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
Responsive offcanvas classes are available across for each breakpoint.
- `.offcanvas`
- `.offcanvas-sm`
- `.offcanvas-md`
- `.offcanvas-lg`
- `.offcanvas-xl`
- `.offcanvas-xxl`
2022-03-02 01:20:37 +01:00
## Placement
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
There's no default placement for offcanvas components, so you must add one of the modifier classes below.
2022-03-02 01:20:37 +01:00
- `.offcanvas-start` places offcanvas on the left of the viewport (shown above)
- `.offcanvas-end` places offcanvas on the right of the viewport
- `.offcanvas-top` places offcanvas on the top of the viewport
- `.offcanvas-bottom` places offcanvas on the bottom of the viewport
2021-03-02 18:10:10 +01:00
2022-03-02 01:20:37 +01:00
Try the top, right, and bottom examples out below.
2021-03-02 18:10:10 +01:00
{{< example > }}
2022-03-02 01:20:37 +01:00
< button class = "btn btn-primary" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#offcanvasTop" aria-controls = "offcanvasTop" > Toggle top offcanvas< / button >
2021-03-02 18:10:10 +01:00
2022-03-02 01:20:37 +01:00
< div class = "offcanvas offcanvas-top" tabindex = "-1" id = "offcanvasTop" aria-labelledby = "offcanvasTopLabel" >
2021-03-02 18:10:10 +01:00
< div class = "offcanvas-header" >
2022-03-02 01:20:37 +01:00
< h5 class = "offcanvas-title" id = "offcanvasTopLabel" > Offcanvas top< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-03-02 18:10:10 +01:00
< / div >
< div class = "offcanvas-body" >
2022-03-02 01:20:37 +01:00
...
2021-03-02 18:10:10 +01:00
< / div >
< / div >
2022-03-02 01:20:37 +01:00
{{< / example > }}
{{< example > }}
< button class = "btn btn-primary" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#offcanvasRight" aria-controls = "offcanvasRight" > Toggle right offcanvas< / button >
< div class = "offcanvas offcanvas-end" tabindex = "-1" id = "offcanvasRight" aria-labelledby = "offcanvasRightLabel" >
2021-03-02 18:10:10 +01:00
< div class = "offcanvas-header" >
2022-03-02 01:20:37 +01:00
< h5 class = "offcanvas-title" id = "offcanvasRightLabel" > Offcanvas right< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-03-02 18:10:10 +01:00
< / div >
< div class = "offcanvas-body" >
2022-03-02 01:20:37 +01:00
...
2021-03-02 18:10:10 +01:00
< / div >
< / div >
2022-03-02 01:20:37 +01:00
{{< / example > }}
{{< example > }}
< button class = "btn btn-primary" type = "button" data-bs-toggle = "offcanvas" data-bs-target = "#offcanvasBottom" aria-controls = "offcanvasBottom" > Toggle bottom offcanvas< / button >
< div class = "offcanvas offcanvas-bottom" tabindex = "-1" id = "offcanvasBottom" aria-labelledby = "offcanvasBottomLabel" >
2021-03-02 18:10:10 +01:00
< div class = "offcanvas-header" >
2022-03-02 01:20:37 +01:00
< h5 class = "offcanvas-title" id = "offcanvasBottomLabel" > Offcanvas bottom< / h5 >
2022-01-02 17:26:05 +01:00
< button type = "button" class = "btn-close" data-bs-dismiss = "offcanvas" aria-label = "Close" > < / button >
2021-03-02 18:10:10 +01:00
< / div >
2022-03-02 01:20:37 +01:00
< div class = "offcanvas-body small" >
...
2021-03-02 18:10:10 +01:00
< / div >
< / div >
{{< / example > }}
## Accessibility
Since the offcanvas panel is conceptually a modal dialog, be sure to add `aria-labelledby="..."` —referencing the offcanvas title—to `.offcanvas` . Note that you don’ `role="dialog"` since we already add it via JavaScript.
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
## CSS
2021-03-02 18:10:10 +01:00
### Variables
v5.2.0 design refresh, plus responsive offcanvas classes (#35736)
* Add responsive offcanvas classes
- Updates navbar-expand classes to de-dupe some styles—these shouldn't interfere now.
- Adds some JS to the offcanvas component to help with responsiveness
Co-Authored-By: GeoSot <geo.sotis@gmail.com>
* Redesign homepage, docs, and examples
Homepage:
- New Bootstrap purple navbar
- Redesigned masthead
- Rewrote and redesigned homepage content
- Replace Copy text with icons like Bootstrap Icons site across all ClipboardJS instances
- Fixed padding issues in site footer
- Match homepage button styles to examples page, use gap instead of tons of responsive margin utils
Docs:
- New navbar, no more subnav. Migrated search and version picker into the main navbar and refreshed the design of it all, including the responsive toggles.
- New sidebar navigation is always expanded, and now features Bootstrap Icons alongside section headings
- Sidebar navigation autoscrolls to active link for better usability
- Subnav and navbar padding issues ironed out
- Enhanced the version picker in anticipation of v5.2: we can now link right to the same page in the previous version.
- Redesign callouts to add more color to our pages
- Collapse table of contents on mobile
- Cleanup and redesign button styles with CSS variables
- Update design for subnav version dropdown
- Update highlight and example to be full-width until md
- Improve the Added In badges
- Turn the ToC into a well on mobile
- Redesign code snippets to better house two action buttons
Examples:
- Redesign Examples page layout
- Add new example for responsive offcanvases in navbars
* Convert offcanvas to CSS vars
* Feat: add resize handler to Offcanvas.js.
If we could use as default the `.offcanvas` class without modifiers, we then, could add a simplified selector
The selector itself, ignores the .offcanvas class as it doesn't have any responsive behavior
The `aria-modal` addon is to protect us, selection backdrop elements
* Separate examples code, Add some selectors, fix stackblitz btn
Co-authored-by: GeoSot <geo.sotis@gmail.com>
2022-04-18 07:17:50 +02:00
< small class = "d-inline-flex px-2 py-1 fw-semibold text-success bg-success bg-opacity-10 rounded-2" > Added in v5.2.0< / small >
As part of Bootstrap's evolving CSS variables approach, offcanvas now uses local CSS variables on `.offcanvas` for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.
{{< scss-docs name = "offcanvas-css-vars" file = "scss/_offcanvas.scss" > }}
### Sass variables
2021-03-02 18:10:10 +01:00
{{< scss-docs name = "offcanvas-variables" file = "scss/_variables.scss" > }}
## Usage
The offcanvas plugin utilizes a few classes and attributes to handle the heavy lifting:
- `.offcanvas` hides the content
- `.offcanvas.show` shows the content
- `.offcanvas-start` hides the offcanvas on the left
- `.offcanvas-end` hides the offcanvas on the right
2021-10-10 07:05:50 +02:00
- `.offcanvas-top` hides the offcanvas on the top
2021-03-02 18:10:10 +01:00
- `.offcanvas-bottom` hides the offcanvas on the bottom
Add a dismiss button with the `data-bs-dismiss="offcanvas"` attribute, which triggers the JavaScript functionality. Be sure to use the `<button>` element with it for proper behavior across all devices.
### Via data attributes
2021-07-28 16:39:32 +02:00
#### Toggle
2021-03-02 18:10:10 +01:00
Add `data-bs-toggle="offcanvas"` and a `data-bs-target` or `href` to the element to automatically assign control of one offcanvas element. The `data-bs-target` attribute accepts a CSS selector to apply the offcanvas to. Be sure to add the class `offcanvas` to the offcanvas element. If you'd like it to default open, add the additional class `show` .
2021-07-28 16:39:32 +02:00
#### Dismiss
{{% js-dismiss "offcanvas" %}}
{{< callout warning > }}
While both ways to dismiss an offcanvas are supported, keep in mind that dismissing from outside an offcanvas does not match [the WAI-ARIA modal dialog design pattern ](https://www.w3.org/TR/wai-aria-practices-1.1/#dialog_modal ). Do this at your own risk.
{{< / callout > }}
2021-03-02 18:10:10 +01:00
### Via JavaScript
Enable manually with:
```js
2021-03-18 11:58:26 +01:00
var offcanvasElementList = Array.prototype.slice.call(document.querySelectorAll('.offcanvas'))
2021-03-02 18:10:10 +01:00
var offcanvasList = offcanvasElementList.map(function (offcanvasEl) {
return new bootstrap.Offcanvas(offcanvasEl)
})
```
2021-03-16 17:35:03 +01:00
### Options
Options can be passed via data attributes or JavaScript. For data attributes, append the option name to `data-bs-` , as in `data-bs-backdrop=""` .
{{< bs-table " table " > }}
| Name | Type | Default | Description |
| --- | --- | --- | --- |
2022-03-02 01:20:37 +01:00
| `backdrop` | boolean or the string `static` | `true` | Apply a backdrop on body while offcanvas is open. Alternatively, specify `static` for a backdrop which doesn't close the offcanvas when clicked. |
2021-03-16 17:35:03 +01:00
| `keyboard` | boolean | `true` | Closes the offcanvas when escape key is pressed |
| `scroll` | boolean | `false` | Allow body scrolling while offcanvas is open |
{{< / bs-table > }}
2021-03-02 18:10:10 +01:00
### Methods
{{< callout danger > }}
{{< partial " callout-danger-async-methods . md " > }}
{{< / callout > }}
Activates your content as an offcanvas element. Accepts an optional options `object` .
You can create an offcanvas instance with the constructor, for example:
```js
var myOffcanvas = document.getElementById('myOffcanvas')
var bsOffcanvas = new bootstrap.Offcanvas(myOffcanvas)
```
2021-03-16 17:35:03 +01:00
{{< bs-table " table " > }}
2021-03-02 18:10:10 +01:00
| Method | Description |
| --- | --- |
| `toggle` | Toggles an offcanvas element to shown or hidden. **Returns to the caller before the offcanvas element has actually been shown or hidden** (i.e. before the `shown.bs.offcanvas` or `hidden.bs.offcanvas` event occurs). |
| `show` | Shows an offcanvas element. **Returns to the caller before the offcanvas element has actually been shown** (i.e. before the `shown.bs.offcanvas` event occurs).|
| `hide` | Hides an offcanvas element. **Returns to the caller before the offcanvas element has actually been hidden** (i.e. before the `hidden.bs.offcanvas` event occurs).|
2021-04-06 20:48:45 +02:00
| `getInstance` | *Static* method which allows you to get the offcanvas instance associated with a DOM element |
2021-09-07 08:45:27 +02:00
| `getOrCreateInstance` | *Static* method which allows you to get the offcanvas instance associated with a DOM element, or create a new one in case it wasn't initialized |
2021-03-16 17:35:03 +01:00
{{< / bs-table > }}
2021-03-02 18:10:10 +01:00
### Events
Bootstrap's offcanvas class exposes a few events for hooking into offcanvas functionality.
2021-03-16 17:35:03 +01:00
{{< bs-table " table " > }}
| Event type | Description |
| --- | --- |
| `show.bs.offcanvas` | This event fires immediately when the `show` instance method is called. |
| `shown.bs.offcanvas` | This event is fired when an offcanvas element has been made visible to the user (will wait for CSS transitions to complete). |
| `hide.bs.offcanvas` | This event is fired immediately when the `hide` method has been called. |
| `hidden.bs.offcanvas` | This event is fired when an offcanvas element has been hidden from the user (will wait for CSS transitions to complete). |
2022-03-02 01:20:37 +01:00
| `hidePrevented.bs.offcanvas` | This event is fired when the offcanvas is shown, its backdrop is `static` and a click outside of the offcanvas is performed. The event is also fired when the escape key is pressed and the `keyboard` option is set to `false` . |
2021-03-16 17:35:03 +01:00
{{< / bs-table > }}
2021-03-02 18:10:10 +01:00
```js
var myOffcanvas = document.getElementById('myOffcanvas')
myOffcanvas.addEventListener('hidden.bs.offcanvas', function () {
// do something...
})
```
