HusDivider 分割线

February 5, 2026 · View on GitHub

← 返回主目录

← 返回本类别目录

HusDivider 分割线

区隔内容的分割线。

  • 模块 { HuskarUI.Basic }

  • 继承自 { Item }


支持的代理:

  • titleDelegate: Component 标题代理

  • splitDelegate: Component 分割线代理


支持的属性:

属性名类型默认值描述
animationEnabledboolHusTheme.animationEnabled是否开启动画
titlestring''标题
titleFontfont-标题字体
titleAlignenumHusDivider.Align_Left标题对齐(来自 HusDivider)
titlePaddingint20标题填充
lineStyleenumHusDivider.SolidLine分割线样式(来自 HusDivider)
lineWidthreal1分割线宽度
dashPatternarray[4, 2]分割线虚线模式
orientationenumQt.Horizontal方向(Qt.Horizontal 或 Qt.Vertical)
colorTextcolor-标题颜色
colorSplitcolor-分割线颜色
contentDescriptionstring''内容描述(提高可用性)

代码演示

示例 1

通过 title 属性改变标题文字。

通过 titleAlign 属性改变标题对齐,支持的对齐:

  • 居左(默认){ HusDivider.Align_Left }

  • 居中{ HusDivider.Align_Center }

  • 居右{ HusDivider.Align_Right }

import QtQuick
import HuskarUI.Basic

Column {
    width: parent.width
    spacing: 15

    HusText {
        width: parent.width
        text: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nonne merninisti licere mihi ista probare, quae sunt a te dicta? Refert tamen, quo modo.'
        wrapMode: Text.WrapAnywhere
    }

    HusDivider {
        width: parent.width
        height: 30
        title: qsTr('水平分割线-居左')
        titleAlign: HusDivider.Align_Left
    }

    HusDivider {
        width: parent.width
        height: 30
        title: qsTr('水平分割线-居中')
        titleAlign: HusDivider.Align_Center
    }

    HusDivider {
        width: parent.width
        height: 30
        title: qsTr('水平分割线-居右')
        titleAlign: HusDivider.Align_Right
    }
}

示例 2

通过 orientation 属性改变方向,支持的方向:

  • 水平分割线(默认){ Qt.Horizontal }

  • 垂直分割线{ Qt.Vertical }

如果需要垂直标题,请自行添加

import QtQuick
import HuskarUI.Basic

Column {
    width: parent.width
    spacing: 15

    HusText {
        width: parent.width
        text: qsTr('Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nonne merninisti licere mihi ista probare, quae sunt a te dicta? Refert tamen, quo modo.')
        wrapMode: Text.WrapAnywhere
    }

    HusDivider {
        width: parent.width
        height: 30
        title: qsTr('水平分割线')
    }

    HusDivider {
        width: 30
        height: 200
        orientation: Qt.Vertical
        title: qsTr('垂\n直\n分\n割\n线')
    }
}

示例 3

通过 lineStyle 属性改变线条风格,支持的风格:

  • 实线(默认){ HusDivider.SolidLine }

  • 虚线{ HusDivider.DashLine }

import QtQuick
import HuskarUI.Basic

Column {
    width: parent.width
    spacing: 15

    HusText {
        width: parent.width
        text: qsTr('Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nonne merninisti licere mihi ista probare, quae sunt a te dicta? Refert tamen, quo modo.')
        wrapMode: Text.WrapAnywhere
    }

    HusDivider {
        width: parent.width
        height: 30
        title: qsTr('实线分割线')
    }

    HusDivider {
        width: parent.width
        height: 30
        lineStyle: HusDivider.DashLine
        title: qsTr('虚线分割线')
    }
}