游戏客户端架构 / 系统课时

一套组件如何适配多种页面

一套组件如何适配多种页面

可复用组件最容易失败在“为了复用而塞满业务判断”:同一个卡片组件逐渐出现任务、背包、商店等页面分支。本节用数据接口统一输入,再用组合方式注入可选区域,让组件复用结构,而不是绑定具体业务。

学习目标

  • 用稳定的数据接口隔离组件与业务对象
  • 通过适配函数让不同页面的数据进入同一组件
  • 使用组合方式处理按钮、标签等页面差异,而不是堆叠条件分支

组件应该依赖展示模型

假设背包页面有 InventoryItem,任务页面有 Quest。如果通用卡片直接接收这两个业务类型,它很快就会出现 if inventory、if quest 一类判断。新增第三种页面时,组件还要继续修改。

更稳定的做法是先定义组件真正需要的数据,例如标题、副标题和图标,再由各页面负责把自己的业务对象转换成这个展示模型。组件因此只认识一份稳定接口。

多页面复用组件的适配与组合关系

用适配器统一不同业务数据

下面的 TypeScript 示例让背包物品和任务都转换为 CardViewModel。renderCard 完全不知道原始数据来自哪个页面。

ts
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), () => "[查看详情]"));

预期输出:

text
[icon-potion] 治疗药水 - 持有数量:8
[icon-ruins] 清理遗迹 - 进度:3/5 [查看详情]

这里的关键并不是 TypeScript 接口本身,而是依赖方向:页面知道业务对象和通用组件,通用组件只知道 CardViewModel,因此页面业务变化不会直接污染组件内部。

差异部分用组合而不是开关堆叠

有些页面差异无法用标题和副标题表示。例如商店卡片需要购买按钮,任务卡片需要进度标签,背包卡片可能显示数量角标。这些内容如果全部变成 showBuyButton、showProgress、showCount 等布尔参数,参数组合很快就会失控。

更合适的方式是保留稳定骨架,并开放少量明确的组合位置,例如 leading、trailing、footer 或 actions。不同页面只组装自己需要的子组件。React 的 children、Flutter 的 Widget 参数、Unity UI 中预制体子节点组合,本质上都可以采用这个思路。

避免把通用组件做成业务中心

复用组件不应该负责读取任务系统、背包管理器或商店服务,也不应该根据页面名称决定点击行为。否则组件虽然只有一份代码,却同时耦合了多个业务模块,修改任何一方都可能触发连锁影响。

页面层应完成数据获取、业务判断和事件绑定,再把展示数据与回调传给组件。组件只处理布局、样式、局部交互状态以及公开的展示接口。这样测试时也可以直接构造 CardViewModel,不必启动完整业务系统。

当两个页面只有视觉骨架相似时,复用骨架和基础样式即可,不必强求所有行为共享。真正健康的复用,是稳定接口加有限组合点,而不是制造一个能够识别所有业务类型的“万能组件”。

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

目录与阅读设置

阅读设置

17

记录一个想法

一套组件如何适配多种页面

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

登录哪都通