JavaFX中CustomMenuItem内CheckBox文本仅鼠标悬停显示问题求助

这个问题我之前也踩过坑！原因是CustomMenuItem的默认CSS样式会影响内部CheckBox的文本渲染——当菜单项未处于悬停/选中状态时，它会让子节点的文本颜色变得透明（或者和背景色一致），导致只有鼠标放上去才会显示文本。

快速解决方法 #

1. FXML内联样式

直接给CustomMenuItem添加样式，强制设置文本颜色：

<AnchorPane xmlns="http://javafx.com/javafx/2.2" fx:controller="ExampleController">
    <MenuBar AnchorPane.leftAnchor="0.0" AnchorPane.rightAnchor="0.0" AnchorPane.topAnchor="0.0">
        <Menu text="Menu" fx:id="menu">
            <items>
                <CustomMenuItem hideOnClick="false" style="-fx-text-fill: black;">
                    <content>
                        <CheckBox text="Click Me" />
                    </content>
                </CustomMenuItem>
            </items>
        </Menu>
    </MenuBar>
</AnchorPane>

2. 代码方式设置样式

如果是在控制器中创建CustomMenuItem，同样可以直接设置样式：

CheckBox checkBox = new CheckBox("Click Me");
CustomMenuItem customItem = new CustomMenuItem(checkBox);
customItem.setHideOnClick(false);
// 强制设置文本颜色，避免默认样式的影响
customItem.setStyle("-fx-text-fill: black;");
menu.getItems().add(customItem);

3. 全局CSS（推荐）

如果有多个这样的菜单项，建议在全局CSS文件中定义样式，避免重复代码：

/* 确保CustomMenuItem内部的CheckBox文本始终可见 */
.custom-menu-item .check-box .text {
    -fx-fill: black;
}

/* 可选：保持悬停时的文本高亮效果 */
.custom-menu-item:hover .check-box .text {
    -fx-fill: white; /* 匹配默认菜单悬停时的文本颜色 */
}

问题根源 #

JavaFX的CustomMenuItem默认样式类.custom-menu-item中，未激活状态下的文本样式被设置为透明，目的是统一菜单项的视觉效果，但它会意外继承给内部的CheckBox控件。通过覆盖文本颜色的样式，就能让CheckBox的文本始终正常显示，同时保留setHideOnClick(false)的特性。

内容的提问来源于stack exchange，提问作者Phillip Truong