TelamonTreeModel

TelamonTreeModel builds a tree model from nested JS objects, because QML can't build a tree model itself. Use it for a small tree that is static or rebuilt as a whole; an app with a large or live tree writes its own QAbstractItemModel: the model builds at most 100000 nodes (the rest are dropped, with one warning) and at most 64 levels deep, and keeps the items list as well as the nodes built from it. An index that outlived a change of items never crashes the model; this is best effort, and with the same address and row it may name the new item. Feed it to TelamonTreeView or any Qt Quick TreeView.

The model has one column. Its roles are display (the text), symbol (a Symbols value, 0 if none) and icon (an icon name or image url, empty if none). Each item is { text, symbol, icon, children }.

Example

TelamonTreeModel {
    id: tree
    items: [
        { text: "Documents", symbol: Symbols.Folder, children: [
            { text: "Report.odt" }, { text: "Notes.md" } ] },
        { text: "Music" }
    ]
}
TelamonTreeView { model: tree; symbolRole: "symbol" }

Properties