切换按钮

简介

切换按钮组件是用于在两个状态之间切换的魔笔基础组件。点击时切换按钮的状态,通常表现为“开”或“关”状态的切换

image

配置项

分类

配置

示例

说明

内容

默认值

image

按钮是否处于开启状态

按钮文字

image

按钮上显示的文本内容

按钮类型

image

控制按钮的不同样式和行为,可选项:主要按钮,默认按钮,虚线按钮,文本按钮,链接按钮

开启徽标

image

是否展示徽标

徽标配置

image

开启徽标后,可以配置徽标属性

悬浮提示

image

是否展示悬浮提示

悬浮提示配置

image

开启「悬浮提示」后,可以配置悬浮提示属性

图标模式

image

可以设置图标模式,可选:固定图标,自定义图标

固定图标

image

可以设置三种类型图标

自定义图标

image

设置自定义图标

图标(True)

image

设置 True 状态图标

图标(False)

image

设置 False 状态图标

交互

隐藏

image

隐藏,详情参见通用属性

隐藏时保留布局

image

是否在隐藏时保留布局

加载

image

显示加载动画

禁用

image

控制组件是否禁用。禁用的组件展示为灰色,提示用户该组件不可用

样式

高度

image

高度,详情参见通用属性

外边距

image

外边距,详情参见通用属性

图标位置

image

设置图标位置,可选项:文本右侧,文本左侧,替换文本

幽灵样式

image

是否展示幽灵样式

危险按钮

image

展示危险按钮标记,强调操作的高风险,通常用于涉及数据丢失、账户删除或其他不可逆转操作的按钮

按钮形状

image

按钮展示形状,可以设置默认、圆形和圆角三种形状

按钮布局

image

按钮在容器内的布局方式,可选项:通栏、左侧、中央、右侧

CSS样式

圆角

image

详情参见通用属性

按钮内容字体大小

image

按钮内容字体大小

按钮内容字体行高

image

按钮内容字体行高

主要按钮激活态背景色

image

详情参见通用属性

主要按钮激活态文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

主要按钮悬浮态背景色

image

详情参见通用属性

主要按钮悬浮态文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

主要按钮背景色

image

详情参见通用属性

主要按钮文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

默认按钮激活态背景色

image

详情参见通用属性

默认按钮激活态边框颜色

image

详情参见通用属性

默认按钮激活态文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

默认按钮悬浮态背景色

image

详情参见通用属性

默认按钮悬浮态边框颜色

image

详情参见通用属性

默认按钮悬浮态文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

默认按钮背景色

image

详情参见通用属性

默认按钮边框颜色

image

详情参见通用属性

默认按钮文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

文本按钮激活态背景色

image

详情参见通用属性

文本按钮禁用时文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

文本按钮文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

文本按钮悬浮时背景颜色

image

详情参见通用属性

链接按钮激活态文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

链接按钮文本颜色

image

设置文本颜色,对应 CSS 属性:color,查看 mdn 详细说明

链接按钮文本悬浮时颜色

image

详情参见通用属性

属性与方法

名称

类型

示例

说明

value

boolean

togglebutton.value

默认值

setValue

func

togglebutton.setValue(true)

设置默认值

clearValue

func

togglebutton.clearValue()

清除组件value

text

string

togglebutton.text

按钮文本

setText

func

togglebutton.setText('按钮')

设置按钮文本

clearText

func

togglebutton.clearText('')

清除按钮文本

loading

boolean

togglebutton.loading

按钮加载状态

setLoading

func

togglebutton.setLoading(true)

设置按钮加载状态

disabled

boolean

togglebutton.disabled

是否禁用当前按钮

setDisabled

func

togglebutton.setDisabled(true)

设置是否禁用当前按钮

clearDisabled

func

splitButton.clearDisabled()

清除按钮禁用按状态

click

func

togglebutton.click()

点击

事件回调

事件名

说明

image

组件点击时的回调