跳转到内容

布局配方

用于 top-nav 和 character/loadout 屏幕的 chrome / layout 原子组件的简短配方。Storybook:Samples~/Storybookicon-railwedge-sliderparallax-stackapp-bar)。


SusIconRail

垂直(默认)或水平的圆形项目类别 / loadout 条带。

Prop作用
ItemsList<RailItem> —— LabelValueIconDisabled
Model已选中的 Value(或索引字符串)
Directionvertical | horizontal
OnChangedAction<string>

根节点布局可能需要消费方的 USS 覆盖:Sharq scoping 会破坏 .sus-icon-rail 上的 self-target,请将不带 scope 的根级规则放在 companion / theme USS 中。

样式钩子

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

  • sus-icon-rail__icon
  • sus-icon-rail__item
  • sus-icon-rail__item--active
  • sus-icon-rail__item--disabled
  • sus-icon-rail__item--h
  • sus-icon-rail__label
  • sus-icon-rail--horizontal
  • sus-icon-rail--vertical

SusWedgeSlider

分段式“volume wedge”(上升条形)。沿行点击可设置已填充的分段数量。

Prop作用
Label可选说明文字
Value / Segments已填充数量 0…Segments
ShowValue / ValueText数值显示
Disabled阻止输入
OnChangedAction<int>

辅助方法:Bind(label, filled, segments = 10)

样式钩子

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

  • sus-wedge-slider
  • sus-wedge-slider__label
  • sus-wedge-slider__row
  • sus-wedge-slider__row--grow
  • sus-wedge-slider__seg
  • sus-wedge-slider__seg--h1
  • sus-wedge-slider__seg--h10
  • sus-wedge-slider__seg--h11
  • sus-wedge-slider__seg--h12
  • sus-wedge-slider__seg--h13
  • sus-wedge-slider__seg--h14
  • sus-wedge-slider__seg--h15
  • sus-wedge-slider__seg--h16
  • sus-wedge-slider__seg--h2
  • sus-wedge-slider__seg--h3
  • sus-wedge-slider__seg--h4
  • sus-wedge-slider__seg--h5
  • sus-wedge-slider__seg--h6
  • sus-wedge-slider__seg--h7
  • sus-wedge-slider__seg--h8
  • sus-wedge-slider__seg--h9
  • sus-wedge-slider__seg--on
  • sus-wedge-slider__value
  • sus-wedge-slider__wrap
  • sus-wedge-slider--disabled

SusParallaxStack

由指针驱动的分层堆叠:bg → pattern → subject → ui(tips) → chrome。

Prop作用
PatternAmp / SubjectAmp / UiAmp视差幅度(px)

构建后调用 EnsureLayers() 以解析出 BgPatternSubjectUiTipHostChrome。将子元素添加到这些层中;堆叠会自行处理指针移动与插值(lerp)。

样式钩子

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

  • sus-parallax-stack
  • sus-parallax-stack__bg
  • sus-parallax-stack__chrome
  • sus-parallax-stack__pattern
  • sus-parallax-stack__subject
  • sus-parallax-stack__tips
  • sus-parallax-stack__ui
  • sus-parallax-stack--off

SusAppBar

带有 prepend / 默认 / append 插槽的顶部条(在 Prominent 时还可有可选的 extension)。

Prop作用
Title内容中的标签
Densitydefault | compact | comfortable
Colorprimary | secondary | … | surface
Flat / Absolute / Prominent视觉 / 位置修饰符

配方: 默认插槽 = SusTabs;append 插槽 = 货币 / 操作用的 SusChip(参见 Storybook 中的 app-bar)。

样式钩子

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

  • sus-app-bar
  • sus-app-bar__append
  • sus-app-bar__content
  • sus-app-bar__extension
  • sus-app-bar__prepend
  • sus-app-bar__row
  • sus-app-bar__title
  • sus-app-bar--absolute
  • sus-app-bar--danger
  • sus-app-bar--density-comfortable
  • sus-app-bar--density-compact
  • sus-app-bar--flat
  • sus-app-bar--info
  • sus-app-bar--primary
  • sus-app-bar--prominent
  • sus-app-bar--secondary
  • sus-app-bar--success
  • sus-app-bar--surface
  • sus-app-bar--warning
  • sus-slot