30 KiB
Executable File
30 KiB
Executable File
title, description, type, group, menuName, icon, order
| title | description | type | group | menuName | icon | order |
|---|---|---|---|---|---|---|
| Cards 卡片组 | 0 | ⚙ 组件 | Cards 卡片组 | 32 |
卡片展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成数据展示。
基本用法
这里我们使用手动初始数据域的方式,即配置data属性,进行数据域的初始化。
{
"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 模式
当 cards 在 crud 中且配置了批量操作按钮时可点选
如果配置了 checkOnItemClick,当用户点击卡片时就能选中这个卡片,而不是只能点击勾选框才能选中
{
"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 开启瀑布流布局模式,适合展示不同高度的卡片内容,比如图片列表、社交媒体流等场景。
瀑布流布局支持两种方式设置列数:
- 通过
columnsCount设置固定列数- 通过
itemClassName设置响应式列数,如Grid-col--xs6 Grid-col--sm4 Grid-col--md3可以在不同屏幕尺寸下展现不同的列数
{
"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 | 模板 | 标题 | |
| source | 数据映射 | ${items} |
数据源, 获取当前数据域中的变量 |
| placeholder | 模板 | '暂无数据' | 当没数据的时候的文字提示 |
| 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 | 配置卡片信息 | |
| selectable | boolean |
false |
卡片组是否可选 |
| multiple | boolean |
true |
卡片组是否为多选 |
| checkOnItemClick | boolean |
点选卡片内容是否选中卡片 |
动作表
6.4.0 或更高版本
当前组件对外暴露以下特性动作,其他组件可以通过指定actionType: 动作名称、componentId: 该组件id来触发这些动作,动作配置可以通过args: {动作配置项名称: xxx}来配置具体的参数,详细请查看事件动作。
| 动作名称 | 动作配置 | 说明 |
|---|---|---|
| select | args.index 可选,指定行数,支持表达式 args.condition 可选,通过表达式指定更新哪些行,支持条件组合 index` |
设置列表的选中项 |
| selectAll | - | 设置列表全部项选中 |
| clearAll | - | 清空列表所有选中项 |
| initDrag | - | 开启列表拖拽排序功能 |
| cancelDrag | - | 放弃列表拖拽排序功能 |
| setValue | args.value: object args.index 可选,指定行数,支持表达式 args.condition 可选,通过表达式指定更新哪些行,支持条件组合 |
更新列表记录 |
| submitQuickEdit | 快速编辑数据提交 |
select
args.index可选,指定行数,支持表达式args.condition可选,通过表达式指定更新哪些行,支持条件组合
[
{
"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
[
{
"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
[
{
"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
[
{
"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
更新列表记录
[
{
"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同样生效,即可以完全替换指定行记录,也可以对指定行记录做合并。
{
"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"
}
]
}
}
]
}
]
}