--- title: Cards 卡片组 description: type: 0 group: ⚙ 组件 menuName: Cards 卡片组 icon: order: 32 --- 卡片展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像`Service`这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过`source`属性,获取数据链中的数据,完成数据展示。 ## 基本用法 这里我们使用手动初始数据域的方式,即配置`data`属性,进行数据域的初始化。 ```schema { "type": "page", "data": { "items": [ { "engine": "Trident", "browser": "Internet Explorer 4.0", "platform": "Win 95+", "version": "4", "grade": "X" }, { "engine": "Trident", "browser": "Internet Explorer 5.0", "platform": "Win 95+", "version": "5", "grade": "C" }, { "engine": "Trident", "browser": "Internet Explorer 5.5", "platform": "Win 95+", "version": "5.5", "grade": "A" }, { "engine": "Trident", "browser": "Internet Explorer 6", "platform": "Win 98+", "version": "6", "grade": "A" }, { "engine": "Trident", "browser": "Internet Explorer 7", "platform": "Win XP SP2+", "version": "7", "grade": "A" } ] }, "body": { "type": "cards", "source": "$items", "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ], "actions": [ { "type": "button", "level": "link", "icon": "fa fa-eye", "actionType": "dialog", "dialog": { "title": "查看详情", "body": { "type": "form", "body": [ { "label": "Engine", "name": "engine", "type": "static" }, { "name": "browser", "label": "Browser", "type": "static" }, { "name": "version", "label": "Version", "type": "static" } ] } } } ] } } } ``` 或者你也可以使用 CRUD 的 [card 模式](./crud#cards-%E5%8D%A1%E7%89%87%E6%A8%A1%E5%BC%8F) ## 当 cards 在 crud 中且配置了批量操作按钮时可点选 如果配置了 `checkOnItemClick`,当用户点击卡片时就能选中这个卡片,而不是只能点击勾选框才能选中 ```schema { "type": "page", "data": { "items": [ { "engine": "Trident", "browser": "Internet Explorer 4.0", "platform": "Win 95+", "version": "4", "grade": "X" }, { "engine": "Trident", "browser": "Internet Explorer 5.0", "platform": "Win 95+", "version": "5", "grade": "C" }, { "engine": "Trident", "browser": "Internet Explorer 5.5", "platform": "Win 95+", "version": "5.5", "grade": "A" }, { "engine": "Trident", "browser": "Internet Explorer 6", "platform": "Win 98+", "version": "6", "grade": "A" } ] }, "body": { "type": "crud", "mode": "cards", "checkOnItemClick": true, "source": "$items", "bulkActions": [ { "type": "button", "label": "查看选中", "actionType": "dialog", "dialog": { "body": "${items|json}" } } ], "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ], "actions": [ { "type": "button", "level": "link", "icon": "fa fa-eye", "actionType": "dialog", "dialog": { "title": "查看详情", "body": { "type": "form", "body": [ { "label": "Engine", "name": "engine", "type": "static" }, { "name": "browser", "label": "Browser", "type": "static" }, { "name": "version", "label": "Version", "type": "static" } ] } } } ] } } } ``` ## 瀑布流布局 设置 `"masonryLayout": true` 开启瀑布流布局模式,适合展示不同高度的卡片内容,比如图片列表、社交媒体流等场景。 > 瀑布流布局支持两种方式设置列数: > > 1. 通过 `columnsCount` 设置固定列数 > 2. 通过 `itemClassName` 设置响应式列数,如 `Grid-col--xs6 Grid-col--sm4 Grid-col--md3` 可以在不同屏幕尺寸下展现不同的列数 ```schema { "type": "page", "data": { "items": [ { "image": "https://internal-amis-res.cdn.bcebos.com/images/2020-1/1578395692722/4f3cb4202335.jpeg@s_0,w_800,l_1,f_jpg,q_80", "title": "风景如画的山水", "description": "在这里,青山绿水相伴,让人心旷神怡。", "author": "Alice", "likes": "1.2k", "imageHeight": "200px" }, { "image": "https://internal-amis-res.cdn.bcebos.com/images/2020-1/1578395692942/d8e4992057f9.jpeg@s_0,w_800,l_1,f_jpg,q_80", "title": "城市的日与夜", "description": "灯火阑珊处,人来人往,演绎着城市的故事。繁华的街道上,每个人都在追逐着自己的梦想。夜幕降临后,霓虹闪烁,为城市增添了一份独特的魅力。都市的喧嚣与宁静在这里交织,构成了一幅动人的画卷。", "author": "Bob", "likes": "2.4k", "imageHeight": "300px" }, { "image": "https://internal-amis-res.cdn.bcebos.com/images/2020-1/1578395693148/1314a2a3d3f6.jpeg@s_0,w_800,l_1,f_jpg,q_80", "title": "美食的诱惑", "description": "舌尖上的美味,让人流连忘返。", "author": "Charlie", "likes": "3.5k", "imageHeight": "180px" }, { "image": "https://internal-amis-res.cdn.bcebos.com/images/2020-1/1578395692722/4f3cb4202335.jpeg@s_0,w_800,l_1,f_jpg,q_80", "title": "旅行日记", "description": "背起行囊,走过山山水水。每一次旅行都是一次心灵的沉淀,让我们在路途中发现生活的美好。旅行不仅仅是观光,更是一种生活方式。", "author": "David", "likes": "4.2k", "imageHeight": "250px" }, { "image": "https://internal-amis-res.cdn.bcebos.com/images/2020-1/1578395692942/d8e4992057f9.jpeg@s_0,w_800,l_1,f_jpg,q_80", "title": "咖啡时光", "description": "一杯咖啡,一本书,一个午后。", "author": "Eve", "likes": "1.8k", "imageHeight": "220px" }, { "image": "https://internal-amis-res.cdn.bcebos.com/images/2020-1/1578395693148/1314a2a3d3f6.jpeg@s_0,w_800,l_1,f_jpg,q_80", "title": "艺术展览", "description": "在艺术的殿堂里,每一幅作品都在诉说着自己的故事。色彩的交织,线条的流动,让人沉醉其中。艺术,是生活的另一种表达方式。", "author": "Frank", "likes": "2.9k", "imageHeight": "280px" } ] }, "body": { "type": "cards", "source": "$items", "masonryLayout": true, "columnsCount": 3, "card": { "type": "container", "style": { "background": "#fff", "borderRadius": "8px", "boxShadow": "0 2px 8px rgba(0, 0, 0, 0.1)", "marginBottom": "16px", "overflow": "hidden" }, "body": [ { "type": "image", "src": "${image}", "thumbMode": "cover", "height": "${imageHeight}" }, { "type": "container", "style": { "padding": "12px" }, "body": [ { "type": "tpl", "tpl": "${title}", "style": { "fontSize": "16px", "fontWeight": "bold", "marginBottom": "8px" } }, { "type": "tpl", "tpl": "${description}", "style": { "color": "#666", "marginBottom": "12px", "fontSize": "14px", "lineHeight": "1.5" } }, { "type": "container", "style": { "display": "flex", "justifyContent": "space-between", "alignItems": "center", "marginTop": "8px" }, "body": [ { "type": "container", "style": { "display": "flex", "alignItems": "center" }, "body": [ { "type": "avatar", "src": "https://internal-amis-res.cdn.bcebos.com/images/2020-1/1578395692722/4f3cb4202335.jpeg@s_0,w_64,l_1,f_jpg,q_80", "size": "sm" }, { "type": "tpl", "tpl": "${author}", "style": { "marginLeft": "8px", "color": "#333" } } ] }, { "type": "container", "style": { "display": "flex", "alignItems": "center" }, "body": [ { "type": "icon", "icon": "fa fa-heart", "className": "text-danger" }, { "type": "tpl", "tpl": "${likes}", "style": { "marginLeft": "4px", "color": "#999" } } ] } ] } ] } ] } } } ``` ## 属性表 | 属性名 | 类型 | 默认值 | 说明 | | ---------------- | -------------------------------------------- | ------------------- | ------------------------------ | | type | `string` | | `"cards"` 指定为卡片组。 | | title | [模板](../../docs/concepts/template) | | 标题 | | source | [数据映射](../../docs/concepts/data-mapping) | `${items}` | 数据源, 获取当前数据域中的变量 | | placeholder | [模板](../../docs/concepts/template) | '暂无数据' | 当没数据的时候的文字提示 | | className | `string` | | 外层 CSS 类名 | | headerClassName | `string` | `amis-grid-header` | 顶部外层 CSS 类名 | | footerClassName | `string` | `amis-grid-footer` | 底部外层 CSS 类名 | | itemClassName | `string` | `col-sm-4 col-md-3` | 卡片 CSS 类名 | | card | [Card](./card) | | 配置卡片信息 | | selectable | `boolean` | `false` | 卡片组是否可选 | | multiple | `boolean` | `true` | 卡片组是否为多选 | | checkOnItemClick | `boolean` | | 点选卡片内容是否选中卡片 | ## 动作表 > 6.4.0 或更高版本 当前组件对外暴露以下特性动作,其他组件可以通过指定`actionType: 动作名称`、`componentId: 该组件id`来触发这些动作,动作配置可以通过`args: {动作配置项名称: xxx}`来配置具体的参数,详细请查看[事件动作](../../docs/concepts/event-action#触发其他组件的动作)。 | 动作名称 | 动作配置 | 说明 | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | select | `args.index` 可选,指定行数,支持表达式
`args.condition` 可选,通过表达式指定更新哪些行,支持条件组合 index` | 设置列表的选中项 | | selectAll | - | 设置列表全部项选中 | | clearAll | - | 清空列表所有选中项 | | initDrag | - | 开启列表拖拽排序功能 | | cancelDrag | - | 放弃列表拖拽排序功能 | | setValue | `args.value`: object
`args.index` 可选,指定行数,支持表达式
`args.condition` 可选,通过表达式指定更新哪些行,支持条件组合 | 更新列表记录 | | submitQuickEdit | | 快速编辑数据提交 | ### select - `args.index` 可选,指定行数,支持表达式 - `args.condition` 可选,通过表达式指定更新哪些行,支持条件组合 ```schema: scope="body" [ { "type": "button-toolbar", "className": "m-b", "buttons": [ { "name": "trigger1", "id": "trigger1", "type": "action", "label": "选中前两个", "onEvent": { "click": { "actions": [ { "actionType": "select", "componentId": "cards-select", "args": { "index": "0,1" } } ] } } } ] }, { "type": "service", "api": "/api/mock2/sample?perPage=5", "body": [ { "id": "cards-select", "type": "cards", "source": "$rows", "selectable": true, "multiple": true, "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ] } } ] } ] ``` ### selectAll ```schema: scope="body" [ { "type": "button-toolbar", "className": "m-b", "buttons": [ { "name": "trigger2", "id": "trigger2", "type": "action", "label": "设置列表全部项选中", "onEvent": { "click": { "actions": [ { "actionType": "selectAll", "componentId": "cards-select", "description": "点击设置指定列表全部内容选中" } ] } } } ] }, { "type": "service", "api": "/api/mock2/sample?perPage=10", "body": [ { "id": "cards-select", "type": "cards", "source": "$rows", "selectable": true, "multiple": true, "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ] } } ] } ] ``` ### clearAll ```schema: scope="body" [ { "type": "button-toolbar", "className": "m-b", "buttons": [ { "name": "trigger3", "id": "trigger3", "type": "action", "label": "清空列表全部选中项", "onEvent": { "click": { "actions": [ { "actionType": "clearAll", "componentId": "cards-select", "description": "点击设置指定列表全部选中项清空" } ] } } } ] }, { "type": "service", "api": "/api/mock2/sample?perPage=10", "body": [ { "id": "cards-select", "type": "cards", "source": "$rows", "selectable": true, "multiple": true, "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ] } } ] } ] ``` ### initDrag & cancelDrag ```schema: scope="body" [ { "type": "button-toolbar", "className": "m-b", "buttons": [ { "name": "trigger4", "id": "trigger4", "type": "action", "label": "开启列表行排序", "onEvent": { "click": { "actions": [ { "actionType": "initDrag", "componentId": "cards-select", "description": "点击开启列表行排序功能" } ] } } }, { "name": "trigger5", "id": "trigger5", "type": "action", "label": "取消列表行排序", "onEvent": { "click": { "actions": [ { "actionType": "cancelDrag", "componentId": "cards-select", "description": "点击取消列表行排序功能" } ] } } } ] }, { "type": "service", "api": "/api/mock2/sample?perPage=10", "body": [ { "id": "cards-select", "type": "cards", "source": "$rows", "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ] } } ] } ] ``` ### setValue #### 更新列表记录 ```schema: scope="body" [ { "type": "button", "label": "更新列表记录", "onEvent": { "click": { "actions": [ { "actionType": "setValue", "componentId": "cards_setvalue", "args": { "value": { "rows": [ { "engine": "Trident - f12fj", "browser": "Internet Explorer 4.0", "platform": "Win 95+", "version": "4", "grade": "X", "badgeText": "默认", "id": 1 }, { "engine": "Trident - oqvc0e", "browser": "Internet Explorer 5.0", "platform": "Win 95+", "version": "5", "grade": "C", "badgeText": "危险", "id": 2 } ] } } } ] } } }, { "type": "button", "label": "清空列表", "className": "ml-2", "onEvent": { "click": { "actions": [ { "actionType": "setValue", "componentId": "cards_setvalue", "args": { "value": { "rows": [] } } } ] } } }, { "type": "service", "id": "u:b25a8ef0050b", "api": { "method": "get", "url": "/api/mock2/sample?perPage=5" }, "body": [ { "type": "cards", "id": "cards_setvalue", "title": "引擎列表", "source": "$rows", "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ] } } ] } ] ``` #### 更新指定行记录 可以通过指定`index`或者`condition`来分别更新指定索引的行记录和指定满足条件(条件表达式或者 ConditionBuilder)的行记录,另外`replace`同样生效,即可以完全替换指定行记录,也可以对指定行记录做合并。 ```schema { "type": "page", "data": { i: '1,3' }, body: [ { "type": "button", "label": "更新index为1和3的行记录", "onEvent": { "click": { "actions": [ { "actionType": "setValue", "componentId": "cards_setvalue_item", "args": { "value": { "engine": "amis", "browser": "Chrome", "platform": "Mac Pro", "version": "8", "grade": "Y", "badgeText": "你好!", "id": 1234 }, "index": "${i}" } } ] } } }, { "type": "button", "label": "更新index为1和3的行记录(替换)", "onEvent": { "click": { "actions": [ { "actionType": "setValue", "componentId": "cards_setvalue_item", "args": { "value": { "engine": "amis", "id": 1234 }, "index": "${i}", "replace": true } } ] } } }, { "type": "button", "label": "更新version=7的行记录", "onEvent": { "click": { "actions": [ { "actionType": "setValue", "componentId": "cards_setvalue_item", "args": { "value": { "engine": "amis", "browser": "Chrome", "platform": "Mac Pro", "version": "4", "grade": "Y", "badgeText": "你好!", "id": 1234 }, "condition": "${version === '7'}" } } ] } } }, { "type": "button", "label": "更新version=4的行记录", "onEvent": { "click": { "actions": [ { "actionType": "setValue", "componentId": "cards_setvalue_item", "args": { "value": { "engine": "amis", "browser": "Chrome", "platform": "Mac Pro", "version": "4", "grade": "Y", "badgeText": "你好!", "id": 1234 }, "condition": { conjunction: 'and', children: [ { left: { type: 'field', field: 'version' }, op: 'equal', right: "4" } ] } } } ] } } }, { "type": "service", "id": "u:b25a8ef0050b", "api": { "method": "get", "url": "/api/mock2/sample?perPage=5" }, "body": [ { "type": "cards", "id": "cards_setvalue_item", "title": "引擎列表", "source": "$rows", "card": { "body": [ { "label": "Engine", "name": "engine" }, { "label": "Browser", "name": "browser" }, { "name": "version", "label": "Version" } ] } } ] } ] } ```