Streamlit库中streamlit.radio()的使用教程与实践

streamlit.radio() 是 Streamlit 库中用于创建单选按钮（Radio buttons）的小部件。单选按钮组允许用户从一组预定义的选项中选择一项。以下是 streamlit.radio() 函数的基本用法、参数说明以及示例：

基本语法

st.radio(label, options, index=None, key=None, help=None)

参数详解

• label (str): 单选按钮组的标签或标题，用于描述整个选项组的目的。
• options (list 或 tuple): 包含所有可选项目的列表或元组。每个项目应该是字符串，表示单选按钮上显示的文字。
• index (int, optional): 默认情况下，第一个选项被选中。如果提供了 index 参数，则指定该索引值所对应的选项作为初始选中项。索引值从0开始。
• key (str 或 any, optional): Streamlit 组件的唯一标识符。当有状态更新或需要缓存时，使用 key 可以确保组件的正确行为。如果在应用程序中有多个相似的单选按钮组，为它们分配不同的 key 值有助于避免状态混淆。
• help (str, optional): 提供给用户的附加帮助文本，当用户将鼠标悬停在单选按钮组上时显示。

示例

import streamlit as st

# 定义单选按钮的选项
gender_options = ['Male', 'Female', 'Other']

# 使用 st.radio 创建单选按钮组
selected_gender = st.radio(
    label="Select your gender:",
    options=gender_options,
    index=0,  # 默认选中第一个选项（“Male”）
    key='gender_selection',
    help='Please choose your gender from the provided options.'
)

# 显示用户选择的结果
st.write(f"You selected: {selected_gender}")

在这个示例中，streamlit.radio() 创建了一个包含三个选项（”Male”, “Female”, “Other”）的单选按钮组。用户只能从中选择一个选项，选择的结果将存储在变量 selected_gender 中。当用户更改选择时，selected_gender 的值会相应更新，以便在后续代码中使用或进行进一步的数据处理。

请注意，尽管您提到的资料中提及了有关调整单选按钮布局（例如横向排列）的内容，但标准的 streamlit.radio() 函数本身并不直接支持这种布局变化。若要实现单选按钮的横向排列，可能需要结合 CSS 或 Streamlit 的其他布局功能（如 st.columns()）来达到所需效果。如果您需要具体的代码示例以实现这一布局调整，请告知，我将为您提供相应指导。

存档地址：https://www.yuque.com/worthstudy/study/frr0u2gp9my1b9pt?singleDoc# 《streamlit.radio()》