跳转到内容

SusLoadingScreenContent

SusLoadingScreenContent

全出血加载页 — 品牌横幅、spinner 和/或 linear bar、消息 + 可选副行。

SusGame · 屏幕(商业)

在 Playground 中打开

SusGame · Screens

属性

名称类型默认值
BrandTextProp<string>""
MessageProp<string>"Loading..."
SubMessageProp<string>""
ProgressProp<float>0f
ShowSpinnerProp<bool>true

插槽

没有插槽。

事件

没有公开事件。

样式钩子

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

  • sus-banner__body
  • sus-banner__text
  • sus-loading-screen
  • sus-loading-screen__bar
  • sus-loading-screen__brand
  • sus-loading-screen__indicator
  • sus-loading-screen__message
  • sus-loading-screen__sub

用法

xml
<template>
  <sus:SusLoadingScreenContent
    :BrandText="Brand.Value"
    :Message="Msg.Value"
    :SubMessage="Sub.Value"
    :Progress="Prog.Value"
    :ShowSpinner="Spin.Value"
  />
</template>

<script>
public Prop<string> Brand = new("My Game");
public Prop<string> Msg = new("Loading...");
public Prop<string> Sub = new("");
public Prop<float> Prog = new(0.35f); // 0…1; <0 = indeterminate
public Prop<bool> Spin = new(true);
</script>
csharp
var loading = new SusLoadingScreenContent();
loading.BrandText.Value = "My Game";
loading.Message.Value = "Connecting…";
loading.SubMessage.Value = "Region EU";
loading.Progress.Value = 0.4f;   // shows linear bar
loading.Progress.Value = -1f;    // indeterminate → spinner if ShowSpinner
loading.ShowSpinner.Value = true;
Prop / APIRole
BrandText顶部横幅;为空 → 隐藏
Message主标签
SubMessage次标签;为空 → 隐藏
Progress0…1 → 进度条百分比;< 0 → 不确定模式
ShowSpinner不确定模式下显示圆形 spinner
BrandBanner内置的横幅宿主

备注

  • 确定态路径将 Progress 钳制到 0…1 并映射到进度条 0…100。
  • 不确定态隐藏进度条;spinner 的可见性还需要 ShowSpinner=true
  • 与 kit 的 MigratedLoadingScreen 不同(包 / props 不同)。