# vuepress-plugin-table-of-contents

为你的 VuePress 站点增加目录组件。

# 安装

npm install -D vuepress-plugin-table-of-contents

# 使用

// .vuepress/config.js
module.exports = {
  plugins: ['vuepress-plugin-table-of-contents'],
}

该组件会为你注册一个 <TOC /> 组件,该组件展示你当前页面文章的目录,你可以在 Markdown 文件和 Vue 文件中使用它。

<!-- README.md / Component.vue -->
<TOC />

# 配置项

# componentName

  • 类型: string
  • 默认值: 'TOC'

组件的名称。

# 组件 Props

# includeLevel

  • 类型: [number, number]
  • 默认值: [2, 3]

<TOC /> 组件包含的标题范围。

例如,[2, 4] 代表 2 <= x <= 4 。

# 演示

输入

<TOC />

输出

输入

<TOC :include-level="[2, 2]" />

输出

# 与 VuePress markdown 目录语法的区别

你可能注意到 VuePress 也提供了一种 markdown 语法 [[toc]] 来生成目录。

但是, [[toc]] 只是 markdown 语法,所以只能用于 .md 文件。而 <TOC /> 是 Vue 组件,所以可以用于 .md 文件和 .vue 文件。

因此,当你需要在页面的其他部分使用目录时, <TOC /> 可以满足你的需要(例如:在你自己的主题中使用目录组件)