Status & info
Shimmer
Shows a skeleton placeholder while content is loading.
Example
Usage
Built-in templates
Built-in templates cover image cards, avatar rows, and text blocks.
#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;
auto* image = new Shimmer(this);
image->setShimmerTemplate(Shimmer::ShimmerTemplate::ImageCard);
image->setFixedSize(160, 92);
auto* row = new Shimmer(this);
row->setShimmerTemplate(Shimmer::ShimmerTemplate::AvatarTextRow);
row->setFixedSize(180, 56);
auto* text = new Shimmer(this);
text->setShimmerTemplate(Shimmer::ShimmerTemplate::TextBlock);
text->setFixedSize(220, 72);import fluentqt
image = fluentqt.Shimmer()
image.setShimmerTemplate(fluentqt.Shimmer.ShimmerTemplate.ImageCard)
image.setFixedSize(160, 92)
avatar_row = fluentqt.Shimmer()
avatar_row.setShimmerTemplate(fluentqt.Shimmer.ShimmerTemplate.AvatarTextRow)
avatar_row.setFixedSize(180, 56)
text = fluentqt.Shimmer()
text.setShimmerTemplate(fluentqt.Shimmer.ShimmerTemplate.TextBlock)
text.setFixedSize(220, 72)API
DeclarationNo matching API members.
fluent::status_info::Shimmer
Inherits QWidget · FluentElement · QMLPlus
Fluent skeleton loading placeholder with animated shimmer.
Constructors
Properties
bool activeWhether the loading skeleton is active.
ReadisActive()WritesetActive()NotifyactiveChanged()bool animationEnabledWhether shimmer motion is enabled.
ReadisAnimationEnabled()WritesetAnimationEnabled()NotifyanimationEnabledChanged()qreal shimmerProgressCurrent normalized shimmer animation progress.
ReadshimmerProgress()WritesetShimmerProgress()NotifyshimmerProgressChanged()int cycleDurationFull shimmer cycle duration in milliseconds.
ReadcycleDuration()WritesetCycleDuration()NotifycycleDurationChanged()ShimmerTemplate shimmerTemplateBuilt-in element template used when custom elements are not supplied.
ReadshimmerTemplate()WritesetShimmerTemplate()NotifyshimmerTemplateChanged()
Methods
bool isActive() constWhether the loading skeleton is active.
void setActive(bool active)Whether the loading skeleton is active.
bool isAnimationEnabled() constWhether shimmer motion is enabled.
void setAnimationEnabled(bool enabled)Whether shimmer motion is enabled.
qreal shimmerProgress() constCurrent normalized shimmer animation progress.
void setShimmerProgress(qreal progress)Current normalized shimmer animation progress.
int cycleDuration() constFull shimmer cycle duration in milliseconds.
void setCycleDuration(int durationMs)Full shimmer cycle duration in milliseconds.
ShimmerTemplate shimmerTemplate() constBuilt-in element template used when custom elements are not supplied.
void setShimmerTemplate(ShimmerTemplate templateKind)Built-in element template used when custom elements are not supplied.
Signals
void activeChanged(bool active)Whether the loading skeleton is active.
void animationEnabledChanged(bool enabled)Whether shimmer motion is enabled.
void shimmerProgressChanged(qreal progress)Current normalized shimmer animation progress.
void cycleDurationChanged(int durationMs)Full shimmer cycle duration in milliseconds.
void shimmerTemplateChanged(ShimmerTemplate templateKind)Built-in element template used when custom elements are not supplied.
Enumerations
enum class ShimmerTemplateCustomImageCardAvatarTextRowTextBlock
Destructors
Subclass interfaces
Methods
Inherited from fluent::FluentElement
Methods
static void setTheme(Theme theme)Updates the global theme and notifies active FluentElement instances.
static void setThemeDeferred(Theme theme)Schedules a visible-first batched theme refresh without blocking the current interaction.
static Theme currentTheme()Returns the currently active global theme.
static bool themeUsesDarkAppearance(Theme theme)Returns whether a theme uses dark-backed chrome and material tokens.
static void refreshTheme()Re-broadcasts the current theme to repaint after a design-token change.
static int themeGeneration()Monotonic counter bumped on every theme change, for staleness checks.
Theme effectiveTheme() constResolves the theme used by this element, honoring an inherited QWidget override.
bool effectiveThemeUsesDarkAppearance() constReturns whether this element's effective theme uses dark-backed chrome.
bool setThemeOverrides(const QJsonObject& overrides)Component-facing token accessors.
QJsonObject themeOverrides() constReturns this element's authored overrides.
void clearThemeOverrides()Restores all token fields to global theme defaults.
const Colors& themeColorsRef() constNon-copying access to the active color set (for hot paint paths).
Material::AcrylicToken themeAcrylic() constMaterial, elevation, and adaptive layout tokens.
QColor themeBackdrop(bool active) constWindow-chrome backdrop color for the given activation state.
virtual void onThemeUpdated()Called after the global theme changes.
Enumerations
enum ThemeGlobal visual theme used when resolving design tokens.
Light = 0Dark = 1HighContrast = 2
Types and aliases
struct ColorsDesign token snapshots returned to components.
Inherited from fluent::QMLPlus
Methods
AnchorLayout::Anchors* anchors()Returns mutable anchors for the QWidget host.
void setState(const QString& name)Applies a named state, or clears state when name is empty.
void addState(const QMLState& state)Registers or replaces a named state definition.
void evaluateStates()Reevaluates conditions; the first registered true condition wins.
QMLPlusRuntime* runtime()Returns the lazy host-owned state observation object.
void setAnchors(const AnchorLayout::Anchors& anchors)Replaces all host anchors and invalidates the parent layout.
void resetAnchors()Clears all host anchors and invalidates the parent layout.
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Binds a source property to a property on the QWidget host.
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installs a managed direct binding on this QWidget host.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installs an explicit-dependency C++ expression on this QWidget host.
void addTransition(const StateTransition& transition)Registers a state transition in precedence order.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Sets the default animation for this host's managed property writes.
void clearBehavior(const char* propertyName)Removes the default animation for future managed writes.
bool writeProperty(const char* propertyName, const QVariant& value)Writes a host property through Behavior without removing its binding.
All inherited Qt members：QWidget
fluent::status_info::ShimmerPainter
Painter helper for Fluent skeleton loading visuals.
Methods
static Palette paletteFromTheme(const fluent::FluentElement::Colors& colors, bool enabled = true)Resolves a shimmer palette from Fluent theme colors.
static void paint(QPainter* painter, const QVector<Element>& elements, const Palette& palette, qreal progress, bool animated = true)Draws shimmer elements using a normalized animation progress.
static QVector<Element> imageCardElements(const QRectF& bounds, qreal radius = 4.0)Skeleton template for a single image/card placeholder.
static QVector<Element> avatarTextRowElements(const QRectF& bounds)Skeleton template for an avatar plus text row.
static QVector<Element> textBlockElements(const QRectF& bounds, int lineCount = 3)Skeleton template for a multi-line text block.
Enumerations
enum class ShapeShape used by a skeleton element.
RectangleRoundedRectCircleLine
Types and aliases
struct PaletteTheme-resolved colors used by shimmer painting.
struct ElementOne skeleton shape in local target coordinates.
fluent::status_info::ShimmerPainter::Palette
Theme-resolved colors used by shimmer painting.
Fields
fluent::status_info::ShimmerPainter::Element
One skeleton shape in local target coordinates.