列表选择器
开发者可使用列表选择器组件,用于投票等场景。
字段定义
| 字段 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| tag | 是 | string | tag=selection |
| content | 是 | object | 内容 |
∟ placeholder | 否 | string | 默认提示文本 |
| ∟ value | 否 | string | 列表选择器显示值,必须为 options 中的 value 发送消息时,可作为初始值更新消息时,作为显示值(否则用户不会显示所选择的内容) |
| config | 否 | object | 配置 |
| ∟ disable | 否 | bool | true: 用户无法点击 false: 用户可点击(触发回传)默认为 false |
| key | 是 | string | 用于回传标识,会将该字段值回传 |
| options | 是 | []object | 列表选项 |
| ∟ content | 是 | string | 选项内容 |
| ∟ value | 是 | string | 列表选择器显示值,必须为 options 中的 value 发送消息时,可作为初始值更新消息时,作为显示值(否则用户不会显示所选择的内容) |
图片示例

(图1:列表选择器)
代码示例
{
"tag":"action",
"actions":[
{
"tag":"selection",
"content":{
"placeholder":"请选择"
},
"key":"key1",
"options":[
{
"content":"选项1",
"value":"option1"
},
{
"content":"选项2",
"value":"option2"
},
{
"content":"选项3",
"value":"option3"
},
{
"content":"选项4",
"value":"option4"
}
]
}
]
}回传示例:
{
"company_id":"11111", // 企业id
"app_ctx_id":"11111", // 消息上下文id
"company_uid":"11111", // 操作用户id
"content":{ // 回传具体内容
"action":"key1", // 组件key
"value":"option1" // 用户选择的选项value
}
}