跳转到内容

SusCheckbox

SusCheckbox

带标签的布尔控件 — 选中、不确定、错误文本。

SusKit · 原子(商业)

在 Playground 中打开

SusKit · Atoms

属性

名称类型默认值
ModelProp<bool>falsev-model
LabelProp<string>""v-model
ColorProp<string>"primary"v-model
DisabledProp<bool>falsev-model
ReadonlyProp<bool>falsev-model
IndeterminateProp<bool>falsev-model
DensityProp<string>"default"v-model
ErrorProp<string>""v-model
HideDetailsProp<string>"auto"v-model

插槽

没有插槽。

事件

名称字段载荷
ChangeOnChangebool

样式钩子

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

  • keyboard-focus
  • sus-checkbox
  • sus-checkbox__details
  • sus-checkbox__icon
  • sus-checkbox__input
  • sus-checkbox__label
  • sus-checkbox--checked
  • sus-checkbox--danger
  • sus-checkbox--density-comfortable
  • sus-checkbox--density-compact
  • sus-checkbox--density-default
  • sus-checkbox--dirty
  • sus-checkbox--disabled
  • sus-checkbox--error
  • sus-checkbox--indeterminate
  • sus-checkbox--primary
  • sus-checkbox--readonly
  • sus-checkbox--secondary
  • sus-checkbox--success
  • sus-checkbox--warning

用法

xml
<template>
  <sus:SusCheckbox Label="Accept terms"
                   :Model="Accepted.Value"
                   Color="primary"
                   @change="OnAccepted" />
</template>

<script>
public Prop<bool> Accepted = new(false);
void OnAccepted(bool value) { /* … */ }
</script>
csharp
var check = new SusCheckbox();
check.Label.Value = "Remember me";
check.Model.Value = false;
check.Color.Value = "primary";
check.OnChange += value => { /* … */ };
// Partial state: check.Indeterminate.Value = true;

备注

  • Indeterminate 显示混合状态(例如"部分子项已选中")。
  • Error + HideDetails 遵循与文本输入相同的表单字段模式。