當前位置: 首頁>>編程示例 >>用法及示例精選 >>正文


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。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。