• @vuepress/plugin-search
    • 安装
    • 使用
    • 选项
      • searchMaxSuggestions
    • 技巧
      • 调整默认颜色

    @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