Hidden mini sidebar
To hide mini sidebar by default, just add.sidebar-xs
and .sidebar-main-hidden
classes to <body>
container.
Sidebars overview
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 JS - 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 270px
(~16.88rem) width, aligned to the left (to the right in RTL version) and has dark blue background color. All navigation levels are based on accordion orcollapsible 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, which is calculated dynamically. 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 requiredto 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. Can be used with main sidebar only.
3. Secondary sidebar
Main sidebar has 270px
width or 56px
(if .sidebar-xs
class added). Secondary sidebar has fixed width of 270px
, which is similar to default and right sidebars, so different sidebar components can be placed to all sidebar types. Main and secondary sidebars can contain any content - menu, navigation, buttons, lists, tabs etc. Only main sidebar is collapsible.
4. Right sidebar
Right sidebar includes additional sidebar displayed on the right (left in RTL direction) side. 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-right-main-toggle
and .sidebar-right-main-hide
.
5. Right/Secondary sidebars
Secondary and Right sidebars can be used together, so basically it is a 4 column layout. When right sidebar is shown, additional options are available: hide main sidebar, hide secondary sidebar or collapse main sidebar width. Since right sidebar is hidden by default, you can display all 4 sidebars at once by manipulating classes. Options are accessible via proper button and/or body classes.
6. Content (component) sidebar
Usually sidebar is not a part of content and mainly used for navigation. Limitless allows you to use sidebar outside and inside content area. Content sidebar isn't based on grid and has the same width as other sidebars, this means all sidebar components can be placed inside content sidebar. Supports left and right positioning and can be either stretched to fill all available height or height that depends on sidbar content height.
Button 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. Please note: these classes don't change sidebar markup, only CSS rules.
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-right-toggle
|
Toggles right sidebar - if right sidebar is shown, main sidebar width remains the same, whether it's in default or mini mode. |
.sidebar-right-main-toggle
|
Toggles right sidebar - if right sidebar is shown, main sidebar changes its width from default to mini and vice versa. Works with all sidebar layouts - main and main/secondary. |
.sidebar-right-main-hide
|
Hides and shows main sidebar in layout with right sidebar. If right sidebar is shown, main sidebar is hidden despite current width.
|
.sidebar-secondary-toggle
|
Hides/shows secondary sidebar. Secondary sidebar supports only toggle functionality and always has fixed width of 270px .
|
.sidebar-right-secondary-hide
|
Hides/shows secondary sidebar - if right sidebar is shown, secondary sidebar is hidden. This works only in the layout with right sidebar.
|
.sidebar-component-toggle
|
Hides/shows content sidebars. Content sidebars aren't connected with other sidebars, so this is the only button that controls their visibility.
|
.sidebar-mobile-main-toggle
|
Toggles main sidebar on mobile - slides from left to right.
|
.sidebar-mobile-secondary-toggle
|
Toggles secondary sidebar on mobile - slides from left to right.
|
.sidebar-mobile-right-toggle
|
Toggles right sidebar on mobile - slides from right to left.
|
.sidebar-mobile-component-toggle
|
Toggles content sidebar on mobile - has full width by default, has no animation.
|
.sidebar-mobile-expand
|
Expands sidebar to full width. Works only with main, secondary and right sidebars. |
Example Markup
Default placement of sidebar control buttons is top navbar:
<!-- Navbar placement --><div class="navbar navbar-expand navbar-dark"> <div class="navbar-brand">...</div> <ul class="navbar-nav"> <li class="nav-item"> <a href="#" class="navbar-nav-link sidebar-control sidebar-main-toggle"> <i class="icon-menu"></i> </a> </li> ... </ul></div><!-- /navbar placement -->
Here is an example of button inside card header:
<!-- Card header placement --><div class="card"> <div class="card-header header-element-inline"> <h5 class="card-title">Card title</h5> <div class="header-elements"> <button type="button" class="sidebar-main-toggle"> <i class="icon-menu"></i> Collapse sidebar </button> </div> </div> <div class="card-body">...</div></div><!-- /card header placement -->
Sidebar classes
Overview
This table demonstrates all classes for sidebar
container, responsible for the sidebar width and color. Almost all of 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). 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 mainsidebar. Mini sidebar (.sidebar-xs class) takes effect only if sidebar has .sidebar-main class. By default, all components except main navigation are hidden in mini sidebar.
|
.sidebar-secondary
|
Defines secondarysidebar. Has fixed 270px width and usually comes after main sidebar.
|
.sidebar-right
|
Defines rightsidebar. Has fixed 270px width and appears on the right side from the main sidebar.
|
.sidebar-light
|
Defines lightsidebar. This class can be applied to all sidebar types and positions. |
.sidebar-dark
|
Defines darksidebar. This class can be applied to all sidebar types and positions. This class is also required for custom colors (see below). |
.sidebar-dark.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-component
|
This class is required in content(or component) sidebar. Also requires .sidebar-component-left or .sidebar-component-right classes for proper spacing.
|
.sidebar-expand-[breakpoint]
|
This class specifies when sidebar needs to be collapsed, basically when sidebar switches to mobile mode. Breakpoint should always be similar to navbarbreakpoint for proper matching. Available breakpoints are: xl, lg, md and sm. This class is required. |
Example Markup
Default left aligned sidebar markup:
<!-- Default sidebar layout --><body> <!-- Navbar --> <div class="navbar navbar-dark navbar-expand-md"> ... </div> <!-- /navbar --> <!-- Page container --> <div class="page-content"> <!-- Main sidebar --> <div class="sidebar sidebar-dark sidebar-main sidebar-expand-md"> <div class="sidebar-content"> ... </div> </div> <!-- /main sidebar --> <!-- Main content --> <div class="content-wrapper"> ... </div> <!-- /main content --> </div> <!-- /page content --></body><!-- /default sidebar layout -->
Mini sidebar markup. The only difference is <body>
class:
<!-- Mini sidebar layout --><body class="sidebar-xs"> <!-- Navbar --> <div class="navbar navbar-dark navbar-expand-md"> ... </div> <!-- /navbar --> <!-- Page container --> <div class="page-content"> <!-- Main sidebar --> <div class="sidebar sidebar-dark sidebar-main sidebar-expand-md"> <div class="sidebar-content"> ... </div> </div> <!-- /main sidebar --> <!-- Main content --> <div class="content-wrapper"> ... </div> <!-- /main content --> </div> <!-- /page content --></body><!-- /mini sidebar layout -->