钉钉高级互动卡片是一种新型的消息类型,具有动态性、可交互性、多端统一等特点,能够极大地丰富消息类型,并促进用户的沟通互动。它是一种即时交互、多人协同、数据驱动的轻量卡片,将原本复杂的应用解构成一个个轻量级的卡片在钉钉的各个场域上运行。
互动卡片的数据结构较为复杂,由多个部分组成。具体来说,它包括左边的区域:大纲树,组件库,预设模板,和数据源;中间的区域:编辑画板区;右边的区域:组件设置区;以及页眉区域:模板管理区。
钉钉高级互动卡片的数据结构通常包含多个部分,以下是一个基本的高级互动卡片数据结构示例:
{
"cardType": "interactive",
"cardData": {
"config": {
"wideScreenMode": true, // 是否开启宽屏模式,默认为false
"btnOrientation": "ver", // 按钮排列方式,可选"hor"(水平)或"ver"(垂直)
"btnSpacing": 20, // 按钮之间的间距
"btnTextSize": 16 // 按钮文本大小
},
"header": {
"title": "卡片标题", // 卡片标题
"template": "blue", // 标题栏样式模板,如"blue"、"green"等
"imgUrl": "https://example.com/image.jpg", // 可选,标题栏背景图片URL
"link": { // 可选,点击标题跳转链接
"pcUrl": "https://example.com/pc",
"mobileUrl": "https://example.com/mobile"
}
},
"elements": [ // 卡片内容元素列表
{
"type": "text",
"text": "一段文本内容"
},
{
"type": "image",
"imgUrl": "https://example.com/image.jpg",
"link": { // 可选,点击图片跳转链接
"pcUrl": "https://example.com/pc",
"mobileUrl": "https://example.com/mobile"
}
},
{
"type": "button",
"title": "按钮标题",
"action": {
"type": "jsticket",
"params": {
"ticket": "your_ticket_here"
}
}
}
],
"actions": [ // 卡片底部操作按钮列表
{
"name": "操作一",
"value": "操作一值",
"type": "button",
"params": {} // 可选,附加参数
},
{
"name": "操作二",
"value": "操作二值",
"type": "button",
"params": {} // 可选,附加参数
}
]
},
"callbackId": "your_unique_callback_id", // 回调ID,用于在用户与卡片交互时识别和处理事件
"bizCardId": "your_biz_card_id", // 可选,关联的企业名片ID
"singleChatShowDetail": false // 可选,是否在单聊中显示详细信息,默认为false
}
这个数据结构包含了以下部分:
cardType
: 表示卡片类型,对于高级互动卡片应为 "interactive"
。cardData
: 包含了卡片的具体配置和内容。config
: 配置卡片的布局和样式。header
: 卡片的头部信息,包括标题、样式、背景图片和链接等。elements
: 卡片的内容元素列表,可以包含文本、图片、按钮等多种类型的元素。actions
: 卡片底部的操作按钮列表,每个按钮都有一个名称、值、类型和可选的附加参数。callbackId
: 用于在用户与卡片交互时识别和处理事件的唯一回调ID。bizCardId
: 可选,关联的企业名片ID。singleChatShowDetail
: 可选,是否在单聊中显示详细信息。钉钉高级互动卡片的数据结构较为复杂,主要包括以下几个部分:
{
"cardType": "interactive",
"cardJson": {
"header": {
"title": "卡片标题",
"logo": "图片URL",
"btnOrientation": "0"
},
"body": {
"form": {
"fields": [
{
"name": "字段名称",
"type": "input",
"placeholder": "请输入内容",
"options": []
},
...
]
}
},
"actions": [
{
"name": "操作名称",
"actionType": "button",
"value": "按钮值",
"styleType": "primary",
"_confirm": {
"title": "确认提示",
"text": "确认要执行此操作吗?"
}
},
...
]
},
"btnOrientation": "0"
}
具体结构可能会根据你的需求有所不同,建议参考钉钉开发者文档中的详细说明。
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。