Skip to content

SusDropdown

SusDropdown

Popup list picker — open list is the identity (unlike closed-field Select).

Package

SusKit · Atoms (commercial)

Open in Playground

SusKit · Atoms

Props

NameTypeDefault
ModelProp<object>nullv-model
LabelProp<string>""v-model
ItemTitleProp<string>""v-model
ItemValueProp<string>""v-model
SearchableProp<bool>falsev-model
SearchTextProp<string>""v-model
NoDataTextProp<string>"Nothing found"v-model
DisabledProp<bool>falsev-model
IsOpenProp<bool>falsev-model
VariantProp<string>"outlined"v-model

Slots

Name
prepend
selection
item

Events

NameFieldPayload
ChangeOnChangeobject
OpenOnOpen
CloseOnClose

Style hooks

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

  • 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

Usage

Items is a List<object> (strings or POCOs). Use ItemTitle / ItemValue when items are objects.

csharp
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 => { /* … */ };
PropRole
ItemsOptions (List<object>)
ModelCurrent selection
ItemTitle / ItemValueProperty names when items are objects
Searchable / SearchTextFilter the open list
IsOpenShow / hide the popup

Variant

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