如何让QML Menu控件适配布局镜像（RTL）？

我正在开发一款支持RTL（从右到左）语言的多语言应用，使用Menu控件时发现它并未遵循顶层ApplicationWindow中的LayoutMirroring.enabled设置。

LTR模式下显示正常：

但切换到RTL模式后，菜单仍向右展开，动画方向也不符合预期，预期效果应为：

相关代码 #

QML代码 #

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Material

ApplicationWindow {
    id: root

    property bool mirroringEnabled: false

    LayoutMirroring.enabled: mirroringEnabled
    LayoutMirroring.childrenInherit: true

    width: 640
    height: 480
    visible: true

    menuBar: MenuBar {
        Menu {
            id: someMenu
            title: qsTr("&File")
            Action { text: qsTr("&New...") }
        }
        Menu {
            title: qsTr("&Edit")
            Action { text: qsTr("Cu&t") }
        }
        Menu {
            title: qsTr("&Help")
            Action { text: qsTr("&About") }
        }
    }

    Button {
        text: `mirror layout: ${root.mirroringEnabled}`
        anchors.centerIn: root.contentItem

        onClicked: {
            console.log("---")
            console.log("Before:     Menu mirrored:", someMenu.mirrored, "<-")
            console.log("Before: Mirroring enabled:", root.mirroringEnabled)
            root.mirroringEnabled = !root.mirroringEnabled
            console.log("After:     Menu mirrored:", someMenu.mirrored, "<-")
            console.log("After: Mirroring enabled:", root.mirroringEnabled)
        }
    }
}

Python运行代码 #

from PySide6.QtCore import QUrl
from PySide6.QtQml import QQmlApplicationEngine
from PySide6.QtWidgets import QApplication
import sys

if __name__ == '__main__':
    app = QApplication([])
    engine = QQmlApplicationEngine()

    engine.load(QUrl.fromLocalFile('window.qml'))

    if not engine.rootObjects():
        sys.exit(-1)

    app.exec()

已尝试的方案 #

• 显式设置Menu的parent属性可让菜单向正确方向展开，但会完全打乱定位
• 从QApplication切换为QGuiApplication也无效

解决方案 #

方案1：显式绑定Menu的mirrored属性 #

Menu控件的mirrored属性默认不会自动继承父级的LayoutMirroring配置，需手动绑定到根窗口的镜像开关：

修改MenuBar中的每个Menu，添加mirrored绑定：

Menu {
    id: someMenu
    title: qsTr("&File")
    mirrored: root.mirroringEnabled
    Action { text: qsTr("&New...") }
}
Menu {
    title: qsTr("&Edit")
    mirrored: root.mirroringEnabled
    Action { text: qsTr("Cu&t") }
}
Menu {
    title: qsTr("&Help")
    mirrored: root.mirroringEnabled
    Action { text: qsTr("&About") }
}

切换镜像状态时，Menu的mirrored会同步更新，菜单展开方向和动画将自动适配RTL模式。

方案2：应用级布局方向切换（更推荐） #

直接设置整个应用的布局方向，能让所有控件（包括Menu）自动适配RTL/LTR，无需单独配置：

1. 修改QML中Button的onClicked逻辑，添加应用布局方向切换：

Button {
    text: `mirror layout: ${root.mirroringEnabled}`
    anchors.centerIn: root.contentItem

    onClicked: {
        root.mirroringEnabled = !root.mirroringEnabled
        Qt.application.setLayoutDirection(root.mirroringEnabled ? Qt.RightToLeft : Qt.LeftToRight)
    }
}

2. 移除ApplicationWindow中的LayoutMirroring相关配置：

// 移除以下两行
// LayoutMirroring.enabled: mirroringEnabled
// LayoutMirroring.childrenInherit: true

这种方式符合Qt多语言布局规范，所有控件的对齐、弹出方向都会自动适配，无需单独处理Menu的镜像问题。

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