EmptyState¶
Placeholder illustration + title + optional action.
import QWinUI3.Extras · src/extras/QWinUI3/Extras/EmptyState.qml
Category: Status & feedback · Library: v2.80
Gallery: EmptyState — src/gallery/pages/EmptyStatePage.qml
Extends Control.
Example¶
EmptyState {
title: qsTr("Nothing here")
description: qsTr("Try another filter.")
}
// --- API ---
// signals: onActionClicked, onSecondaryActionClicked
Notes¶
Placeholder for empty lists; title/message (description alias) + optional action. Neutral Document default (not Warning); bordered false by default for a lighter Fluent look. illustration slot replaces the circular glyph when set.
API¶
Properties¶
| Name | Type | Description |
|---|---|---|
symbol |
var |
FluentIcons symbol (preferred over iconGlyph) |
glyph |
string |
Fluent glyph drawn in the button |
title |
string |
Primary title text |
message |
string |
Body / message text |
description |
alias |
WinUI / docs alias of message |
actionText |
string |
Optional action button label |
secondaryActionText |
string |
Secondary action button label |
compact |
bool |
Compact layout density |
bordered |
bool |
Draw a border when true (default false — lighter empty surface) |
glyphColor |
color |
Glyph color |
showGlyph |
bool |
Show leading glyph (ignored when illustration has children) |
illustration |
alias |
Custom illustration slot (replaces circular glyph) |
effectiveGlyph |
string |
Resolved glyph string — neutral Document, not Warning |
Signals¶
| Signature | Description |
|---|---|
actionClicked() |
Emitted when action is clicked |
secondaryActionClicked() |
Secondary action clicked |
Methods¶
No custom methods (use inherited methods from the base type).
Inherited from Control¶
Also available (base type / Qt Quick Controls):
paddingfontbackground/contentItem
Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.