QML中ListView使用ListModel时字段无法解析的问题

核心原因 #

你的comp2组件如果被用作其他视图（比如外层ListView）的delegate，组件实例化时的上下文会切换到外层模型的元素作用域，导致内部ListView无法正确访问Page作用域下的listModelA，进而delegate无法解析text2字段。即使组件未被用作外层delegate，Qt Creator的静态检查也可能因组件的作用域隔离误报，但运行时报错说明模型确实未被正确关联。

解决方案 #

方案1：通过组件属性传递模型

给comp2添加属性来传递模型，确保组件内部能正确获取到listModelA：

Component {
    id: comp2
    // 定义属性接收外部模型
    property ListModel innerModel: listModelA
    Column {
        ListView {
            id: listA
            width: parent.width
            height: 100
            // 使用组件属性传入的模型
            model: innerModel
            delegate: Item {
                id: aaa
                // 给delegate设置明确尺寸，避免布局异常
                width: 100
                height: 20
                Text {
                    width: parent.width
                    height: parent.height
                    // 直接访问模型字段即可
                    text: text2
                }
            }
        }
    }
}

如果是通过Loader加载该组件，需明确绑定属性：

Loader {
    sourceComponent: comp2
    innerModel: listModelA
}

方案2：调整模型作用域（仅适用于模型专属该组件的场景）

若listModelA仅服务于comp2内部的ListView，可将模型直接定义在组件内部：

Component {
    id: comp2
    Column {
        ListView {
            id: listA
            width: parent.width
            height: 100
            model: ListModel {
                ListElement { text2: "aaa" }
                ListElement { text2: "bbb" }
                ListElement { text2: "ccc" }
                ListElement { text2: "ddd" }
            }
            delegate: Item {
                id: aaa
                width: 100
                height: 20
                Text {
                    width: parent.width
                    height: parent.height
                    text: text2
                }
            }
        }
    }
}

额外注意 #

你的delegate根Item未设置尺寸，可能导致ListView布局异常，建议始终给delegate根元素设置明确的宽高。

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