SuperAPI AI 工具集

building-streamlit-multipage-apps

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:为 Streamlit 应用搭建多页面结构与导航,并跨页面共享状态。

目录结构:入口为 streamlit_app.py,页面放在 app_pages/ 目录(不要用 pages/,会与旧自动发现 API 冲突)。

主要能力:在主模块用 st.navigation 定义导航,用 st.Page 注册页面并设置 title、icon;页面少(3-7 个)可用 position="top" 顶部导航,页面多或需分组用 position="sidebar";分组时用空字符串键 "" 放置未分组页面,它们始终排在最前。

状态管理:全局状态在主模块初始化,如 st.session_state.api_client,可用 st.session_state.setdefault("key", default_value);页面专属状态建议加前缀键,如 analytics_date_range。

共享元素:把共享标题、侧边栏控件放在 page.run() 之前,即可出现在所有页面;若在入口处理标题,各页面不要再调用 st.title。

跳转:用 st.switch_page("app_pages/settings.py") 程序化跳转,用 st.page_link 创建链接;标准导航优先用 st.navigation,不要用 st.page_link 重建导航栏。

条件页面:动态构建页面列表,依据 st.user.is_logged_in、st.session_state 标志、环境变量或密钥、时间条件等显示或隐藏页面。

导入:从 app_pages/ 内导入模块时按根目录视角写,如 from utils.data import load_sales_data,不要用相对导入。

限制:资料未提供收费、平台支持范围及性能数据。