LayoutSwitchKey 布局切换键
切换到指定的文本键盘布局。常用于在 QWERTY ↔ 数字符号 ↔ 符号面板之间跳转。
字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | ✓ | 固定为 "LayoutSwitchKey" |
label | string | ✓ | 键面主标签，如 "?123"、"ABC" |
subLabel | string | 目标布局名；留空表示回到默认文本键盘 | |
swipe | object | 一个 MacroAction，可用作滑动备用动作 | |
swipeLabel | string | 滑动时显示的提示文字 | |
weight / rowHeightPercent / 颜色字段 | — | 与共通字段相同 |
切换"层" vs 切换"布局文件"
- LayoutSwitchKey 切换的是键盘布局目标：
subLabel为内置布局名、布局文件中的 layout key，或空字符串 - 如果只是在当前输入方案布局内切换"层"，用 MacroKey 的
layerstep
示例
json
{ "type": "LayoutSwitchKey", "label": "?123", "subLabel": "Symbol" }json
{
"type": "LayoutSwitchKey",
"label": "ABC",
"subLabel": "",
"swipe": { "macro": [ { "type": "text", "text": " " } ] }
}