Components/Data display

EListy Virtual list

import EUI 1.0

Examples

Virtual list

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EListy { readonly property string itemLabel: qsTr("Project Alpha") width: 420 height: 270 overscan: 80 items: Array.from({ "length": 500 }, function(_, index) { return { "key": index, "label": itemLabel + " " + index, "kind": index < 250 ? "A" : "B" } }) }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Group by callback

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EListy { readonly property string itemLabel: qsTr("Project Alpha") width: 420 height: 270 group: ({ "key": function(item) { return item.kind }, "title": function(key, entries) { return key + " · " + entries.length } }) items: Array.from({ "length": 500 }, function(_, index) { return { "key": index, "label": itemLabel + " " + index, "kind": index < 250 ? "A" : "B" } }) }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Sticky group headings

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EListy { readonly property string itemLabel: qsTr("Project Alpha") width: 420 height: 270 sticky: true group: ({ "key": "kind" }) items: Array.from({ "length": 500 }, function(_, index) { return { "key": index, "label": itemLabel + " " + index, "kind": index < 250 ? "A" : "B" } }) }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Custom item delegate

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EListy { readonly property string itemLabel: qsTr("Project Alpha") width: 420 height: 270 itemDelegate: Component { EListItem { property var itemKey: null avatarText: "Q" extra: String(itemKey) } } items: Array.from({ "length": 500 }, function(_, index) { return { "key": index, "label": itemLabel + " " + index, "kind": index < 250 ? "A" : "B" } }) }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Locate by stable key

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EListy { id: list readonly property string itemLabel: qsTr("Project Alpha") width: 420 height: 270 header: EButton { text: qsTr("Locate item 200") onClicked: list.scrollTo({ "key": 200, "align": "top" }) } items: Array.from({ "length": 500 }, function(_, index) { return { "key": index, "label": itemLabel + " " + index, "kind": index < 250 ? "A" : "B" } }) }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Properties

PropertyDescriptionValues and default

datasetvarRead only

Built row data and error information.

DefaultComputed

errorStringstringRead only

Invalid data or callback error description; empty on success.

DefaultComputed

groupvar

Group key and group title configuration.

Fields:
key, title

Defaultnull

groupHeaderDelegateComponent

Custom group header; receives groupKey and groupTitle.

Defaultnull

indexOffsetint

Source index offset; EList uses it to preserve indexes across pages.

Default0

itemDelegateComponent

Custom item delegate; receives itemData, itemIndex, and related context.

Defaultnull

itemsvar

List data array; replace it to update the view.

Default[]

overscanreal

Delegate cache distance beyond the viewport in pixels.

Default120

rowKeyvar

Stable key field or (item, index) callback; missing fields fall back to the index.

Default"key"

rowsvarRead only

Grouped rows retaining source index, stable key, and grouping metadata.

DefaultComputed

stickybool

Keep the current group heading at the top.

Defaultfalse

virtualbool

Create and reuse delegates on demand; false expands the cache to all content.

Defaulttrue

Signals

SignaturePurpose

itemClicked(var item, int index)

Emitted when a list item is clicked; item is its data and index is its zero-based index.

Methods

SignaturePurpose

scrollTo(config)

Scroll to an item or position using config.