macOS中如何用TAB和SHIFT+TAB实现自定义QML控件的activeFocus循环？

这个问题其实是macOS平台特有的QML焦点处理行为导致的——原生输入控件（比如TextField）已经由Qt封装了平台适配的焦点逻辑，但自定义容器类控件（比如基于Pane的Widget）需要手动处理Tab键的焦点传递，否则Tab事件会被父组件捕获。

问题根源 #

在macOS上，Qt的容器控件（如Pane、Rectangle）默认不会将Tab键事件纳入自身的焦点处理流程，当你按下Tab时，事件会向上冒泡到父组件，导致焦点直接跳出当前控件组。而TextField这类输入控件继承自InputControl，Qt为它专门实现了平台兼容的焦点切换逻辑，所以能正常工作。

解决方案：手动处理Tab/Shift+Tab事件 #

我们需要在自定义控件中捕获Tab和Shift+Tab事件，手动调用焦点链的方法来切换到下一个/上一个可聚焦控件，同时标记事件已被处理，避免父组件捕获。

修改后的Widget.qml代码如下：

import QtQuick 2.12
import QtQuick.Controls 2.12
Pane {
    id: root
    property color color
    width: 175
    height: 25
    focusPolicy: Qt.StrongFocus
    activeFocusOnTab: true

    // 处理Tab键，切换到下一个焦点控件
    Keys.onTabPressed: {
        event.accepted = true; // 标记事件已处理，阻止冒泡到父组件
        // 查找焦点链中的下一个可聚焦控件（true表示包含所有可聚焦项）
        const nextItem = FocusScope.focusedItem.nextItemInFocusChain(true);
        if (nextItem) {
            nextItem.forceActiveFocus(); // 强制激活下一个控件的焦点
        }
    }

    // 处理Shift+Tab键，切换到上一个焦点控件
    Keys.onShiftTabPressed: {
        event.accepted = true;
        const prevItem = FocusScope.focusedItem.previousItemInFocusChain(true);
        if (prevItem) {
            prevItem.forceActiveFocus();
        }
    }

    background: Rectangle {
        color: root.color
        radius: 10
        antialiasing: true
        border.width: root.activeFocus ? 2 : 0
        border.color: "darkblue" // 增加焦点边框，直观显示状态
    }
    Label {
        id: label
        anchors.fill: parent
        horizontalAlignment: Text.AlignHCenter
        verticalAlignment: Text.AlignVCenter
        text: root.activeFocus ? 'I have focus' : ''
    }
}

关键说明 #

1. event.accepted = true：必须设置这个，否则Tab事件会继续向上传递给父组件，导致焦点跳出控件组。
2. nextItemInFocusChain(true)：true参数表示遍历整个焦点链中的所有可聚焦控件（包括非输入类控件），如果不传这个参数，默认只会遍历输入类控件，不符合我们的需求。
3. forceActiveFocus()：直接激活目标控件的activeFocus，确保焦点切换生效。

额外优化：使用FocusScope管理焦点范围 #

如果你的自定义控件内部有多个子控件，建议将根节点改为FocusScope，确保焦点在控件内部正确管理，避免焦点丢失：

FocusScope {
    id: root
    // 其余属性和逻辑保持不变
    Pane {
        anchors.fill: parent
        // Pane的原有代码...
    }
}

这样修改后，你的自定义控件应该就能在macOS上和Windows一样，通过Tab/Shift+Tab正常循环切换焦点了。

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