按钮
更新时间:2022-12-01
概述
按钮是一种交互组件,用户可以自定义按钮的外观和文字样式,也可以添加超链接以达到跳转页面的效果。
特有属性设置
除了每个组件都拥有的常规静态属性(X, Y, 宽,高,字体等属性)之外,按钮主要还有如下配置项。
属性名称 | 描述 | 类型 |
---|---|---|
外观-背景图片 | 按钮背景可以选择用图片来填充 | string |
外观-填充模式 | 图片的填充方式可以三选一:填满容器(可能扭曲)/居中显示(可能留白)/等比填满(可能裁剪) | string |
外观-圆角 | 背景框的圆角属性,非负浮点数,单位为px | number |
文字设置-文字 | 按钮的文字 | string |
文字设置-两边距 | 按钮文字距离背景框左右两侧的内边距 | number |
文字设置-对齐 | 文字横向的对齐方式 | string |
链接设置-开启交互 | 是否开启按钮的点击跳转交互 | boolean |
链接设置-链接地址 | 点击按钮将跳转的超链接地址 | string |
链接设置-新开窗口 | 新开一个窗口打开链接,或者在当前窗口直接跳转 | boolean |
数据绑定
数据绑定,是连接『可视化仪表盘』与『数据』的窗口。数据绑定标签中可供选择的数据表,是已在数据标签中创建好的二维数据表。数据表的创建过程可参考 仪表盘数据表处理 及 典型实践文档。绑定的操作说明可参考仪表盘数据绑定。
按钮可视元件有以下可以绑定的属性:
属性名称 | 描述 | 数据类型 | 绑定类型 |
---|---|---|---|
文字 | 按钮文字 | string | 单值绑定 |
链接地址 | 点击按钮将跳转的超链接地址 | string | 单值绑定 |
交互事件
在设计器页面,可以双击组件进入组件交互。在运行或者分享页面,可以直接与组件进行交互。交互事件的监听可以通过物可视PlayerAPI中的 onWidgetDOMEvent API。
事件
事件名称 | 描述 | 监听函数 |
---|---|---|
click | 按钮的点击事件 | e => void; |