HusEmpty 空状态

January 28, 2026 · View on GitHub

← 返回主目录

← 返回本类别目录

HusEmpty 空状态

显示一个表示空状态的图像和描述文本。

  • 模块 { HuskarUI.Basic }

  • 继承自 { Control }


支持的代理:

  • imageDelegate: Component 图片代理

  • descriptionDelegate: Component 描述文本代理


支持的属性:

属性名类型默认值描述
imageSourcestring''自定义的图片地址(优先显示此地址)
imageStyleintHusEmpty.Style_Default预设的图片样式(来自 HusEmpty)
imageWidthint-图片宽度
imageHeightint-图片高度
showDescriptionbooltrue是否显示描述文本
descriptionstring''描述文本
descriptionFontfont-描述文本字体
descriptionSpacingint12描述文本与图像的间距
colorDescriptioncolor-描述文本颜色


代码演示

示例 1 - 基本

最简单的用法,支持图像和描述。

通过 imageSource 属性设置图片地址。

通过 imageStyle 属性设置预设的图片样式。

通过 description 属性设置描述文本。

import QtQuick
import HuskarUI.Basic

Column {
    spacing: 10

    HusRadioBlock {
        id: imageStyleRadio
        initCheckedIndex: 1
        model: [
            { label: 'None', value: HusEmpty.Style_None },
            { label: 'Default', value: HusEmpty.Style_Default },
            { label: 'Simple', value: HusEmpty.Style_Simple }
        ]
    }

    Rectangle {
        width: 230
        height: 230
        color: HusTheme.Primary.colorBgBase

        HusEmpty {
            anchors.fill: parent
            imageStyle: imageStyleRadio.currentCheckedValue
            description: qsTr('暂无数据')
        }
    }
}