- system_settings 新增 AppearanceSettings(default_theme),默认为 light, 对应 GET /api/system-settings/appearance(任何人可读)+ PUT(admin 可写) - App.tsx 把 NextThemesProvider 的 defaultTheme 从 dark 改为 light,并把 QueryClientProvider 提到 ThemeProvider 外层以便后者使用 useQuery - ThemeContext 新增 localStorage 标志 strategy-theme-user-set:用户调用 toggleTheme / setTheme 时打标;每次启动若标志未设,则跟随 admin 配置的 default_theme 同步主题,admin 改动用户刷新即生效;标志一旦存在永远尊重 用户个人选择 - legacy 'theme' 键迁移视为用户显式选择,避免老用户被新默认覆盖 - frontend system-settings api/hook 增 appearance 拉取与更新 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
227 lines
6.4 KiB
TypeScript
227 lines
6.4 KiB
TypeScript
import React, {
|
|
createContext,
|
|
useContext,
|
|
useEffect,
|
|
useState,
|
|
type ReactNode,
|
|
} from 'react';
|
|
import { useTheme as useNextTheme } from 'next-themes';
|
|
|
|
import { useAppearanceSettings } from '@/core/system-settings/hooks';
|
|
|
|
// 主题类型
|
|
export type ThemeType = 'dark' | 'light';
|
|
|
|
// 主题配置
|
|
export interface ThemeConfig {
|
|
type: ThemeType;
|
|
name: string;
|
|
colors: {
|
|
background: string;
|
|
backgroundSecondary: string;
|
|
text: string;
|
|
textSecondary: string;
|
|
primary: string;
|
|
primaryHover: string;
|
|
border: string;
|
|
accent: string;
|
|
success: string;
|
|
warning: string;
|
|
error: string;
|
|
card: string;
|
|
cardHover: string;
|
|
input: string;
|
|
inputBorder: string;
|
|
overlay: string;
|
|
};
|
|
}
|
|
|
|
// 主题配置
|
|
const themes: Record<ThemeType, ThemeConfig> = {
|
|
dark: {
|
|
type: 'dark',
|
|
name: '深色主题',
|
|
colors: {
|
|
background: 'slate-900',
|
|
backgroundSecondary: 'slate-800',
|
|
text: 'white',
|
|
textSecondary: 'slate-400',
|
|
primary: 'blue-500',
|
|
primaryHover: 'blue-400',
|
|
border: 'slate-700',
|
|
accent: 'blue-600',
|
|
success: 'emerald-500',
|
|
warning: 'amber-500',
|
|
error: 'rose-500',
|
|
card: 'slate-800',
|
|
cardHover: 'slate-700',
|
|
input: 'slate-800',
|
|
inputBorder: 'slate-600',
|
|
overlay: 'slate-900/80',
|
|
},
|
|
},
|
|
light: {
|
|
type: 'light',
|
|
name: '红白主题',
|
|
colors: {
|
|
background: 'white',
|
|
backgroundSecondary: 'red-50',
|
|
text: 'gray-900',
|
|
textSecondary: 'gray-600',
|
|
primary: 'red-600',
|
|
primaryHover: 'red-500',
|
|
border: 'red-200',
|
|
accent: 'red-700',
|
|
success: 'green-600',
|
|
warning: 'amber-500',
|
|
error: 'red-600',
|
|
card: 'white',
|
|
cardHover: 'red-50',
|
|
input: 'white',
|
|
inputBorder: 'red-200',
|
|
overlay: 'black/30',
|
|
},
|
|
},
|
|
};
|
|
|
|
const STORAGE_KEY = 'strategy-theme';
|
|
// Marker that the user has explicitly toggled the theme (via the appearance
|
|
// settings page or any future toggle UI). When this flag is absent we treat
|
|
// any value stored in ``strategy-theme`` as one we put there ourselves while
|
|
// syncing the admin's default — so we'll re-sync on every boot, picking up
|
|
// admin changes. When the flag is present we never override the user.
|
|
const EXPLICIT_FLAG_KEY = 'strategy-theme-user-set';
|
|
|
|
function readPersistedTheme(): ThemeType {
|
|
if (typeof window === 'undefined') {
|
|
return 'light';
|
|
}
|
|
const saved = localStorage.getItem(STORAGE_KEY);
|
|
return saved === 'dark' ? 'dark' : 'light';
|
|
}
|
|
|
|
function hasExplicitChoice(): boolean {
|
|
if (typeof window === 'undefined') return false;
|
|
return localStorage.getItem(EXPLICIT_FLAG_KEY) === '1';
|
|
}
|
|
|
|
function markExplicitChoice(): void {
|
|
if (typeof window === 'undefined') return;
|
|
localStorage.setItem(EXPLICIT_FLAG_KEY, '1');
|
|
}
|
|
|
|
// 主题上下文
|
|
interface ThemeContextType {
|
|
theme: ThemeType;
|
|
themeConfig: ThemeConfig;
|
|
toggleTheme: () => void;
|
|
setTheme: (theme: ThemeType) => void;
|
|
/** next-themes 完成挂载前为 false,避免 hydration 与 DOM 不同步 */
|
|
mounted: boolean;
|
|
}
|
|
|
|
const ThemeContext = createContext<ThemeContextType | undefined>(undefined);
|
|
|
|
// 主题提供者
|
|
interface ThemeProviderProps {
|
|
children: ReactNode;
|
|
}
|
|
|
|
export const ThemeProvider: React.FC<ThemeProviderProps> = ({ children }) => {
|
|
const { resolvedTheme, setTheme: setNextTheme } = useNextTheme();
|
|
const [mounted, setMounted] = useState(false);
|
|
// Admin-configured global default. If the user hasn't explicitly chosen
|
|
// a theme yet, this value drives the rendered theme — and re-syncs on
|
|
// every mount so an admin change propagates without users clearing
|
|
// localStorage by hand.
|
|
const { data: appearance } = useAppearanceSettings();
|
|
|
|
useEffect(() => {
|
|
setMounted(true);
|
|
}, []);
|
|
|
|
// 迁移 / 规范化 localStorage:去掉旧的 'theme' 键,并清掉一切非法值。
|
|
// 注意:不要在这里强制写入一个 fallback —— 那会让 next-themes 视作
|
|
// 「用户已选过」,admin 默认就再也注入不进来了。
|
|
useEffect(() => {
|
|
if (!mounted) return;
|
|
const current = localStorage.getItem(STORAGE_KEY);
|
|
const legacy = localStorage.getItem('theme');
|
|
|
|
if (current && current !== 'light' && current !== 'dark') {
|
|
// Garbage value — wipe it so the boot-sync below can take over.
|
|
localStorage.removeItem(STORAGE_KEY);
|
|
}
|
|
if (!current && legacy && (legacy === 'light' || legacy === 'dark')) {
|
|
// Migrate the legacy key as the user's explicit choice (it was set
|
|
// long enough ago that we should preserve their pick rather than
|
|
// override with admin default).
|
|
setNextTheme(legacy);
|
|
markExplicitChoice();
|
|
}
|
|
if (legacy) {
|
|
localStorage.removeItem('theme');
|
|
}
|
|
}, [mounted, setNextTheme]);
|
|
|
|
// Boot-time sync: when the user has never picked a theme themselves,
|
|
// apply whatever the admin configured. Re-runs whenever the admin
|
|
// setting changes (so a logged-in user sees the new default after
|
|
// refreshing without having to clear cookies).
|
|
useEffect(() => {
|
|
if (!mounted) return;
|
|
if (hasExplicitChoice()) return;
|
|
const adminDefault = appearance?.default_theme;
|
|
if (!adminDefault) return;
|
|
if (resolvedTheme !== adminDefault) {
|
|
setNextTheme(adminDefault);
|
|
}
|
|
}, [mounted, appearance?.default_theme, resolvedTheme, setNextTheme]);
|
|
|
|
const theme: ThemeType = mounted
|
|
? resolvedTheme === 'dark'
|
|
? 'dark'
|
|
: 'light'
|
|
: readPersistedTheme();
|
|
|
|
const toggleTheme = () => {
|
|
setNextTheme(theme === 'dark' ? 'light' : 'dark');
|
|
markExplicitChoice();
|
|
};
|
|
|
|
const setTheme = (newTheme: ThemeType) => {
|
|
setNextTheme(newTheme);
|
|
markExplicitChoice();
|
|
};
|
|
|
|
const themeConfig = themes[theme];
|
|
|
|
return (
|
|
<ThemeContext.Provider
|
|
value={{ theme, themeConfig, toggleTheme, setTheme, mounted }}
|
|
>
|
|
{children}
|
|
</ThemeContext.Provider>
|
|
);
|
|
};
|
|
|
|
// 使用主题的 Hook
|
|
export const useTheme = (): ThemeContextType => {
|
|
const context = useContext(ThemeContext);
|
|
if (!context) {
|
|
throw new Error('useTheme must be used within a ThemeProvider');
|
|
}
|
|
return context;
|
|
};
|
|
|
|
// 主题工具函数 - 生成动态类名
|
|
export const getThemeClasses = (colorKey: keyof ThemeConfig['colors']): string => {
|
|
const { themeConfig } = useTheme();
|
|
return themeConfig.colors[colorKey];
|
|
};
|
|
|
|
// 组合类名工具函数
|
|
export const cn = (...classes: (string | undefined | null | false)[]): string => {
|
|
return classes.filter(Boolean).join(' ');
|
|
};
|