iter(g312): 表格空状态补操作插槽

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T16:41:28.122Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T16:42:26.169Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -1026,6 +1026,7 @@ const name = signal(''); const f = form({ onSubmit: submit }, [formItem({ label:
 - pageSize（默认 5）：number —— 每页行数；缺省 5
 - pageSizes（默认 [5, 10, 20]）：number[] —— 分页条「每页条数」候选档；缺省 [5, 10, 20]，当前 pageSize 不在候选里会自动补进去
 - emptyText（默认 暂无数据）：string —— 无数据时的空状态文案；有筛选词时仍显示「没有符合「x」的行」并给一键清除（两种语义不混用）
+- emptyAction：unknown —— 真没数据时占位区右侧的操作（如「新建」按钮）；有筛选词时这一位置换成「清除筛选」，两者互斥
 - selectable（默认 false）：boolean —— 启用行选择列：全选三态（含半选）、行 checkbox、已选计数；缺省 false
 - page：Signal<number> —— 受控页码信号：与内核分页双向同步，传同一个信号给独立 pagination 组件即可联动
 - loading：boolean | Signal<boolean> —— 加载态：为真时数据行换成骨架行（行数随 pageSize），筛选输入与翻页按钮临时禁用，容器带 aria-busy
@@ -1063,6 +1064,7 @@ dataTable({ data: users, selectable: true, columns: [{ key: 'name', header: '姓
 17. 整行可点（进详情、选中一行做后续操作）传 onRowClick：行会变成可聚焦项，Enter / 空格与点击等价；不传时行不进 Tab 序列，纯展示表不会被读屏当成按钮
 18. 需要让用户自己调列时开 columnToggle：工具栏多一个「列」按钮，弹层勾选即刻重绘表头与单元格（隐藏列不占 colspan，空状态与骨架行同步收窄）
 19. 想记住用户偏好就传 hiddenColumns 信号：面板勾选实时写回，外部赋值即整表跟随；隐藏筛选列后筛选条件仍然生效，属预期而非失效
+20. 表里本来就空（不是筛掉的）时传 emptyAction 给个「新建」之类的出口：它只在「真没数据」时出现，一旦有筛选词就换成「清除筛选」——先让用户清条件，而不是急着让他新建
 
 现场演示：apps/docs/demo.html#sec-table