# 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

```qml
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](https://telamon.eterneon.net/framework/telamon-ui/symbols.md)) | `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](https://telamon.eterneon.net/framework/telamon-ui/symbols.md)) | `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. |