KeyboardKit 9.1版本新增键盘侧边停靠功能解析

功能背景

在移动设备单手操作场景中，iOS原生键盘提供了侧边停靠功能，通过将键盘界面固定在屏幕左侧或右侧，显著提升了单手输入的便捷性。KeyboardKit作为第三方键盘开发框架，在9.1版本中实现了这一特性的自定义支持。

技术实现方案

KeyboardKit 9.1版本通过以下核心组件实现该功能：

1. DockEdge枚举类型 定义键盘停靠位置的基础数据结构，包含：

   • 标准模式（全宽度显示）
   • 左侧停靠（可配置宽度比例）
   • 右侧停靠（可配置宽度比例）

2. 设置存储体系 新增Keyboard.Settings.keyboardDockEdge存储属性，持久化用户选择的停靠偏好。

3. 视图修饰符 提供.keyboardDockEdge(...)视图修饰符，默认通过RootView自动应用用户设置。

架构设计考量

开发过程中曾考虑采用更复杂的"显示模式"枚举方案，计划包含标准模式、浮动模式（iPad专属）、左右停靠以及折叠状态。但最终采用更简洁的独立属性设计，原因包括：

1. 不同显示状态并非完全互斥
2. 现有上下文属性（如isCollapsed）可保持为计算属性
3. 降低API复杂度，提高易用性

开发者集成建议

在实际开发中建议：

1. 通过Settings统一管理停靠状态，确保配置持久化
2. 在键盘布局计算时考虑停靠边缘参数
3. 为iPad设备保留浮动模式兼容处理
4. 提供合理的默认宽度比例（建议70-80%）

该功能的实现使得KeyboardKit在用户体验层面进一步向原生键盘看齐，为开发者提供了更完善的输入法定制能力。