组合卡
CompositeCard 用于一个完整业务语义需要组合多个模板模块,或需要定制内容区、但没有完全匹配的专用模板时。它管理标准卡片外壳、标题栏和底部操作区;内容区可以按顺序组合行程、内容列表、选项组或业务组件。
示例
自定义内容区示例(ShipmentContent 是业务维护的组件,内部可使用自己的样式):
主要 Props
CompositeCardSection
使用说明
sections是单层有序数组,接受transit、content、option-group和custom。custom通过content传入一个业务组件,不使用 sectionchildren。- Widget 使用
CompositeCard时,构建检查会提示核对组合后的整体效果是否符合豆包卡片设计规范;若静态识别到custom,同一条提示还会要求核对自定义内容及其样式。此提醒不表示当前卡片违规,也不阻断构建。 header.placement默认是default,渲染独立的 40px 标题栏。设为floating时标题栏覆盖在首个内容区左上角,不占据纵向空间;可通过header.title和header.iconSrc指定浮层品牌文案和图标,不传时使用应用插件信息。- section 不提供独立标题字段。普通标题、说明或信息条目使用
contentsection 表达。 content.props.items与ContentCard.items一致,但只复用内容区域,不渲染ContentCard的标题栏、底部操作区或卡片外壳。transit和contentsection 只接受对应卡片的items;option-groupsection 接受完整的OptionGroupProps,可继续使用选项组的回调。- 只有
custom.content支持业务组件与其内部样式。业务样式应限定在该组件内部,不覆盖模板类名、卡片外壳、标题栏或 footer。其他 section 仍不接受任意 JSX、children、布局参数或 wrapper 样式。 - 构建检查可识别直接传入、从当前文件导入的
custom.content组件,并放行其依赖链内的样式文件;Widget 入口和无关依赖的样式仍会提示widget.styles。动态或跨模块组装的 section 可能无法静态识别,不能把没有 warning 当作边界已通过验证。 - 模块保留原有内容留白、内部布局和窄屏策略。
OptionGroup的组合容器补充左右 12px、下方 16px 的留白,上方不额外留白。 - 列表项原有回调和具名内容字段仍可使用;
transit.props.items支持多个行程。 items为空的 section 会连同间距一起收起;运行时遇到未知type时不会展示。sections不支持运行中插入、删除或重排,因此不要求业务配置 section key。