Skip to content

列表选择器

开发者可使用列表选择器组件,用于投票等场景。

字段定义

字段是否必填类型说明
tagstringtag=selection
contentobject内容

∟ placeholder

string默认提示文本
∟ valuestring列表选择器显示值,必须为 options 中的 value 发送消息时,可作为初始值更新消息时,作为显示值(否则用户不会显示所选择的内容)
configobject配置
∟ disablebooltrue: 用户无法点击 false: 用户可点击(触发回传)默认为 false
keystring用于回传标识,会将该字段值回传
options[]object列表选项
∟ contentstring选项内容
∟ valuestring列表选择器显示值,必须为 options 中的 value 发送消息时,可作为初始值更新消息时,作为显示值(否则用户不会显示所选择的内容)

图片示例

xiezuo20220627-104103.png

(图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
    }
}