显示一个滑块小部件以从列表中选择项目。
这也允许您通过传递一个包含两个元素的元组或列表作为value来渲染一个范围滑块。
st.select_slider 和 st.slider 的区别在于 select_slider 接受任何数据类型并接受可迭代的选项集, 而 st.slider 只接受数值或日期/时间数据并 接受范围作为输入。
函数签名[source] | |
---|---|
st.select_slider(label, options=(), value=None, format_func=special_internal_function, key=None, help=None, on_change=None, args=None, kwargs=None, *, disabled=False, label_visibility="visible") | |
参数 | |
label (str) | 一个简短的标签,向用户解释此滑块的用途。 标签可以选择性地包含以下类型的GitHub风格的Markdown:粗体、斜体、删除线、内联代码、链接和图片。图片显示为图标,最大高度等于字体高度。 不支持的Markdown元素会被解包,因此只有它们的子元素(文本内容)会呈现。通过反斜杠转义不支持的元素,将其显示为字面字符。例如, "1\. 不是一个有序列表"。 有关其他支持的Markdown指令,请参见st.markdown的body参数。 出于可访问性原因,您不应设置空标签,但可以根据需要使用label_visibility隐藏它。将来,我们可能会通过引发异常来禁止空标签。 |
options (Iterable) | 选择选项的标签在一个Iterable中。这可以是一个 list、set,或任何st.dataframe支持的内容。如果 options是类似数据框的,将使用第一列。每个 标签默认情况下将在内部转换为str。 |
value (支持的类型或支持类型的元组/列表或None) | 滑块首次渲染时的值。如果传递了一个包含两个值的元组/列表,则会渲染一个具有这些下限和上限的范围滑块。例如,如果设置为(1, 10),滑块将具有1到10之间的可选范围。默认为第一个选项。 |
format_func (function) | 用于修改选项标签显示的函数。 它接收选项作为参数,其输出 将被转换为字符串。 |
key (str or int) | 一个可选的字符串或整数,用作小部件的唯一键。 如果省略,将根据小部件的内容生成一个键。 任何两个小部件都不能有相同的键。 |
help (str) | 一个可选的小提示,显示在小部件标签旁边。 只有当label_visibility="visible"时,Streamlit才会显示这个小提示。 |
on_change (callable) | 当此选择滑块的值发生变化时调用的可选回调函数。 |
args (tuple) | 传递给回调函数的可选参数元组。 |
kwargs (dict) | 一个可选的字典,用于传递给回调函数。 |
disabled (bool) | 一个可选的布尔值,如果设置为True,则禁用选择滑块。默认值为False。 |
label_visibility ("visible", "hidden", or "collapsed") | 标签的可见性。默认是"visible"。如果这是"hidden",Streamlit会显示一个空白的间隔符而不是标签,这有助于保持小部件与其他小部件对齐。如果这是"collapsed",Streamlit不会显示标签或间隔符。 |
返回 | |
(any value or tuple of any value) | 滑块小部件的当前值。返回类型将与值参数的数据类型匹配。 |
示例
import streamlit as st color = st.select_slider( "Select a color of the rainbow", options=[ "red", "orange", "yellow", "green", "blue", "indigo", "violet", ], ) st.write("My favorite color is", color)
这里有一个范围选择滑块的示例:
import streamlit as st start_color, end_color = st.select_slider( "Select a range of color wavelength", options=[ "red", "orange", "yellow", "green", "blue", "indigo", "violet", ], value=("red", "blue"), ) st.write("You selected wavelengths between", start_color, "and", end_color)
Featured videos
查看我们的视频,了解如何使用Streamlit的核心功能之一,选择滑块!🎈
在下面的视频中,我们将更进一步,制作一个双端滑块。
还有问题吗?
我们的 论坛 充满了有用的信息和Streamlit专家。