BBnepal-Accounts/account/theme/pages/docs/javascript/control-sidebar.md
Sampanna Rimal 9cd05ef3cb commitall
2024-07-10 18:28:19 +05:45

2.5 KiB

layout title
page Control Sidebar Plugin

The control sidebar component is part of AdminLTE's layout as the right sidebar.

Usage

This plugin can be activated as a jQuery plugin or using the data api. To activate the plugin, you must first add the HTML markup to your layout, then create the toggle button as shown below.

HTML Markup

{: .text-bold }

<!-- Control Sidebar -->
<aside class="control-sidebar control-sidebar-dark">
  <!-- Control sidebar content goes here -->
</aside>
<!-- /.control-sidebar -->
Data api

{: .text-bold } Add data-widget="control-sidebar" to any button or a element to activate the plugin.

<a href="#" data-widget="control-sidebar">Toggle Control Sidebar</a>
jQuery

{: .text-bold } Just like all other AdminLTE plugins, you can also activate the toggle button using jQuery by running the following example.

$("#my-toggle-button").ControlSidebar('toggle');
Options

|---

Name Type Default Description
controlsidebarSlide Boolean TRUE Whether the sidebar should slide over the content or push the content to make space for itself.
scrollbarTheme Boolean os-theme-light Scrollbar Theme used while SideBar Fixed
scrollbarAutoHide Boolean l Scrollbar auto-hide trigger
target String .control-sidebar Target control-sidebar to handle multiple control-sidebars.
animationSpeed Boolean 300 Set the animation/transition speed equals to the scss transition speed.
{: .table .table-bordered .bg-light}
Tip!

You can use any option via the data-attributes like this to enable auto collapse sidebar on 768 pixels width.

<a href="#" data-widget="control-sidebar" data-controlsidebar-slide="false">Toggle Control Sidebar</a>

{: .quote-info}

Events

{: .mt-4}

|---

Event Type  Description
expanded.lte.controlsidebar Triggered after a control sidebar expands.
collapsed.lte.controlsidebar Triggered after a control sidebar collapses.
collapsed-done.lte.controlsidebar Triggered after a control sidebar is fully collapsed.
{: .table .table-bordered .bg-light}

Example: $('#toggle-button').on('expanded.lte.controlsidebar', handleExpandedEvent)

Methods

{: .mt-4}

|---

Method Description
collapse Collapses the control-sidebar
show Show's the control-sidebar
toggle Toggles the state of the control-sidebar expanded and collapsed
{: .table .table-bordered .bg-light}

Example: $('#toggle-button').ControlSidebar('toggle')