Streamlit多页面应用项目教程

项目介绍

st_pages 是一个用于创建和管理Streamlit多页面应用的实验性开源项目。它允许用户在不更改文件名的情况下，通过配置文件定义页面名称和图标，从而使多页面应用的开发更加灵活和可定制。

项目快速启动

安装

首先，通过pip安装st_pages包：

pip install st-pages

配置

在项目目录下创建一个streamlit/pages.toml文件，并添加以下内容：

[[pages]]
path = "page1.py"
name = "Home"
icon = "🏠"

[[pages]]
path = "other_pages/page2.py"
name = "Page 2"
icon = ":books:"

示例代码

在主文件中导入并使用st_pages：

import streamlit as st
from st_pages import Page, show_pages, add_page_title

# 添加页面标题和图标
add_page_title()

# 定义页面
show_pages([
    Page("page1.py", "Home", "🏠"),
    Page("other_pages/page2.py", "Page 2", ":books:")
])

# 主应用逻辑
st.title("Welcome to the Home Page")

应用案例和最佳实践

案例一：多页面导航

通过st_pages，可以轻松实现多页面导航，每个页面可以有不同的功能和布局，如下所示：

# page1.py
import streamlit as st

st.title("Home Page")
st.write("This is the home page of the multi-page app.")

# page2.py
import streamlit as st

st.title("Page 2")
st.write("This is the second page of the multi-page app.")

最佳实践

• 模块化设计：将每个页面的逻辑封装在单独的文件中，便于管理和维护。
• 配置文件管理：使用pages.toml文件集中管理页面配置，避免硬编码。

典型生态项目

st_pages 可以与其他Streamlit组件和库结合使用，扩展其功能。例如，结合streamlit-webrtc实现实时视频处理，或结合streamlit-aggrid实现复杂的数据表格展示。

示例：结合streamlit-webrtc

# page3.py
import streamlit as st
from streamlit_webrtc import webrtc_streamer

st.title("Real-time Video Processing")
webrtc_streamer(key="example")

通过这些扩展，可以构建更加丰富和交互式的多页面应用。