用途:帮助开发者在 Streamlit 应用中为选项选择场景挑选合适的组件,避免沿用已过时的旧写法。
主要能力与选型建议:选项少且都需可见时,用 st.segmented_control 做单选(适合 2-5 个选项),用 st.pills 做多选(适合 2-5 个选项);选项很多时改用下拉,st.selectbox 负责单选,st.multiselect 负责多选。纵向排布的 st.radio(..., horizontal=False) 仍是好选择,而横向 radio 被视为旧写法,建议替换为 st.segmented_control。st.pills 也可配合 label_visibility="collapsed" 模拟示例选择器。
开关与复选框:应用设置类、会触发界面变化的项用 st.toggle,表单内的确认项用 st.checkbox。表单方面,简短的行内表单可设 border=False 去掉边框,较长表单保留边框以便视觉分组。
自定义选项:st.selectbox 与 st.multiselect 支持 accept_new_options=True,允许用户输入并加入自己的选项,可配合 placeholder 使用。
限制:资料未提供组件版本要求、性能数据、平台或收费信息,使用前需自行确认所用 Streamlit 版本是否支持上述参数。