游戏客户端架构 / 系统课时
一套组件如何适配多种页面
一套组件如何适配多种页面
可复用组件最容易失败在“为了复用而塞满业务判断”:同一个卡片组件逐渐出现任务、背包、商店等页面分支。本节用数据接口统一输入,再用组合方式注入可选区域,让组件复用结构,而不是绑定具体业务。
学习目标
- 用稳定的数据接口隔离组件与业务对象
- 通过适配函数让不同页面的数据进入同一组件
- 使用组合方式处理按钮、标签等页面差异,而不是堆叠条件分支
组件应该依赖展示模型
假设背包页面有 InventoryItem,任务页面有 Quest。如果通用卡片直接接收这两个业务类型,它很快就会出现 if inventory、if quest 一类判断。新增第三种页面时,组件还要继续修改。
更稳定的做法是先定义组件真正需要的数据,例如标题、副标题和图标,再由各页面负责把自己的业务对象转换成这个展示模型。组件因此只认识一份稳定接口。

用适配器统一不同业务数据
下面的 TypeScript 示例让背包物品和任务都转换为 CardViewModel。renderCard 完全不知道原始数据来自哪个页面。
interface CardViewModel {
title: string;
subtitle: string;
icon: string;
}
interface InventoryItem {
name: string;
count: number;
iconId: string;
}
interface Quest {
name: string;
progress: number;
target: number;
iconId: string;
}
type ExtraContent = (model: CardViewModel) => string;
function inventoryToCard(item: InventoryItem): CardViewModel {
return {
title: item.name,
subtitle: `持有数量:${item.count}`,
icon: item.iconId
};
}
function questToCard(quest: Quest): CardViewModel {
return {
title: quest.name,
subtitle: `进度:${quest.progress}/${quest.target}`,
icon: quest.iconId
};
}
function renderCard(model: CardViewModel, extra?: ExtraContent): string {
// 通用部分保持固定,可变业务区域通过组合函数注入。
const base = `[${model.icon}] ${model.title} - ${model.subtitle}`;
return extra ? `${base} ${extra(model)}` : base;
}
const potion: InventoryItem = {
name: "治疗药水",
count: 8,
iconId: "icon-potion"
};
const quest: Quest = {
name: "清理遗迹",
progress: 3,
target: 5,
iconId: "icon-ruins"
};
console.log(renderCard(inventoryToCard(potion)));
console.log(renderCard(questToCard(quest), () => "[查看详情]"));预期输出:
[icon-potion] 治疗药水 - 持有数量:8
[icon-ruins] 清理遗迹 - 进度:3/5 [查看详情]这里的关键并不是 TypeScript 接口本身,而是依赖方向:页面知道业务对象和通用组件,通用组件只知道 CardViewModel,因此页面业务变化不会直接污染组件内部。
差异部分用组合而不是开关堆叠
有些页面差异无法用标题和副标题表示。例如商店卡片需要购买按钮,任务卡片需要进度标签,背包卡片可能显示数量角标。这些内容如果全部变成 showBuyButton、showProgress、showCount 等布尔参数,参数组合很快就会失控。
更合适的方式是保留稳定骨架,并开放少量明确的组合位置,例如 leading、trailing、footer 或 actions。不同页面只组装自己需要的子组件。React 的 children、Flutter 的 Widget 参数、Unity UI 中预制体子节点组合,本质上都可以采用这个思路。
避免把通用组件做成业务中心
复用组件不应该负责读取任务系统、背包管理器或商店服务,也不应该根据页面名称决定点击行为。否则组件虽然只有一份代码,却同时耦合了多个业务模块,修改任何一方都可能触发连锁影响。
页面层应完成数据获取、业务判断和事件绑定,再把展示数据与回调传给组件。组件只处理布局、样式、局部交互状态以及公开的展示接口。这样测试时也可以直接构造 CardViewModel,不必启动完整业务系统。
当两个页面只有视觉骨架相似时,复用骨架和基础样式即可,不必强求所有行为共享。真正健康的复用,是稳定接口加有限组合点,而不是制造一个能够识别所有业务类型的“万能组件”。