聆客开放平台

# 如何构造卡片

卡片是由许多的基础的模块搭建而成的一个消息卡片。 下面将详细介绍卡片的构造,帮助您快速地学习并构建属于你的卡片!

# 卡片配置数据结构

卡片是通过 JSON 数据结构进行描述的,总共可将该描述划分为三个部分:卡片属性、卡片头部以及卡片内容。

# 卡片属性

字段 是否必填 类型 描述 示例
rootPadding int 卡片边距 0
axisSpacing int 卡片众轴间隔 0

# json示例

{
  "config": {
    "rootPadding": 0,
    "axisSpacing": 0
  }
}

# 卡片内容

卡片的模块构成总共可以分为以下三大类:

# 基础模块

提供基础的内容展示,目前共支持以下类型

  • 文本模块
  • 富文本模块
  • 图片模块
  • 多图模块
  • 轮播图模块
  • 视频模块
  • 分割线模块
  • 交互模块

# 提供可交互的表单组件,增加卡片的交互性,目前以支持以下交互组件

  • 按钮
  • 混排模块

# 将文本与上述的特定模块混合组成,提供更丰富的布局与交互,目前支持以下混排布局

  • 文本 + 图片
  • 文本 + 聚合菜单
  • 文本 + 按钮