Appearance
变量、模板与动态数据
变量用于把插件、工作流或应用产生的数据映射到卡片组件。模板负责复用布局，不会自动提供真实业务数据。
创建变量
变量需要明确名称、类型、示例和是否必填。推荐先根据调用方输出契约设计变量，再绑定组件。
| 数据形态 | 常见用途 |
|---|---|
| 字符串 | 标题、说明、状态文本 |
| 数字 | 金额、数量、评分 |
| 布尔值 | 显示条件、开关状态 |
| 对象 | 详情信息和嵌套结构 |
| 数组 | 列表、表格和重复区域 |
绑定检查
- 变量名称与调用方输出完全一致。
- 对象字段路径和数组项结构稳定。
- 空值有占位、隐藏或默认展示规则。
- 示例数据覆盖最长文本和最大列表数量。
- 按钮回传参数符合插件或工作流契约。
模板复用
使用模板后应重新命名资源、检查变量和交互。模板更新不会自动同步到已经创建的卡片副本。