🔔 Alert..!! Get 2 Month Free Cloud Hosting With $200 Bonus From Digital Ocean ACTIVATE DEAL

A touch slideout navigation menu for your mobile web apps.Features:Dependency-free.Simple markup.Native scrolling.Easy customization.CSS transforms & transitions.Just 4 Kb!

Core Java Script Menus

Documentation

Slideout.js

NPM version License Build status Coverage Status Dependency status devDependency status downloads

A touch slideout navigation menu for your mobile web apps.

Features

  • Dependency-free.
  • Simple markup.
  • Native scrolling.
  • Easy customization.
  • CSS transforms & transitions.
  • Just 2 Kb! (min & gzip)

Demo

Check out the demo to see it in action (on your mobile or emulate touches on your browser).

Slideout.js demo

Installation

Slideout is available on cdnjs

<script src="https://cdnjs.cloudflare.com/ajax/libs/slideout/1.0.1/slideout.min.js"></script>

Also you can use one of many package managers

$ npm install slideout  $ spm install slideout  $ bower install slideout.js  $ component install mango/slideout 

Usage

Implementing Slideout.js into your project is easy.

First of all, you'll need to create your markup. You should have a menu (#menu) and a main content (#panel) into your body.

<nav id="menu">   <header>     <h2>Menu</h2>   </header> </nav>  <main id="panel">   <header>     <h2>Panel</h2>   </header> </main>

Add the Slideout.js styles (index.css) in your web application.

