雨霖铃
d38bafe237
移除 chrome.i18n 后，将各功能页面、布局与工具模块的 UI 文案改为内联中文； 删除冗余注释与过度抽象（如 ToolCard、StatCard），精简 props 与状态管理； 同步优化 JsonTools、StorageCleaner、Timestamp、TestDataGenerator、Dashboard、 Base64Converter、RightClickRestorer、TextStatistics、TopBar、RouterProvider、 ThemeModeProvider 及生成器库与 utils 工具文件。
51 lines
1.7 KiB
TypeScript
51 lines
1.7 KiB
TypeScript
export type ThemeMode = 'light' | 'dark' | 'system';
|
|
export type ResolvedThemeMode = 'light' | 'dark';
|
|
|
|
export const THEME_MODE_STORAGE_KEY = 'app/themeMode' as const;
|
|
export const THEME_MODE_SNAPSHOT_KEY = 'snapshot/app/themeMode';
|
|
|
|
const VALID_MODES: ThemeMode[] = ['light', 'dark', 'system'];
|
|
|
|
export const isValidThemeMode = (value: unknown): value is ThemeMode =>
|
|
VALID_MODES.includes(value as ThemeMode);
|
|
|
|
/**
|
|
* 同步读取 localStorage 快照（首屏防闪烁）
|
|
*/
|
|
export const getThemeSyncSnapshot = (): ThemeMode => {
|
|
try {
|
|
const raw = localStorage.getItem(THEME_MODE_SNAPSHOT_KEY);
|
|
if (!raw) return 'system';
|
|
const parsed = JSON.parse(raw) as unknown;
|
|
return isValidThemeMode(parsed) ? parsed : 'system';
|
|
} catch {
|
|
return 'system';
|
|
}
|
|
};
|
|
|
|
export const getSystemThemeMode = (): ResolvedThemeMode => {
|
|
if (typeof window === 'undefined') return 'light';
|
|
return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
|
|
};
|
|
|
|
export const resolveThemeMode = (mode: ThemeMode): ResolvedThemeMode =>
|
|
mode === 'system' ? getSystemThemeMode() : mode;
|
|
|
|
export const persistThemeModeSnapshot = (mode: ThemeMode): void => {
|
|
try {
|
|
localStorage.setItem(THEME_MODE_SNAPSHOT_KEY, JSON.stringify(mode));
|
|
} catch (error) {
|
|
console.error('保存主题快照失败:', error);
|
|
}
|
|
};
|
|
|
|
export const applyResolvedThemeClass = (resolved: ResolvedThemeMode): void => {
|
|
if (typeof document === 'undefined') return;
|
|
document.documentElement.classList.toggle('dark', resolved === 'dark');
|
|
};
|
|
|
|
/** 在 React 挂载前同步应用快照主题，避免首帧闪烁 */
|
|
export const applyThemeFromSnapshot = (): void => {
|
|
applyResolvedThemeClass(resolveThemeMode(getThemeSyncSnapshot()));
|
|
};
|