# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V6.0.1 | 支持卡片分录设置焦点行时，焦点行滚动到可视区域 | 2023年10月25日 |
# 1 功能介绍
卡片分录一个可循环的容器，可承载文字、按钮、图片、段落等等。分有编辑态与查看态两种，可以高效简洁的录入展示数据，比如人物信息卡。
# 2 控件对象
`kd.bos.form.cardentry.CardEntry`
# 3 视觉展示
* 卡片分录视图：卡片列表层，包含所有卡片
* 卡片：参与数据循环，有多少条数据就会创建多少张卡片
* 固定卡片：不参与循环，相当于一个普通的容器，可以在里面放置不需要循环的内容，不需要也可删除，默认隐藏，下图是固定卡片典型应用场景之一。
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
* 单据体
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 多选 | 复选框 | true | 设置卡片是否多选 |
| 分页 | 复选框 | false | 设置卡片是否分页 |
| 分页条数 | 下拉 | 20条/页 | 设置每一页显示多少条数据 |
| 表名 | 文本 | - | 对应数据库的表名 |
| 拆分表 | 弹框选择 | - | 配置存储的纵向拆分表 |
| 界面规则 | 弹框选择 | - | 实体服务规则，详见4.3.1 |
| 序号字段名 | 文本 | FSeq | 配置分录序号字段名称 |
| 主键 | 文本 | FEntryID | 配置分录主键字段名称 |
| 缺省行数 | 整数 | 1 | 设置默认有几行卡片 |
| 业务规则 | 弹框选择 | - | 配置实体对应的业务规则 |
| 关键字段 | 下拉 | - | 配置分录的关键字段,用于表明分录行录入的有效性 |
| 卡片模式 | 下拉 | 默认 | 设置卡片模式，0为默认模式，1为购物车模式（目前只支持插件配置），详见4.3.2 |
* 卡片分录视图
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 布局方式 | 下拉 | 横向滚动布局 | 设置卡片布局方式，横向滚动布局(默认)，只在水平方向延伸，不会换行，超出界面，会出现前后滑动按钮，可以左右滚动。流式布局，搭配容器快速布局使用 |
| 显示卡片下划线 | 复选框 | false | 设置卡片是否出现下划线，卡片单选、横向滚动布局 两个条件同时满足时才生效。 |
| 分页隐藏 | 复选框 | true | 设置是否隐藏分页工具栏 |
| 滚动加载 | 复选框 | false | 设置是否滚动加载下一页数据 |
| 无数据提示 | 复选框 | true | 卡片没有数据行时，是否显示无数据提示图片 |
* 卡片
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 显示选择框 | 复选框 | false | 卡片选中时，是否显示选择框 |
| 选中样式 | 下拉 | 默认风格 | 打开显示选择框时，设置选中样式：默认、勾选（1）、边框（2）、竖条（3）风格 |
| 移入移出效果 | 复选框 | true | 设置卡片是否会随着鼠标移动，出现悬停样式 |
| 背景图片字段 | 下拉 | - | 设置卡片背景图，关联图片字段 |
| 界面规则 | 界面规则 | - | 卡片客户端界面规则，详见4.3.1 |
* 卡片布局容器
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 可折叠 | 复选框 | false | 设置卡片布局容器是否折叠 |
| 默认折叠 | 复选框 | false | 在布局容器可折叠时，设置是否默认折叠 |
| 折叠摘要 | 弹框选择 | - | 在布局容器可折叠时，设置折叠时显示的摘要信息 |
| 允许点击 | 复选框 | false | 设置布局容器是否有点击事件 |
| 允许全屏 | 复选框 | false | 设置布局容器是否全屏显示 |
| 悬停显示元素 | 复选框 | false | 设置卡片在鼠标悬停时显示的布局容器内容 |
| 悬停隐藏元素 | 复选框 | false | 设置卡片在鼠标悬停时隐藏的布局容器内容 |
### 4.3.1 界面规则
卡片界面规则相关设置[请参考](https://vip.kingdee.com/article/137913100514217728)
### 4.3.2 卡片模式
卡片模式分为默认模式和购物车模式：默认模式点击卡片任一区域都可选中取消，购物车模式类似于淘宝的购物车，只有点击勾选框才可以选中取消。两种模式匹配不同的场景
以下是两种模式的示例：
默认模式：
购物车模式：
# 5 卡片接口介绍
## 5.1 控件编程模型
卡片分录的控件编程模型为 CardEntry，派生自标准单据体的控件编程模型 EntryGrid，重写了部分方法，在移动表单上显示时，强制分页，暂未增加新的控制方法：
```java
package kd.bos.form.cardentry;
public class CardEntry extends EntryGrid {
```
## 5.2 数据模型
卡片分录数据模型，与标准单据体数据模型完全一致，不重复介绍。
## 5.3 插件事件
卡片分录提供的插件事件，与[标准单据体](https://vip.kingdee.com/knowledge/specialDetail/218022218066869248?category=218035559762017280&id=224093028694948608)一致，无须特别介绍。
