状态卡片

文档基于状态卡片v1.0.4版本

组件说明

状态卡片是展示不同状态的组件，可以通过添加数据的方式，添加多个状态，根据状态显示相应的图标，帮助管理者直观地做出判断。

效果案例

状态卡片是展示不同状态的组件，可以通过添加数据的方式，添加多个状态，帮助管理者直观地做出判断。

一、样式

在样式中可以设置组件的基本属性、全局和状态栏。

1、基本属性

位置尺寸

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

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

图标占比图组件尺寸不影响组件内容显示、组件动画。

默认隐藏

勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。

2、全局

在全局配置中可以调整组件的内容溢出、边距和文本样式。

内容溢出

若显示文字较多不能完整展示，可在内容溢出栏选择显示、滚动、隐藏三种显示状态

边距

在边距栏，可调整状态卡片整个组件四边（上、下、左、右）的边距。

四个边距具体位置如下图所示👇

文本样式

可在文本样式栏目下设置文本字体、大小、颜色、透明度等，来实现文字样式的自定义。

3、状态栏

在状态栏配置中可以调整组件的排列方式、高度/宽度（选择横向排列为宽度，纵向排列为高度）和子项间距。

排列方式

排列方式可选择横向或纵向排列。

下图为横向排列样式👇

高度/宽度与子项间距

采取纵向排列后可设置组件高度与子项间距，单位为px。

采取横向排列后可设置组件宽度与子项间距，单位为px。

鼠标滑过

设置鼠标滑过时底色的改变。

系列

点击可添加多个数据系列，每个数据系列拥有自己的字段名可对应一种状态，同时可在下方设置状态的图片，图片尺寸与偏移距离。

二、数据

组件数据格式

*组件数据格式说明

JSON数据案例

[
	{
		"name": "服务器 #001：成功",
		"status": "success"
	},
	{
		"name": "服务器 #002：失败",
		"status": "error"
	},
	{
		"name": "服务器 #003：挂起",
		"status": "suspend"
	}
]

数据配置项说明

数据对接详情

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

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

三、交互

状态卡片组件当前通过载入动画、点击回调、自定义事件三种方式设置交互。

载入动画

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

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

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

载入动画配置项：

点击回调

点击回调即指在点击组件后发出回调参数。

回调参数可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的。

字段值即参数变量，变量名是对字段值的重命名

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

自定义事件

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

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

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

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