AdminLTE/docs/javascript/navbar-search.md

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')