Skip to content

SusButton

SusButton

Primary action button — variants, colors, sizes, icons, loading state.

Package

SusKit · Atoms (commercial)

Open in Playground

SusKit · Atoms

Props

NameTypeDefault
TextProp<string>""
VariantProp<string>"elevated"
ColorProp<string>"primary"
SizeProp<string>"default"
DensityProp<string>"default"
PrependIconProp<string>""
AppendIconProp<string>""
IconProp<string>""
DisabledProp<bool>false
LoadingProp<bool>false
ReadonlyProp<bool>false
ActiveProp<bool>false
BlockProp<bool>false
StackedProp<bool>false
RoundedProp<string>"md"
BorderProp<string>""
SpacedProp<string>""

Slots

Name
loader

Events

NameFieldPayload
ClickOnClick

Style hooks

USS class contract — override appearance without touching C#. States toggle via these classes:

  • keyboard-focus
  • sus-button
  • sus-button__content
  • sus-button__icon-wrap
  • sus-button__icon-wrap--append
  • sus-button__icon-wrap--prepend
  • sus-button__label
  • sus-button__loader
  • sus-button--active
  • sus-button--block
  • sus-button--border-lg
  • sus-button--border-md
  • sus-button--border-sm
  • sus-button--border-xl
  • sus-button--border-xs
  • sus-button--color-danger
  • sus-button--color-info
  • sus-button--color-primary
  • sus-button--color-secondary
  • sus-button--color-success
  • sus-button--color-warning
  • sus-button--density-comfortable
  • sus-button--density-compact
  • sus-button--disabled
  • sus-button--elevated
  • sus-button--flat
  • sus-button--icon-only
  • sus-button--loading
  • sus-button--outlined
  • sus-button--plain
  • sus-button--readonly
  • sus-button--rounded-0
  • sus-button--rounded-circle
  • sus-button--rounded-lg
  • sus-button--rounded-md
  • sus-button--rounded-pill
  • sus-button--rounded-sm
  • sus-button--rounded-xl
  • sus-button--rounded-xs
  • sus-button--size-default
  • sus-button--size-lg
  • sus-button--size-sm
  • sus-button--size-xl
  • sus-button--size-xs
  • sus-button--spaced-both
  • sus-button--spaced-end
  • sus-button--spaced-start
  • sus-button--stacked
  • sus-button--text
  • sus-button--tonal

Usage

xml
<template>
  <sus:SusButton Text="Save"
                 Variant="elevated"
                 Color="primary"
                 PrependIcon="floppy-disk"
                 @click="OnSave" />
</template>

<script>
void OnSave() { /* … */ }
</script>
csharp
var btn = new SusButton();
btn.Text.Value = "Save";
btn.OnClick += () => { /* … */ };

Variants

elevated · flat · tonal · outlined · text · plain

Colors

primary · secondary · success · danger · warning · info