Socket
Socket
Sign inDemoInstall

@docsearch/js

Package Overview
Dependencies
Maintainers
3
Versions
40
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@docsearch/js

JavaScript package for DocSearch, the best search experience for docs.


Version published
Weekly downloads
126K
increased by7.56%
Maintainers
3
Weekly downloads
 
Created

Package description

What is @docsearch/js?

@docsearch/js is a JavaScript library that provides a powerful and customizable search experience for documentation websites. It leverages Algolia's search capabilities to deliver fast and relevant search results.

What are @docsearch/js's main functionalities?

Basic Search Implementation

This code initializes a basic search functionality using @docsearch/js. You need to provide your Algolia API key, index name, and the selector for the input element where users will type their search queries.

const { DocSearch } = require('@docsearch/js');

const search = new DocSearch({
  apiKey: 'your-api-key',
  indexName: 'your-index-name',
  inputSelector: '#search-input',
});

search.init();

Customizing Search Results

This code demonstrates how to customize the search results by transforming the items. In this example, the titles of the search results are converted to uppercase.

const { DocSearch } = require('@docsearch/js');

const search = new DocSearch({
  apiKey: 'your-api-key',
  indexName: 'your-index-name',
  inputSelector: '#search-input',
  transformItems: (items) => {
    return items.map(item => ({
      ...item,
      title: item.title.toUpperCase(),
    }));
  }
});

search.init();

Styling the Search Interface

This code shows how to style the search interface by providing custom templates for the search items. The `templates` option allows you to define HTML templates for the search results.

const { DocSearch } = require('@docsearch/js');

const search = new DocSearch({
  apiKey: 'your-api-key',
  indexName: 'your-index-name',
  inputSelector: '#search-input',
  container: '#search-container',
  templates: {
    item: '<div class="search-item">{{title}}</div>',
  }
});

search.init();

Other packages similar to @docsearch/js

Changelog

Source

3.3.4 (2023-04-26)

Bug Fixes

  • prevent calling onClose() when shiftKey, ctrlKey or metaKey is pressed (#1870) (b9a3899)
  • type of lvl0 (#1859) (8f48ebb)

Readme

Source

@docsearch/js

JavaScript package for DocSearch, the best search experience for docs.

Installation

yarn add @docsearch/js@3
# or
npm install @docsearch/js@3

Get started

If you don’t want to use a package manager, you can use a standalone endpoint:

<script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script>

To get started, you need a container for your DocSearch component to go in. If you don’t have one already, you can insert one into your markup:

<div id="docsearch"></div>

Then, insert DocSearch into it by calling the docsearch function and providing the container. It can be a CSS selector or an Element.

Make sure to provide a container (for example, a div), not an input. DocSearch generates a fully accessible search box for you.

import docsearch from '@docsearch/js';

import '@docsearch/css';

docsearch({
  container: '#docsearch',
  appId: 'YOUR_APP_ID',
  indexName: 'YOUR_INDEX_NAME',
  apiKey: 'YOUR_SEARCH_API_KEY',
});

Documentation

Read documentation →

FAQs

Package last updated on 26 Apr 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc