开发者社区> 问答> 正文

钉钉高级互动卡片数据结构是怎么样的?

钉钉高级互动卡片数据结构是怎么样的?

展开
收起
真的很搞笑 2023-12-28 08:02:56 53 0
3 条回答
写回答
取消 提交回答
  • 面对过去,不要迷离;面对未来,不必彷徨;活在今天,你只要把自己完全展示给别人看。

    钉钉高级互动卡片是一种新型的消息类型,具有动态性、可交互性、多端统一等特点,能够极大地丰富消息类型,并促进用户的沟通互动。它是一种即时交互、多人协同、数据驱动的轻量卡片,将原本复杂的应用解构成一个个轻量级的卡片在钉钉的各个场域上运行。

    互动卡片的数据结构较为复杂,由多个部分组成。具体来说,它包括左边的区域:大纲树,组件库,预设模板,和数据源;中间的区域:编辑画板区;右边的区域:组件设置区;以及页眉区域:模板管理区。

    2023-12-28 16:43:16
    赞同 展开评论 打赏
  • 钉钉高级互动卡片的数据结构通常包含多个部分,以下是一个基本的高级互动卡片数据结构示例:

    {
      "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: 可选,是否在单聊中显示详细信息。
    2023-12-28 14:42:59
    赞同 展开评论 打赏
  • 钉钉高级互动卡片的数据结构较为复杂,主要包括以下几个部分:

    {
      "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"
    }
    

    具体结构可能会根据你的需求有所不同,建议参考钉钉开发者文档中的详细说明。

    2023-12-28 14:27:27
    赞同 展开评论 打赏
来源圈子
更多
收录在圈子:
+ 订阅
问答排行榜
最热
最新

相关电子书

更多
钉钉小程序——为工作方式插上翅膀 立即下载
钉钉客户端自动化的应用 立即下载
使命必达 —— 钉钉企业级 消息服务的机遇与挑战 立即下载