Skip to content

Dropdown Input

A user input component that allows users to select a single value from a list of options using a dropdown menu.

Fields

NameTypeDescriptionOptions
LabelText
OptionsKey-ValueKey-value object with options. Must be a JSON string or a state reference to a dictionary.
Custom CSS classesTextCSS classes, separated by spaces. You can define classes in custom stylesheets.

Events

NameDescriptionUsage
ss-option-changeSent when the selected option changes.
def onchange_handler(state, payload):

  # Set the state variable "selected" to the selected option

  state["selected"] = payload

Low code usage

This component can be declared directly in Python, using backend-driven UI.

python
ui.DropdownInput(content={
        "label": "", # str 
        "options": {}, # Union[Dict, str] 
        "cssClasses": "", # str 
    },
    handlers={
        "ss-option-change": handle_event,
    }
)
A function, in this example handle_event, should be implemented in your code to handle events.
python
def handle_event(state, payload, context, ui):
  pass

Reference