Files
Starlight_Lancher/.claude/skills/lark-im/references/card/components/date_picker.md

1.6 KiB
Raw Blame History

日期选择器 date_picker

提供日期选项的交互组件,默认拥有交互能力(无需显式 behaviors 也会回调)。Card 2.0

最小示例

{
  "tag": "date_picker",
  "placeholder": { "tag": "plain_text", "content": "请选择" },
  "initial_date": "2024-01-01"
}

字段

字段 必填 类型 默认 说明
tag String / 固定 date_picker
name 否* String / 唯一标识;form 内必填且全局唯一
required Boolean false 是否必选form 内生效)
initial_date String / 初始值,格式 yyyy-MM-dd,会覆盖 placeholder
placeholder Object / 占位文本plain_text未设 initial_date 时必填
width String default default/fill/[100,∞)px
disabled Boolean false 是否禁用(需端版本 V7.4+
behaviors Array / [{type:"callback", value:{...}}]
confirm Object / 二次确认弹窗 {title, text}
margin String 0 [-99,99]px

嵌套 / 易错点

  • 可嵌套在 column_set / form / collapsible_panel / 循环容器 / 交互容器内;搭建工具中暂不支持嵌套在交互容器中。
  • 提醒用户注意时区语境(如预定海外酒店用酒店所在地时区);服务端只返回用户当前时区作为参考,不代表用户选的就是该时区。
  • 回调:action.tag="date_picker" + action.option(日期字符串,如 "2025-06-10 +0800"+ action.timezoneform 内则读 form_value[name]