iter(g71): 数据表表头补 aria-sort 三态播报

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-26T04:36:57.291Z",
+  "generatedAt": "2026-10-26T04:40:12.953Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -1725,7 +1725,8 @@
               "表头粘性固定（滚动容器 max-height 420px），斑马纹 + 悬停高亮由 CSS 提供",
               "数据在途时传 loading（布尔或信号）：表格体换成骨架行、筛选与翻页禁用，返回后置回 false 即恢复",
               "需要独立分页器联动时传 page 信号：const page = signal(1)，dataTable({ page }) 与 pagination({ page }) 共用",
-              "需要批量操作时传 selected 信号：内部勾选实时写回，外部置空或赋值即同步整表（跨页保留，按 rowKey 存）"
+              "需要批量操作时传 selected 信号：内部勾选实时写回，外部置空或赋值即同步整表（跨页保留，按 rowKey 存）",
+              "可排序表头的 aria-sort 跟随排序态同步（ascending / descending / none），读屏能直接播报当前列序，箭头只是视觉补充"
             ]
           },
           {

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T04:36:57.291Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T04:40:12.953Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -930,6 +930,7 @@ dataTable({ data: users, selectable: true, columns: [{ key: 'name', header: '姓
 9. 数据在途时传 loading（布尔或信号）：表格体换成骨架行、筛选与翻页禁用，返回后置回 false 即恢复
 10. 需要独立分页器联动时传 page 信号：const page = signal(1)，dataTable({ page }) 与 pagination({ page }) 共用
 11. 需要批量操作时传 selected 信号：内部勾选实时写回，外部置空或赋值即同步整表（跨页保留，按 rowKey 存）
+12. 可排序表头的 aria-sort 跟随排序态同步（ascending / descending / none），读屏能直接播报当前列序，箭头只是视觉补充
 
 现场演示：apps/docs/demo.html#sec-table
 

packages/skin/ui/src/dataTable.ts

@@ -102,8 +102,8 @@ export function dataTable<T extends { id: RowKey }>(props: DataTableProps<T>): H
       },
     );
 
-  const th = (col: (typeof props.columns)[number]) =>
-    h(
+  const th = (col: (typeof props.columns)[number]) => {
+    const el = h(
       'th',
       {
         class: `${col.sortable ? 'ua-sortable' : ''}${col.align ? ` ua-align-${col.align}` : ''}`.trim(),
@@ -112,6 +112,14 @@ export function dataTable<T extends { id: RowKey }>(props: DataTableProps<T>): H
       col.header ?? col.key,
       col.sortable ? sortMark(col.key) : null,
     );
+    if (col.sortable) {
+      effect(() => {
+        const rule = state().sorting.find((r) => r.key === col.key); // 与视觉箭头同源
+        el.setAttribute('aria-sort', rule ? (rule.dir === 'asc' ? 'ascending' : 'descending') : 'none');
+      });
+    }
+    return el;
+  };
 
   /*** 骨架行：列宽与表头对齐，行数取当前每页条数（上限 6 行防过长） ***/
   const skeletonRows = (): Node[] => {

packages/skin/ui/ua.manifest.json

@@ -1596,7 +1596,8 @@
           "表头粘性固定（滚动容器 max-height 420px），斑马纹 + 悬停高亮由 CSS 提供",
           "数据在途时传 loading（布尔或信号）：表格体换成骨架行、筛选与翻页禁用，返回后置回 false 即恢复",
           "需要独立分页器联动时传 page 信号：const page = signal(1)，dataTable({ page }) 与 pagination({ page }) 共用",
-          "需要批量操作时传 selected 信号：内部勾选实时写回，外部置空或赋值即同步整表（跨页保留，按 rowKey 存）"
+          "需要批量操作时传 selected 信号：内部勾选实时写回，外部置空或赋值即同步整表（跨页保留，按 rowKey 存）",
+          "可排序表头的 aria-sort 跟随排序态同步（ascending / descending / none），读屏能直接播报当前列序，箭头只是视觉补充"
         ]
       },
       {