在st.dataframe或st.data_editor中配置一个文本列。
这是字符串值的默认列类型。此命令需要在st.dataframe或st.data_editor的column_config参数中使用。当与st.data_editor一起使用时，将启用文本输入小部件进行编辑。
| 函数签名[source] | |
|---|---|
st.column_config.TextColumn(label=None, *, width=None, help=None, disabled=None, required=None, pinned=None, default=None, max_chars=None, validate=None) | |
| 参数 | |
标签 (str 或 None) | 显示在列顶部的标签。如果这是 None（默认），则使用列名。 |
宽度 ("small", "medium", "large", 或 None) | 列的显示宽度。如果这是 None（默认值），列将根据单元格内容自动调整大小。否则，可以是以下之一：
|
帮助 (str 或 None) | 一个可选的工具提示，当鼠标悬停在列标签上时会显示。如果这是 None（默认值），则不显示工具提示。 |
disabled (bool or None) | 是否应禁用此列的编辑。如果这是None （默认），Streamlit 将决定：索引被禁用，数据列 则不被禁用。 如果列具有混合类型，无论disabled如何，它都可能变得不可编辑。 |
required (bool or None) | 列中编辑的单元格是否需要有一个值。如果这是 False（默认），用户可以为此列提交空值。 如果这是True，则此列中编辑的单元格只有在 其值不为None时才能提交，并且新行只有在 用户填写此列后才能提交。 |
pinned (bool or None) | 列是否被固定。被固定的列将始终显示在左侧，无论用户滚动到哪里。如果这是None（默认值），Streamlit 将决定：索引列被固定，数据列不被固定。 |
默认值 (str 或 None) | 指定当用户添加新行时此列的默认值。默认为 None。 |
max_chars (int or None) | 可以输入的最大字符数。如果这是None（默认值），则没有最大限制。 |
validate (str or None) | 一个JS风格的正则表达式（例如 "^[a-z]+$"），用于验证编辑的值。如果用户输入无效，则不会提交。 |
示例
import pandas as pd import streamlit as st data_df = pd.DataFrame( { "widgets": ["st.selectbox", "st.number_input", "st.text_area", "st.button"], } ) st.data_editor( data_df, column_config={ "widgets": st.column_config.TextColumn( "Widgets", help="Streamlit **widget** commands 🎈", default="st.", max_chars=50, validate=r"^st\.[a-z_]+$", ) }, hide_index=True, )
还有问题吗？
我们的 论坛 充满了有用的信息和Streamlit专家。