组件/基础组件

EFloatButton 悬浮按钮

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 { height: 96 width: 420 EFloatButton { iconSource: EIcons.PLUS anchors.centerIn: parent tooltip: qsTr("查看详情") } }

效果

运行代码，体验组件交互

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

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

方形和文字

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { height: 96 width: 420 EFloatButton { shape: "square" anchors.centerIn: parent iconSource: EIcons.CHECK content: qsTr("保存") } }

效果

运行代码，体验组件交互

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

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

徽标和提示

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { height: 96 width: 420 EFloatButton { badge: ({ "value": 12 }) iconSource: EIcons.BELL anchors.centerIn: parent tooltip: qsTr("查看通知") } }

效果

运行代码，体验组件交互

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

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

主题状态

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { height: 96 width: 420 EFloatButton { anchors.centerIn: parent iconSource: EIcons.CHECK styleType: EStyle.Success } }

效果

运行代码，体验组件交互

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

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

禁用操作

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { height: 96 width: 420 EFloatButton { enabled: false iconSource: EIcons.PLUS anchors.centerIn: parent } }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

accessibleNamestring

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

默认值text

autoInsertSpacebool

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

默认值EControlConfig.optionFor(control, "button", "autoInsertSpace", false)

autofocusbool

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

默认值false

badgevar

按钮上显示的徽标内容或配置。

文字、数值或对象
对象字段：
value, isDot, max
showZero, hidden
color, offset

默认值""

bgbool

为文字按钮显示背景。

默认值false

checkablebool

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

默认值false

checkedbool

控件是否选中或开启。

默认值false

circlebool

采用圆形按钮样式。

默认值shape !== "square"

colorcolor

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

默认值EPaletteManager.BasePalette.transparent

contentalias

默认内容槽；EFloatButton 中为按钮文字的别名。

默认值control.text

dashedbool

使用虚线边框。

默认值EControlConfig.optionFor(control, "button", "dashed", false)

displayTextstring只读

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

默认值自动计算

durationint

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

默认值2600

enabledbool

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

默认值true

fontfont

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

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

默认值应用字体

heightreal

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

默认值implicitHeight

iconComponentComponent

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

默认值null

iconSizeint

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

默认值EDefaultConfig.iconSize(control.size)

iconSourceint

组件使用的图标。

EIcons.*
0（无图标）

默认值未设置

leftIconbool

将图标放在文字左侧。

默认值false

linkbool

采用链接按钮样式。

默认值false

loadingbool

是否处于加载状态。

默认值false

loadingComponentComponent

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

默认值null

loadingIconSourceint

组件使用的图标。

EIcons.*
0（无图标）

默认值未设置

minHeightint

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

默认值48

nativeTypestring

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

button
submit
reset

默认值"button"

paddingSpacingint

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

默认值6

plainbool

采用朴素配色。

默认值EControlConfig.optionFor(control, "button", "plain", false)

progressreal

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

默认值-1

roundbool

采用圆角胶囊按钮样式。

默认值EControlConfig.optionFor(control, "button", "round", false)

shapestring

悬浮按钮形状。

circle
square

默认值"circle"

sizeint

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

EStyle.Small
EStyle.Medium
EStyle.Large

默认值EControlConfig.sizeFor(control)

strokeWidthint

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

默认值3

styleTypeint

语义配色风格。

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

默认值EControlConfig.styleFor(control, "button", "type", EStyle.Default)

textstring

显示的文字内容。

默认值""

textButtonbool

采用文字按钮样式。

默认值link || EControlConfig.optionFor(control, "button", "text", false)

tooltipstring

鼠标悬停时显示的提示文字。

默认值""

visiblebool

是否显示组件。

默认值true

widthreal

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

默认值implicitWidth