OpenSumi Core 中禁用对话框回车键关闭功能的技术实现

在 OpenSumi Core 框架中，使用 IDialogService.open 方法打开的对话框默认会监听回车键（Enter）事件，并在用户按下回车键时自动关闭对话框。这一默认行为在某些特定场景下可能不符合开发需求，比如当对话框内嵌复杂表单或需要特殊交互时。

问题背景分析

OpenSumi Core 的对话框服务底层实现中，默认注册了回车键的快捷键处理逻辑。这个设计源于常见的对话框交互模式，即回车键通常用于确认操作并关闭对话框。然而，在实际开发中，我们可能会遇到以下场景需要禁用这一行为：

1. 对话框内嵌表单，回车键需要用于表单提交而非关闭对话框
2. 对话框包含多步骤交互，回车键用于步骤切换
3. 对话框内有特殊控件需要使用回车键

技术解决方案

方案一：卸载默认快捷键

通过分析 OpenSumi Core 的源代码可以发现，对话框服务在初始化时会注册快捷键。我们可以通过获取快捷键服务实例，主动卸载这些快捷键绑定：

// 获取快捷键服务
const keybindingService = injector.get(IKeybindingService);

// 卸载对话框相关的回车键绑定
keybindingService.unregisterKeybinding('enter', 'dialog.accept');

这种方法的优势是全局生效，适用于需要完全禁用回车键关闭行为的场景。

方案二：自定义对话框服务

对于需要更精细控制的场景，可以创建自定义对话框服务，继承或重写默认实现：

class CustomDialogService extends DialogService {
  protected createDialog(): IDialog {
    const dialog = super.createDialog();
    // 重写快捷键处理逻辑
    dialog.onKeyDown((e) => {
      if (e.key === 'Enter') {
        e.preventDefault();
        // 自定义处理逻辑
      }
    });
    return dialog;
  }
}

这种方法提供了更大的灵活性，允许开发者根据不同的对话框类型实现不同的回车键行为。

方案三：对话框级别控制

如果只需要针对特定对话框禁用回车键关闭，可以在打开对话框时传递自定义参数：

dialogService.open({
  // 对话框配置
  disableEnterClose: true,
  // 其他配置...
});

然后在对话框服务内部根据这个参数决定是否注册回车键监听。

实现注意事项

1. 快捷键冲突：在卸载或修改默认回车键行为时，需要注意是否会影响其他功能的快捷键
2. 用户体验一致性：虽然可以禁用回车键关闭，但要确保提供明确的替代操作方式
3. 可访问性：确保修改后的对话框仍然可以通过键盘完全操作
4. 版本兼容性：不同版本的 OpenSumi Core 可能有不同的实现细节

最佳实践建议

1. 对于简单场景，推荐使用方案一的快捷键卸载方式
2. 对于复杂场景，建议采用方案二的自定义服务
3. 在修改默认行为时，应该在文档中明确说明这一变化
4. 考虑提供回退机制，确保在特殊情况下用户仍然可以关闭对话框

通过以上方法，开发者可以灵活控制 OpenSumi Core 中对话框的回车键行为，满足各种业务场景的需求。