按钮

文档基于按钮v1.0.15版本

组件说明

按钮组件可以通过默认、悬停、点击等配置项修改按钮组件不同状态的样式，可用于页面之间的效果切换，用于交互效果的实现，在可视化应用中使用广泛。

效果案例

如下案例所示。

一、样式

在样式中可以设置组件的基本属性、全局、样式和数据系列。

1、基本属性

位置尺寸

位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。

尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。

基本柱状图组件尺寸不影响组件内容显示、组件动画。

默认隐藏

勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制。

2、全局

在全局配置中可以调整组件文字方向、水平对齐、垂直对齐、偏移。

文字方向

在全局配置中可以针对按钮中的文字对进行调整，包括文字横排/竖排显示和水平、垂直对齐方式。

偏移

偏移即按钮内文字和图标整体，以px为单位在“按钮内”进行偏移。

3、样式

样式分为默认、点击、悬停三个不同情况，当前以默认情况为例。

圆角

可以根据需要，调整按钮的圆角样式。格式：左上,右上,右下,左下（例如:10,20,30,19）或者只输入一个值，此时四个角圆角相同。

文字

文本样式：

当有特定字体需求时，对坐标轴显示字体进行调整，可以对字体、字体大小、字体颜色、加粗、斜体、字距、行距进行设置。当需要调整时，可以根据效果逐步修改。

偏移：

偏移用来调整选项文字的偏移量，以px为单位在按钮内进行偏移。

阴影：

按钮未选中时的文字阴影，如下示例图所示将阴影调整为了红色，可以通过x/y模糊/扩展四项配置进行进一步调整。

背景

背景可以设置为颜色或者自定义图片两种背景方式。

如下示例图所示将背景填充方式设置为蓝黑色：

如下示例图所示将背景填充方式设置为一张纯色底图：

描边

描边设置的是按钮的描边程度，如下示例图所示，为凸显配置将选项粗细设置为8，还可以通过颜色进行进一步调整。

阴影

可以设置内阴影和外阴影的颜色、水平阴影（X）、垂直阴影（Y）、模糊程度。

图标

图标设置的是按钮内文字前的图标，如下示例图所示，为丰富按钮的样式在文字前加上图标，还可以对图标的尺寸、边距进一步调节。

动画

点击或悬停可以开启动画。动画设置的是按钮的动画效果。目前提供两种内置动画样式，水波纹和流光，如下图所示修改对应的动画时长等配置。

示例效果如下

二、数据

组件数据格式

*数据格式说明

JSON数据案例

[
	{
		"text": "按钮",
		"state": "on"
	}
]

数据对接详情

数据对接详情请见以下文档👇

项目交付——数据对接入门

三、交互

载入动画

所有组件均提供移入、移入(小)、划变三种组件载入动画。

载入动画选择无时，则组件没有载入动画。

载入动画仅在可视化应用预览、发布组件加载时显示。

载入动画配置项：

回调参数

回调参数即为全局性的参数变量，用于控制组件之间参数的传递，可通过设置回调参数来实现数据驱动交互。

其中，字段值即参数变量，变量名即对字段值的重命名。

详细的回调参数教学👉 回调的使用

自定义事件

简单而言，自定义事件通过事件类型+条件去控制其他组件的不同状态。

自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑。

详细的自定义事件教学👉自定义事件教学

欢迎您在评论区留下您对该组件的意见，管理员会及时回复您，如长时间未回复欢迎您搜索钉钉群：33782396或者扫描以下二维码添加微信群说出您的想法，采纳后将送出定制礼品。

也可以通过问卷来向我们反馈需求：https://jinshuju.net/f/XyCXU0