AlphabetKey 字母键
最常用的按键类型:点击发送 main 字符,滑动发送 alt 字符。
字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | ✓ | 固定为 "AlphabetKey" |
main | string | ✓ | 主字符(通常一个字符),如 "Q" / "中" |
alt | string | ✓ | 滑动备用字符,如 "1" |
displayText | string | map | 自定义键面显示文本,详见 overview | |
composeOverride | object | 输入过程中样式覆盖;见 Compose Override | |
weight / rowHeightPercent / 颜色字段 | — | 与共通字段相同 |
字符与按键事件
main一般是一个字符;输入法(Fcitx)会将其作为按键事件处理(拼音方案下会进入候选流程)alt在用户滑动该键时发送- 编辑器会要求
main/alt都是单个字符;如果不需要滑动备用行为,使用 SymbolKey 或 MacroKey 更合适 - 如果需要发送一段字符串、或更复杂行为,使用 MacroKey
示例
json
{ "type": "AlphabetKey", "main": "Q", "alt": "1" }按方案区分显示文字(仓颉显示偏旁、其他方案显示字母):
json
{
"type": "AlphabetKey",
"main": "Q",
"alt": "1",
"displayText": { "倉頡五代": "手" }
}