@noction/vue-use-flexsearch

useFlexSearch

Wrapper for Flexsearch.

Install

pnpm add flexsearch @noction/vue-use-flexsearch

API

// eslint-disable-next-line unused-imports/no-unused-vars
function useFlexSearch<T extends Record<'id', Id>, D = unknown>(
  query: Ref<string>,
  providedIndex: Ref<Index | Document<D> | null>,
  store?: Ref<Array<T>>,
  searchOptions: SearchOptions = {},
  limit = 10,
): { results: ComputedRef<T[]> }

By utilizing the useFlexSearch composable, you can provide your search query, index, and store as inputs, and obtain the results as an array. This optimizes searches by memoizing them, ensuring efficient searching.

Parameters

Usage

This code snippet creates a text input field and utilizes FlexSearch to execute a search on the index when the query is changed.

<script setup>
import { useFlexSearch } from '@noction/vue-use-flexsearch'
import { Index } from 'flexsearch'
import { ref, shallowRef } from 'vue'

const store = ref([
  { id: 1, title: 'The Jungle Book' },
  { id: 2, title: 'Dracula' },
  { id: 3, title: 'Shōgun' },
])

const index = shallowRef(new Index({ preset: 'match' }))

store.value.forEach(item => index.value.add(item.id, item.title))

const query = ref('')
const { results } = useFlexSearch(query, index, store)
</script>

<template>
  <div>
    <input v-model="query">
    <h1>Results</h1>
    <ul>
      <li v-for="result in results" :key="result.id" v-text="result.title" />
    </ul>
  </div>
</template>