Tiptap 2.5.5版本输入规则失效问题分析与解决方案

在Tiptap富文本编辑器从2.5.4升级到2.5.5版本后，部分开发者报告了输入规则失效的问题。这个问题主要影响了列表相关的功能，特别是任务列表的输入规则。

问题现象

开发者发现，在2.5.5版本中，某些输入规则不再被触发。例如，用于创建任务列表项的输入规则：

wrappingInputRule({
  find: taskItemRegex,
  type: this.type,
  getAttributes: match => ({
    checked: match.at(-1)?.toLowerCase() === 'x',
  }),
})

在2.5.4版本中正常工作，但在2.5.5版本中不再生效。

问题根源

经过深入排查，发现问题源于一个与原子节点(atom nodes)相关的提交。虽然这些受影响的输入规则本身并不直接涉及原子节点，但该提交引入的变更意外影响了输入规则的匹配逻辑。

具体表现为：

• 在2.5.5版本中，输入规则匹配时获取的textBefore包含了不应包含的后续文本
• 在2.5.4版本中，textBefore仅包含光标前的相关文本

技术分析

输入规则是Tiptap中实现Markdown风格快捷输入的重要机制。它们通过监听用户输入，在特定文本模式匹配时自动转换为相应的节点或标记。

在这个案例中，问题出在文本匹配范围的确定上。2.5.5版本错误地将光标后的一些文本也包含在了匹配范围内，导致正则表达式无法正确匹配预期的模式。

解决方案

Tiptap团队在2.5.9版本中修复了这个问题。修复方案调整了文本范围确定的逻辑，确保：

1. 仅将光标前的相关文本包含在匹配范围内
2. 正确处理各种节点类型的边界情况

最佳实践

对于遇到类似问题的开发者，建议：

1. 首先检查输入规则的正则表达式是否严格限定了匹配范围
2. 确保使用的Tiptap版本是最新的稳定版
3. 对于复杂的输入规则，添加详细的测试用例覆盖各种边界情况

总结

这个案例展示了即使看似不相关的代码变更也可能产生意想不到的影响。Tiptap团队通过快速响应和修复，确保了编辑器的稳定性和向后兼容性。开发者在使用这类高级富文本编辑器时，应当关注版本更新日志，并在升级前进行充分的测试。