SusDropdown

弹出式列表选择器 — 打开的列表即身份标识（不同于封闭字段的 Select）。

包

SusKit · 原子（商业）

在 Playground 中打开

SusKit · Atoms

属性

名称	类型	默认值
Model	Prop<object>	null	v-model
Label	Prop<string>	""	v-model
ItemTitle	Prop<string>	""	v-model
ItemValue	Prop<string>	""	v-model
Searchable	Prop<bool>	false	v-model
SearchText	Prop<string>	""	v-model
NoDataText	Prop<string>	"Nothing found"	v-model
Disabled	Prop<bool>	false	v-model
IsOpen	Prop<bool>	false	v-model
Variant	Prop<string>	"outlined"	v-model

插槽

名称
prepend
selection
item

事件

名称	字段	载荷
Change	OnChange	object
Open	OnOpen	—
Close	OnClose	—

样式钩子

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

• density-comfortable
• density-compact
• keyboard-focus
• sus-dropdown
• sus-dropdown__item
• sus-dropdown__item--highlighted
• sus-dropdown__item--selected
• sus-dropdown__list
• sus-dropdown__popup
• sus-dropdown__search
• sus-dropdown__search-input
• sus-dropdown__trigger
• sus-dropdown--disabled
• sus-dropdown--filled
• sus-dropdown--open
• sus-dropdown--outlined
• sus-dropdown--underlined

用法

Items 是 List<object>（字符串或 POCO）。当条目为对象时，使用 ItemTitle / ItemValue。

var dropdown = new SusDropdown();
dropdown.Label.Value = "Difficulty";
dropdown.Items.Value = new List<object> { "Easy", "Normal", "Hard" };
dropdown.Model.Value = "Normal";
dropdown.IsOpen.Value = true;
dropdown.Variant.Value = "outlined";
dropdown.OnChange += value => { /* … */ };

属性	作用
Items	选项（List<object>）
Model	当前选中项
ItemTitle / ItemValue	当条目为对象时的属性名
Searchable / SearchText	过滤打开的列表
IsOpen	显示 / 隐藏弹出层

变体

filled · outlined · underlined · plain · solo · solo-inverted · solo-filled