AlphabetKey 字母键
最常用的按键类型：点击发送 main 字符，滑动发送 alt 字符。
字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | ✓ | 固定为 "AlphabetKey" |
main | string | ✓ | 主字符（通常一个字符），如 "Q" / "中" |
alt | string | ✓ | 滑动备用字符，如 "1" |
displayText | string | map | 自定义键面显示文本，详见 overview；显式设置时按原样渲染、不随 Shift/Caps 改写 | |
composeOverride | object | 输入过程中样式覆盖；见 Compose Override | |
weight / rowHeightPercent / 颜色字段 | — | 与共通字段相同 |
字符与按键事件
main一般是一个字符；输入法（Fcitx）会将其作为按键事件处理（拼音方案下会进入候选流程）alt在用户滑动该键时发送- 编辑器会要求
main/alt都是单个字符；如果不需要滑动备用行为，使用 SymbolKey 或 MacroKey 更合适 - 如果需要发送一段字符串、或更复杂行为，使用 MacroKey
显示文本优先（本版）
「是否显式设置了显示文本」以布局 JSON 里该字段存不存在为准，与取值无关：
- 显式设置了
displayText：键面按其原样渲染——多字符标签（如W E）不再被 Shift 截断，也不参与 Shift/Caps 大小写改写； - 未设置：键面显示
main，并照常参与 Shift/Caps 大小写变换。
多方案键面
displayText 的多模式格式（map，按方案分别指定）照常可用——典型如仓颉方案下显示字根、其他方案显示字母（见下方示例）。26 键字母层的冗余显示文本（取值与 main 完全相同）已在内置布局中清理；非 26 键层与按方案分组的 displayText 保持原样。
示例
json
{ "type": "AlphabetKey", "main": "Q", "alt": "1" }按方案区分显示文字（仓颉显示偏旁、其他方案显示字母）：
json
{
"type": "AlphabetKey",
"main": "Q",
"alt": "1",
"displayText": { "倉頡五代": "手" }
}