FractalDataWorks.UI.Themes 0.1.0-preview.11

FractalDataWorks.UI.Themes

Theme system for FractalDataWorks UI components using TypeCollections.

Overview

This package provides a theming system built on TypeCollections. Themes combine color palettes, border styles, and icon sets into visual configurations. Theme components are referenced by Id for persistence.

TypeCollections

MenuThemes

Pre-configured theme combinations:

ColorPalettes

BorderStyles

IconSets

Usage

Get Theme by Name

From IMenuTheme.cs:24-30:

// Theme provides resolved components via properties
IColorPalette Colors { get; }
IBorderStyle Borders { get; }
IIconSet Icons { get; }

Access a theme using the TypeCollection lookup:

var theme = MenuThemes.ByName("Dark");
var colors = theme.Colors;
var borders = theme.Borders;
var icons = theme.Icons;

Custom Theme

From DarkMenuTheme.cs:8-27:

[TypeOption(typeof(MenuThemes), "Dark")]
public sealed class DarkMenuTheme : MenuThemeBase
{
    public DarkMenuTheme() : base(1, "Dark") { }

    public override string ThemeFamily => "Dark";

    public override int ColorPaletteId => 1;  // DarkColorPalette

    public override int BorderStyleId => 1;  // RoundedBorderStyle

    public override int IconSetId => 1;  // UnicodeIconSet
}

Custom themes follow the same pattern - override the Id properties to specify which components the theme uses:

[TypeOption(typeof(MenuThemes), "Corporate")]
public sealed class CorporateMenuTheme : MenuThemeBase
{
    public CorporateMenuTheme() : base(10, "Corporate") { }

    public override string ThemeFamily => "Corporate";

    public override int ColorPaletteId => 10;  // Custom palette Id

    public override int BorderStyleId => 2;   // SquareBorderStyle

    public override int IconSetId => 2;       // AsciiIconSet
}

Color Palette Properties

From IColorPalette.cs:21-76:

public interface IColorPalette : ITypeOption<int, ColorPaletteBase>
{
    Color Primary { get; }
    Color Secondary { get; }
    Color Background { get; }
    Color Foreground { get; }
    Color Muted { get; }
    Color Success { get; }
    Color Warning { get; }
    Color Error { get; }
    Color Info { get; }
    Color Focused { get; }
    Color Selected { get; }
    Color Disabled { get; }
    Color Hover { get; }
    Color InputBorder { get; }
    Color InputBorderFocused { get; }
    Color InputBorderError { get; }
    Color TableHeader { get; }
    Color TableRowAlternate { get; }
}

Icon Set Properties

From IIconSet.cs:9-46:

public interface IIconSet : ITypeOption<int, IconSetBase>
{
    string SelectedIndicator { get; }
    string UnselectedIndicator { get; }
    string CheckedIndicator { get; }
    string UncheckedIndicator { get; }
    string RequiredIndicator { get; }
    string SuccessIcon { get; }
    string ErrorIcon { get; }
    string WarningIcon { get; }
    string InfoIcon { get; }
    string ExpandedIcon { get; }
    string CollapsedIcon { get; }
    string LoadingIcon { get; }
}

Best Practices

• Use TypeCollection lookups (MenuThemes.ByName(), MenuThemes.ById()) instead of direct instantiation
• Reference theme components by Id for database persistence
• Create custom themes by inheriting from MenuThemeBase and applying [TypeOption]
• Custom color palettes should inherit from ColorPaletteBase and apply [TypeOption(typeof(ColorPalettes), "Name")]

See Also

• UI Components
• TypeCollections