#### Sidebars - Main Custom

Statistics Invoices Schedule

###### Custom background color

All sidebars support light and dark color palettes. By default main sidebar is light, if you want to change background color to some custom color from color system, add color helper class to `.sidebar-main` container and replace `.sidebar-light` class with `.sidebar-dark` class.

##### 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 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, 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 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. 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 main sidebar. 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 secondary sidebar. Has fixed `270px` width and usually comes after main sidebar.
`.sidebar-right` | Defines right sidebar. Has fixed `270px` width and appears on the right side from the main sidebar.
`.sidebar-light` | Defines light sidebar. This class can be applied to all sidebar types and positions.
`.sidebar-dark` | Defines dark sidebar. 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 navbar breakpoint 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 -->