fantasy-ngzorro 2.1.55 → 2.1.57

package/README.md

@@ -24,6 +24,7 @@
 | 14 | `hd-detail-lines` | 详情明细（前端分页 / 搜索） |
 | 15 | `hd-detail-lines-page` | 详情明细（服务端分页） |
 | 16 | `hd-log` | 操作日志 |
+| 17 | `hd-accessory-list` | 附件列表（分组标签 + 可下载文件行） |
 
 > 配置类型（SelectOption、FormItem、HdTableColumn 等）见 [附录：公共配置类型](#附录公共配置类型)。
 
@@ -34,6 +35,8 @@
 | MC | 2023-2-10 | Readme 创建；按钮、按钮组、通用表格、筛选器、状态、详情头、详情单头、详情明细文档 |
 | MC | 2023-2-13 | 表单、明细表单、间隔、小标题文档；组件字段增加必填说明 |
 | — | 2026-5-20 | 补充 hd-table、hd-detail-lines-page 等组件；完善公共子类型（SelectOption、FormItem 等）文档 |
+| — | 2026-9-17 | hd-table / hd-detail-lines / hd-detail-lines-page 支持 `selectDisabledField` / `rowInvalidField`：按行字段控制勾选禁用、失效行样式 |
+| — | 2026-9-14 | 新增 `hd-accessory-list` 附件列表组件（分组 name + accessoryList，点击下载/查看） |
 | — | 2026-6-23 | hd-table 状态列支持 `stateField` 自定义取值字段、`isState` 按列名取值；hd-form Input 支持 `prefix` / `prefixIcon`；hd-detail-lines-page 支持 `isCrossPageSelect` 跨页勾选开关 |
 | — | 2026-7-6 | hd-form 支持 `FormListType.Checkbox`（单个复选框 / 复选框组）及 `CheckboxOption` 配置 |
 | — | 2026-9-8 | hd-form 支持 `FormListType.RegionAddress`（省市区级联 + 详细地址，双 FormControl，固定占 2 列） |
@@ -43,6 +46,7 @@
 | — | 2026-8-25 | hd-status：`statusToColor` 按 sunan-server 业务状态枚举全量去重补充（排除银行 / AGV / HTTP StatusCode） |
 | — | 2026-8-21 | 分页选项统一增加 500 / 1000；`hd-table` / `hd-detail-lines` / `hd-detail-lines-page` 默认 `tablePageSize` 改为 100 |
 | — | 2026-9-14 | TotalOption 增加 `preserveNumber`（合计小数位数，不传默认 2）；用于 `hd-detail-lines` / `hd-detail-lines-page` / `hd-form-lines` |
+| — | 2026-9-14 | hd-table：普通列支持文案后挂 `btnList` 操作按钮；`OperateBtn.name` 支持按行动态文案 |
 
 ## 前言
 
@@ -322,6 +326,16 @@ tableCols: HdTableColumn[] = [{
   isState: true, // 按 hd-status 渲染，取值字段为 name（orderStatus）
   width: ColWidth.enumColWidth,
   render: (line) => line.orderStatusText
+}, {
+  title: '业务数据自动上报',
+  name: 'autoReport',
+  width: 140,
+  render: (line) => (line.autoReport ? '是' : '否'),
+  // 普通列挂 btnList：文案后跟操作按钮（见 Figma 操作列单元格）
+  btnList: [{
+    name: (line) => (line.autoReport ? '解除' : '设置'),
+    click: (line) => { line.autoReport = !line.autoReport; }
+  }]
 }, {
   title: '操作',
   name: 'operate',
@@ -346,6 +360,8 @@ tableCols: HdTableColumn[] = [{
 | selectEvent | EventEmitter | — | 勾选变化 |
 | showSelected | boolean | false | 勾选列 |
 | selectField | string | billNumber | 勾选主键字段 |
+| selectDisabledField | string | — | 行勾选禁用字段名；行数据该字段为 `true` 时禁用勾选（全选也会跳过） |
+| rowInvalidField | string | — | 行失效字段名；为 `true` 时整行背景 `#F7F8FA`、普通文字 `#868A9C`（操作按钮/超链接颜色不变） |
 | showOperateColWarpButton | boolean | false | 展开/缩略显示换行列 |
 | virtualScroll | boolean | true | 行数多自动虚拟滚动；横向滚动条按**列总宽是否超出容器**决定 |
 | virtualItemSize | number | — | 虚拟滚动行高（px）；**不传则首屏自动测量** |
@@ -609,6 +625,8 @@ formCols: HdOption[] = [
 | tablePageSize | number | 100 | 每页条数（开启前端分页时生效） |
 | showSelected | boolean | false | 勾选 |
 | selectField | string | billNumber | 勾选主键 |
+| selectDisabledField | string | — | 行勾选禁用字段名；行数据该字段为 `true` 时禁用勾选（全选也会跳过） |
+| rowInvalidField | string | — | 行失效字段名；为 `true` 时整行背景 `#F7F8FA`、普通文字 `#868A9C`（操作按钮/超链接颜色不变） |
 | selectedField | string | — | 初始勾选标记字段 |
 | selectEvent | EventEmitter | — | 勾选变化 |
 | allowDrop | boolean | false | 拖拽排序 |
@@ -688,7 +706,7 @@ onDetailLinesPageSizeChange(pageSize: number) {
 | tablePageIndexChange | EventEmitter | — | 页码变化 |
 | tablePageSizeChange | EventEmitter | — | 每页条数变化（组件内会重置到第 1 页） |
 | pageChange | EventEmitter | — | 任意分页变化 |
-| showSelected / allowDrop / showTotal 等 | — | — | 同 hd-detail-lines |
+| showSelected / allowDrop / showTotal / selectDisabledField / rowInvalidField 等 | — | — | 同 hd-detail-lines |
 | isCrossPageSelect | boolean | — | 跨页勾选 |
 
 分页可选条数：`10 / 50 / 100 / 200 / 500 / 1000`。模板中 `index` 为**全局序号**：`(pageIndex - 1) * pageSize + 行号`。
@@ -720,6 +738,61 @@ onDetailLinesPageSizeChange(pageSize: number) {
 
 ---
 
+## 17、附件列表（hd-accessory-list）
+
+只读附件分组列表：上方标签（如「营业执照扫描件：」），下方灰色文件行；每行最多 4 个，超出自动换行；点击文件名下载/查看。对齐 Figma「文件列表」样式。
+
+### 示例
+
+```html
+<hd-accessory-list
+  [groups]="accessoryGroups"
+  (fileClick)="onAccessoryFileClick($event)">
+</hd-accessory-list>
+```
+
+```typescript
+import { HdAccessoryGroup } from 'fantasy-ngzorro';
+
+accessoryGroups: HdAccessoryGroup[] = [
+  {
+    name: '营业执照扫描件',
+    accessoryList: [
+      { name: '文件名称.doc', path: 'https://oss.xxx.com/files/license.doc', size: 12 * 1024 * 1024 },
+      { name: '副本.pdf', path: 'https://oss.xxx.com/a.pdf' }, // size 可缺省
+    ],
+  },
+];
+
+onAccessoryFileClick(e: { group: HdAccessoryGroup; file: any; path: string }) {
+  console.log('下载', e.path);
+}
+```
+
+| 参数 | 类型 | 默认值 | 说明 |
+| ---- | ---- | ------ | ---- |
+| groups | HdAccessoryGroup[] | [] | 分组数组，每项含 `name` + `accessoryList` |
+| labelColon | boolean | true | 标签后自动补「：」 |
+| autoOpen | boolean | true | 点击后默认 `window.open` 打开 |
+| fileClick | EventEmitter | — | 点击附件回调 `{ group, file, path }` |
+
+#### HdAccessoryGroup
+
+| 参数 | 类型 | 说明 |
+| ---- | ---- | ---- |
+| name | string | 分组标签 |
+| accessoryList | HdAccessoryFile[] | 附件列表 |
+
+#### HdAccessoryFile
+
+| 参数 | 类型 | 说明 |
+| ---- | ---- | ---- |
+| name | string | 展示文件名 |
+| path | string | 完整下载/查看地址（由父组件直接传入） |
+| size | number \| string | 可缺省；有值才展示。数字按字节格式化为 B/KB/MB，字符串原样展示 |
+
+---
+
 ## 附录：公共配置类型
 
 以下类型在 `hd-filter`、`hd-form`、`hd-form-lines`、`hd-table` 等组件中复用。
@@ -974,13 +1047,14 @@ onOpenChangeEvent: (open: boolean, line: FormGroup) => void
 | isState | boolean | false | 是否按状态列渲染，取值字段为 `name` |
 | stateField | string | — | 状态列取值字段（`name` 为 `state` 且未设置 `isState` 时生效，默认 `state`） |
 | render / click | Function | — | 渲染 / 点击 |
-| btnList | OperateBtn[] | — | 操作按钮 |
+| canClick | (line) => boolean | — | 按行控制是否可点 |
+| btnList | OperateBtn[] | — | `title` 为「操作」时整列按钮；其他列时显示在单元格文案后的操作按钮 |
 
 #### OperateBtn（操作列按钮）
 
 | 参数 | 类型 | 默认值 | 说明 |
 | ---- | ---- | ------ | ---- |
-| name | string | — | 按钮文案 |
+| name | string \| (line) => string | — | 按钮文案；支持按行动态（如 `是/否` 旁的「解除/设置」） |
 | showConfirm | boolean \| (line) => boolean | false | 是否 popconfirm 确认；传函数时按行数据判断 |
 | isRepeat | boolean | false | 与其他按钮互斥显示 |
 | click | (line) => void | — | 点击回调 |