@vuepress/plugin-search

基于 Headers 的搜索插件

安装

  1. yarn add -D @vuepress/plugin-search@next
  2. # OR npm install -D @vuepress/plugin-search@next

提示

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

使用

  • 启用此插件:
  1. // .vuepress/config.js or themePath/index.js
  2. module.exports = {
  3. plugins: [
  4. ['@vuepress/search', {
  5. searchMaxSuggestions: 10
  6. }]
  7. ]
  8. }
  • 本插件将自动注入指向搜索组件的 webpack 别名 @SearchBox,以便您可以直接在 layout 组件中使用它:
  1. <template>
  2. <div class="foo-layout">
  3. <header>
  4. <SearchBox/>
  5. </header>
  6. <main>
  7. ...
  8. </main>
  9. </div>
  10. </template>
  11. <script>
  12. import SearchBox from '@SearchBox'
  13. export default {
  14. components: { SearchBox }
  15. }
  16. </script>

选项

searchMaxSuggestions

  • 类型: number
  • 默认值: 5设置搜索的最大结果数。

技巧

调整默认颜色

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

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