SusHudRoot

全屏 HUD 外壳——七个绝对定位区域（top / tl / tr / center / bl / br / bottom）用于承载 chrome 模块。

包

SusGame · HUD（商业）

在 Playground 中打开

SusGame · HUD

属性

名称	类型	默认值
Dimmed	Prop<bool>	false

插槽

名称
top
tl
tr
center
l
r
bl
br
bottom

事件

没有公开事件。

样式钩子

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

• sus-hud-root
• sus-hud-root__ability-scroll
• sus-hud-root__bottom-chrome
• sus-hud-root__bottom-chrome-center
• sus-hud-root__bottom-chrome-left
• sus-hud-root__bottom-chrome-right
• sus-hud-root__zone
• sus-hud-root__zone--bl
• sus-hud-root__zone--bottom
• sus-hud-root__zone--br
• sus-hud-root__zone--center
• sus-hud-root__zone--l
• sus-hud-root__zone--r
• sus-hud-root__zone--tl
• sus-hud-root__zone--top
• sus-hud-root__zone--tr
• sus-hud-root--dim
• sus-scroll
• sus-slot

用法

通过 XML 中的具名插槽组合，或用 MountIn 从代码挂载控件。

var root = new SusHudRoot();
root.Dimmed.Value = false;
root.MountIn(SusHudZone.TL, new SusHudPlayerStatus());
root.MountIn(SusHudZone.Bottom, new SusAbilityBar());
root.MountIn(SusHudZone.BR, new SusHudTurnActions());
// root.ClearZones(); // wipe all zone children

<template>
  <sus:SusHudRoot :Dimmed="Dim.Value">
    <template #top><!-- objective / banners --></template>
    <template #tl>
      <sus:SusHudPlayerStatus />
    </template>
    <template #tr>
      <sus:SusHudMenuButton />
    </template>
    <template #center><!-- toasts / confirm overlays --></template>
    <template #bl><!-- prompts --></template>
    <template #br>
      <sus:SusHudTurnActions />
    </template>
    <template #bottom>
      <sus:SusAbilityBar />
    </template>
  </sus:SusHudRoot>
</template>

<script>
public Prop<bool> Dim = new(false);
</script>

Prop / API	Role
Dimmed	添加 --dim 遮罩（rgba 蒙版）
插槽 top · tl · tr · center · bl · br · bottom	区域宿主
GetZone(SusHudZone)	解析区域 VisualElement
MountIn(zone, element)	将子元素追加到某区域
ClearZones()	清空所有区域子元素

备注

• 根节点与空区域使用 PickingMode.Ignore，使地图点击可穿透；有交互的子元素保持默认拾取模式。
• 区域是绝对定位的 flex 容器——通过 Assembler / SusHudModuleKind 放置模块，或手动挂载。
• SusHudZone：Top、TL、TR、Center、BL、BR、Bottom。