ELoading 加载

import EUI 1.0

示例与代码

目标区域加载

QML 代码QML

import EUI 1.0
import QtQuick 2.15
import QtQuick.Layouts 1.15
import QtQuick.Controls 2.15

Item {
    width: Math.min(640, parent.width)
    height: 480

Column {
        width: parent.width - 48
        spacing: 16
        anchors.centerIn: parent

ERectangle {
            id: webNavigationLoadingTarget

radius: 8
            height: 140
            width: parent.width
            color: EPaletteManager.ThemePalette.surfaceComponent(ETheme.dark)

EButton {
                anchors.centerIn: parent
                text: qsTr("开始任务")

onClicked: webNavigationTaskTimer.restart()
            }
        }
        ELoading {
            target: webNavigationLoadingTarget
            loading: webNavigationTaskTimer.running
            text: qsTr("正在处理…")
            backgroundColor: ETheme.dark ? Qt.rgba(0.1, 0.12, 0.16, 0.85) : Qt.rgba(1, 1, 1, 0.85)
        }
        Timer {
            id: webNavigationTaskTimer

interval: 1800
        }
    }
}

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行许可

加载

QML 代码QML

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行许可

属性

属性说明取值与默认值

backgroundColorcolor

背景颜色。

默认值动态绑定

beforeClosevar

关闭前回调；弹窗通过 done(cancel) 完成异步判断。

默认值null

clockwisebool

按顺时针方向绘制或旋转。

默认值true

colorcolor

自定义颜色；透明值通常表示使用当前主题或语义配色。

默认值动态绑定

durationint

动画或显示持续时间，单位为毫秒；组件的绑定表达式给出实际用途。

默认值1000

enabledbool

是否允许交互；false 时控件禁用。

默认值true

fullscreenbool

是否使用全屏显示或全窗口覆盖。

默认值false

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

loadingbool

是否处于加载状态。

默认值true

lockbool

加载时阻止目标区域交互。

默认值true

materialbool

使用 Material 风格的加载弧动画。

默认值false

showBackgroundbool

显示进度轨道或加载遮罩背景。

默认值true

spinnerComponentComponent

自定义加载动画的 Component 插槽；null 使用默认内容。委托上下文见本页示例。

默认值null

strokeWidthint

边框、分隔线或进度轨道的线宽，单位为像素。

默认值6

styleTypeint

语义配色风格。

EStyle.Default
EStyle.Primary
EStyle.Success
EStyle.Info
EStyle.Warning
EStyle.Danger

默认值EStyle.Primary

svgurl

自定义加载图形的 SVG 内容。

默认值""

sweepAngleint

加载圆弧的角度范围，单位为度。

默认值180

targetItem

滚动、定位或加载遮罩所作用的目标对象。

默认值null

textstring

显示的文字内容。

默认值""

textComponentComponent

自定义文字的 Component 插槽；null 使用默认内容。委托上下文见本页示例。

默认值null

visiblebool

是否显示组件。

默认值loading

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

angleint只读

加载图形当前旋转角度，单位为度。

默认值由运行时计算

animPhasereal只读

加载动画当前或上一阶段的位置，用于连续旋转计算。

默认值由运行时计算

cycleOffsetDegreal只读

连续加载动画累计的旋转角度，单位为度。

默认值由运行时计算

lastPhasereal只读

上一次加载动画相位，用于处理循环边界。

默认值由运行时计算

overlayModebool只读

加载指示器是否以覆盖层方式显示。

默认值由运行时计算

信号

签名作用

closed()

组件关闭后触发。

方法

签名作用

close()

关闭组件的面板或弹窗。

ELoading 加载 ​

示例与代码 ​

目标区域加载 ​

加载 ​

属性 ​

信号 ​

方法 ​

ELoading 加载

示例与代码

目标区域加载

加载

属性

信号

方法