Cherry Markdown 新增目录展开/收起API功能解析

Cherry Markdown作为一款功能强大的Markdown编辑器，近期新增了控制目录(TOC)展开与收起的API功能，为开发者提供了更灵活的交互控制能力。本文将深入解析这一新特性的技术实现和使用方法。

目录控制功能背景

在文档编辑场景中，目录(TOC)功能对于长文档导航至关重要。Cherry Markdown原有的目录功能虽然完善，但缺乏程序化控制接口，开发者无法通过代码动态控制目录的展开与收起状态。

新增API详解

Cherry Markdown最新版本提供了三种调用方式：

1. 状态切换：cherryObj.toggleToc()

   • 无参数调用，在"full"(全屏)和"pure"(极简)两种状态间切换

2. 强制全屏模式：cherryObj.toggleToc('full')

   • 将目录强制设置为全屏展开状态

3. 强制极简模式：cherryObj.toggleToc('pure')

   • 将目录强制设置为收起状态

技术实现原理

该API底层实际上调用了两个核心方法：

• $switchModel()：即时切换目录视图状态
• setModelToLocalStorage()：持久化存储用户偏好设置

这种设计既保证了即时响应的用户体验，又能在页面刷新后保持用户之前的设置。

使用场景建议

1. 响应式布局：可根据屏幕尺寸自动调整目录状态
2. 自定义工具栏：为开发者提供更多交互可能性
3. 文档演示模式：全屏展示时可自动收起目录

兼容性说明

该API在Cherry Markdown的最新稳定版中可用，建议开发者查阅项目的API文档获取最新信息。对于需要深度定制的场景，开发者仍可直接操作底层方法，但需注意未来版本可能的变化。

这一功能的加入使得Cherry Markdown的目录交互更加灵活，为开发者构建更丰富的文档编辑体验提供了有力支持。