iter: d16 dataTable 落地列宽 width

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T08:57:12.133Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T08:58:43.429Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -687,7 +687,7 @@ const name = signal(''); const f = form({ onSubmit: submit }, [formItem({ label:
 参数：
 
 - data（必填）：T[] —— 全量行数据，每行须含 id 字段作 rowKey
-- columns（必填）：ColumnDef<T>[] —— 列定义：内核字段 { key, header?, sortable? } + 皮肤字段 { align?: left|center|right, format?: (value, row) => string }
+- columns（必填）：ColumnDef<T>[] —— 列定义：内核字段 { key, header?, sortable?, width? } + 皮肤字段 { align?, format? }；width 数字为固定像素，'flex' 自适应
 - filterKey：string —— 工具栏筛选的列；缺省取第一列
 - pageSize（默认 5）：number —— 每页行数；缺省 5
 - selectable（默认 false）：boolean —— 启用行选择列：全选三态（含半选）、行 checkbox、已选计数；缺省 false
@@ -705,12 +705,13 @@ dataTable({ data: users, selectable: true, columns: [{ key: 'name', header: '姓
 1. 准备行数据，确保每行有唯一 id（跨页选择与刷新不丢行靠它）
 2. 定义 columns：sortable: true 的列表头可点击排序（升 → 降 → 取消循环），标记箭头 ↑↓↕
 3. 列展示细节用皮肤字段：align 控制表头与单元格对齐，format(value, row) 返回纯文本（走 textContent，不需要转义）
-4. selectable: true 开启行选择：表头全选框带 indeterminate 半选态，工具栏显示已选计数
-5. 选中行用低视觉比重样式（淡色底 + 弱化文字），选择状态存 rowKey，跨页不丢失
-6. 工具栏输入框即筛选，输入即时过滤并回第 1 页；无匹配时显示空状态行
-7. 表头粘性固定（滚动容器 max-height 420px），斑马纹 + 悬停高亮由 CSS 提供
-8. 数据在途时传 loading（布尔或信号）：表格体换成骨架行、筛选与翻页禁用，返回后置回 false 即恢复
-9. 需要独立分页器联动时传 page 信号：const page = signal(1)，dataTable({ page }) 与 pagination({ page }) 共用
+4. 列宽用内核字段 width：数字（像素）固定该列，'flex' 或不设则按内容自适应
+5. selectable: true 开启行选择：表头全选框带 indeterminate 半选态，工具栏显示已选计数
+6. 选中行用低视觉比重样式（淡色底 + 弱化文字），选择状态存 rowKey，跨页不丢失
+7. 工具栏输入框即筛选，输入即时过滤并回第 1 页；无匹配时显示空状态行
+8. 表头粘性固定（滚动容器 max-height 420px），斑马纹 + 悬停高亮由 CSS 提供
+9. 数据在途时传 loading（布尔或信号）：表格体换成骨架行、筛选与翻页禁用，返回后置回 false 即恢复
+10. 需要独立分页器联动时传 page 信号：const page = signal(1)，dataTable({ page }) 与 pagination({ page }) 共用
 
 现场演示：apps/docs/demo.html#sec-table