跳转到内容

SusBottomNav

SusBottomNav

移动端 / 主机风格标签条 —— 由 Items + Model 驱动的图标 + 标签单元格。

SusKit · 分子(商业)

在 Playground 中打开

SusKit · Molecules

属性

名称类型默认值
ModelProp<string>""v-model
GrowProp<bool>truev-model
DisabledProp<bool>falsev-model
ColorProp<string>"primary"v-model

插槽

没有插槽。

事件

名称字段载荷
ChangeOnChangestring

样式钩子

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

  • sus-bottom-nav
  • sus-bottom-nav__icon
  • sus-bottom-nav__item
  • sus-bottom-nav__item--active
  • sus-bottom-nav__item--disabled
  • sus-bottom-nav__item--grow
  • sus-bottom-nav__label
  • sus-bottom-nav__row
  • sus-bottom-nav--disabled
  • sus-bottom-nav--grow
  • sus-bottom-nav--primary
  • sus-bottom-nav--secondary
  • sus-bottom-nav--surface

用法

Items 在代码中设置(List<BottomNavItem>)。每个项携带 LabelValue,以及可选的 Icon / Disabled

csharp
var nav = new SusBottomNav();
nav.Items.Value = new List<SusBottomNav.BottomNavItem>
{
    new() { Label = "Home", Value = "home", Icon = "home" },
    new() { Label = "Party", Value = "party", Icon = "users" },
    new() { Label = "Shop", Value = "shop", Icon = "shop" },
    new() { Label = "Settings", Value = "settings", Icon = "settings" },
};
nav.Model.Value = "home";
nav.Grow.Value = true;
nav.Color.Value = "primary";
nav.OnChange += value => { /* … */ };
xml
<template>
  <sus:SusBottomNav :Model="Tab.Value"
                    Color="primary"
                    :Grow="Grow.Value"
                    @change="OnTab" />
</template>

<script>
public Prop<string> Tab = new("home");
public Prop<bool> Grow = new(true);
void OnTab(string value) { Tab.Value = value; }
// Populate Items in code (same pattern as ChipGroup / Tabs).
</script>
PropRole
ItemsList<BottomNavItem> —— 要渲染的单元格
Model选中的值
Grow让单元格在行内拉伸铺满
Colorprimary · secondary · surface