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

输入框 input

收集用户文本输入。常嵌在 form 内配合提交按钮使用。Card 2.0。

最小示例

{
  "tag": "input",
  "name": "comment",
  "placeholder": { "tag": "plain_text", "content": "请输入" },
  "label": { "tag": "plain_text", "content": "备注：" }
}

字段

字段	必填	类型	默认	说明
tag	是	String	/	固定 input
name	否*	String	/	唯一标识；在 form 内必填且全局唯一，用于识别提交数据
required	否	Boolean	false	是否必填（仅 form 内生效）
placeholder	否	Object	/	占位文本，plain_text，≤100 字符
default_value	否	String	/	预填内容
label	否	Object	/	描述文本，plain_text
label_position	否	String	top	top / left（窄屏自动转 top）
input_type	否	String	text	text / multiline_text(多行，回调含 \n) / password
rows	否	Number	5	多行时默认行数
auto_resize	否	Boolean	false	多行时高度自适应（仅 PC）
max_rows	否	Number	/	auto_resize 时最大行数
max_length	否	Number	1000	最大字符数，[1,1000]
show_icon	否	Boolean	true	password 时是否显示前缀图标
width	否	String	default	default / fill / [100,∞)px
disabled	否	Boolean	false	是否禁用（配 disabled_tips plain_text）
behaviors	否	Array	/	[{type:"callback", value:{...}}]
confirm	否	Object	/	二次确认弹窗 {title, text}
margin	否	String	0	外边距 [-99,99]px

嵌套 / 易错点

• 可嵌套在 column_set / form / collapsible_panel / 循环容器 / interactive_container 内。
• 在 form 内为异步提交：用户填完点提交按钮才一次性回调全部表单数据。
• 回调里 action.tag="input" + action.input_value（用户输入值）；form 提交则值在 form_value 内。