桌面应用 / 系统课时

用 StackView 管理页面导航

用 StackView 管理页面导航

本篇解决多页面 QML 应用中手动切换界面难以维护的问题。你将使用 StackView 建立页面导航栈,实现页面进入、返回和替换,并学习如何向目标页面传递参数。

学习目标

  • 理解 StackView 的页面栈模型。
  • 掌握 push、pop 和 replace 的使用方式。
  • 能够在导航过程中传递页面参数。

理解 StackView 的导航模型

StackView 使用后进先出的栈结构管理页面。调用 push 时,新页面进入栈顶;调用 pop 时,栈顶页面退出并返回上一页;replace 会用新页面替换当前页面。

StackView 页面栈导航关系示意图

与手动修改 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 可以减少大量手工管理代码,让导航逻辑集中在一个组件中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 StackView 管理页面导航

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通