本文介绍如何在 Vaadin Flow（v24+）中安全、高效地修改 PasswordField 内置“密码显示按钮”的 aria-label 文本，避开直接操作 DOM 的风险，推荐使用 Element.setPropertyMap() 设置国际化属性。
本文介绍如何在 vaadin flow（v24+）中安全、高效地修改 `passwordfield` 内置“密码显示按钮”的 `aria-label` 文本，避开直接操作 dom 的风险，推荐使用 `element.setpropertymap()` 设置国际化属性。
在 Vaadin Flow 中，PasswordField 组件内置的“显示/隐藏密码”按钮（即 aria-label 并非硬编码，而是由组件内部的 i18n 配置对象动态生成——其中 i18n.reveal 字段决定了按钮的可访问性文本（例如默认为 "Show password" 或 "Reveal password"）。虽然该按钮在 Shadow DOM 中渲染，不建议通过 executeJs() 操作原生 DOM 元素（如 document.getElementsByTagName(...)），原因包括：
- Shadow DOM 封装导致选择器失效；
- 组件生命周期中按钮可能尚未挂载；
- 违反 Vaadin 声明式编程原则，难以维护且存在兼容性风险。
✅ 正确做法是通过 Element.setPropertyMap() 直接设置 i18n 属性映射：
PasswordField passwordField = new PasswordField();
passwordField.getElement().setPropertyMap("i18n", Map.of("reveal", "显示密码"));
// 或使用传统 Map 构造（兼容 Java 8+）
passwordField.getElement().setPropertyMap("i18n",
Collections.singletonMap("reveal", "显示密码")
);
? 注意：
setPropertyMap()会完全覆盖当前i18n对象。若需保留其他国际化项（如hide、togglePassword等），应显式传入完整映射：Map<string string> i18n = new HashMap(); i18n.put("reveal", "显示密码"); i18n.put("hide", "隐藏密码"); i18n.put("togglePassword", "切换密码可见性"); passwordField.getElement().setPropertyMap("i18n", i18n);</string>
此外，该配置支持响应式更新：后续调用 setPropertyMap("i18n", ...) 会自动刷新按钮的 aria-label，无需手动触发重绘。对于多语言场景，建议将 i18n 映射与 Locale 绑定，在 UI.getCurrent().getLocale() 变化时动态更新。
总结：优先使用 Element.setPropertyMap("i18n", Map) 替代 JavaScript DOM 操作；确保传递完整的国际化键值对以避免意外丢失功能；该方案简洁、稳定，符合 Vaadin Flow 的设计哲学。
