Zephora UI

主题

主题是编译为 --z-* CSS 自定义属性的纯 TypeScript 对象。切换主题会重写这些变量 — 即时生效，没有 CSS-in-JS，样式也没有重新渲染的开销。

现成主题

import { lightTheme, darkTheme, auraTheme, materialTheme } from "@zephora/theme";

createTheme

import { createTheme, lightTheme } from "@zephora/theme";

const brand = createTheme(lightTheme, {
  name: "brand",
  colors: {
    primary: "#0f766e",
    primaryHover: "#115e59",
    ring: "#14b8a6",
  },
  radius: "0.75rem",
});

作用域 vs 全局

// Scoped — wraps a subtree in a themed scope element
<ThemeProvider theme={brand}>...</ThemeProvider>

// Global — writes variables onto <html>, ideal for app-level switching
import { applyTheme } from "@zephora/theme";
applyTheme(brand);

CSS 层面的覆盖

组件直接读取变量，因此任何 CSS 规则都能为任意子树重新设置主题：

.marketing-section {
  --z-primary: #ea580c;
  --z-radius: 9999px;
}

深色模式

const [scheme, setScheme] = useState<"light" | "dark">("light");
<ThemeProvider theme={scheme === "dark" ? darkTheme : lightTheme} global>
  <App />
</ThemeProvider>