Tiptap富文本编辑器在移动端日语输入法下的格式重置问题解析

问题背景

在Tiptap富文本编辑器2.8.0版本中，开发者发现了一个影响移动端用户体验的重要问题：当用户在iOS设备上使用日语输入法(IME)时，预先设置的文本格式（如加粗、高亮等）会在确认输入后被意外重置。该问题在Safari和Chrome浏览器上均可复现，但在Android设备上表现正常。

技术分析

现象特征

1. 触发条件：仅当编辑器内容为空且已应用格式样式时
2. 输入场景：使用日语IME进行组合输入（composition）
3. 平台特异性：iOS WebView/Safari/Chrome特有，Android设备无此问题

根本原因

通过深入代码分析，发现问题源于编辑器核心的clearDocument插件。该插件原本设计用于处理空文档状态下的格式清理，但在iOS+IME组合输入场景下会被意外触发。具体表现为：

1. IME输入过程中产生了非预期的文档变更事务(transaction)
2. 插件未能正确识别IME组合输入状态
3. 导致格式样式被错误清除

解决方案

团队通过修改clearDocument插件的逻辑，增加了对IME组合输入状态的判断：

new Plugin({
  key: new PluginKey('clearDocument'),
  appendTransaction: (transactions, oldState, newState) => {
    if (transactions.some(tr => tr.getMeta('composition'))) {
      return  // 组合输入期间跳过处理
    }
    // 原有逻辑...
  }
})

该修复方案已在2.11.3版本中发布，主要改进点包括：

1. 通过getMeta('composition')检测IME输入状态
2. 组合输入期间禁用格式清理逻辑
3. 保持原有功能在其他场景下的正常运作

技术启示

1. 输入法兼容性：富文本编辑器需要特别处理不同平台的IME行为差异
2. 状态管理：事务处理时应考虑各种边缘场景
3. 移动端适配：iOS和Android的WebView实现存在细微但重要的区别

这个问题也提醒开发者，在开发跨平台富文本编辑器时，需要充分考虑：

• 不同输入法的行为差异
• 移动端特有的交互模式
• 内容状态变化的精确控制

该修复不仅解决了日语输入法的问题，也为处理其他语言输入法提供了参考方案。