Qt 5.15.2中QML ComboBox无法通过JS append()填充的问题

Qt Quick Controls 2的ComboBox默认依赖textRole属性匹配模型字段，默认值为"text"。你的ListModel中存储文本的字段是"name"，而非默认的"text"，且未显式指定textRole，导致ComboBox无法正确识别要显示的文本内容。

而ListView是直接通过你自定义的delegate（text: name）渲染每个条目，不需要依赖textRole，所以能正常显示。官方示例中使用的是"text"字段，刚好匹配ComboBox的默认textRole，因此可以正常工作。

有两种方式可以修复这个问题：

方法一：指定textRole #

在ComboBox中添加textRole属性，绑定到模型字段"name"：

ComboBox {
    id: myComboBox
    textRole: "name" // 新增配置textRole

    ListModel {
        id: myModel
    }

    model: myModel
    delegate: ItemDelegate {
        text: name
    }

    Component.onCompleted: {
        myModel.append({ "name": "1", "value": "val1" });
        myModel.append({ "name": "2", "value": "val2" });
        myModel.append({ "name": "3", "value": "val3" });
        myModel.append({ "name": "4", "value": "val4" });
        currentIndex = 0; // 可选：设置初始选中项，让按钮默认显示内容
    }
}

方法二：修改模型字段为"text" #

如果允许调整模型字段名，直接将"name"改为"text"，匹配ComboBox的默认textRole：

ComboBox {
    id: myComboBox

    ListModel {
        id: myModel
    }

    model: myModel
    delegate: ItemDelegate {
        text: text
    }

    Component.onCompleted: {
        myModel.append({ "text": "1", "value": "val1" });
        myModel.append({ "text": "2", "value": "val2" });
        myModel.append({ "text": "3", "value": "val3" });
        myModel.append({ "text": "4", "value": "val4" });
        currentIndex = 0;
    }
}

另外建议设置currentIndex为有效索引（比如0），这样ComboBox初始化后按钮上就会显示选中条目，避免看起来为空。

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