主题色切换

本文介绍 EasyAdminBlazor 的主题色切换能力:5 种预置主色、即时生效、自动记忆。

功能概述

  • 5 种预置主色:默认蓝、清新绿、典雅紫、活力橙、中国红。
  • 即时生效:切换主色后按钮、菜单、标签页、表单焦点等组件颜色立即跟随变化。
  • 自动记忆:选择结果保存在浏览器本地(localStorage),下次打开仍是上次的颜色。
  • 可配置默认色:通过 EasyAdminBlazorOptions.DefaultThemeColor 指定默认主色(支持预置颜色名或十六进制色值)。
  • 登录页同步:后台切换过的主题色在登录页同样生效。

使用方法

1. 切换主题色

登录后台后,在顶部工具栏打开主题色面板,选择想要的主色即可。

2. 配置默认主色

builder.AddEasyAdminBlazor(new EasyAdminBlazorOptions
{
    // 预置颜色名或十六进制色值,例如 "#fd7e14"
    DefaultThemeColor = "#fd7e14"
});

3. 持久化说明

用户选择保存在浏览器 localStorage,按浏览器/设备生效;服务端只提供默认值。

界面说明

  • 主题色面板:位于后台顶部工具栏,展示预置色板。
  • 跟随范围:按钮、链接、菜单选中态、标签页、表单焦点等主色相关组件。

常见问题

换了主色但页面没变?

清一下浏览器缓存或换个无痕窗口试试;DefaultThemeColor 只在用户本地没有保存过选择时生效。

想在客户项目里换品牌色?

直接在 DefaultThemeColor 配置客户品牌色即可,无需改组件样式。