AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

卡片

更新时间：
复制为 MD 格式
我的收藏

卡片组件以一定的界面样式展示常用数据。例如展示设备属性数据或接口返回的数值型数据。下文介绍组件的详细配置方法。

步骤一：添加组件

  1. 创建Web应用。具体操作，请参见创建Web应用。

  2. 在Web应用编辑器中，单击最左侧的组件图标组件。

  3. 在画布左侧组件列表上方，输入卡片，找到该组件，然后将组件拖拽到中间画布。

    有关组件添加的更多信息，请参见添加组件。

    在左侧组件面板搜索框中输入卡片，从基础组件区域选中卡片组件并拖入画布。在右侧样式面板中可配置组件的坐标、尺寸、名称、可见性、不透明度等基础属性，单击配置数据源绑定数据，并设置标题、单位、背景颜色及边框（粗细、颜色、样式）等样式属性。

步骤二：配置数据源

  1. 在Web应用编辑器右侧样式中，单击展示数据后的配置数据源。

  2. 在数据源配置页面，选择数据源类型，完成配置。
    可选数据类型有设备、接口、应用推送。
    说明 接口或设备数据源返回的数据类型必须为单精度数字、双精度数字、整数。
    以设备数据源为例，在选择数据源面板中需要依次配置以下参数：选择产品、选择设备（支持指定设备、动态设备和空设备三种方式）、选择数据项类型（如设备属性）以及具体的属性。配置完成后可单击格式参考查看示例或单击验证数据格式进行验证，确认无误后单击确定。
  3. 单击确定。

步骤三：配置样式

  1. 在右侧样式中，设置卡片标题、数据单位、背景样式和边框样式。

    样式中有多个配置项支持配置动态数据源，可选设备、接口、应用推送。其中，边框颜色仅支持配置接口和应用推送数据源。

    不同配置项支持的数据格式不同，数据源返回数据需与要求的数据格式保持一致。

    配置项

    数据格式

    组件可见性

    布尔型或枚举型，设置对应的可见和不可见。

    如果配置数据源为设备，仅支持选择属性，支持数据格式为单精度数字、双精度数字、整数、布尔型和枚举型。此时，支持设置设备离线时组件是否可见。若数据源的数据格式为数值型，需要转换整数型为布尔值或转换数字为枚举型后设置对应的可见性。

    说明

    在重复列表中使用该组件时，若需要根据设备物模型属性设置组件可见性及对应设备离线时组件可见性，该组件数据源配置需关联设备，配置方法如下：

    • 重复列表数据源配置为设备，该组件可见性的数据源可配置为母组件数据源或设备。

    • 重复列表数据源配置非设备，该组件可见性的数据源必须为设备。

    填充颜色

    布尔型或枚举型。

    如果配置数据源为设备，仅支持选择属性，支持数据格式为单精度数字、双精度数字、整数、布尔型和枚举型。此时，支持设置设备离线时组件内容的显示颜色。若数据格式为数值型，需要转换整数型为布尔值或转换数字为枚举型后设置不同值显示的颜色。

    说明

    在重复列表中使用该组件时，若需要根据设备物模型属性设置颜色及对应设备离线时组件显示颜色，该组件数据源配置需关联设备，配置方法如下：

    • 重复列表数据源配置为设备，该组件颜色的数据源可配置为母组件数据源或设备。

    • 重复列表数据源配置非设备，该组件颜色的数据源必须为设备。

    边框粗细

    整数，取值范围为0~1000。

    边框颜色

    RGB颜色的JSON格式。

    说明

    其中a为可选参数，表示颜色透明度，取值范围为0~100。

    {
  "r": 255,
  "g": 255,
  "b": 255,
  "a":0
}

    边框样式
    整数，取值范围为0~2。

    对应线样式的映射关系为（同下拉列表顺序）：

    • 实线：0
    • 虚线：1
    • 点线：2

  2. 调整组件在页面中的最终位置。有关组件通用样式配置的更多信息，请参见样式配置。

步骤四：配置交互动作

  1. 选中组件的交互页签，配置事件和交互动作。具体操作请参见交互配置。

    例如，点击组件，执行动作打开链接，即配置链接打开方式，展示链接的内容。

  2. 单击页面右上方的预览，预览和调试组件展示的数据和样式。

上一篇：指示灯下一篇：时钟