add docs section

docs/_config.yml

@@ -65,6 +65,8 @@ navigation:
         url: javascript/todo-list.html
       - title: Toasts
         url: javascript/toasts.html
+      - title: Sidebar Search
+        url: javascript/sidebar-search.html
   - title: Browser Support
     url: browser-support.html
     icon: fab fa-chrome

docs/javascript/sidebar-search.md

@@ -0,0 +1,71 @@
+---
+layout: page
+title: Sidebar Search Plugin
+---
+
+The sidebar search plugin provides the functionality to search menu items from the sidebar menu entries. 
+
+##### Usage
+
+This plugin can be activated as a jQuery plugin or using the data API. 
+
+###### Data API
+{: .text-bold }
+
+Activate the plugin by adding the following data-attribue `data-widget="sidebar-search"` to a input-group inside the sidebar. You can use the HTML Markup below for a quick start.
+
+
+###### jQuery
+{: .text-bold }
+
+The jQuery API provides more customizable options that allows the developer to pre-process the request before rendering and post-process it after rendering. 
+
+```js
+("[data-widget="sidebar-search"]").SidebarSearch(options)
+```
+
+##### HTML Markup
+Place this HTML Markup after `div.user-panel`.
+```html
+<div class="form-inline">
+  <div class="input-group" data-widget="sidebar-search">
+    <input class="form-control form-control-sidebar" type="search" placeholder="Search" aria-label="Search">
+    <div class="input-group-append">
+      <button class="btn btn-sidebar">
+        <i class="fas fa-search fa-fw"></i>
+      </button>
+    </div>
+  </div>
+</div>
+```
+
+##### Options
+{: .mt-4}
+
+|---
+| Name | Type | Default | Description
+|-|-|-|-
+| arrowSign | String | '->' | Arrow Sign between the menu item path.
+| minLength | Number | 3 | Min search query length.
+| maxResults | Number | 7 | Max search results to display.
+| highlightName | Boolean | TRUE | Whether to highlight menu item name.
+| highlightPath | Boolean | FALSE  | Whether to highlight menu item path.
+| highlightClass | String | 'text-light' | Hightlight class.
+| notFoundText | String | 'No element found! | Response text if no menu item found.
+{: .table .table-bordered .bg-light}
+
+
+##### Methods
+{: .mt-4}
+
+|---
+| Method | Description
+|-|-
+|init | Init's the SidebarSearch Plugin and registers all visible menu items.
+|toggle | Toggles the search dropdown list.
+|close | Closes the search dropdown list.
+|open | Opens the search dropdown list.
+|search | Triggers a search.
+{: .table .table-bordered .bg-light}
+
+Example: `$('[data-widget="sidebar-search"]').SidebarSearch('toggle')`