2.8 KiB
layout | title |
---|---|
page | Navbar Search Plugin |
The navbar search plugin provides the functionality to show/hide a search input across the whole header.
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="navbar-search"
to the .navbar-search-block
inside the header. 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.
("[data-widget="navbar-search"]").SiteSearch(options)
HTML Markup
Place this HTML Markup after inside the header.
<a data-widget="navbar-search" href="#" role="button">
<i class="fas fa-search"></i>
</a>
<div class="navbar-search-block">
<form class="form-inline">
<div class="input-group input-group-sm">
<input class="form-control form-control-navbar" type="search" placeholder="Search" aria-label="Search">
<div class="input-group-append">
<button class="btn btn-navbar" type="submit">
<i class="fas fa-search"></i>
</button>
<button class="btn btn-navbar" type="button" data-widget="navbar-search">
<i class="fas fa-times"></i>
</button>
</div>
</div>
</form>
</div>
Or you can place the search button inside the navbar as nav-item with this markup:
<li class="nav-item">
<a class="nav-link" data-widget="navbar-search" href="#" role="button">
<i class="fas fa-search"></i>
</a>
<div class="navbar-search-block">
<form class="form-inline">
<div class="input-group input-group-sm">
<input class="form-control form-control-navbar" type="search" placeholder="Search" aria-label="Search">
<div class="input-group-append">
<button class="btn btn-navbar" type="submit">
<i class="fas fa-search"></i>
</button>
<button class="btn btn-navbar" type="button" data-widget="navbar-search">
<i class="fas fa-times"></i>
</button>
</div>
</div>
</form>
</div>
</li>
Options
{: .mt-4}
|---
Name | Type | Default | Description |
---|---|---|---|
resetOnClose | Boolean | false | Reset Input on Close/Hide. |
target | String | .navbar-search-block |
Target navbar-search-block to handle multiple navbar-search-blocks. |
{: .table .table-bordered .bg-light} |
Methods
{: .mt-4}
|---
Method | Description |
---|---|
toggle | Toggles the search block. |
close | Closes the search block. |
open | Opens the search block. |
{: .table .table-bordered .bg-light} |
Example: $('[data-widget="navbar-search"]').SiteSearch('toggle')