桌面应用 / 系统课时
用 StackView 管理页面导航
用 StackView 管理页面导航
本篇解决多页面 QML 应用中手动切换界面难以维护的问题。你将使用 StackView 建立页面导航栈,实现页面进入、返回和替换,并学习如何向目标页面传递参数。
学习目标
- 理解 StackView 的页面栈模型。
- 掌握 push、pop 和 replace 的使用方式。
- 能够在导航过程中传递页面参数。
理解 StackView 的导航模型
StackView 使用后进先出的栈结构管理页面。调用 push 时,新页面进入栈顶;调用 pop 时,栈顶页面退出并返回上一页;replace 会用新页面替换当前页面。

与手动修改 Loader.source 相比,StackView 会维护页面历史,更适合设置页、向导流程和多级业务页面。
使用 push 打开新页面
下面示例展示从首页进入详情页的基本方式。
qml
import QtQuick
import QtQuick.Controls
ApplicationWindow {
visible: true
width: 800
height: 600
StackView {
id: stackView
anchors.fill: parent
initialItem: "HomePage.qml"
}
function openDetail() {
stackView.push("DetailPage.qml")
}
}预期结果
text
调用 openDetail() 后,DetailPage.qml 被压入导航栈,用户看到详情页面。push 适合表示用户进入一个新的任务上下文,例如从列表进入详情。
使用 pop 和 replace 控制返回与替换
pop 用于返回上一页,replace 用于当前页面直接切换为目标页面。
qml
Button {
text: "返回"
onClicked: stackView.pop()
}
Button {
text: "完成"
onClicked: stackView.replace("ResultPage.qml")
}预期结果
text
点击返回按钮后,当前页面退出并显示上一个页面。
点击完成按钮后,当前页面被 ResultPage.qml 替换。如果业务要求用户不能返回中间步骤,例如登录完成后的跳转,replace 通常比 push 更合适。
向目标页面传递参数
StackView 支持 push 一个对象配置属性,把业务数据传给目标组件。
qml
function openUser(id) {
stackView.push("UserPage.qml", {
userId: id
})
}预期结果
text
UserPage.qml 创建后,userId 属性值为传入的用户 ID。目标页面需要提前声明对应属性:
qml
import QtQuick
Item {
property string userId
}预期结果
text
页面实例可以直接读取 userId 属性,并根据参数加载对应数据。页面导航设计中的边界
StackView 适合管理页面层级关系,但不适合保存所有业务状态。页面销毁后,未保存的数据可能丢失。
常见做法是让页面负责展示和交互,把长期状态放到独立的数据模型中。这样页面可以自由 push 和 pop,而不会影响业务数据一致性。
当应用存在明确页面层级、返回路径和流程跳转时,StackView 可以减少大量手工管理代码,让导航逻辑集中在一个组件中。
按自己的节奏,确认真正理解。