🦐 Yabomish MANUAL
第 03 章

🪟 選字窗

選字窗

Yabomish 提供兩種選字窗模式——游標跟隨固定位置,可隨時透過右鍵選單或設定程式切換。


3.1 游標跟隨模式(Cursor)

預設模式。選字窗以毛玻璃垂直列表呈現,緊貼輸入游標下方顯示。

特性:

  • 選字窗自動跟隨文字游標位置移動
  • 螢幕邊界偵測
    • 當游標接近螢幕底部、候選窗會溢出時,自動翻到游標上方顯示
    • 游標靠近螢幕左右邊緣時,自動修正水平位置,確保候選窗不超出螢幕範圍

3.2 固定位置模式(Fixed)

選字窗以水平列呈現,採半透明毛玻璃背景,固定於螢幕底部 Dock 上方。

特性:

  • 可拖曳:按住選字窗可上下拖曳調整垂直位置(僅限垂直方向)
  • 顯示組字區:正在輸入的編碼以 [abc] 形式顯示在選字窗中
  • 模式標籤:當輸入模式不是繁體中文時,選字窗會顯示當前模式名稱(如「簡中」「速打」等)

右鍵選單

在固定位置模式的選字窗上按右鍵,可調整:

設定項選項
對齊方式靠左 / 置中 / 靠右
透明度30% – 100%
字體大小14pt – 48pt
切換模式切換至游標跟隨模式

3.3 翻頁與選字

每頁顯示最多 9 個候選字,以數字鍵 19 選字。

操作按鍵
下一頁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 會自動停用,不攔截任何按鍵、不顯示選字窗,避免密碼內容洩漏至輸入法程序。