Visible opposite sidebar
Display opposite sidebar on page load by adding.sidebar-opposite-visible
class to the <body>
tag.
Sidebar - vertical area that displays onscreen and presents widget components and website navigation menu in a text-based hierarchical form. All sidebars are css-driven - just add one of css classes to the body
tag and/or .sidebar
container, and sidebar will change its width and color. No js, css only. Although sidebar type is based on css, buttons do their job with jQuery - they switch necessary classes in <body>
tag. Below you'll find summarized tables with all available button
and sidebar container classes. By default the template includes 6 different sidebar types and combinations:
1. Default sidebar
Default template sidebar has 260px
width, aligned to the left (to the right in RTL version) and has dark blue background color. All navigation levels are based on accordion or collapsible functionality, open on click. Supports 2 versions: static and fixed. Fixed version can be used with native or custom scrollbars.
2. Mini sidebar
Mini sidebar has 56px
width, no text in parent level of menu items, aligned to the left (to the right in RTL version) and has dark blue background color. Second navigation level opens on parent level hover, absolute positioned, other children levels are based on accordion or collapsible functionality, open on click. It is required to add .sidebar-xs
class to the <body>
tag. This class is responsible for sidebar width and main navigation. By default all components except main navigation are hidden in mini sidebar.
3. Dual sidebar
Main sidebar has 260px
width or 56px
(if .sidebar-xs
class added). Secondary sidebar has fixed width of 260px
, which is identical to default and opposite sidebars, so different sidebar components can be placed to all these sidebars. Main and secondary sidebars can contain any content - menu, navigation, buttons, lists, tabs etc. In this type of sidebar only main sidebar is collapsible.
4. Double sidebar
Double sidebar includes additional sidebar displayed on the opposite side of the main sidebar. It has a static position, appears as an additional component with 100% height and pushes content left/right. There are 2 different ways of displaying alternative sidebar: first - when it collapses main sidebar from default to mini width and second - when it hides the main sidebar. For these actions are responsible 2 different buttons - .sidebar-opposite-toggle
and .sidebar-opposite-fix
.
5. Dual double sidebar
Dual and Double sidebars can be used together, so basically it is a 4 column layout. When opposite sidebar is shown, additional options are available: hide main sidebar, hide secondary sidebar, hide all sidebars or collapse main sidebar width. Since opposite sidebar is hidden by default, by manipulating classes you can display all 4 sidebars at once. Options are accessible via proper button and/or body classes.
Overview
This table displays all optional button
classes, responsible for the sidebar appearance. Depending on the sidebar type, add one of these classes to any button or link and this element will handle sidebar control. Multiple controls are also available - add as many sidebar controls as you wish. Pleas note: these classes don't change sidebar markup, only its CSS.
Button class | Action |
---|---|
.sidebar-main-toggle |
Collapsible sidebar. Changes main sidebar width from default to mini. This button is added to all pages by default. |
.sidebar-main-hide |
Hides and shows main sidebar. Used mostly in dual sidebar type to hide main sidebar. In other layouts this button does the same job as .sidebar-hide-all button. |
.sidebar-all-hide |
Hideable sidebar. Hides and shows main sidebar. Works with all sidebar types, except opposite sidebar. |
.sidebar-opposite-fix |
Double sidebar with fixed width. If alt sidebar is shown, main sidebar stays the same and doesn't change the width. |
.sidebar-opposite-toggle |
Collapsible double sidebar. If opposite sidebar is shown, main sidebar changes its width from default to mini. Works with all sidebar types - single and dual. |
.sidebar-opposite-main-hide |
Hides and shows main sidebar in dual sidebar layout. If opposite sidebar is shown, main sidebar is hidden. This works only in dual double sidebar version of layout. |
.sidebar-secondary-hide |
Hides/shows secondary sidebar in dual sidebar layout. Secondary sidebar supports only toggle functionality and always has fixed width of 260px . |
.sidebar-opposite-secondary-hide |
Hides/shows secondary sidebar in dual sidebar layout. If opposite sidebar is shown, secondary sidebar is hidden. This works only in dual double sidebar version of layout. |
.sidebar-opposite-hide |
Hides/shows all sidebars when opposite sidebar is shown. If opposite sidebar is shown, all sidebars are hidden. This works in all layout types. |
Example Markup
Default placement of sidebar control buttons is top navbar:
<!-- Navbar placement -->
<div class="navbar navbar-inverse">
<div class="navbar-header">...</div>
<ul class="nav navbar-nav">
<li>
<a class="sidebar-main-toggle">
<i class="icon-menu"></i>
</a>
</li>
</ul>
</div>
<!-- /navbar placement -->
Here is an example of button inside panel heading:
<!-- Panel heading placement -->
<div class="panel panel-default">
<div class="panel-heading">
<h5 class="panel-title">Panel title</h5>
<div class="heading-elements">
<button type="button" class="sidebar-main-toggle">
<i class="icon-menu"></i>
Collapse sidebar
</button>
</div>
</div>
<div class="panel-body">...</div>
</div>
<!-- /panel heading placement -->
Overview
This table demonstrates all classes for sidebar
container, responsible for the sidebar width and color. Almost all these classes are mandatory, some of them are responsible for proper styling or have a specific code attached to this class (like .sidebar-main
class, which has collapsible functionality attached). All classes can be combined depending on the type of sidebar:
Body class | Description |
---|---|
.sidebar |
Default sidebar class, should be added in all layout types. |
.sidebar-main |
Defines main sidebar. Mini sidebar .sidebar-xs class takes effect only if class .sidebar-main specified. By default all components except main navigation are hidden in mini sidebar. |
.sidebar-secondary |
Defines secondary sidebar in dual sidebar layout. Has fixed 260px width. |
.sidebar-opposite |
Defines opposite sidebar in double sidebar layout. Has fixed 260px width and appears on the opposite side from the main sidebar. |
.sidebar-default |
Defines light sidebar. This class can be applied to all sidebar types and positions. |
.sidebar.bg-* |
Defines sidebar background color. According to the custom color system, sidebar background color can be changed to one of the available colors by adding a proper class to the main sidebar container. |
.sidebar-separate |
Removes background and border from sidebar and displays categories as separate widgets. |
Example Markup
Default left aligned sidebar markup:
<!-- Default sidebar layout -->
<body>
<!-- Page container -->
<div class="page-container">
<!-- Page content -->
<div class="page-content">
<!-- Main sidebar -->
<div class="sidebar sidebar-main">
<div class="sidebar-content">...</div>
</div>
<!-- /main sidebar -->
<!-- Main content -->
<div class="content-wrapper">...</div>
<!-- /main content -->
</div>
<!-- /page content -->
</div>
<!-- /page container -->
</body>
<!-- /default sidebar layout -->
Mini sidebar markup. The only difference is <body>
class:
<!-- Mini sidebar layout -->
<body class="sidebar-xs">
<!-- Page container -->
<div class="page-container">
<!-- Page content -->
<div class="page-content">
<!-- Main sidebar -->
<div class="sidebar sidebar-main">
<div class="sidebar-content">...</div>
</div>
<!-- /main sidebar -->
<!-- Main content -->
<div class="content-wrapper">...</div>
<!-- /main content -->
</div>
<!-- /page content -->
</div>
<!-- /page container -->
</body>
<!-- /mini sidebar layout -->