選字窗
Yabomish 提供兩種選字窗模式——游標跟隨與固定位置,可隨時透過右鍵選單或設定程式切換。
3.1 游標跟隨模式(Cursor)
預設模式。選字窗以毛玻璃垂直列表呈現,緊貼輸入游標下方顯示。
特性:
- 選字窗自動跟隨文字游標位置移動
- 螢幕邊界偵測:
- 當游標接近螢幕底部、候選窗會溢出時,自動翻到游標上方顯示
- 游標靠近螢幕左右邊緣時,自動修正水平位置,確保候選窗不超出螢幕範圍
3.2 固定位置模式(Fixed)
選字窗以水平列呈現,採半透明毛玻璃背景,固定於螢幕底部 Dock 上方。
特性:
- 可拖曳:按住選字窗可上下拖曳調整垂直位置(僅限垂直方向)
- 顯示組字區:正在輸入的編碼以
[abc]形式顯示在選字窗中 - 模式標籤:當輸入模式不是繁體中文時,選字窗會顯示當前模式名稱(如「簡中」「速打」等)
右鍵選單
在固定位置模式的選字窗上按右鍵,可調整:
| 設定項 | 選項 |
|---|---|
| 對齊方式 | 靠左 / 置中 / 靠右 |
| 透明度 | 30% – 100% |
| 字體大小 | 14pt – 48pt |
| 切換模式 | 切換至游標跟隨模式 |
3.3 翻頁與選字
每頁顯示最多 9 個候選字,以數字鍵 1–9 選字。
| 操作 | 按鍵 |
|---|---|
| 下一頁 | Tab、→、↓ |
| 上一頁 | Shift+Tab、←、↑ |
候選字超過一頁時,選字窗右側會顯示頁碼(如 1/3)。
滑鼠點擊
兩種模式皆支援滑鼠操作——直接點擊候選字的數字標籤即可送字。
3.4 多螢幕支援
Yabomish 自動偵測輸入焦點所在的螢幕,優先以滑鼠游標位置判斷。
部分 GPU 加速終端(如某些 OpenGL/Metal 渲染的終端模擬器)回報的游標座標可能無效,此時 Yabomish 會自動 fallback 至固定位置模式,確保選字窗仍可正常使用。
3.5 全螢幕 App 相容
選字窗設定了 fullScreenAuxiliary 視窗層級,可在全螢幕 App 中正常顯示。已測試相容的終端包括 tmux、Ghostty 等。
3.6 VoiceOver 無障礙
候選字窗支援 macOS VoiceOver 螢幕朗讀:
- 候選字窗開啟時,VoiceOver 自動朗讀當前 highlight 的候選字(如「第一,好」)
- 方向鍵移動、翻頁時,朗讀新的 highlight 候選字
- 每個候選字 label 帶有無障礙描述(如「第三,哈」),可用 VO+方向鍵逐一瀏覽
- 嘸蝦米的確定性拆碼特性對視障使用者友善 — 熟練後幾乎不需要看候選字窗,打碼 → Space 即可送字
3.7 安全輸入
當系統偵測到安全輸入模式(IsSecureEventInputEnabled,例如密碼欄位)時,Yabomish 會自動停用,不攔截任何按鍵、不顯示選字窗,避免密碼內容洩漏至輸入法程序。