Streamlit隐藏dataframe下载按钮方法

作者：小确幸时间：2026-02-06 浏览：0

本文将详细介绍如何在Streamlit应用中隐藏st.dataframe组件自带的下载按钮。通过利用Streamlit的st.markdown功能注入自定义CSS样式，开发者可以轻松移除该按钮，从而更好地控制用户界面，提升应用的用户体验。本教程提供了具体的代码示例和使用注意事项，帮助您快速实现这一功能。

本文目录

隐藏Streamlit st.dataframe下载按钮的实用教程

理解问题背景

在Streamlit的较新版本中，st.dataframe组件默认会在数据框的右上角显示一个下载按钮，允许用户将显示的数据导出为CSV或其他格式。虽然这在许多场景下非常有用，但在某些特定应用中，开发者可能不希望用户拥有直接下载数据的选项，例如出于数据安全、界面简洁性或特定交互流程的考虑。此时，我们就需要一种方法来隐藏这个默认的下载按钮。

解决方案：注入自定义CSS

Streamlit允许通过st.markdown函数注入HTML和CSS代码。我们可以利用这一特性，编写一段CSS样式来选择并隐藏包含下载按钮的元素。经过检查，Streamlit的下载按钮通常位于一个具有特定data-testid属性的工具栏元素中，该属性为stElementToolbar。因此，我们可以针对这个元素设置display: none;来将其隐藏。

以下是实现这一功能的具体代码：

import streamlit as st
import pandas as pd

st.set_page_config(layout="wide")

st.title("Streamlit DataFrame 下载按钮隐藏示例")

# 示例数据
data = {
    '列A': [1, 2, 3, 4, 5],
    '列B': ['苹果', '香蕉', '橙子', '葡萄', '草莓'],
    '列C': [10.5, 20.3, 15.0, 25.8, 12.1]
}
df = pd.DataFrame(data)

st.subheader("未隐藏下载按钮的DataFrame (仅作对比，实际应用中可能不显示)")
st.dataframe(df) # 这里的下载按钮将不受影响，因为它在隐藏代码之前

st.subheader("隐藏下载按钮的DataFrame")
st.dataframe(df.head(3)) # 这里的下载按钮将被隐藏

# 核心代码：隐藏下载按钮
st.markdown(
    """
    
    """,
    unsafe_allow_html=True
)

st.write("上述DataFrame的下载按钮已被隐藏。")

st.subheader("另一个隐藏下载按钮的DataFrame")
st.dataframe(df.tail(2)) # 这里的下载按钮也将被隐藏

代码解析

st.markdown(...): 这是Streamlit中用于渲染Markdown、HTML或CSS的函数。
"""""": 这是一个多行字符串，包含了我们想要注入的CSS代码。