@vuepress/plugin-search (opens new window)

基于 Headers 的搜索插件

安装

yarn add -D @vuepress/plugin-search
# OR npm install -D @vuepress/plugin-search

TIP

请注意，此插件已包含在默认主题中，你现在看到的搜索便是由本插件提供支持。

使用

启用此插件：

// .vuepress/config.js or themePath/index.js
module.exports = {
  plugins: [
    ['@vuepress/search', {
      searchMaxSuggestions: 10
    }]
  ]
}

本插件将自动注入指向搜索组件的 webpack 别名 @SearchBox，以便您可以直接在 layout 组件中使用它：

<template>
  <div class="foo-layout">
    <header>
      <SearchBox/>
    </header>
    <main>
      ...
    </main>
  </div>
</template>

<script>
import SearchBox from '@SearchBox'

export default {
  components: { SearchBox }
}
</script>

选项

searchMaxSuggestions

类型: number
默认值: 5

设置搜索的最大结果数。

技巧

调整默认颜色

由于该搜索组件使用了内置调色板，你可以通过 styles/palette.styl 来调整搜索框的默认颜色：

// 你现在看到的这个搜索栏的颜色：
$accentColor = #3eaf7c
$textColor = #2c3e50
$borderColor = #eaecef
$codeBgColor = #282c34
$arrowBgColor = #ccc

← register-components