文章自动生成目录及侧边栏目录滚动特效的插件toc-helper(v2)

toc-helper是一款用于文章自动生成目录的插件,v2版本简化了用法,提升了性能,并增加了目录自动展开、折叠等功能。支持浏览器直接引入和npm安装,提供API和配置项,方便开发者自定义设置。
摘要由CSDN通过智能技术生成

toc-helper

toc-helper 是一款给文章自动生成目录的插件

v1 入口
v2 在线预览 Demo

一、 v2 特性

  • 用法精简,减少了大量的配置,去除不必要的API,仅需要引入一个js文件
  • 性能优化,联动滚动更加流畅,自动停靠顶部更加精准
  • 目录支持自动展开、折叠
  • 自动定位,初始目录高亮位置自动识别
  • 支持显示、隐藏、自适应宽度变化
  • 支持非标题标签, 但需要提供 data-level 属性
  • 支持局部滚动(非body, 内容div滚动)
  • 支持 React、Vue、Svelte

二、 使用

浏览器

  1. 引入JS
<script src="lib/umd/index.js"></script>

esmodule 引入 lib/es/index.js

  1. 使用
new TocHelper(el [, options])

npm方式

1. 安装

npm install toc-helper --save 
# 或者
yarn add toc-helper

2. 使用

2.1 require
const TocHelper = require('toc-helper')
new TocHelper(el [, options])
2.2 import
import TocHelper from 'toc-helper'
new TocHelper(el [, options])
2.3 React 示例
2.3.1 普通模式
import TocHelper from 'toc-helper'
class App extends React.PureComponent{
   
  constructor(props){
   
    super(props)
    this.ref = null
  }
  componentDidMount
在 Vue 中使用 Markdown 渲染文档时,如果文档内容比较长,我们需要为用户提供侧边栏目录导航,方便用户快速定位到所需部分。下面是一个简单的方法来实现自动生成 Markdown 文档的侧边栏目录。 首先,我们需要安装 `markdown-it` 和 `markdown-it-toc`: ```bash npm install markdown-it markdown-it-toc --save ``` 然后,在 Vue 组件中引入并使用它们: ```javascript <template> <div> <!-- 目录导航 --> <div v-html="toc"></div> <!-- Markdown 内容 --> <div v-html="html"></div> </div> </template> <script> import MarkdownIt from 'markdown-it' import MarkdownItToc from 'markdown-it-toc' export default { data() { return { markdown: '# 一级标题\n\n## 二级标题\n\n### 三级标题', toc: '', // 目录导航 html: '', // 渲染后的 HTML } }, mounted() { // 解析 Markdown 文档 const md = new MarkdownIt() md.use(MarkdownItToc, { tocFirstLevel: 1 }) const result = md.render(this.markdown) // 生成目录导航 this.toc = md.toc // 渲染 Markdown 内容 this.html = result }, } </script> ``` 在上面的代码中,我们使用了 `markdown-it-toc` 插件自动生成目录导航,并将导航内容存储在 `toc` 变量中。然后,我们使用 `v-html` 指令将导航和 Markdown 文档内容渲染到页面上。 注意,`markdown-it-toc` 插件需要在解析 Markdown 文档之前使用 `md.use(MarkdownItToc)` 方法来注册。在注册时,我们可以设置 `tocFirstLevel` 属性来指定目录导航的起始层级,默认为 `1`。 最后,我们需要使用 CSS 样式来美化目录导航和 Markdown 内容,以便更好地展示给用户。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值