SusHoldButton

长按控件 — 仅在 HoldDurationMs 后完成，带进度反馈。

包

SusKit · 原子（商业）

在 Playground 中打开

SusKit · Atoms

属性

名称	类型	默认值
Text	Prop<string>	"Hold"
Icon	Prop<string>	""
Variant	Prop<string>	"elevated"
Color	Prop<string>	"primary"
Size	Prop<string>	"default"
Disabled	Prop<bool>	false
Block	Prop<bool>	false
HoldDurationMs	Prop<int>	1000
DelayMs	Prop<int>	0
ProgressMode	Prop<string>	"strip"
CancelRewindMs	Prop<int>	180
CompletedHoldMs	Prop<int>	600
AutoResetCompleted	Prop<bool>	true
IsHolding	Prop<bool>	false
Progress	Prop<float>	0f
Phase	Prop<string>	"idle"

插槽

没有插槽。

事件

名称	字段	载荷
Click	OnClick	—
HoldComplete	OnHoldComplete	—
HoldCancel	OnHoldCancel	—
HoldProgress	OnHoldProgress	float

样式钩子

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

• keyboard-focus
• sus-hold-button
• sus-hold-button__content
• sus-hold-button__fill
• sus-hold-button__icon
• sus-hold-button__label
• sus-hold-button__ring
• sus-hold-button__track
• sus-hold-button--block
• sus-hold-button--color-danger
• sus-hold-button--color-info
• sus-hold-button--color-primary
• sus-hold-button--color-secondary
• sus-hold-button--color-success
• sus-hold-button--color-warning
• sus-hold-button--content-sized
• sus-hold-button--disabled
• sus-hold-button--elevated
• sus-hold-button--flat
• sus-hold-button--holding
• sus-hold-button--icon-only
• sus-hold-button--mode-fill
• sus-hold-button--mode-ring
• sus-hold-button--mode-strip
• sus-hold-button--outlined
• sus-hold-button--phase-armed
• sus-hold-button--phase-cancelled
• sus-hold-button--phase-completed
• sus-hold-button--phase-holding
• sus-hold-button--phase-idle
• sus-hold-button--size-default
• sus-hold-button--size-lg
• sus-hold-button--size-sm
• sus-hold-button--text
• sus-hold-button--tonal

用法

<template>
  <sus:SusHoldButton Text="Confirm delete"
                     Color="danger"
                     Variant="elevated"
                     HoldDurationMs="1200"
                     ProgressMode="strip"
                     @hold-complete="OnConfirmed" />
</template>

<script>
void OnConfirmed() { /* … */ }
</script>

var hold = new SusHoldButton();
hold.Text.Value = "Hold to sell";
hold.HoldDurationMs.Value = 1000;
hold.ProgressMode.Value = "strip";
hold.OnHoldComplete += () => { /* … */ };
hold.OnHoldCancel += () => { /* … */ };

备注

• ProgressMode：strip · ring。
• OnClick 在普通点击时触发；长按成功对应的是 OnHoldComplete。