Python Streamlit st.multiselect用法及代码示例

显示多选小部件。

多选小部件开始为空。

函数签名

st.multiselect(label, options, default=None, format_func=special_internal_function, key=None, help=None, on_change=None, args=None, kwargs=None, *, disabled=False)

参数	说明
label (str)	一个简短的标签，向用户解释此选择小部件的用途。
options (Sequence[V], numpy.ndarray, pandas.Series, pandas.DataFrame, or pandas.Index)	选择选项的标签。默认情况下，这将在内部强制转换为 str 。对于 pandas.DataFrame，第一列被选中。
default ([V], V, or None)	默认值列表。也可以是单个值。
format_func (function)	修改选择框选项显示的函数。它接收原始选项作为参数，并应输出要为该选项显示的标签。这对多选的返回值没有影响。
key (str or int)	一个可选的字符串或整数，用作小部件的唯一键。如果省略，将根据其内容为小部件生成一个 key 。相同类型的多个小部件可能不共享相同的键。
help (str)	显示在多选旁边的可选工具提示。
on_change (callable)	当此多选的值更改时调用的可选回调。
args (tuple)	传递给回调的可选参数元组。
kwargs (dict)	一个可选的 kwargs 字典传递给回调。
disabled (bool)	一个可选的布尔值，如果设置为 True，则禁用多选小部件。默认值为假。此参数只能由关键字提供。
返回	说明
(list)	包含所选选项的列表

示例

options = st.multiselect(
     'What are your favorite colors',
     ['Green', 'Yellow', 'Red', 'Blue'],
     ['Yellow', 'Red'])

st.write('You selected:', options)

注意

options (100+) 的大型列表可能会降低用户体验，因为此小部件并非旨在有效处理任意文本搜索。有关更多信息，请参阅 Streamlit 社区论坛上的 thread，有关此问题的更新，请参阅 GitHub issue #1059。

相关用法

注：本文由纯净天空筛选整理自streamlit.io大神的英文原创作品 st.multiselect。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。