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

多图选择 select_img

以图片为选项的交互组件，支持单选/多选（如商品图、模板图、AI 生成图）。仅支持手写 JSON，搭建工具不支持。Card 2.0。

最小示例

{
  "tag": "select_img",
  "name": "select_img_1",
  "layout": "bisect",
  "aspect_ratio": "16:9",
  "options": [
    { "img_key": "img_v2_xxx", "value": "picture1" },
    { "img_key": "img_v2_yyy", "value": "picture2" }
  ]
}

字段

字段	必填	类型	默认	说明
tag	是	String	/	固定 select_img
options	是	Array	/	选项，每项 {img_key, value, disabled?, disabled_tips?, hover_tips?}
multi_select	否	Boolean	false	多选仅支持异步提交，必须内嵌在 form 中，否则报错
layout	否	String	bisect	图片布局：stretch(撑满)/bisect(二等分)/trisect(三等分)
aspect_ratio	否	String	16:9	1:1/16:9/4:3
name	否*	String	/	唯一标识；form 内必填且全局唯一
required	否	Boolean	false	是否必选（form 内生效）
can_preview	否	Boolean	true	点击图片是否弹窗放大（仅 form 内生效）
disabled	否	Boolean	false	是否禁用整组件
value	否	String/Object	/	自定义回传参数
behaviors	是	Array	/	[{type:"callback", value:{...}}]
confirm	否	Object	/	二次确认弹窗 {title, text}

嵌套 / 易错点

• 可嵌套在根节点 / column_set / form / 交互容器（搭建工具暂不支持嵌套交互容器）。
• 不在 form 内：仅支持单选，点击立即提交触发回调，不支持多选/异步提交。
• 在 form 内：支持单选/多选 + 异步提交（随表单一起提交）。
• 回调（非 form）：action.tag="select_img" + action.options（单选时仍是该字段）；form 内则读 form_value[name]。