Kampf-UI Pattern A - Split-Panel-Implementierung
Diese Fertigkeit führt durch die Implementierung der Split-Panel-Kampf-Benutzeroberfläche, die das vertikale Theater-Modus-Layout in ein horizontales Konfrontationslayout umwandelt.
Architekturübersicht
┌───────────────────────────────────────────────────┐
│ ZUGANZEIGE │ PHASENPIPELINE │ MODIFIKATOREN │ ← PhaseHeader
├──────────────────┴───────┬───────────┴────────────┤
│ │ │
│ SPIELERPANEL │ GEGNERPANEL │ ← ConfrontationZone
│ (CharacterPanel) │ (CharacterPanel) │
│ │ │
├──────────────────────────┴────────────────────────┤
│ SCHNELLAKTIONEN (SEITE/UMSCHALTEN) │ HAUPTAKTIONEN │ ← ActionDock
└───────────────────────────────┴───────────────────┘
Komponentenhierarchie
Combat.tsx (Szenen-Orchestrator)
├── CombatLayout.tsx (CSS-Grid-Container)
│ ├── PhaseHeader.tsx (obere Statusleiste)
│ │ ├── TurnIndicator
│ │ ├── PhasePipeline
│ │ ├── SideActionCounter
│ │ └── ApproachModifier
│ │
│ ├── ConfrontationZone.tsx (Kampfbereich)
│ │ ├── CharacterPanel.tsx (Spielervariante)
│ │ │ ├── CharacterSprite
│ │ │ ├── IdentityBar
│ │ │ ├── ResourceBars (HP/CP)
│ │ │ └── BuffBar
│ │ │
│ │ ├── VSDivider.tsx (zentrales Emblem)
│ │ │
│ │ └── CharacterPanel.tsx (Gegnervariante)
│ │ ├── CharacterSprite
│ │ ├── IdentityBar (Name, Stufe, Element)
│ │ ├── HealthBar
│ │ ├── DefenseStats
│ │ └── BuffBar
│ │
│ └── ActionDock.tsx (Fertigkeitsleiste)
│ ├── QuickActionsSection
│ │ ├── QuickActionCard (SEITE-Fertigkeiten)
│ │ └── QuickActionCard (UMSCHALTEN-Fertigkeiten)
│ ├── MainActionsSection
│ │ └── MainActionCard (HAUPT-Fertigkeiten)
│ └── ControlButtons (Auto, Zug beenden)
│
└── FloatingTextLayer (z-50, unverändert)
Dateistruktur
src/components/combat/
├── index.ts # Barrel-Exporte
├── CombatLayout.tsx # Grid-Container
├── PhaseHeader.tsx # Obere Statusleiste
├── ConfrontationZone.tsx # Spieler vs. Gegner Bereich
├── CharacterPanel.tsx # Wiederverwendbare Charakteranzeige
├── VSDivider.tsx # Zentrales VS-Emblem
├── ActionDock.tsx # Untere Fertigkeitsleiste
├── QuickActionCard.tsx # Kompakte SEITE/UMSCHALTEN-Karte
└── MainActionCard.tsx # Große HAUPT-Fertigkeitenkarte
Implementierungs-Workflow
Schritt 1: Zielkomponente identifizieren
Frage den Benutzer, welche Komponente implementiert werden soll:
- CombatLayout - Beginne hier für eine neue Implementierung
- PhaseHeader - Obere Statusleiste
- ConfrontationZone - Kampfbereich mit beiden Panels
- CharacterPanel - Einzelne Charakteranzeige
- VSDivider - Zentrales Emblem und Effekte
- ActionDock - Untere Fertigkeitsleiste
- QuickActionCard - Kompakte Fertigkeitenkartenvariante
- MainActionCard - Große Fertigkeitenkartenvariante
Schritt 2: Komponentenreferenz laden
Basierend auf der Auswahl die entsprechende Referenz laden:
- Layout/Struktur: Siehe layout-specs.md
- Komponenten-Props: Siehe component-interfaces.md
- Styling-Anleitung: Siehe styling-tokens.md
- Animationsspezifikationen: Siehe animations.md
Schritt 3: Komponentencode generieren
Folge dem Komponentenvorlagenmuster:
import React from 'react';
import { cn } from '@/lib/utils'; // falls cn-Dienstprogramm verwendet wird
interface ComponentNameProps {
// Props aus component-interfaces.md
}
export const ComponentName: React.FC<ComponentNameProps> = ({
// destrukturierte Props
}) => {
return (
<div className={cn(
// Basisstile aus styling-tokens.md
// Bedingte Stile
)}>
{/* Komponenteninhalt */}
</div>
);
};
Schritt 4: In Combat.tsx einbinden
Nach der Komponentenerstellung:
- Aus
components/combat/index.tsexportieren - In
Combat.tsximportieren - Entsprechenden Abschnitt ersetzen
- Erforderliche Props aus vorhandenem Status übergeben
Schnellimplementierungsbefehle
Alle Dateien erstellen (Grundgerüst)
# Verzeichnis erstellen
mkdir -p src/components/combat
# Alle Komponentendateien erstellen
touch src/components/combat/{index,CombatLayout,PhaseHeader,ConfrontationZone,CharacterPanel,VSDivider,ActionDock,QuickActionCard,MainActionCard}.tsx
Barrel-Exportvorlage
// 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';
Props-Zuordnung aus vorhandenem Code
Von App.tsx → Combat.tsx (unverändert)
player: Player
enemy: Enemy
turnState: 'PLAYER' | 'ENEMY_TURN'
turnPhase: TurnPhaseState
combatState: CombatState
onUseSkill: (skill: Skill) => void
onPassTurn: () => void
onToggleAutoCombat: () => void
autoCombatEnabled: boolean
Combat.tsx → Neue Komponenten
// PhaseHeader
turnState, turnPhase, combatState.approach
// ConfrontationZone
player, enemy, playerStats, enemyStats
// CharacterPanel (Spieler)
character: player, stats: playerStats, variant: 'player'
// CharacterPanel (Gegner)
character: enemy, stats: enemyStats, variant: 'enemy'
// ActionDock
skills: player.skills, turnPhase, onUseSkill, onPassTurn
Migrationsstrategie
Phase 1: Layout-Grundlage
CombatLayout.tsxmit CSS Grid erstellen- Platzhalterkomponenten erstellen
- Feature-Flag in Combat.tsx hinzufügen
Phase 2: Komponentenextraktion
CharacterPanelimplementieren (aus PlayerHUD + CinematicViewscreen extrahieren)ActionDockimplementieren (aus Fertigkeitsrastern extrahieren)PhaseHeaderimplementieren (aus Inline-Anzeigen extrahieren)
Phase 3: Visuelle Überarbeitung
VSDividermit Effekten hinzufügen- Animationen implementieren
- Positionen der schwebenden Texte anpassen
Phase 4: Bereinigung
- Alten Theater-Modus-Code entfernen
- Feature-Flag entfernen
- Tests aktualisieren
Referenzdateien
- layout-specs.md - CSS-Grid-Struktur, responsive Haltepunkte
- component-interfaces.md - TypeScript-Schnittstellen für alle Komponenten
- styling-tokens.md - Farben, Abstände, Typografie-Token
- animations.md - Animations-Keyframes und Übergänge
Ausgabeformat
Generiere TypeScript-React-Komponenten mit:
- TypeScript-Schnittstelle für Props
- Tailwind CSS für Styling (passend zur vorhandenen Codebasis)
- Responsive Klassen (mobile Rückfall auf vertikal)
- Memoization wo angemessen (React.memo für Karten)
- Barrierefreiheitsattribute (aria-labels, Rollen)
Vorhandene Code-Referenzen
Bei der Implementierung auf diese vorhandenen Dateien verweisen:
| Neue Komponente | Referenz von |
|---|---|
| CharacterPanel (Spieler) | src/components/PlayerHUD.tsx |
| CharacterPanel (Gegner) | src/scenes/Combat.tsx Zeilen 113-305 |
| ActionDock | src/scenes/Combat.tsx Zeilen 308-607 |
| QuickActionCard | src/components/SkillCard.tsx |
| MainActionCard | src/components/SkillCard.tsx |
| PhaseHeader | src/scenes/Combat.tsx Zeilen 311-328 |