Fluent-Qt

Layout

Accordion

Coordinates a vertical group of expandable sections with single or multiple expansion.

Example

Accordion: Single expansion

Usage

Single expansion

Single mode closes the previous section when another header is opened.

#include <FluentQt/Layout.h>
using namespace fluent::layout;

auto* accordion = new Accordion(this);
accordion->setExpansionMode(
    Accordion::ExpansionMode::Single);
accordion->setFixedWidth(520);

auto makeSection = [](const QString& title,
                     const QString& detail) {
    auto* item = new Expander;
    item->setHeaderText(title);
    auto* body = new QWidget;
    auto* bodyLayout = new QVBoxLayout(body);
    bodyLayout->setContentsMargins(16, 12, 16, 14);
    bodyLayout->addWidget(
        new Label("Additional details", body));
    bodyLayout->addWidget(new Label(detail, body));
    item->setContentWidget(
        body, WidgetOwnership::Owned);
    return item;
};

accordion->addItem(
    makeSection("Account",
        "Profile, sign-in, and recovery options."),
    WidgetOwnership::Owned);
accordion->addItem(
    makeSection("Notifications",
        "Choose which activity can interrupt you."),
    WidgetOwnership::Owned);
accordion->addItem(
    makeSection("Privacy",
        "Review diagnostics and personalization settings."),
    WidgetOwnership::Owned);
accordion->itemAt(0)->setExpandedAnimated(true, false);

fluent::layout::Accordion

Inherits QWidget · FluentElement · QMLPlus

Vertical group of Expander items with coordinated expansion and keyboard focus.

Constructors

Properties

ExpansionMode expansionMode
Read expansionMode()Write setExpansionMode()Notify expansionModeChanged()
int count
Read count()Notify countChanged()

Methods

bool addItem(Expander* item)

Appends a borrowed Expander item.

bool addItem(Expander* item, WidgetOwnership ownership)

Appends an Expander item with explicit lifetime ownership.

bool insertItem(int index, Expander* item)

Inserts a borrowed Expander at the requested index.

bool insertItem(int index, Expander* item, WidgetOwnership ownership)

Inserts an Expander with explicit lifetime ownership.

bool removeItem(int index)

Removes an item and applies its configured ownership policy.

Expander* takeItem(int index)

Removes an item without deleting it and transfers it to the caller.

Signals

Enumerations

enum class ExpansionMode

Controls whether one or several items may be expanded.

  • Single
  • Multiple

Destructors

PySide6 additions

addOwnedItem(item)

Append an item that is deleted with the Accordion.

addBorrowedItem(item)

Append an item that becomes parentless when released.

addReparentedItem(item)

Append an item that returns to its current QWidget parent.

insertOwnedItem(index, item)

Insert an item that is deleted with the Accordion.

insertBorrowedItem(index, item)

Insert an item that becomes parentless when released.

insertReparentedItem(index, item)

Insert an item that returns to its current QWidget parent.

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() const

Resolves the theme used by this element, honoring an inherited QWidget override.

bool effectiveThemeUsesDarkAppearance() const

Returns whether this element's effective theme uses dark-backed chrome.

QJsonObject themeOverrides() const

Returns this element's authored overrides.

void clearThemeOverrides()

Restores all token fields to global theme defaults.

const Colors& themeColorsRef() const

Non-copying access to the active color set (for hot paint paths).

Material::AcrylicToken themeAcrylic() const

Material, elevation, and adaptive layout tokens.

QColor themeBackdrop(bool active) const

Window-chrome backdrop color for the given activation state.

virtual void onThemeUpdated()

Called after the global theme changes.

Enumerations

enum Theme

Global visual theme used when resolving design tokens.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Types and aliases

struct Colors

Design 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 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