Off-canvas

Create a smooth off-canvas sidebar that slides in and out of the page.

The Off-canvas component is perfect for building a mobile navigation, similar to those which are popular with many native mobile apps, where a single button in the upper left corner toggles an off-canvas sidebar with a menu.


Usage

The Off-canvas component consists of an overlay and an off-canvas bar.

Class Description
.uk-offcanvas Add this class to a <div> element to create the bar container and an overlay, blanking out the page. An id also needs to be added, so the off-canvas sidebar can be toggled.
.uk-offcanvas-bar Add this class to a child <div> element to create the off-canvas bar.

You can use any element to toggle an off-canvas sidebar. An <a> element needs to be linked to the id of the off-canvas container. To enable the necessary JavaScript, just add the data-uk-offcanvas attribute. If you are using another element, like a button, just add the data-uk-offcanvas="{target:'#ID'}" attribute to target the id of the off-canvas container.

Example

Open
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Markup

<!-- This is an anchor toggling the off-canvas sidebar -->
<a href="#my-id" data-uk-offcanvas>...</a>

<!-- This is a button toggling the off-canvas sidebar -->
<button class="uk-button" data-uk-offcanvas="{target:'#my-id'}">...</button>

<!-- This is the off-canvas sidebar -->
<div id="my-id" class="uk-offcanvas">
    <div class="uk-offcanvas-bar">...</div>
</div>

Animation Modes

You can choose between four different animation modes how the off-canvas bar should appear:

Example

Push (Default) Slide Reveal None

Markup

<a href="#my-id" data-uk-offcanvas="{mode:'slide'}">...</a>

<a href="#my-id" data-uk-offcanvas="{mode:'reveal'}">...</a>

<a href="#my-id" data-uk-offcanvas="{mode:'none'}">...</a>

Flip modifier

Add the .uk-offcanvas-bar-flip class to the off-canvas bar to adjust its alignment, so that it slides in from the right.

Example

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Markup

<div id="my-id" class="uk-offcanvas">
    <div class="uk-offcanvas-bar uk-offcanvas-bar-flip">...</div>
</div>

Off-canvas navs

An off-canvas sidebar can contain a nav from the Nav component. Add the .uk-nav-offcanvas class to style the nav according to the off-canvas context.

Example

Markup

<!-- This is the button toggling the off-canvas sidebar -->
<button class="uk-button" data-uk-offcanvas="{target:'#my-id'}">...</button>

<!-- This is the off-canvas sidebar -->
<div id="my-id" class="uk-offcanvas">
    <div class="uk-offcanvas-bar">
        <ul class="uk-nav uk-nav-offcanvas" data-uk-nav>...</ul>
    </div>
</div>

Off-canvas panels

You can place any custom content inside the off-canvas bar. Just wrap it with a <div> and add the .uk-panel class.

Example

Panel title

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Panel title

Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Markup

<!-- This is the button toggling the off-canvas sidebar -->
<button class="uk-button" data-uk-offcanvas="{target:'#my-id'}">...</button>

<!-- This is the off-canvas sidebar -->
<div id="my-id" class="uk-offcanvas">
    <div class="uk-offcanvas-bar">
        <div class="uk-panel">...</div>
    </div>
</div>

JavaScript

You can open and close the offcanvas via JavaScript:

// Show an off-canvas matching the passed CSS selector
UIkit.offcanvas.show('#my-id');

// Hide any active offcanvas. Set force to true, if you don't want any animation.
UIkit.offcanvas.hide([force = false])

JavaScript options

This is an example of how to set options via attribute:

data-uk-offcanvas="{mode:'slide'}"
Option Possible value Default Description
mode 'push', 'slide', 'reveal', 'none' push Offcanvas bar appear effect mode

Events

Name Parameter Description
show.uk.offcanvas event, panel, bar On offcanvas show
hide.uk.offcanvas event, panel, bar On offcanvas hide