跳转到内容

SusStatusEffect

SusStatusEffect

增益 / 减益 chip——带可选叠加层数、倍率、剩余回合的图标;mini/normal 状态下带 tooltip。

SusGame · HUD(商业)

在 Playground 中打开

SusGame · HUD

属性

名称类型默认值
SizeProp<string>"normal"
IconProp<string>""
TitleProp<string>""
DescriptionProp<string>""
StacksProp<int>1
MultiplyProp<float>1f
TurnsLeftProp<int>0
IsDebuffProp<bool>false

插槽

没有插槽。

事件

名称字段载荷
ClickedOnClicked

样式钩子

USS 类契约 — 无需改 C# 即可覆盖外观。状态通过这些类切换:

  • sus-status-effect
  • sus-status-effect__desc
  • sus-status-effect__icon
  • sus-status-effect__meta
  • sus-status-effect__multiply
  • sus-status-effect__stacks
  • sus-status-effect__title
  • sus-status-effect__turns
  • sus-status-effect--buff
  • sus-status-effect--debuff
  • sus-status-effect--large
  • sus-status-effect--mini
  • sus-status-effect--normal
  • sus-status-effect-host

用法

csharp
var fx = new SusStatusEffect();
fx.Size.Value = "normal"; // mini | normal | large
fx.ApplyData(new SusStatusEffectData
{
    Id = "regen",
    Icon = "heart",
    Title = "Regen",
    Description = "Restore HP each turn",
    Stacks = 2,
    Multiply = 1f,
    TurnsLeft = 3,
    IsDebuff = false,
});
fx.OnClicked += () => { /* open detail */ };
xml
<template>
  <sus:SusStatusEffect :Size="Size.Value"
                       :Icon="Icon.Value"
                       :Title="Title.Value"
                       :Description="Desc.Value"
                       :Stacks="Stacks.Value"
                       :Multiply="Mul.Value"
                       :TurnsLeft="Turns.Value"
                       :IsDebuff="Debuff.Value"
                       @clicked="OnClicked" />
</template>

<script>
public Prop<string> Size = new("normal");
public Prop<string> Icon = new("heart");
public Prop<string> Title = new("Regen");
public Prop<string> Desc = new("Restore HP each turn");
public Prop<int> Stacks = new(2);
public Prop<float> Mul = new(1f);
public Prop<int> Turns = new(3);
public Prop<bool> Debuff = new(false);
void OnClicked() { /* … */ }
</script>
Prop / APIRole
Sizemini(仅图标)· normal(含元信息)· large(标题+描述,关闭 tooltip)
Icon · Title · Description视觉内容 + tooltip 文案
Stacks> 1 时显示 xN 徽标(mini 下隐藏)
Multiply不等于 0/1 时显示 ×N(仅 normal)
TurnsLeft> 0 时显示 Nt
IsDebuff切换 debuff / buff 的外框与图标颜色
ApplyData(SusStatusEffectData)批量设置字段
OnClicked点击 chip 主体

备注

  • 基于 kit 的 SusTooltip + SusIcon 构建——主题 token 从 SusKit 级联而来。
  • 通常由 unit card / rail 通过 SetEffects 持有实例;也可独立用于 inspector 或大尺寸详情展示。
  • 紧凑的纯图标托盘参见 SusBuffTray