Skip to content

CSS 代码片段加载机制

当思源启动或相关设置更新时,前端会:

  1. 通过内部 API (/api/snippet/getSnippet) 获取所有已保存且标记为启用的 CSS 片段内容。
  2. 检查 CSS 片段的总开关 (window.siyuan.config.snippet.enabledCSS) 是否开启。
  3. 如果总开关开启且片段自身也启用,则将该段 CSS 代码动态地创建一个 <style> 标签(例如 <style id="snippetCSS{片段ID}">...</style>)。
  4. 将这个 <style> 标签插入到当前 HTML 文档的 <head> 元素中。

除了通过思源笔记的图形用户界面管理代码片段外,开发者还可以通过一组后端 API 来以编程方式获取、创建、更新和删除代码片段。这对于批量操作、自动化或与其他工具集成非常有用。

相关的 API 文档如下:

请注意,特别是 /api/snippet/setSnippet API 执行的是全量替换操作,使用时请务必仔细阅读其文档说明,以避免意外丢失数据。