Slate 接口体系详解基于纯 JSON 的可定制富文本编辑器数据模型【免费下载链接】slateA completely customizable framework for building rich text editors. (Currently in beta.)项目地址: https://gitcode.com/gh_mirrors/sl/slate导读Slate 是当前仓库gh_mirrors/sl/slate中维护的一个完全可定制的富文本编辑器框架当前处于 beta 阶段。它最核心的设计哲学是不要求你使用任何框架自带的模型类而是直接操作纯 JSON 对象。本文以官方概念文档 docs/concepts/01-interfaces.md 为骨架结合packages/slate/src/interfaces/下的源码实现系统讲解 Slate 的接口体系——包括Text、Element、Node、LocationPath/Point/Range等核心接口的结构、内置辅助函数以及如何通过自定义属性和自定义 Helpers 将数据模型塑造成你自己的业务形态。读完本文你将掌握 Slate 数据模型的最小合法结构、扩展自定义字段的方法以及利用辅助函数简化文档树操作的全部常用姿势。一切皆 JSON接口而非类大多数富文本编辑器会强迫你使用它们预先定义好的、手写的模型类model class这给数据引入、序列化、跨端复用都带来了额外的摩擦。Slate 走的是完全相反的路它只与纯 JSON 对象打交道唯一的要求是这些对象必须符合 Slate 定义的若干接口interfaces。例如Slate 中的一个文本节点必须符合Text接口interface Text { text: string }这意味着一个文本节点必须有一个text属性其值为字符串内容const textNode { text: Hello, Slate!, }除了这个最小要求之外任何其他自定义属性都是允许的且完全由你决定。这让你可以针对自己的具体领域和用例来定制数据自由添加任何想要的格式化逻辑而 Slate 不会横加干涉。从源码看Text接口的真实定义位于 packages/slate/src/interfaces/text.tsexport interface BaseText { text: string } export type Text ExtendedTypeText, BaseText注意这里的ExtendedTypeText, BaseText写法它来自 packages/slate/src/types/custom-types.ts作用是如果用户没有通过 TypeScript 模块声明扩展Text类型就用默认的BaseText如果扩展了就使用用户自定义的类型。这是 Slate 支持接口可扩展这一理念在类型层面的落地后面TypeScript 自定义类型部分会进一步展开。这种接口驱动的方式将 Slate 与大多数要求你操作手写模型类的编辑器区分开来让数据模型更容易被理解同时因为 Slate 从不初始化你的数据模型也避免了启动阶段的性能开销——你的 JSON 数据是什么Slate 就直接用什么。核心接口全览从 Node 到 LocationText只是 Slate 接口体系的一角。Slate 定义了约十余个接口全部从入口统一导出见 packages/slate/src/interfaces/index.tsexport * from ./editor export * from ./element export * from ./location export * from ./node export * from ./operation export * from ./path-ref export * from ./path export * from ./point-ref export * from ./point export * from ./range-ref export * from ./range export * from ./scrubber export * from ./text export * from ./transforms/indexNode文档树的联合类型Node是一个联合类型代表 Slate 文档树中可能出现的一切节点。见 packages/slate/src/interfaces/node.tsexport type Node Editor | Element | Text同时源码还提供了两个常用窄化类型Descendant Element | Text树中的后代节点不含根EditorAncestor Editor | Element树中的祖先节点不含叶子Text。以及遍历文档树时最常遇到的NodeEntry类型——一个[Node, Path]二元组表示某个节点 它在文档中的路径export type NodeEntryT extends Node Node [T, Path]Element唯一强制属性是 childrenElement节点的接口极其宽松见 packages/slate/src/interfaces/element.tsexport interface BaseElement { children: Descendant[] } export type Element ExtendedTypeElement, BaseElement它唯一的要求就是必须定义children属性其中包含该元素的所有子节点子元素或文本节点。Element是 Slate 文档树中承载结构的关键无论是块级block还是行内inline元素都由编辑器配置决定接口本身并不强制。LocationPath / Point / Range 三种定位方式Location是一个联合类型涵盖三种引用文档位置的方式见 packages/slate/src/interfaces/location.tsexport type Location Path | Point | RangePath路径number[]一列索引精确描述节点在树中的位置。例如[0, 1]表示根节点的第 0 个孩子的第 1 个孩子。见 packages/slate/src/interfaces/path.ts 顶部注释路径通常相对于根Editor对象但也可以相对任意Node对象。Point点{ path: Path; offset: number }path指向文本节点的位置offset表示深入该节点文本字符串的偏移量。Point 只能指向Text节点。见 packages/slate/src/interfaces/point.ts。Range范围{ anchor: Point; focus: Point }由两个 Point 组成表示文档中的一个区间——既可以只覆盖单个节点内部也可以横跨多个节点。见 packages/slate/src/interfaces/range.ts。Location接口还提供了isLocation、isPath、isPoint、isRange、isSpan等类型守卫。许多 API 会直接接受Location而非强制要求某一种具体类型这样开发者就不必在自己的代码里手动做类型转换。接口族谱小结除上述之外Slate 还定义了Editor根节点 方法集合、Operation描述文档变更的原子操作、PathRef/PointRef/RangeRef可随操作自动更新的引用、Scrubber日志脱敏等接口。完整清单以 packages/slate/src/interfaces/index.ts 的导出为准后续概念文档如 docs/concepts/02-nodes.md、docs/concepts/03-locations.md、docs/concepts/05-operations.md会逐一深入。自定义属性让数据模型为你的领域服务接口的宽松正是 Slate 可定制性的根基。以Element为例你可以为元素或其他任何接口扩展与业务领域强相关的自定义属性。比如你可能会有段落paragraph和链接link两种元素const paragraph { type: paragraph, children: [...], } const link { type: link, url: https://example.com, children: [...] }这里的type和url就是你自己的自定义 API。Slate 知道它们存在但不会去使用它们——Slate 只关心children是否存在以及树的结构是否合法。当渲染链接元素时你会收到一个携带这些自定义属性的对象从而可以把它渲染成真实链接a href{element.url}{element.children}/a这种设计让type这类约定俗成的字段既可以在你的代码里自由发挥区分段落、引用、图片、表格等又不会污染 Slate 核心的逻辑。测试目录中也能看到这种模式被大量使用例如 packages/slate/test/interfaces/Element/isElement/ 下的用例就是围绕{ children: [...] }加任意自定义字段的 JSON 结构来验证类型守卫行为的。辅助函数每个接口都自带一组工具方法除了类型信息Slate 的每一个接口都附带一系列辅助函数helper functions让这些纯 JSON 对象用起来毫不费力。这一点在源码中体现为接口类型 同名常量对象成对出现例如Node既是类型也是对象见 packages/slate/src/interfaces/node.ts 中export const Node: NodeInterface { ... }。Node 的常用辅助函数官方文档给出两个典型例子import { Node } from slate // 获取元素节点的字符串内容。 const string Node.string(element) // 获取根节点中某个路径指向的节点。 const descendant Node.get(value, path)结合 packages/slate/src/interfaces/node.ts 的源码实现可以看到它们背后还有一套完整的工具集按功能可分为几类读取与定位Node.get(root, path)路径取节点找不到会抛错、Node.getIf(root, path)找不到返回undefined、Node.has(root, path)判断路径是否存在、Node.child/Node.parent/Node.ancestor/Node.descendant/Node.leaf、Node.first/Node.last取某个分支的第一个/最后一个叶子节点。遍历Node.nodes深度优先遍历整棵树产出[node, path]条目、Node.ancestors/Node.descendants/Node.children/Node.levels/Node.texts/Node.elements这些生成器大多支持reverse、from/to、pass等选项来控制遍历顺序与跳过条件。判断与匹配Node.isText/Node.isElement/Node.isEditor/Node.isAncestor/Node.isNode/Node.isNodeList以及Node.matches(node, props)按属性子集匹配节点。内容提取Node.string(node)拼接节点内容为字符串、Node.texts产出全部文本节点、Node.fragment(root, range)按范围切出一段文档片段。其中Node.string的实现同文件第 643-649 行非常直观string(node: Node): string { if (Node.isText(node)) { return node.text } else { return node.children.map(Node.string).join() } }即文本节点直接返回text元素节点递归拼接所有子节点的字符串。Range 的常用辅助函数处理选区selection时Range的辅助函数同样强大import { Range } from slate // 按文档顺序获取范围的起点和终点。 const [start, end] Range.edges(range) // 判断范围是否折叠为单个点即光标未选中任何内容。 if (Range.isCollapsed(range)) { // ... }从 packages/slate/src/interfaces/range.ts 的实现可以看到Range.edges会根据isBackward的结果把anchor/focus排成正确的先后顺序Range.isCollapsed则直接比较anchor与focus两个 Point 是否相等。此外还有Range.start/Range.end、Range.isBackward/Range.isForward/Range.isExpanded、Range.includes判断是否包含某个 Path/Point/Range、Range.intersection求交集、Range.transform让选区跟随一次操作自动更新等。其他接口的辅助函数也遵循同样的模式Text提供Text.isText、Text.equals、Text.matches、Text.decorations按装饰区间把文本切成叶子Element提供Element.isElement、Element.isElementList、Element.matches、Element.isElementType默认检查type键的取值也可指定其他键Path提供Path.compare、Path.isBefore/Path.isAfter、Path.isAncestor/Path.isChild、Path.parent、Path.transform等Point提供Point.compare、Point.isBefore/Point.isAfter、Point.transform等。对于所有常见用例Slate 都准备了相应的辅助函数。入门阶段通读一遍这些函数非常值得——很多复杂的逻辑往往可以压缩成寥寥几行代码。自定义辅助函数把领域逻辑收纳进自己的命名空间除了内置辅助函数你几乎总是需要定义自己的辅助函数并把它们挂到自定义的命名空间上复用。例如如果你的编辑器支持图片你可能会需要一个判断某元素是否为图片元素的辅助函数const isImageElement element { return element.type image typeof element.url string }这种一次性函数定义起来很简单。但你也可以像核心接口那样把它们打包进一个命名空间统一使用import { Element } from slate // 你可以在任何地方使用 MyElement 来获得你的扩展能力。 export const MyElement { ...Element, isImageElement, isParagraphElement, isQuoteElement, }这样领域相关的逻辑就可以与 Slate 内置的辅助函数一起被轻松复用——判断类型、匹配属性、遍历子树等核心能力照旧图片/段落/引用的专有判断则随取随用。从类型层面看这种扩展与 Slate 的ExtendedType机制相辅相成内置接口的默认类型定义在 packages/slate/src/interfaces/ 各文件中而 packages/slate/src/types/custom-types.ts 则开放了Editor、Element、Text、Selection、Range、Point、Operation等键位允许你通过 TypeScript 的模块声明declaration merging为这些接口注入自定义字段让自定义属性在编译期就获得完整的类型推导。详细的 TypeScript 扩展姿势见官方指南 docs/concepts/12-typescript.md。实战把接口体系串起来把上面的内容串成一个最小可用的例子。假设你要构建一个支持段落与链接的编辑器你的初始文档一个Editor节点本质上是带children和一堆方法的对象可以这样组织数据import { Node, Range } from slate const value [ { type: paragraph, children: [ { text: 访问 }, { type: link, url: https://example.com, children: [{ text: 示例站点 }] }, { text: 了解更多。 }, ], }, ] // 读取整篇文档的纯文本内容 const plain Node.string({ children: value }) // 选中第二段文本的起始位置path 为 [0, 1] 的文本节点offset 为 0 const selection { anchor: { path: [0, 1], offset: 0 }, focus: { path: [0, 1], offset: 4 }, } if (!Range.isCollapsed(selection)) { const [start, end] Range.edges(selection) // 处理选中区间 ... }整个过程没有实例化任何编辑器内部类文档是普通对象选区是普通对象读取和判断全靠接口自带的辅助函数。这正是 Slate接口驱动、JSON 优先设计理念的直观体现——也是它与传统模型类编辑器最根本的区别。进一步阅读概念文档节点结构见 docs/concepts/02-nodes.md位置与选区见 docs/concepts/03-locations.md操作模型见 docs/concepts/05-operations.mdTypeScript 类型扩展见 docs/concepts/12-typescript.md。API 参考每个接口的辅助函数完整签名与说明位于 docs/api/ 下对应的nodes/、locations/、operations/等目录例如 docs/api/nodes/node.md、docs/api/locations/range.md。源码所有接口的类型与实现集中在 packages/slate/src/interfaces/对应的行为测试分散在 packages/slate/test/interfaces/ 下按Node/、Element/、Path/、Point/、Range/、Text/等子目录组织是理解每个辅助函数边界行为的最佳参考。【免费下载链接】slateA completely customizable framework for building rich text editors. (Currently in beta.)项目地址: https://gitcode.com/gh_mirrors/sl/slate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Slate 接口体系详解：基于纯 JSON 的可定制富文本编辑器数据模型
Slate 接口体系详解基于纯 JSON 的可定制富文本编辑器数据模型【免费下载链接】slateA completely customizable framework for building rich text editors. (Currently in beta.)项目地址: https://gitcode.com/gh_mirrors/sl/slate导读Slate 是当前仓库gh_mirrors/sl/slate中维护的一个完全可定制的富文本编辑器框架当前处于 beta 阶段。它最核心的设计哲学是不要求你使用任何框架自带的模型类而是直接操作纯 JSON 对象。本文以官方概念文档 docs/concepts/01-interfaces.md 为骨架结合packages/slate/src/interfaces/下的源码实现系统讲解 Slate 的接口体系——包括Text、Element、Node、LocationPath/Point/Range等核心接口的结构、内置辅助函数以及如何通过自定义属性和自定义 Helpers 将数据模型塑造成你自己的业务形态。读完本文你将掌握 Slate 数据模型的最小合法结构、扩展自定义字段的方法以及利用辅助函数简化文档树操作的全部常用姿势。一切皆 JSON接口而非类大多数富文本编辑器会强迫你使用它们预先定义好的、手写的模型类model class这给数据引入、序列化、跨端复用都带来了额外的摩擦。Slate 走的是完全相反的路它只与纯 JSON 对象打交道唯一的要求是这些对象必须符合 Slate 定义的若干接口interfaces。例如Slate 中的一个文本节点必须符合Text接口interface Text { text: string }这意味着一个文本节点必须有一个text属性其值为字符串内容const textNode { text: Hello, Slate!, }除了这个最小要求之外任何其他自定义属性都是允许的且完全由你决定。这让你可以针对自己的具体领域和用例来定制数据自由添加任何想要的格式化逻辑而 Slate 不会横加干涉。从源码看Text接口的真实定义位于 packages/slate/src/interfaces/text.tsexport interface BaseText { text: string } export type Text ExtendedTypeText, BaseText注意这里的ExtendedTypeText, BaseText写法它来自 packages/slate/src/types/custom-types.ts作用是如果用户没有通过 TypeScript 模块声明扩展Text类型就用默认的BaseText如果扩展了就使用用户自定义的类型。这是 Slate 支持接口可扩展这一理念在类型层面的落地后面TypeScript 自定义类型部分会进一步展开。这种接口驱动的方式将 Slate 与大多数要求你操作手写模型类的编辑器区分开来让数据模型更容易被理解同时因为 Slate 从不初始化你的数据模型也避免了启动阶段的性能开销——你的 JSON 数据是什么Slate 就直接用什么。核心接口全览从 Node 到 LocationText只是 Slate 接口体系的一角。Slate 定义了约十余个接口全部从入口统一导出见 packages/slate/src/interfaces/index.tsexport * from ./editor export * from ./element export * from ./location export * from ./node export * from ./operation export * from ./path-ref export * from ./path export * from ./point-ref export * from ./point export * from ./range-ref export * from ./range export * from ./scrubber export * from ./text export * from ./transforms/indexNode文档树的联合类型Node是一个联合类型代表 Slate 文档树中可能出现的一切节点。见 packages/slate/src/interfaces/node.tsexport type Node Editor | Element | Text同时源码还提供了两个常用窄化类型Descendant Element | Text树中的后代节点不含根EditorAncestor Editor | Element树中的祖先节点不含叶子Text。以及遍历文档树时最常遇到的NodeEntry类型——一个[Node, Path]二元组表示某个节点 它在文档中的路径export type NodeEntryT extends Node Node [T, Path]Element唯一强制属性是 childrenElement节点的接口极其宽松见 packages/slate/src/interfaces/element.tsexport interface BaseElement { children: Descendant[] } export type Element ExtendedTypeElement, BaseElement它唯一的要求就是必须定义children属性其中包含该元素的所有子节点子元素或文本节点。Element是 Slate 文档树中承载结构的关键无论是块级block还是行内inline元素都由编辑器配置决定接口本身并不强制。LocationPath / Point / Range 三种定位方式Location是一个联合类型涵盖三种引用文档位置的方式见 packages/slate/src/interfaces/location.tsexport type Location Path | Point | RangePath路径number[]一列索引精确描述节点在树中的位置。例如[0, 1]表示根节点的第 0 个孩子的第 1 个孩子。见 packages/slate/src/interfaces/path.ts 顶部注释路径通常相对于根Editor对象但也可以相对任意Node对象。Point点{ path: Path; offset: number }path指向文本节点的位置offset表示深入该节点文本字符串的偏移量。Point 只能指向Text节点。见 packages/slate/src/interfaces/point.ts。Range范围{ anchor: Point; focus: Point }由两个 Point 组成表示文档中的一个区间——既可以只覆盖单个节点内部也可以横跨多个节点。见 packages/slate/src/interfaces/range.ts。Location接口还提供了isLocation、isPath、isPoint、isRange、isSpan等类型守卫。许多 API 会直接接受Location而非强制要求某一种具体类型这样开发者就不必在自己的代码里手动做类型转换。接口族谱小结除上述之外Slate 还定义了Editor根节点 方法集合、Operation描述文档变更的原子操作、PathRef/PointRef/RangeRef可随操作自动更新的引用、Scrubber日志脱敏等接口。完整清单以 packages/slate/src/interfaces/index.ts 的导出为准后续概念文档如 docs/concepts/02-nodes.md、docs/concepts/03-locations.md、docs/concepts/05-operations.md会逐一深入。自定义属性让数据模型为你的领域服务接口的宽松正是 Slate 可定制性的根基。以Element为例你可以为元素或其他任何接口扩展与业务领域强相关的自定义属性。比如你可能会有段落paragraph和链接link两种元素const paragraph { type: paragraph, children: [...], } const link { type: link, url: https://example.com, children: [...] }这里的type和url就是你自己的自定义 API。Slate 知道它们存在但不会去使用它们——Slate 只关心children是否存在以及树的结构是否合法。当渲染链接元素时你会收到一个携带这些自定义属性的对象从而可以把它渲染成真实链接a href{element.url}{element.children}/a这种设计让type这类约定俗成的字段既可以在你的代码里自由发挥区分段落、引用、图片、表格等又不会污染 Slate 核心的逻辑。测试目录中也能看到这种模式被大量使用例如 packages/slate/test/interfaces/Element/isElement/ 下的用例就是围绕{ children: [...] }加任意自定义字段的 JSON 结构来验证类型守卫行为的。辅助函数每个接口都自带一组工具方法除了类型信息Slate 的每一个接口都附带一系列辅助函数helper functions让这些纯 JSON 对象用起来毫不费力。这一点在源码中体现为接口类型 同名常量对象成对出现例如Node既是类型也是对象见 packages/slate/src/interfaces/node.ts 中export const Node: NodeInterface { ... }。Node 的常用辅助函数官方文档给出两个典型例子import { Node } from slate // 获取元素节点的字符串内容。 const string Node.string(element) // 获取根节点中某个路径指向的节点。 const descendant Node.get(value, path)结合 packages/slate/src/interfaces/node.ts 的源码实现可以看到它们背后还有一套完整的工具集按功能可分为几类读取与定位Node.get(root, path)路径取节点找不到会抛错、Node.getIf(root, path)找不到返回undefined、Node.has(root, path)判断路径是否存在、Node.child/Node.parent/Node.ancestor/Node.descendant/Node.leaf、Node.first/Node.last取某个分支的第一个/最后一个叶子节点。遍历Node.nodes深度优先遍历整棵树产出[node, path]条目、Node.ancestors/Node.descendants/Node.children/Node.levels/Node.texts/Node.elements这些生成器大多支持reverse、from/to、pass等选项来控制遍历顺序与跳过条件。判断与匹配Node.isText/Node.isElement/Node.isEditor/Node.isAncestor/Node.isNode/Node.isNodeList以及Node.matches(node, props)按属性子集匹配节点。内容提取Node.string(node)拼接节点内容为字符串、Node.texts产出全部文本节点、Node.fragment(root, range)按范围切出一段文档片段。其中Node.string的实现同文件第 643-649 行非常直观string(node: Node): string { if (Node.isText(node)) { return node.text } else { return node.children.map(Node.string).join() } }即文本节点直接返回text元素节点递归拼接所有子节点的字符串。Range 的常用辅助函数处理选区selection时Range的辅助函数同样强大import { Range } from slate // 按文档顺序获取范围的起点和终点。 const [start, end] Range.edges(range) // 判断范围是否折叠为单个点即光标未选中任何内容。 if (Range.isCollapsed(range)) { // ... }从 packages/slate/src/interfaces/range.ts 的实现可以看到Range.edges会根据isBackward的结果把anchor/focus排成正确的先后顺序Range.isCollapsed则直接比较anchor与focus两个 Point 是否相等。此外还有Range.start/Range.end、Range.isBackward/Range.isForward/Range.isExpanded、Range.includes判断是否包含某个 Path/Point/Range、Range.intersection求交集、Range.transform让选区跟随一次操作自动更新等。其他接口的辅助函数也遵循同样的模式Text提供Text.isText、Text.equals、Text.matches、Text.decorations按装饰区间把文本切成叶子Element提供Element.isElement、Element.isElementList、Element.matches、Element.isElementType默认检查type键的取值也可指定其他键Path提供Path.compare、Path.isBefore/Path.isAfter、Path.isAncestor/Path.isChild、Path.parent、Path.transform等Point提供Point.compare、Point.isBefore/Point.isAfter、Point.transform等。对于所有常见用例Slate 都准备了相应的辅助函数。入门阶段通读一遍这些函数非常值得——很多复杂的逻辑往往可以压缩成寥寥几行代码。自定义辅助函数把领域逻辑收纳进自己的命名空间除了内置辅助函数你几乎总是需要定义自己的辅助函数并把它们挂到自定义的命名空间上复用。例如如果你的编辑器支持图片你可能会需要一个判断某元素是否为图片元素的辅助函数const isImageElement element { return element.type image typeof element.url string }这种一次性函数定义起来很简单。但你也可以像核心接口那样把它们打包进一个命名空间统一使用import { Element } from slate // 你可以在任何地方使用 MyElement 来获得你的扩展能力。 export const MyElement { ...Element, isImageElement, isParagraphElement, isQuoteElement, }这样领域相关的逻辑就可以与 Slate 内置的辅助函数一起被轻松复用——判断类型、匹配属性、遍历子树等核心能力照旧图片/段落/引用的专有判断则随取随用。从类型层面看这种扩展与 Slate 的ExtendedType机制相辅相成内置接口的默认类型定义在 packages/slate/src/interfaces/ 各文件中而 packages/slate/src/types/custom-types.ts 则开放了Editor、Element、Text、Selection、Range、Point、Operation等键位允许你通过 TypeScript 的模块声明declaration merging为这些接口注入自定义字段让自定义属性在编译期就获得完整的类型推导。详细的 TypeScript 扩展姿势见官方指南 docs/concepts/12-typescript.md。实战把接口体系串起来把上面的内容串成一个最小可用的例子。假设你要构建一个支持段落与链接的编辑器你的初始文档一个Editor节点本质上是带children和一堆方法的对象可以这样组织数据import { Node, Range } from slate const value [ { type: paragraph, children: [ { text: 访问 }, { type: link, url: https://example.com, children: [{ text: 示例站点 }] }, { text: 了解更多。 }, ], }, ] // 读取整篇文档的纯文本内容 const plain Node.string({ children: value }) // 选中第二段文本的起始位置path 为 [0, 1] 的文本节点offset 为 0 const selection { anchor: { path: [0, 1], offset: 0 }, focus: { path: [0, 1], offset: 4 }, } if (!Range.isCollapsed(selection)) { const [start, end] Range.edges(selection) // 处理选中区间 ... }整个过程没有实例化任何编辑器内部类文档是普通对象选区是普通对象读取和判断全靠接口自带的辅助函数。这正是 Slate接口驱动、JSON 优先设计理念的直观体现——也是它与传统模型类编辑器最根本的区别。进一步阅读概念文档节点结构见 docs/concepts/02-nodes.md位置与选区见 docs/concepts/03-locations.md操作模型见 docs/concepts/05-operations.mdTypeScript 类型扩展见 docs/concepts/12-typescript.md。API 参考每个接口的辅助函数完整签名与说明位于 docs/api/ 下对应的nodes/、locations/、operations/等目录例如 docs/api/nodes/node.md、docs/api/locations/range.md。源码所有接口的类型与实现集中在 packages/slate/src/interfaces/对应的行为测试分散在 packages/slate/test/interfaces/ 下按Node/、Element/、Path/、Point/、Range/、Text/等子目录组织是理解每个辅助函数边界行为的最佳参考。【免费下载链接】slateA completely customizable framework for building rich text editors. (Currently in beta.)项目地址: https://gitcode.com/gh_mirrors/sl/slate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考