重复器 QML 类型

使用提供的模型实例化多个基于 Item 的组件。 更多...

• 包括继承成员在内的所有成员列表

属性

• count : int
• delegate : Component
• model : var

信号

• itemAdded(int index, Item item)
• itemRemoved(int index, Item item)

方法

• Item itemAt(index)

详细描述

重复器类型用于创建大量相似的项目。像其他视图类型一样，重复器有一个模型和一个委托：对于模型中的每个条目，委托都在由模型数据种子的上下文中实例化。重复器项通常在行或列等定位器类型中封装，以在视觉上定位重复器创建的多个委托项。

以下重复器在行中创建了三个矩形项的实例

import QtQuick

Row {
    Repeater {
        model: 3
        Rectangle {
            width: 100; height: 40
            border.width: 1
            color: "yellow"
        }
    }
}

重复器的模型可以是支持的任何数据模型。此外，类似于其他视图的委托，重复器委托可以访问它在重复器中的索引以及与委托相关的模型数据。有关详细信息，请参阅委托属性的文档。

重复器实例化的项目按顺序以重复器父项的子项插入。插入从重复器在父项堆叠列表中的位置立即开始。这使得重复器可以在布局中使用。例如，以下重复器的项在红色矩形和蓝色矩形之间堆叠

Row {
    Rectangle { width: 10; height: 20; color: "red" }
    Repeater {
        model: 10
        Rectangle { width: 20; height: 20; radius: 10; color: "green" }
    }
    Rectangle { width: 10; height: 20; color: "blue" }
}

使用重复器的注意事项

重复器类型在第一次创建时会创建所有其代理项。如果代理项数量庞大且不是所有项都需要同时可见，这可能会效率低下。在这种情况下，可以考虑使用其他视图类型，如ListView（仅在项滚动到视图中时创建代理项），或者使用动态对象创建方法在需要时创建项。

另外，请注意，重复器是Item-based的，只能重复Item派生的对象。例如，它不能用于重复 QtObjects

// bad code:
Item {
    // Can't repeat QtObject as it doesn't derive from Item.
    Repeater {
        model: 10
        QtObject {}
    }
}

属性文档

Column {
    Repeater {
        model: 10
        Text {
            required property int index
            text: "I'm item " + index
        }
    }
}

Column {
    Repeater {
        model: ["apples", "oranges", "pears"]
        Text {
            required property string modelData
            text: "Data: " + modelData
        }
    }
}

信号文档

方法文档