战斗UI模式A - 分屏实现
此技能指导实现分屏战斗UI,将垂直剧场模式转变为横向对峙布局。
架构概览
┌───────────────────────────────────────────────────┐
│ 回合指示器 │ 阶段管道 │ 修正器 │ ← PhaseHeader
├──────────────────┴───────┬───────────┴────────────┤
│ │ │
│ 玩家面板 │ 敌人面板 │ ← ConfrontationZone
│ (CharacterPanel) │ (CharacterPanel) │
│ │ │
├──────────────────────────┴────────────────────────┤
│ 快速行动(侧边/切换) │ 主要行动 │ ← ActionDock
└───────────────────────────────┴───────────────────┘
组件层级
Combat.tsx (场景编排器)
├── CombatLayout.tsx (CSS网格容器)
│ ├── PhaseHeader.tsx (顶部状态栏)
│ │ ├── TurnIndicator
│ │ ├── PhasePipeline
│ │ ├── SideActionCounter
│ │ └── ApproachModifier
│ │
│ ├── ConfrontationZone.tsx (战斗区域)
│ │ ├── CharacterPanel.tsx (玩家变体)
│ │ │ ├── CharacterSprite
│ │ │ ├── IdentityBar
│ │ │ ├── ResourceBars (HP/CP)
│ │ │ └── BuffBar
│ │ │
│ │ ├── VSDivider.tsx (中央徽章)
│ │ │
│ │ └── CharacterPanel.tsx (敌人变体)
│ │ ├── CharacterSprite
│ │ ├── IdentityBar (名称、等级、元素)
│ │ ├── HealthBar
│ │ ├── DefenseStats
│ │ └── BuffBar
│ │
│ └── ActionDock.tsx (技能栏)
│ ├── QuickActionsSection
│ │ ├── QuickActionCard (SIDE技能)
│ │ └── QuickActionCard (TOGGLE技能)
│ ├── MainActionsSection
│ │ └── MainActionCard (MAIN技能)
│ └── ControlButtons (自动、结束回合)
│
└── FloatingTextLayer (z-50, 保持不变)
文件结构
src/components/combat/
├── index.ts # 桶导出
├── CombatLayout.tsx # 网格容器
├── PhaseHeader.tsx # 顶部状态栏
├── ConfrontationZone.tsx # 玩家 vs 敌人区域
├── CharacterPanel.tsx # 可复用的角色显示
├── VSDivider.tsx # 中央VS徽章
├── ActionDock.tsx # 底部技能栏
├── QuickActionCard.tsx # 紧凑的SIDE/TOGGLE卡片
└── MainActionCard.tsx # 大型MAIN技能卡片
实施工作流
步骤1:识别目标组件
询问用户要实现哪个组件:
- CombatLayout - 新实现从此开始
- PhaseHeader - 顶部状态栏
- ConfrontationZone - 包含两个面板的战斗区域
- CharacterPanel - 单个角色显示
- VSDivider - 中央徽章和效果
- ActionDock - 底部技能栏
- QuickActionCard - 紧凑技能卡片变体
- MainActionCard - 大型技能卡片变体
步骤2:加载组件参考
根据选择加载相应的参考:
- 布局/结构:见 layout-specs.md
- 组件属性:见 component-interfaces.md
- 样式指南:见 styling-tokens.md
- 动画规格:见 animations.md
步骤3:生成组件代码
遵循组件模板模式:
import React from 'react';
import { cn } from '@/lib/utils'; // 如果使用cn工具函数
interface ComponentNameProps {
// 来自 component-interfaces.md 的属性
}
export const ComponentName: React.FC<ComponentNameProps> = ({
// 解构的属性
}) => {
return (
<div className={cn(
// 来自 styling-tokens.md 的基础样式
// 条件样式
)}>
{/* 组件内容 */}
</div>
);
};
步骤4:接入Combat.tsx
组件创建后:
- 从
components/combat/index.ts导出 - 在
Combat.tsx中导入 - 替换相应部分
- 从现有状态传递所需的属性
快速实施命令
创建所有文件(脚手架)
# 创建目录
mkdir -p src/components/combat
# 创建所有组件文件
touch src/components/combat/{index,CombatLayout,PhaseHeader,ConfrontationZone,CharacterPanel,VSDivider,ActionDock,QuickActionCard,MainActionCard}.tsx
桶导出模板
// src/components/combat/index.ts
export { CombatLayout } from './CombatLayout';
export { PhaseHeader } from './PhaseHeader';
export { ConfrontationZone } from './ConfrontationZone';
export { CharacterPanel } from './CharacterPanel';
export { VSDivider } from './VSDivider';
export { ActionDock } from './ActionDock';
export { QuickActionCard } from './QuickActionCard';
export { MainActionCard } from './MainActionCard';
来自现有代码的属性映射
从 App.tsx → Combat.tsx(不变)
player: Player
enemy: Enemy
turnState: 'PLAYER' | 'ENEMY_TURN'
turnPhase: TurnPhaseState
combatState: CombatState
onUseSkill: (skill: Skill) => void
onPassTurn: () => void
onToggleAutoCombat: () => void
autoCombatEnabled: boolean
Combat.tsx → 新组件
// PhaseHeader
turnState, turnPhase, combatState.approach
// ConfrontationZone
player, enemy, playerStats, enemyStats
// CharacterPanel (玩家)
character: player, stats: playerStats, variant: 'player'
// CharacterPanel (敌人)
character: enemy, stats: enemyStats, variant: 'enemy'
// ActionDock
skills: player.skills, turnPhase, onUseSkill, onPassTurn
迁移策略
阶段1:布局基础
- 创建
CombatLayout.tsx,使用CSS网格 - 创建占位组件
- 在 Combat.tsx 中添加功能标志
阶段2:组件提取
- 实现
CharacterPanel(从 PlayerHUD + CinematicViewscreen 提取) - 实现
ActionDock(从技能网格提取) - 实现
PhaseHeader(从内联指示器提取)
阶段3:视觉优化
- 添加带效果的
VSDivider - 实现动画
- 调整浮动文本位置
阶段4:清理
- 移除旧剧场模式代码
- 移除功能标志
- 更新测试
参考文件
- layout-specs.md - CSS网格结构、响应式断点
- component-interfaces.md - 所有组件的TypeScript接口
- styling-tokens.md - 颜色、间距、排版标记
- animations.md - 动画关键帧和过渡
输出格式
生成TypeScript React组件,包含:
- TypeScript接口定义属性
- Tailwind CSS用于样式(匹配现有代码库)
- 响应式类(移动端回退为垂直布局)
- 记忆化(对卡片使用 React.memo)
- 可访问性属性(aria-label、role)
现有代码参考
实现时,参考这些现有文件:
| 新组件 | 参考来源 |
|---|---|
| CharacterPanel (玩家) | src/components/PlayerHUD.tsx |
| CharacterPanel (敌人) | src/scenes/Combat.tsx 第113-305行 |
| ActionDock | src/scenes/Combat.tsx 第308-607行 |
| QuickActionCard | src/components/SkillCard.tsx |
| MainActionCard | src/components/SkillCard.tsx |
| PhaseHeader | src/scenes/Combat.tsx 第311-328行 |