翻牌器
文档基于翻牌器v1.1.10版本
组件说明
翻牌器是指标组件的一种，支持自定义翻牌器的标题、数字、前缀、后缀样式，在可视化应用中用于展示实时数据的变化情况，通常单独用于热数据展示或与其他组件配合使用。
效果案例
*翻牌器做核心指标效果案例
*翻牌器结合地图效果案例
一、样式
在样式中可以设置组件的基本属性、全局配置和翻牌器。
1、基本属性
位置尺寸
位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。
尺寸宽度大于组件实际大小时，不影响组件显示，组件不被拉伸；尺寸宽度小于组件实际宽度时，组件布局受影响；尺寸高度小于组间实际高度时，不影响组件显示。
*组件位置尺寸说明
默认隐藏
勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。
2、全局配置
排列方式
翻牌器标题与前缀、数值、后缀的布局关系：标题在上、标题在右、标题在下、标题在左
*翻牌器排列方式说明
对齐方式
翻牌器标题与前缀、数值、后缀的对齐关系：起点、居中、终点、两端。
对齐方式两端只有在排列方式为标题在左、标题在右为左右布局时生效。
*翻牌器排列方式说明
标题
组件默认启用组件标题，可禁用
配置项 | 说明 |
内容 | 输入标题文字，组件优先使用数据面板中配置的数据 |
字体 | 设置标题文字字体 |
阴影 | 设置内容阴影的位置，模糊程度等 |
字号 | 设置标题文字字号大小，单位为pt |
颜色 | 设置标题文字颜色 |
透明度 | 设置标题文字透明度 |
加粗 | 设置标题文字是否加粗 |
斜体 | 设置标题文字是否倾斜 |
字距 | 设置标题文字间距大小，单位为px |
行距 | 设置标题文字行间距大小，单位为px |
偏移 | 设置标题位置，单位为px |
*标题配置项说明
*标题设置
3、翻牌器
翻牌器由四部分构成：标题、前缀、数据、后缀，各个部分(包含后缀)均可单独配置样式。
添加组件时前缀默认为禁用状态，禁用状态时，数据与后缀自适应布局。
*翻牌器组件结构
前缀
组件默认禁用前缀，可启用
内容：翻牌器前缀内容，可以为空
开启样式跟随数字，前缀样式与数值样式相同
配置前缀文本样式
配置项 | 说明 |
字体 | 设置前缀文字字体 |
字号 | 设置前缀文字字号大小，单位为pt |
颜色 | 设置前缀文字颜色 |
透明度 | 设置前缀文字透明度 |
加粗 | 设置前缀文字是否加粗 |
斜体 | 设置前缀文字是否倾斜 |
字距 | 设置前缀文字间距大小，单位为px |
行距 | 设置前缀文字行间距大小，单位为px |
偏移 | 设置前缀位置，单位为px |
*前缀配置项说明
*前缀修改
数值
*数值设置
阴影
组件默认启用数字阴影，可禁用。
配置项 | 说明 |
水平阴影 | 水平阴影、垂直阴影设置阴影的形态 |
垂直阴影 | |
模糊距离 | 模糊距离设置阴影的模糊程度 |
颜色 | 设置数字字体阴影颜色 |
*阴影配置项说明
布局
*数值的布局设置
格式化
小数样式选择自定义可更改小数部分样式
分割样式选择自定义可更改分隔符样式
设置数值显示样式
配置项 | 说明 |
异常数据占位 | 可以在数据异常时显示对应内容 |
分割位数 | 可根据业务场景需求选择数据分割位数，从数值末尾往数值首端计 位（例：数据为1234，分割3位，显示1,234） |
补零位数 | 数据返回数据位数小于数据展示位数时，可设置补零位数向前补零 补零位数需大于数据位数，否则组件报错 |
小数位数 | 设置小数点后保留位数，若数据内小数位数大于样式设置，自动进 行四舍五入，勾选尾零省略可以尾部的0（例：数据为1234.56，设置一位小数，显示1234.6） |
*格式化配置项配置说明
*格式化设置
背景
配置翻牌器每个数值背景图片。
图片根据数字字号大小以图片宽高比例自适应。
*背景设置
自定义符号
支持通过上传图片自定义设置符号，修改符号图片大小和位置。
*自定义符号设置
动画
组件预置两种数字滚动动画：跳动、滚动，也可以选择无动画
*翻牌器动画说明
动画选择普通时，可选择启用模拟数据请求可模拟数据间隔一段时间更新的数据变更动画。
动画选择滚动时，无法启用模拟数据请求。
起跳占比：
数据更新动画初始数值占原本数值的比例。
例起跳占比为起跳占比为0.5，数据将从0.5倍开始滚动，至原本数据大小。
动画间隔：
设置数据更新动画的时长。
*动画设置
后缀
组件默认开启后缀，可禁用
内容：翻牌器后缀内容，可以为空
开启样式跟随数字，后缀样式与数值样式相同
配置后缀文本样式
配置项 | 说明 |
字体 | 设置后缀文字字体 |
字号 | 设置后缀文字字号大小，单位为pt |
颜色 | 设置后缀文字颜色 |
透明度 | 设置后缀文字透明度 |
加粗 | 设置后缀文字是否加粗 |
斜体 | 设置后缀文字是否倾斜 |
字距 | 设置后缀文字间距大小，单位为px |
行高 | 设置后缀文字行间距大小，单位为px |
偏移 | 设置后缀位置，单位为px |
*后缀配置项配置说明
后缀阴影默认开启，可隐藏
配置项 | 说明 |
水平阴影（X） | 水平阴影、垂直阴影设置阴影的形态 |
垂直阴影（Y） | |
模糊距离 | 模糊距离设置阴影的模糊程度 |
颜色 | 设置数字字体阴影颜色 |
*后缀阴影配置项配置说明
*后缀修改
二、数据
组件数据格式
字段 | 说明 |
name | 名称，翻牌器名称 |
value | 数值，翻牌器数值 |
prefix | 前缀，翻牌器前缀 |
suffix | 后缀，翻牌器后缀 |
*数据格式说明
JSON数据案例
[
{
"name": "翻牌器标题",
"value": -1234.56,
"prefix": "",
"suffix": "/单位"
}
]CSV数据格式案例
数据配置项说明
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
*数据配置项说明
数据对接详情
数据对接详情请见以下文档👇
三、交互
载入动画
所有组件均提供移入、移入(小)、划变三种组件载入动画。
载入动画选择无时，则组件没有载入动画。
载入动画仅在可视化应用预览、发布组件加载时显示。
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
回调参数
回调参数即为全局性的参数变量，用于控制组件之间参数的传递，可通过设置回调参数来实现数据驱动交互。
其中，字段值即参数变量，变量名即对字段值的重命名。
详细的回调参数教学👉 回调的使用
自定义事件
自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑；
详细的自定义事件教学👉自定义事件教学
视频教程
欢迎您在评论区留下您对该组件的意见，管理员会及时回复您，如长时间未回复欢迎您搜索钉钉群：33782396或者扫描以下二维码添加微信群 @谨禧 说出您的想法，采纳后将送出定制礼品。
也可以通过问卷来向我们反馈需求：https://jinshuju.net/f/XyCXU0