/** * @file TalentItemComp.ts * @description 驻场技能项组件(UI 视图层) * * 职责: * 1. 接收 TalentsComp 下发的 FieldSkillConfig 与当前场上总加成值。 * 2. 渲染名称 / 基础值 / 当前值 / 描述四段信息。 * 3. 兼容旧的 `@ecs.register('TalentItem')` 资源引用。 * * 依赖: * - SkillSet.FieldSkillConfig —— 单条驻场技能配置 */ import { _decorator, Label } from "cc"; import { ecs } from "../../../../extensions/oops-plugin-framework/assets/libs/ecs/ECS"; import { CCComp } from "../../../../extensions/oops-plugin-framework/assets/module/common/CCComp"; import { FieldSkillConfig } from "../common/config/SkillSet"; const { ccclass, property } = _decorator; /** * 将驻场配置值统一格式化为可读字符串。 * 兼容"小数"(0.1 表示 10%)与"整数百分点"(10 表示 10%)两种口径。 */ function formatBuffValue(value: number): string { if (Math.abs(value) < 1) { return `${(value * 100).toFixed(0)}%`; } return value.toString(); } /** TalentItemComp —— 驻场技能项组件 */ @ccclass('TalentItemComp') @ecs.register('TalentItem', false) export class TalentItemComp extends CCComp { @property({ type: Label, tooltip: "驻场技能名称" }) lbl_name: Label = null!; @property({ type: Label, tooltip: "基础值(来自配置)" }) lbl_base: Label = null!; @property({ type: Label, tooltip: "当前场上总加成(实时聚合)" }) lbl_current: Label = null!; @property({ type: Label, tooltip: "驻场技能描述" }) lbl_info: Label = null!; /** * 刷新单条驻场技能展示 * @param config FieldSkillSet 中的单条配置 * @param currentTotal 当前场上同 type 累加值(实时聚合) */ public updateItem(config: FieldSkillConfig, currentTotal: number): void { if (!config) return; if (this.lbl_name) this.lbl_name.string = config.name ?? ""; if (this.lbl_base) this.lbl_base.string = `基础 +${formatBuffValue(config.value)}`; if (this.lbl_current) this.lbl_current.string = `当前 +${formatBuffValue(currentTotal)}`; if (this.lbl_info) this.lbl_info.string = config.info ?? ""; } /** ECS 组件移除时销毁节点(CCComp 抽象方法实现) */ reset() { this.node.destroy(); } }