scopy-style-rules

name	scopy-style-rules
description	Scopy styling system patterns including Style::setStyle, theme colors, section backgrounds, and widget styling. Auto-loads when applying styling to scopy widgets or sections.

Scopy Style Rules

Core Functions

#include <style.h>

// Apply predefined styles
Style::setStyle(widget, style::properties::label::menuBig);
Style::setStyle(widget, style::properties::widget::border_interactive);
Style::setStyle(widget, style::properties::widget::basicBackground, true, true);

// Set background colors
Style::setBackgroundColor(widget, json::theme::background_primary);
Style::setBackgroundColor(widget, json::theme::background_subtle);

// Get theme values
QString iconPath = Style::getAttribute(json::theme::icon_theme_folder);
QColor color = Style::getColor(json::theme::content_error);

Section Styling Pattern

// Standard section
Style::setBackgroundColor(sectionWidget, json::theme::background_primary);
Style::setStyle(sectionWidget, style::properties::widget::border_interactive);

// Section title
Style::setStyle(titleLabel, style::properties::label::menuBig);

Note: Not every section needs background_primary — check reference implementations to see which sections use it vs inherit parent background.

Key Style Properties

• Labels: menuBig, menuMedium, menuSmall, subtle, deviceIcon
• Buttons: basicButton, blueGrayButton, squareIconButton, borderButton
• Widgets: border_interactive, basicBackground
• Backgrounds: background_primary, background_secondary, background_subtle

Collapsible Section (for advanced sub-tabs)

#include <gui/widgets/menucollapsesection.h>

MenuSectionCollapseWidget *section = new MenuSectionCollapseWidget(
    "Section Title", MenuCollapseSection::MHCW_ARROW,
    MenuCollapseSection::MHW_BASEWIDGET, parent);
section->contentLayout()->addWidget(widget);

Rules

• Never hardcode colors — always use theme system
• Apply styles after widget creation
• Check widget validity before styling
• Always include #include <style.h>

Full Reference

See reference.md in this directory for the complete style catalog.