Streamlit(十八)- API 参考文档(十一)- 页面导航组件

文章目录


1. st.navigation:自定义多页面导航生成器

功能说明

新一代多页面应用路由核心API,在入口文件统一管理全部页面,支持页面分组、侧边/隐藏两种导航位置、菜单折叠控制,完全替代传统pages/文件夹自动路由。返回当前选中的页面对象,调用.run()渲染页面内容。

核心参数

参数 说明
pages 页面列表或分组字典:列表为平铺页面;字典键为分组标题,值为该分组下st.Page对象列表
position 导航菜单位置:sidebar侧边栏顶部、hidden完全隐藏导航
expanded 导航菜单默认展开状态,True永久展开、False默认折叠

代码示例

python 复制代码
import streamlit as st

# 定义分组页面
page_groups = {
    "数据工具": [
        st.Page("data_upload.py", title="数据上传", icon="📤"),
        st.Page("data_analysis.py", title="数据分析", icon="📊")
    ],
    "系统设置": [
        st.Page("setting.py", title="账号设置", icon="⚙️", default=True)
    ]
}
# 生成侧边导航
current_page = st.navigation(page_groups, position="sidebar")
# 执行当前选中页面
current_page.run()

2. st.Page:页面对象构造类

功能说明

用来封装单页信息的构造函数,生成StreamlitPage实例,传入st.navigation注册页面;支持本地py文件、Python函数两种页面源,可自定义页面标题、图标、路由地址、默认首页。

核心参数

参数 说明
page 页面源:py文件相对路径 / 无参Python函数
title 导航菜单展示的页面名称,不填自动读取文件名/函数名
icon 导航图标,支持Emoji、Material图标
url_path 浏览器路由后缀,默认自动生成;default=True时为空根路由
default 是否设为应用默认首页,打开App自动加载该页面

代码示例

python 复制代码
import streamlit as st

# 1. 文件页面
page_file = st.Page("dashboard.py", title="数据看板", icon=":material/bar_chart:", default=True)
# 2. 函数页面
def func_page():
    st.title("函数页面")
page_func = st.Page(func_page, title="工具页面", icon="🔧")

st.navigation([page_file, page_func]).run()

3. st.page_link:页面跳转链接

功能说明

页面内渲染跳转按钮/链接,分为内部应用页面跳转 、外部网址跳转两种模式;点击后直接切换页面或新开标签页,无需额外按钮逻辑。

核心参数

参数 说明
page 目标:本地页面文件路径 / st.Page对象 / http/https外部链接
label 链接显示文字,外部链接必填
icon 链接前置图标
disabled 是否禁用该跳转链接
use_container_width 链接宽度填满父容器

代码示例

python 复制代码
import streamlit as st

# 跳转内部页面
st.page_link("dashboard.py", label="返回首页", icon="🏠")
# 跳转外部网页
st.page_link("https://www.baidu.com", label="打开百度", icon="🌐")
# 禁用的页面链接
st.page_link("analysis.py", label="数据分析(维护中)", disabled=True)

4. st.switch_page:代码编程式强制切换页面

功能说明

代码内触发页面跳转,常用于按钮点击、表单提交、登录成功等场景,执行后立刻终止当前页面代码,加载目标页面,纯逻辑驱动无UI展示。

核心参数

  • page:目标页面的相对文件路径,或预先定义的st.Page对象

代码示例

python 复制代码
import streamlit as st

# 点击按钮自动跳转到首页
if st.button("回到首页"):
    st.switch_page("main.py")

# 表单提交后跳转数据页
submit = st.form_submit_button("开始分析")
if submit:
    st.switch_page("pages/data_analysis.py")
相关推荐
黑客笔记8 小时前
python小工具win7翻车事故现场
python
岁月宁静11 小时前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
benchmark_cc11 小时前
个人开发者接入五档盘口:用 QuantDash 读取单只股票的验收清单与易错点
python·数据分析·pandas·量化交易·股票数据·quantdash
ZhengEnCi12 小时前
项目越写越乱?先别改架构:用一次目录重排 + 一份可复算的体检脚本把乱治住
python·架构·ai编程
Dmz丶13 小时前
前端转 AI 100 天 Day 45:阶段复盘——从“会调 API”到“做出 AI 产品”
python
Sakura_j_h_13 小时前
MCP SDK 2.0 实战:用 MCPServer 搭本地笔记检索服务
开发语言·笔记·python·qt·ai工具·mcp·mcpserver
QuZhengRong14 小时前
【AI】Agent 全栈进阶|AgentScope 沙箱源码解析
python·学习·ai·agent·沙箱
Eider199814 小时前
Python基础语法之并发相关3
开发语言·python
M--Y15 小时前
LangGraph 架构基石:持久化与运行控制
python·langchain·大模型·llm·持久化·langgraph
用户0190275816116 小时前
新浪财经 / 东方财富股票接口不稳、被限?稳定替代方案
python