Java 雙向文字支援實戰：BiD 國際化核心 API、Swing 元件修正與除錯技巧

BiDi（雙向文字）支援是軟體進軍中東市場的門檻。阿拉伯文、希伯來文從右向左（RTL），夾雜英文/數字從左向右（LTR），瀏覽器與作業系統已處理輸入順序，但 Java UI 框架仍需開發者顯式啟用與微調。

核心類：ComponentOrientation

• getOrientation(Locale)：依區域取得全域方向
• isLeftToRight()：判斷當前方向
• 常數 LEFT_TO_RIGHT、RIGHT_TO_LEFT
• Component.applyComponentOrientation(orientation)：遞套套用至子元件

AWT vs Swing：選擇很關鍵

AWT 仰賴作業系統原生繪製，BiDi 表現不穩、元件佈局缺陷多；Swing 純 Java 實作，跨平台一致、BiDi 支援完整。**請務必使用 Swing。**

一鍵啟用：依系統區域自動切換

public class BiDiApp extends JFrame {
    public BiDiApp() {
        applyComponentOrientation(
            ComponentOrientation.getOrientation(Locale.getDefault())
        );
    }
}

英文區跑 LTR，阿拉伯區自動變 RTL：選單、工具列、捲軸、游標全翻轉。

四大 Swing 元件「缺陷」與修正代碼

對齊常數：拋棄 LEFT/RIGHT，改用 LEADING/TRAILING

SwingConstants.LEADING、TRAILING 會依 ComponentOrientation 自動對應「行首/行尾」，相容 LTR/RTL 切換。嚴禁硬編碼 LEFT/RIGHT，否則覆蓋全域方向。

Eclipse SWT/JFace：BiDi 零代碼

SWT 封裝原生元件，BiDi 邏輯內建於控件。只需啟動時設定 RTL 區域，應用程式自動呈現鏡像介面，開發者無需額外代碼。

實戰陷阱與解法

1. 標點符號亂跑：LRM/RLM 隱形控制字元

標點屬「弱字元」，方向由鄰近「強字元」或全域方向決定。阿拉伯資源 "URL \u0644\u0637\u0644\u0628 UDDI:" 顯示時冒號跑到右邊、英文倒序。

修正：RTL 環境前加 \u200F (LRM) 強制 LTR 片段方向。

String text = "URL \u0644\u0637\u0644\u0628 UDDI:";
if (!orientation.isLeftToRight()) text = "\u200F" + text;
new JLabel(text, SwingConstants.LEADING);

2. URL/路徑/XPath 必須永遠 LTR

這類技術字串在任何語系下都應保持原序。檢測顯示異常時，在字串前加 \u200E (RLM) 或 \u200F (LRM) 強制方向。

3. 資源還是代碼錯？用 Unicode Converter + 瀏覽器驗證

1. 將 Unicode 資源貼入 Unicode Code Converter，取得實字字串
2. 啟用 RTL 模式的 IE/Firefox 貼上字串，觀察基準渲染
3. 應用程式顯示不一致 → 代碼問題；一致 → 資源問題

總結

掌握 ComponentOrientation、修正四大 Swing 元件、善用 LEADING/TRAILING、靈活插入 LRM/RLM、建立「資源驗證基準流程」，Java BiDi 國際化不再是黑盒。