本文详解如何在 JavaFX 菜单中正确实现键盘助记符（mnemonic），避免误用 Unicode 下划线变体字符（如 U+1E0F “ḏ”），推荐使用内置的 _ 前缀机制，兼顾可访问性、样式保留与屏幕阅读器兼容性。
本文详解如何在 javafx 菜单中正确实现键盘助记符（mnemonic），避免误用 unicode 下划线变体字符（如 u+1e0f “ḏ”），推荐使用内置的 `_` 前缀机制，兼顾可访问性、样式保留与屏幕阅读器兼容性。
在 JavaFX 应用开发中，为菜单项（如 MenuItem）添加快捷键提示（例如“File → _Open”中 O 被下划线标出）是常见需求。但需特别注意：不应手动将字母替换为 Unicode 下划线组合字符（如 U+1E0F “ḏ”、U+1E4D “ṭ” 等）。这类字符属于“带下划线的拉丁字母”（Latin Extended Additional 区块），其设计初衷是语音学或古文字转写，并非 UI 助记符标准，且存在严重缺陷：
- ❌ 屏幕阅读器无法识别其语义：读屏软件会将其朗读为“d with dot below”或直接跳过下划线修饰，而非“Open，快捷键 Alt+O”；
- ❌ 破坏文本样式与布局：这些字符具有独立字形宽度和基线偏移，可能导致菜单项高度异常、CSS 样式错乱；
- ❌ 丧失可访问性（a11y）支持：JavaFX 的助记符系统依赖纯 ASCII 字符 + 下划线前缀，而非视觉修饰。
✅ 正确做法是启用 JavaFX 内置的 Mnemonic Parsing 机制：
MenuItem openItem = new MenuItem("_Open");
openItem.setMnemonicParsing(true); // 默认已启用，显式声明更清晰
// 或全局设置：System.setProperty("prism.lcdtext", "false");（非必需）当 mnemonicParsing 启用时，JavaFX 会自动：
- 将第一个出现的 _ 后紧跟的字母（如 _O 中的 O）设为助记符；
- 在该字母下方渲染下划线（视觉效果）；
- 绑定 Alt+O（Windows/Linux）或 Ctrl+O（macOS）触发事件；
- 保持原始文本为标准 UTF-8 字符（U+004F），完全兼容 CSS、字体、国际化及屏幕阅读器（后者会明确播报“Open, Alt+O”）。
? 进阶提示：
立即学习“Java免费学习笔记（深入）”；
- 若菜单文本本身含下划线（如文件名 "report_v2.txt"），需用双下划线 __ 转义：new MenuItem("Save __As") → 显示为 “Save _As”，无助记符；
- 如需同时显示快捷键（如 “Open (Ctrl+O)”），应使用 setAccelerator() 配合 KeyCodeCombination：
openItem.setAccelerator( new KeyCodeCombination(KeyCode.O, KeyCombination.CONTROL_DOWN) ); - 所有 MenuItem、Button、Tab 等控件均支持此机制，无需额外图形（Graphic）或自定义渲染——既保留样式，又保障可访问性。
总结：放弃手动 Unicode 字符映射（如 U+1E0F），拥抱 JavaFX 原生助记符解析。它轻量、可靠、无障碍友好，且一行代码即可生效。真正的“下划线”应由框架在语义层生成，而非在字符层硬编码。
