组件/导航组件

EBacktop 回到顶部

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: parent.width height: 280 Flickable { id: scroll clip: true width: parent.width - 130 height: parent.height contentHeight: sections.height Column { id: sections width: parent.width spacing: 20 ECard { id: overview height: 240 width: parent.width header: "概览" } ECard { id: details height: 240 width: parent.width header: "详细内容" } } } EBacktop { target: scroll } }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

accessibleNamestring

辅助技术读取的名称；建议为无文字控件设置可读名称。

默认值随当前语言变化

autoInsertSpacebool

在两个中文字符的按钮文字之间插入空格。

默认值继承 Provider，默认 false

autofocusbool

组件显示时自动聚焦；受控件可用状态及弹层生命周期影响。

默认值false

bgbool

为文字按钮显示背景。

默认值false

checkablebool

是否允许通过点击切换选中状态。

默认值false

checkedbool

控件是否选中或开启。

默认值false

circlebool

采用圆形按钮样式。

默认值true

colorcolor

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

默认值动态绑定

dashedbool

使用虚线边框。

默认值继承 Provider，默认 false

durationint

加载图标完成一圈旋转的时间，单位为毫秒。

默认值250

enabledbool

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

默认值true

fontfont

字体配置，控制字体、字号及文字样式。

常用字段：
family、pixelSize、pointSize
bold、italic、weight
underline、strikeout
letterSpacing、wordSpacing

默认值应用字体

heightreal

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

默认值40

iconComponentComponent

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

默认值null

iconSizeint

图标、选项或交互部件的尺寸，单位为像素。

默认值16

iconSourceint

组件使用的图标。

EIcons.*
0（无图标）

默认值EIcons.CHEVRON_UP

leftIconbool

将图标放在文字左侧。

默认值false

linkbool

采用链接按钮样式。

默认值false

loadingbool

是否处于加载状态。

默认值false

loadingComponentComponent

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

默认值null

loadingIconSourceint

组件使用的图标。

EIcons.*
0（无图标）

默认值0

minHeightint

控件最小高度，单位为像素；默认随 size 变化。

默认值动态绑定

nativeTypestring

按钮行为，可用于普通操作、提交或重置表单。

button
submit
reset

默认值"button"

paddingSpacingint

文字和图标之间的间距，单位为像素。

默认值6

plainbool

采用朴素配色。

默认值继承 Provider，默认 false

progressreal

进度值；用于进度动画或通知进度显示，具体范围由组件处理。

默认值-1

roundbool

采用圆角胶囊按钮样式。

默认值继承 Provider，默认 false

sizeint

控件尺寸；默认继承最近的 EConfigProvider。

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider，默认 EStyle.Medium

strokeWidthint

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

默认值3

styleTypeint

语义配色风格。

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

默认值EStyle.Primary

targetItem

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

默认值null

textstring

显示的文字内容。

默认值""

textButtonbool

采用文字按钮样式。

默认值继承 Provider，默认 false

visibilityHeightreal

滚动到此高度后显示回到顶部按钮，单位为像素。

默认值200

visiblebool

是否显示组件。

默认值动态绑定

widthreal

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

默认值40

displayTextstring只读

经过格式化、进度或徽章规则处理后的显示文字。

默认值由运行时计算

方法

签名作用

scrollToTop()

滚动到目标内容顶部。