Theme Loader

IsaThemeLoader

The IsaThemeLoader component loads and applies IsaThemeBuilder themes at runtime. It supports CSS, JSON, and SCSS ZIP formats from URLs, byte arrays, or base64 strings. JSON is the recommended format — it fully preserves component-specific overrides (popup colors, selected states, hover effects, etc.) which CSS and SCSS imports cannot restore. It can run as an invisible headless component or as a dropdown theme picker.

Theme Loader Parameters

Component Preview (affected by loaded theme)

Current Configuration

📋

<IsaThemeLoader @ref="themeLoader"
                AutoLoad="false"
                OnThemeLoaded="HandleThemeLoaded" />

@code {
    private IsaThemeLoader? themeLoader;

    private async Task ApplyTheme(string themeName)
    {
        if (themeName == "Light")
        {
            await themeLoader!.ClearThemeAsync();
            return;
        }
        var config = new IsaThemeConfig { ThemeName = themeName };
        // Set theme colors...
        await themeLoader!.ApplyConfigAsync(config);
    }
}

Related learning

See the Custom Theme tutorial for a step-by-step walkthrough.