TelamonEmptyState

What a list shows when it has nothing: a large symbol, a title, an explanation and an optional action button, centred.

TelamonEmptyState has a large symbol, a title, a line of explanation, and an optional action button, all centred. Fill the list's area with it and show it when the list is empty. The button appears when actionText is set and emits triggered(). In an area too short for all of it, the symbol is left out first; if the rest still does not fit, it scrolls inside the area rather than drawing past its edges.

Example

TelamonEmptyState {
    anchors.fill: parent
    visible: list.count === 0
    symbol: Symbols.FolderOpen
    title: qsTr("No files")
    text: qsTr("Files you download will show up here.")
    actionText: qsTr("Open Downloads")
    actionSymbol: Symbols.FolderOpen
    onTriggered: openDownloads()
}

Accessibility

It is a group: the title is its name and the text its description.

Properties

Name	Type	Default	Description
`actionSymbol`	`int` (a `Symbols.<Name>` value, see Symbols)	`0`	A symbol shown on the action button; 0 for none.
`actionText`	`string`	`""`	The button's label; empty for no button.
`iconName`	`string`	`""`	A theme icon by name, instead of `symbol`.
`symbol`	`int` (a `Symbols.<Name>` value, see Symbols)	`0`	The large Material Symbol.
`text`	`string`	`""`	The line of explanation.
`title`	`string`	`""`	The title, in bold.

Signals

Name	Description
`triggered()`	The action button was used.