UI 视觉设计 / 系统课时

复用多品牌主题的组件逻辑

复用多品牌主题的组件逻辑

同一套 Button 在两个品牌下通常只需换颜色,不该复制两份 React 组件。这里把品牌差异放进 Figma 语义变量和 CSS 自定义属性,保留共同的点击、禁用、悬停及键盘焦点行为,最终用一个下拉框验证切换效果。

学习目标

  • 在 Figma 中用品牌模式覆盖相同的语义变量。
  • 让 React 组件只依赖语义令牌,不读取品牌名称。
  • 验证品牌切换后外观改变、交互行为不变。

用语义变量约束品牌差异

在 Figma 的变量集合中建立 Ocean 和 Forest 两个 Mode。Button 的填充应引用 color/action/primary,不要直接绑定 blue/700,更不要为两个品牌各建一个 Button 组件集。导出时把相同语义路径映射为同名 CSS 变量,按品牌覆盖取值。

语义路径 CSS 名称 Ocean 海蓝 Forest 松绿
color.action.primary --action-bg #1D4ED8 #0F766E
color.action.primaryHover --action-bg-hover #1E40AF #115E59
color.text.onAction --action-fg #FFFFFF #FFFFFF
color.focus.ring --focus-ring #1E40AF #115E59
color.surface.canvas --surface-bg #EFF6FF #ECFDF5

这里的路径是项目自定命名,不是 Figma 内置字段。原始品牌色可以在基础变量层不同,但 Button 只读取上表五个语义入口;因此以后新增第三个品牌,只需补一组取值。

多品牌语义令牌到共享按钮的依赖关系

建立共享的 React 组件

准备满足当前 Vite 要求的 Node.js 和 npm,创建 React + TypeScript 项目。首次运行时若 npm 询问是否安装脚手架工具,确认即可。

bash
npm create vite@latest brand-demo -- --template react-ts
cd brand-demo
npm install

预期结果:生成 src/App.tsx、src/index.css、src/main.tsx,依赖安装完成。保留模板自带的 src/main.tsx 作为应用入口,用下面的代码替换 src/App.tsx:

tsx
import { useState, type ReactNode } from 'react';

type Brand = 'ocean' | 'forest';

function BrandButton({ children, disabled = false, onClick }: {
  children: ReactNode;
  disabled?: boolean;
  onClick?: () => void;
}) {
  // 行为只由 Props 决定,不分支判断品牌。
  return <button type="button" className="brand-button" disabled={disabled} onClick={onClick}>
    {children}
  </button>;
}

export default function App() {
  const [brand, setBrand] = useState<Brand>('ocean');
  const [status, setStatus] = useState('未提交');

  return (
    <main className="demo" data-brand={brand}>
      <label htmlFor="brand">当前品牌</label>
      <select id="brand" value={brand} onChange={(event) => {
        const next = event.currentTarget.value;
        if (next === 'ocean' || next === 'forest') setBrand(next);
      }}>
        <option value="ocean">Ocean 海蓝</option>
        <option value="forest">Forest 松绿</option>
      </select>
      <BrandButton onClick={() => setStatus('已提交')}>提交订单</BrandButton>
      <BrandButton disabled onClick={() => setStatus('不应触发')}>暂不可提交</BrandButton>
      <p role="status">{status}</p>
    </main>
  );
}

预期页面行为:切换 brand 只改变容器属性;两种品牌点“提交订单”都会显示“已提交”。禁用按钮不能触发回调,组件也不读取品牌名称。

用 CSS 作用域覆盖颜色

用下面的内容替换 src/index.css。模板的 src/main.tsx 已导入此文件,不需要再从 App.tsx 引入样式。两个品牌必须定义完全相同的变量名,Button 的样式选择器只写一遍。

css
:root { font-family: system-ui, sans-serif; }
* { box-sizing: border-box; }
body { margin: 0; }

.demo {
  min-height: 100vh;
  padding: 32px;
  display: flex;
  flex-direction: column;
  align-items: flex-start;
  gap: 16px;
  background: var(--surface-bg);
}
.demo[data-brand="ocean"] {
  --action-bg: #1D4ED8;
  --action-bg-hover: #1E40AF;
  --action-fg: #FFFFFF;
  --focus-ring: #1E40AF;
  --surface-bg: #EFF6FF;
}
.demo[data-brand="forest"] {
  --action-bg: #0F766E;
  --action-bg-hover: #115E59;
  --action-fg: #FFFFFF;
  --focus-ring: #115E59;
  --surface-bg: #ECFDF5;
}
.brand-button {
  border: 0;
  border-radius: 8px;
  padding: 10px 16px;
  background: var(--action-bg);
  color: var(--action-fg);
  font: inherit;
  cursor: pointer;
}
/* 交互规则共享;颜色由当前品牌作用域提供。 */
.brand-button:hover:not(:disabled) {
  background: var(--action-bg-hover);
}
.brand-button:focus-visible {
  outline: 3px solid var(--focus-ring);
  outline-offset: 3px;
}
.brand-button:disabled {
  opacity: 0.55;
  cursor: not-allowed;
}

生效行为:Ocean 下正常按钮为 #1D4ED8,Forest 下为 #0F766E;悬停使用对应深色,按 Tab 聚焦时出现 3px 描边。CSS 自定义属性会向后代继承,因此不需要把颜色逐层传成 React Props。

运行与验收

替换好文件后,在项目目录执行:

bash
npm run dev

预期输出(节选,实际端口和启动耗时会不同):

text
Local: http://localhost:<PORT>/

在终端显示的本地地址打开页面,逐项检查:

  1. 下拉框由 Ocean 改为 Forest,页面底色和正常按钮随之变化;按钮文案、DOM 结构及 disabled 状态不变。
  2. 两种品牌点“提交订单”都得到“已提交”,禁用按钮不会把状态改为“不应触发”;悬停正常按钮则分别使用自己的 --action-bg-hover。
  3. 使用 Tab 聚焦正常按钮,检查描边是否可见;再用浏览器开发者工具查看按钮计算后的 background-color,对应两种模式应分别解析为 rgb(29, 78, 216) 与 rgb(15, 118, 110)。

避免把品牌做成逻辑分叉

错误做法是在 BrandButton 中写 brand === 'ocean' ? '#1D4ED8' : '#0F766E',以后每添一个品牌,都要修改组件并重新测试所有交互状态。正确做法是保持语义令牌名称固定,只在新品牌作用域增加覆盖值;只有确实不同的业务行为才用 Props 表达。

还要区分品牌和明暗主题:品牌决定识别色,light/dark 决定背景与文本亮度,两者可分别使用 data-brand 和 data-theme。若 Dialog 或下拉浮层经 React Portal 挂到作用域之外,它不会继承 .demo 的变量;正式项目应把品牌属性放到包含浮层宿主的共同祖先(如 html),并为默认品牌提供回退值,避免未初始化时出现无色按钮。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

复用多品牌主题的组件逻辑

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通