命令：Commands

当编辑富文本的时候，用户可能会插入文本，删除文本，分隔段落，添加格式等等。这些编辑行为都可以用两个概念来说明：命令和操作。

命令（Commands）是代表用户特定意图的高级操作。它们是 Editor 接口的辅助函数。辅助函数包含了一些富文本常用的核心行为，但是建议你编写针对自己特定模型的命令。

比如，下面这些是内置命令：

  1. Editor.insertText(editor, 'A new string of text to be inserted.')
  3. Editor.deleteBackward(editor, { unit: 'word' })
  5. Editor.insertBreak(editor)

但是你可以（一定会）定义自己的自定义命令。比如，你可能会根据允许的内容类型定义 formatQuote 命令， insertImage 命令，或者是 toggleBold 命令。

命令总是描述将要进行的操作，就好像是用户自己在执行一样。由于这个原因，它们从不需要定义执行命令的位置（location），因为它们总是对当前的选择范围执行操作。

🤖 命令的概念基本上来自于 DOM 内检的 execCommand API。然而 Slate 定义了自己的简单（并且可扩展）的API ，因为 DOM 版本的API 表现过于不一致（opinionated and inconsistent.）。

因此，Slate 将每一个命令转换为一系列的低级操作（operations），这些操作用来产生一个新的值。这就是协同编辑可以实现的原因。同时你不用担心这些问题，因为它是自动完成的。

自定义命令

在编写自定义命令时，你可以创建自己的命名空间：

  1. const MyEditor = {
  2.   ...Editor,
  4.   insertParagraph(editor) {
  5.     // ...
  6.   },
  7. }

你通常会使用 Slate 的 Transforms 来编写自定义命令。

转换：Transforms

转换（Transforms）是一个特殊的辅助函数，它允许你对文档执行各种特定的更改，比如：

  1. // 对选中的所有文本节点设置粗体。
  2. Transforms.setNodes(
  3.   editor,
  4.   { bold: true },
  5.   {
  6.     at: range,
  7.     match: node => Text.isText(node),
  8.     split: true,
  9.   }
  10. )
  12. // 把光标所在的最后一个块转换为引用块。
  13. Transforms.wrapNodes(
  14.   editor,
  15.   { type: 'quote', children: [] },
  16.   {
  17.     at: point,
  18.     match: node => Editor.isBlock(editor, node),
  19.     mode: 'lowest',
  20.   }
  21. )
  23. // 在指定路径（path）处插入一个新的文本用来替代原来的文本。
  24. Transforms.insertText(editor, 'A new string of text.', { at: path })
  26. // ...还有省略的其他变换操作！

转换辅助函数被设计为一个集合。所以你可能在每个命令中都会使用到它的一部分。