Files
Starlight_Lancher/.agents/skills/lark-im/references/card/components/interactive_container.md

2.2 KiB
Raw Blame History

交互容器 interactive_container

整块可点击区域统一定义内嵌内容的样式和交互callback/open_url适合卡片内的列表项、可点击卡片块。Card 2.0

最小示例

{
  "tag": "interactive_container",
  "width": "fill",
  "has_border": true,
  "border_color": "grey",
  "corner_radius": "8px",
  "padding": "4px 12px 4px 12px",
  "behaviors": [{ "type": "callback", "value": { "key": "value" } }],
  "elements": [
    { "tag": "markdown", "content": "帮我生成一篇产品方案的框架" }
  ]
}

字段

字段 必填 类型 默认 说明
tag String / 固定 interactive_container
elements Element[] [] 子节点,支持除 form/table 外的所有组件
behaviors Array / 点击整容器的交互:callback(回传)/ open_url(跳转),可同数组共存
width String fill fill/auto/[16,999]px
height String auto auto/[10,999]px
direction String vertical vertical/horizontal
horizontal_align/vertical_align String left/top 对齐方式
background_style String default default/laser/颜色枚举/RGBA../resource/colors.md
has_border Boolean false 是否展示 1px 边框
border_color String grey has_border 为 true 时生效
corner_radius String 0px [0,∞]px[0,100]%
padding/margin String 4px,12px / 0px 同间距写法
disabled / disabled_tips Boolean/Object false / 空 禁用整容器及禁用提示
hover_tips Object PC 端悬浮提示
confirm Object / 二次确认弹窗 {title, text}

嵌套 / 易错点

  • 可嵌套除 form/table 外的所有组件,包括嵌套自身(列表项常见写法)。
  • 若容器内有交互组件(如内部 button),优先响应该子组件的交互,容器级 behaviors 不会触发。
  • 回调来源:card.action.triggeraction.tag 取决于内部触发的具体组件;容器本身被点击时 action.value 即容器 behaviors.value