1. 理解 st.dataframe 的下载按钮
streamlit 的 st.dataframe 组件在最新版本中引入了一个便捷的数据下载按钮，允许用户直接导出表格数据。这在许多场景下非常有用，但有时开发者可能希望禁用此功能，例如：
- 界面简洁性： 保持应用界面干净整洁，避免不必要的按钮。
- 数据访问控制： 限制用户直接下载原始数据，只允许通过特定途径获取。
- 安全性考量： 防止敏感数据被未经授权地导出。
由于 Streamlit 官方目前没有直接提供一个参数来控制这个按钮的显示与隐藏，我们需要借助 CSS 注入的方式来实现。
2. 隐藏下载按钮的原理
Streamlit 应用的渲染基于 Web 技术，这意味着我们可以通过注入自定义 CSS 来修改页面元素的样式。st.dataframe 的下载按钮及其所在的工具栏被赋予了一个特定的 data-testid 属性，即 stElementToolbar。通过针对这个 data-testid 应用 display: none; 样式，我们就可以将其从页面上隐藏。
3. 实现步骤与示例代码
隐藏 st.dataframe 下载按钮的核心代码非常简洁，只需在 st.dataframe 调用之后添加一段 st.markdown 代码即可。
import streamlit as st
import pandas as pd
import numpy as np
st.set_page_config(layout="wide")
st.title("Streamlit st.dataframe 下载按钮隐藏示例")
# 准备一些示例数据
data = {
'列A': np.random.rand(10),
'列B': np.random.randint(1, 100, 10),
'列C': ['文本' + str(i) for i in range(10)],
'列D': pd.to_datetime(['2023-01-01', '2023-01-02', '2023-01-03', '2023-01-04',
'2023-01-05', '2023-01-06', '2023-01-07', '2023-01-08',
'2023-01-09', '2023-01-10'])
}
df = pd.DataFrame(data)
st.subheader("带有下载按钮的 DataFrame (默认)")
st.dataframe(df, use_container_width=True)
st.subheader("隐藏下载按钮的 DataFrame")
st.dataframe(df, use_container_width=True)
# 隐藏 st.dataframe 的下载按钮（通过 CSS 注入）
st.markdown(
"""
<style>
/* 针对 st.dataframe 的工具栏，包含下载按钮 */
[data-testid="stElementToolbar"] {
display: none; /* 隐藏该元素 */
}
</style>
""",
unsafe_allow_html=True # 允许渲染 HTML 内容
)
st.write("请注意，第二个 DataFrame 上方的下载按钮已不可见。")
# 也可以在其他位置添加此CSS，它会全局影响所有st.dataframe
# 只要在st.dataframe渲染之后执行即可在上述代码中：
- 我们首先创建了一个示例 pandas.DataFrame。
- 第一个 st.dataframe(df) 展示了默认情况下带有下载按钮的表格。
- 第二个 st.dataframe(df) 紧随其后，但其上方的下载按钮会被接下来的 CSS 代码隐藏。
- 关键在于 st.markdown 部分。我们嵌入了一个
- display: none; 是 CSS 属性，用于将选中的元素从页面布局中完全移除，使其不可见且不占据空间。
- unsafe_allow_html=True 参数是必需的，因为它告诉 Streamlit 允许渲染包含 HTML 标签（如
4. 注意事项与最佳实践
- unsafe_allow_html=True 的安全性： 使用 unsafe_allow_html=True 时需要谨慎。如果允许用户输入的内容被 st.markdown 渲染并设置此参数为 True，可能会存在跨站脚本 (XSS) 攻击的风险。但在本例中，我们注入的是固定的、由开发者控制的 CSS 代码，因此是安全的。
- CSS 选择器的稳定性： 这种基于 data-testid 的方法依赖于 Streamlit 内部的 HTML 结构。虽然 data-testid 通常用于测试，相对稳定，但 Streamlit 的未来版本理论上可能会更改这些内部标识符，从而导致此方法失效。在版本升级后，如果发现按钮再次出现，可能需要检查 Streamlit 的最新文档或社区讨论以获取更新的 CSS 选择器。
- 全局与局部影响： 上述 CSS 代码一旦被注入，将影响页面上所有 st.dataframe 组件的工具栏（只要它们使用了相同的 data-testid）。如果只想隐藏特定 st.dataframe 的下载按钮，而保留其他 st.dataframe 的下载功能，则需要更复杂的 CSS 策略，例如为特定的 st.dataframe 所在的容器添加一个唯一的 ID 或类名，然后通过更具体的 CSS 选择器来定位。然而，目前 st.dataframe 没有直接提供设置 ID 或类名的参数，因此这种场景会比较复杂。对于大多数需求，全局隐藏是可接受的。
-
替代方案： 如果你的目标是控制数据下载，但又不想完全禁用，可以考虑以下替代方案：
- 自定义下载按钮： 使用 st.button 结合 st.download_button 创建一个自定义的下载按钮。你可以完全控制按钮的显示逻辑、下载的数据内容以及文件格式。
- 数据处理与导出： 在后端进行数据处理后，再提供下载链接或通过其他方式交付数据，而不是直接暴露原始 DataFrame 的下载功能。
总结
通过 st.markdown 注入自定义 CSS 样式是 Streamlit 中一种强大且灵活的定制 UI 的方式。本文展示了如何利用这一特性，轻松隐藏 st.dataframe 组件自带的数据下载按钮，从而帮助开发者更好地控制应用的外观和用户交互。在应用此方法时，请务必注意 unsafe_allow_html 参数的含义以及 CSS 选择器可能存在的版本兼容性问题。
