桌面应用 / 系统课时

用 Loader 按需加载界面

用 Loader 按需加载界面

本篇解决 QML 页面组件越来越多时的创建成本问题。你将学习如何使用 Loader 延迟创建界面对象,根据业务状态动态加载或释放组件,并理解不同加载方式的适用边界。

学习目标

  • 理解 Loader 的工作机制和适用场景。
  • 掌握 source 与 sourceComponent 的基本用法。
  • 能够根据状态变化控制组件创建和销毁。

为什么需要按需加载组件

QML 中组件声明后通常会参与对象创建和属性绑定。当应用包含设置页、帮助页、复杂表单等多个界面时,一次性创建所有对象会增加启动时间,也会占用不必要的内存。

Loader 提供了一种延迟创建机制。它本身是一个轻量对象,只有在指定组件来源后,才会实例化真正的界面内容。

Loader 创建与释放组件的生命周期示意图

使用 source 加载外部 QML 文件

当界面已经拆分为独立的 QML 文件时,source 是最直接的方式。Loader 会根据路径创建对应组件实例。

qml
import QtQuick
import QtQuick.Controls

ApplicationWindow {
    visible: true
    width: 800
    height: 600

    Loader {
        id: pageLoader
        anchors.fill: parent
        source: "SettingsPage.qml"
    }
}

预期结果

text
窗口启动后,Loader 创建 SettingsPage.qml 对应的组件实例,并填充到 Loader 区域中。

source 的值发生变化时,Loader 会销毁旧实例并加载新的组件。这适合根据用户操作切换独立页面。

使用 sourceComponent 创建内嵌组件

如果组件逻辑较短,不需要单独文件,可以通过 Component 配合 sourceComponent 创建。

qml
import QtQuick

Item {
    width: 400
    height: 300

    Component {
        id: messagePanel

        Rectangle {
            width: 200
            height: 100
            color: "lightgray"
        }
    }

    Loader {
        anchors.centerIn: parent
        sourceComponent: messagePanel
    }
}

预期结果

text
Loader 创建一个宽 200、高 100 的灰色 Rectangle,并显示在父对象中央。

sourceComponent 更适合局部复用的小组件,而复杂页面通常应该拆分为独立 QML 文件。

根据状态控制加载时机

实际项目中通常根据状态决定是否创建组件。例如进入高级设置页时才加载配置界面。

qml
Loader {
    id: advancedLoader
    anchors.fill: parent
    active: showAdvanced
    source: "AdvancedSettings.qml"
}

预期结果

text
showAdvanced 为 true 时创建 AdvancedSettings.qml。
showAdvanced 为 false 时释放已加载组件。

Loader 的 active 属性适合控制生命周期。需要注意,频繁销毁和重建复杂页面可能导致状态丢失,应结合页面缓存需求决定是否使用。

选择合适的加载方式

场景 推荐方式
独立页面或大型组件 source
小型临时组件 sourceComponent
需要减少启动开销 active 控制加载

Loader 的核心价值不是替代普通组件,而是在界面规模扩大后,把对象创建时机交给业务状态管理。当组件昂贵、使用频率低或生命周期明确时,按需加载可以有效降低资源压力。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Loader 按需加载界面

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

登录哪都通