Qt 5.15 QML中list<Item>语法错误问题（Qt 6.4+可正常运行）

问题核心 #

Qt 6.8支持直接使用list<Item>类型绑定模型，但Qt 5.15对QML列表类型的语法限制更严格，直接声明会触发语法错误；同时QQmlListProperty<QQuickItem>在绑定到Repeater时，存在Delegate无法正确访问Item属性的问题。

可行解决方案 #

1. C++侧模型调整：改用QList<QObject*>暴露数据 #

放弃QQmlListProperty，直接用QList<QObject*>作为Backend的模型属性，并添加通知信号支持动态更新：

#include <QObject>
#include <QList>
#include <QQuickItem>

class Backend : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QList<QObject*> model READ model WRITE setModel NOTIFY modelChanged)
public:
    explicit Backend(QObject *parent = nullptr) : QObject(parent) {}

    QList<QObject*> model() const { return m_model; }
    void setModel(const QList<QObject*> &model) {
        if (m_model != model) {
            m_model = model;
            emit modelChanged();
        }
    }

    // 动态添加Item的示例方法
    Q_INVOKABLE void addCustomItem(QQuickItem *item) {
        m_model.append(item);
        emit modelChanged();
    }

signals:
    void modelChanged();

private:
    QList<QObject*> m_model;
};

2. QML侧属性声明：使用var类型绑定模型 #

在QML中用var类型声明属性，避开Qt 5.15不支持的list<Item>语法：

import QtQuick 2.15

Item {
    property var myModel: Backend.model

    Repeater {
        model: myModel
        delegate: Item {
            // 基于Item类型动态渲染的示例
            Text {
                text: modelData.type === "CustomItem1" ? modelData.property1 : modelData.property2
            }
            // 或用Loader加载对应组件
            Loader {
                sourceComponent: modelData.type === "CustomItem1" ? customComp1 : customComp2
                item: modelData
            }
        }
    }

    // 自定义组件示例
    Component {
        id: customComp1
        CustomItem1 {}
    }

    Component {
        id: customComp2
        CustomItem2 {}
    }
}

3. 类型标识优化：给自定义Item添加类型属性 #

在C++自定义Item类中添加常量类型属性，方便QML侧区分不同Item：

class CustomItem1 : public QQuickItem
{
    Q_OBJECT
    Q_PROPERTY(QString type READ type CONSTANT)
public:
    QString type() const { return "CustomItem1"; }
    // 其他业务属性
};

关键注意事项 #

• 所有自定义Item必须继承QObject（QQuickItem已满足该要求），才能存入QList<QObject*>并在QML中正常访问属性。
• 动态修改模型后必须触发modelChanged信号，否则Repeater不会自动更新内容。
• Qt 5.15的Repeater无法直接兼容QQmlListProperty<QQuickItem>，改用QList<QObject*>是跨版本兼容的最优方案。

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