body {   width: 100%;   height: 100%; }  .slideout-menu {   position: fixed;   top: 0;   bottom: 0;   width: 256px;   min-height: 100vh;   overflow-y: scroll;   -webkit-overflow-scrolling: touch;   z-index: 0;   display: none; }  .slideout-menu-left {   left: 0; }  .slideout-menu-right {   right: 0; }  .slideout-panel {   position: relative;   z-index: 1;   will-change: transform;   background-color: #FFF; /* A background-color is required */   min-height: 100vh; }  .slideout-open, .slideout-open body, .slideout-open .slideout-panel {   overflow: hidden; }  .slideout-open .slideout-menu {   display: block; }

Then you just include Slideout.js, create a new instance with some options and call the toggle method:

<script src="dist/slideout.min.js"></script> <script>   var slideout = new Slideout({     'panel': document.getElementById('panel'),     'menu': document.getElementById('menu'),     'padding': 256,     'tolerance': 70   });    // Toggle button   document.querySelector('.toggle-button').addEventListener('click', function() {     slideout.toggle();   }); </script>

Full example

<!doctype html> <html lang="en">   <head>     <meta charset="utf-8">     <title>Slideout Demo</title>     <meta http-equiv="cleartype" content="on">     <meta name="MobileOptimized" content="320">     <meta name="HandheldFriendly" content="True">     <meta name="apple-mobile-web-app-capable" content="yes">     <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">     <style>       body {         width: 100%;         height: 100%;       }        .slideout-menu {         position: fixed;         left: 0;         top: 0;         bottom: 0;         right: 0;         z-index: 0;         width: 256px;         overflow-y: scroll;         -webkit-overflow-scrolling: touch;         display: none;       }        .slideout-panel {         position: relative;         z-index: 1;         will-change: transform;       }        .slideout-open,       .slideout-open body,       .slideout-open .slideout-panel {         overflow: hidden;       }        .slideout-open .slideout-menu {         display: block;       }     </style>   </head>   <body>      <nav id="menu">       <h2>Menu</h2>     </nav>      <main id="panel">       <header>         <button class="toggle-button">☰</button>         <h2>Panel</h2>       </header>     </main>      <script src="dist/slideout.min.js"></script>     <script>       var slideout = new Slideout({         'panel': document.getElementById('panel'),         'menu': document.getElementById('menu'),         'padding': 256,         'tolerance': 70       });        // Toggle button       document.querySelector('.toggle-button').addEventListener('click', function() {         slideout.toggle();       });     </script>    </body> </html>

Browser Support

  • Chrome (IOS, Android, desktop)
  • Firefox (Android, desktop)
  • Safari (IOS, Android, desktop)
  • Opera (desktop)
  • IE 10+ (desktop and mobile)

API

Slideout(options)

Create a new instance of Slideout.

  • options (Object) - Options to customize a new instance of Slideout.
  • options.panel (HTMLElement) - The DOM element that contains all your application content (.slideout-panel).
  • options.menu (HTMLElement) - The DOM element that contains your menu application (.slideout-menu).
  • [options.duration] (Number) - The time (milliseconds) to open/close the slideout. Default: 300.
  • [options.easing] (String) - The CSS effect to use when animating the opening and closing of the slideout. Default: ease. Possible values:
    • ease
    • linear
    • ease-in
    • ease-out
    • ease-in-out
    • step-start
    • step-end
    • cubic-bezier
  • [options.padding] (Number) - Default: 256.
  • [options.tolerance] (Number) - The number of px needed for the menu can be opened completely, otherwise it closes. Default: 70.
  • [options.touch] (Boolean) - Set this option to false to disable Slideout touch events. Default: true.
  • [options.side] (String) - The side to open the slideout (left or right). Default: left.
var slideout = new Slideout({   'panel': document.getElementById('main'),   'menu': document.getElementById('menu'),   'padding': 256,   'tolerance': 70,   'easing': 'cubic-bezier(.32,2,.55,.27)' });

Slideout.open();

Opens the slideout menu. It emits beforeopen and open events.

slideout.open();

Slideout.close();

Closes the slideout menu. It emits beforeclose and close events.

slideout.close();

Slideout.toggle();

Toggles (open/close) the slideout menu.

slideout.toggle();

Slideout.isOpen();

Returns true if the slideout is currently open, and false if it is closed.

slideout.isOpen(); // true or false

Slideout.destroy();

Cleans up the instance so another slideout can be created on the same area.

slideout.destroy();

Slideout.enableTouch();

Enables opening the slideout via touch events.

slideout.enableTouch();

Slideout.disableTouch();

Disables opening the slideout via touch events.

slideout.disableTouch();

Slideout.on(event, listener);

slideout.on('open', function() { ... });

Slideout.once(event, listener);

slideout.once('open', function() { ... });

Slideout.off(event, listener);

slideout.off('open', listener);

Slideout.emit(event, ...data);

slideout.emit('open');

Events

An instance of Slideout emits the following events:

  • beforeclose
  • close
  • beforeopen
  • open
  • translatestart
  • translate
  • translateend

The slideout emits translatestart, translate and translateend events only when it is opening/closing via touch events.

slideout.on('translatestart', function() {   console.log('Start'); });  slideout.on('translate', function(translated) {   console.log('Translate: ' + translated); // 120 in px });  slideout.on('translateend', function() {   console.log('End'); });  // 'Start' // 'Translate 120' // 'End'

data-slideout-ignore attribute

You can use the special HTML attribute data-slideout-ignore to disable dragging on some elements. For example, if you have to prevent slideout will open when touch on carousels, maps, iframes, etc.

<main id="panel">   <header>     <h2>Panel</h2>   </header>   <div id="carousel" data-slideout-ignore>     <h2>Carousel</h2>     ...   </div> </main>

npm-scripts

$ npm run build 
$ npm run dist 
$ npm test 
$ npm run hint 

FAQ

How to add a toggle button.

// vanilla js document.querySelector('.toggle-button').addEventListener('click', function() {   slideout.toggle(); });  // jQuery $('.toggle-button').on('click', function() {     slideout.toggle(); });

How to open slideout from right side.

You should use the side option with the value right.

var slideout = new Slideout({   'panel': document.getElementById('content'),   'menu': document.getElementById('menu'),   'side': 'right' });

How to enable slideout only on mobile devices.

You should use mediaqueries:

@media screen and (min-width: 780px) {   .slideout-panel {     margin-left: 256px;   }    .slideout-menu {     display: block;   }    .btn-hamburger {     display: none;   } }

Demo: http://codepen.io/pazguille/pen/mEdQvX

How to use slideout with a fixed header.

First, you should define the styles for your fixed header:

.fixed-header {   position: fixed;   width: 100%;   height: 50px;   backface-visibility: hidden;   z-index: 2;   background-color: red; }

Then, using slideout's events you should translate the fixed header:

var fixed = document.querySelector('.fixed-header');  slideout.on('translate', function(translated) {   fixed.style.transform = 'translateX(' + translated + 'px)'; });  slideout.on('beforeopen', function () {   fixed.style.transition = 'transform 300ms ease';   fixed.style.transform = 'translateX(256px)'; });  slideout.on('beforeclose', function () {   fixed.style.transition = 'transform 300ms ease';   fixed.style.transform = 'translateX(0px)'; });  slideout.on('open', function () {   fixed.style.transition = ''; });  slideout.on('close', function () {   fixed.style.transition = ''; });

Demo: http://codepen.io/pazguille/pen/ZBxdgw

How to disable dragging on some elements.

You can use the attribute data-slideout-ignore to disable dragging on some elements:

<nav id="menu">   <header>     <h2>Menu</h2>   </header> </nav>  <main id="panel">   <header>     <h2>Panel</h2>   </header>   <div id="carousel" data-slideout-ignore>     <h2>Carousel</h2>     ...   </div> </main>

How to add an overlay to close the menu on click.

You can do that using the powerful slideout API and a little extra CSS:

.panel:before {   content: '';   display: block;   background-color: rgba(0,0,0,0);   transition: background-color 0.5s ease-in-out; }  .panel-open:before {   position: absolute;   top: 0;   bottom: 0;   width: 100%;   background-color: rgba(0,0,0,.5);   z-index: 99; }
function close(eve) {   eve.preventDefault();   slideout.close(); }  slideout   .on('beforeopen', function() {     this.panel.classList.add('panel-open');   })   .on('open', function() {     this.panel.addEventListener('click', close);   })   .on('beforeclose', function() {     this.panel.classList.remove('panel-open');     this.panel.removeEventListener('click', close);   });

Demo: http://codepen.io/pazguille/pen/BQYRYK

With ❤️ by

License

MIT license. Copyright © 2015 Mango.


You May Also Like