HeliBoard键盘布局中的弹出键自定义实现方案

在HeliBoard输入法项目中，针对不同语言布局的弹出键(popup keys)定制需求，开发者提供了灵活的解决方案。本文将从技术实现角度详细介绍如何在HeliBoard中为不同键盘布局配置专属的弹出键。

背景需求

某些语言如孟加拉语(bn-BD)包含大量字符(达50个)，需要充分利用Shift键状态和弹出键来容纳所有字符。不同布局(如Unijoy和Akkhor)对这些弹出键的排列需求各不相同，这就要求输入法能够为同一语言的不同布局分别定义弹出键。

实现方案

HeliBoard支持两种键盘布局格式，每种格式都有对应的弹出键定义方式：

1. 简单文本格式(.txt布局)

在这种格式中，可以直接在键定义后追加弹出键，语法格式为：

<主键> <弹出键1> <弹出键2>

示例：

m p o

这表示在按下m键时，会显示p和o作为弹出选项。

2. JSON格式布局

对于更复杂的FlorisBoard风格布局(.json文件)，弹出键的定义方式更为结构化。开发者需要在键定义中添加专门的popup字段：

{
    "code": 123,
    "label": "主键",
    "popups": {
        "main": "主要弹出键",
        "relevant": ["相关弹出键1", "相关弹出键2"]
    }
}

实际案例中可以看到：

• 主弹出键(main)定义为单个字符
• 相关弹出键(relevant)定义为字符数组

目前两种弹出键类型在功能上没有本质区别，主要区别在于main用于单个弹出键，而relevant支持多个弹出键。

设计考量

最初将弹出键定义放在语言而非布局中的设计决策，虽然简化了大量布局迁移工作，但对于某些特殊语言(如字符量大的语言)可能不是最优选择。当前方案通过在布局文件中直接定义弹出键，为这些特殊情况提供了更灵活的解决方案。

最佳实践建议

对于需要特殊弹出键配置的语言布局：

1. 优先考虑使用JSON格式布局，以获得更精细的控制
2. 对于简单需求，可以使用文本格式快速定义
3. 注意保持弹出键与主键的语义关联性
4. 考虑用户输入习惯，合理安排弹出键顺序

这种设计既保持了核心功能的简洁性，又通过布局级定制满足了特殊需求，体现了HeliBoard在输入法设计上的灵活性和实用性。