| Function signature | |
|---|---|
st.selectbox(label, options, index=0, format_func=special_internal_function, key=None, help=None, on_change=None, args=None, kwargs=None, *, disabled=False) | |
| Parameters | |
label (str) | A short label explaining to the user what this select widget is for. |
options (Sequence, numpy.ndarray, pandas.Series, pandas.DataFrame, or pandas.Index) | Labels for the select options. This will be cast to str internally by default. For pandas.DataFrame, the first column is selected. |
index (int) | The index of the preselected option on first render. |
format_func (function) | Function to modify the display of the labels. It receives the option as an argument and its output will be cast to str. |
key (str or int) | An optional string or integer to use as the unique key for the widget. If this is omitted, a key will be generated for the widget based on its content. Multiple widgets of the same type may not share the same key. |
help (str) | An optional tooltip that gets displayed next to the selectbox. |
on_change (callable) | An optional callback invoked when this selectbox's value changes. |
args (tuple) | An optional tuple of args to pass to the callback. |
kwargs (dict) | An optional dict of kwargs to pass to the callback. |
disabled (bool) | An optional boolean, which disables the selectbox if set to True. The default is False. This argument can only be supplied by keyword. |
| Returns | |
(any) | The selected option |
Example
option = st.selectbox(
'How would you like to be contacted?',
('Email', 'Home phone', 'Mobile phone'))
st.write('You selected:', option)
(view standalone Streamlit app)