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 询问是否安装脚手架工具,确认即可。
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:
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 的样式选择器只写一遍。
: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。
运行与验收
替换好文件后,在项目目录执行:
npm run dev预期输出(节选,实际端口和启动耗时会不同):
Local: http://localhost:<PORT>/在终端显示的本地地址打开页面,逐项检查:
- 下拉框由 Ocean 改为 Forest,页面底色和正常按钮随之变化;按钮文案、DOM 结构及
disabled状态不变。 - 两种品牌点“提交订单”都得到“已提交”,禁用按钮不会把状态改为“不应触发”;悬停正常按钮则分别使用自己的
--action-bg-hover。 - 使用 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),并为默认品牌提供回退值,避免未初始化时出现无色按钮。