# TableHead 更新日志

先阅读 [完整 LICENSE](https://snowui.dev/LICENSE)；同任务、同版本、同范围去重。

### v2.4.1 (2026-10-23)

- 排序图标与标题内容保留4 CSS px间距，覆盖此前零间距设计；同一排序按钮继续拥有对齐、单行、截断和原排序状态。

- 2026-10-07：明确图标与组件标题插槽；修复块级图标标题及排序内容的列对齐，保持纯图标可访问名称。

- 2026-10-07：关闭横向滚动时，待隐藏列按容器宽度同步渐隐；完整规则由 Table 响应式 统一定义。

- 2026-10-07：统一表格外缘最小 8px，相邻列内容间最小 8px（内部两侧各 4px），收列后重新分配外缘。

- 2026-10-07：响应式单元格每侧最小 padding 从 2px 调整为 4px，相邻列最小内容间距为 8px。

- 2026-10-07：v2.4.0，新增 responsiveHide 列保护；常驻角色表头一直显示，自动布局复用 Table 实测结果。

- 2026-10-07：v2.3.2，行内与表头 Checkbox 统一按实际右边缘定位透明区，向右使用固定 `--size-5`（名义 20px）柔和过渡；跟随控件尺寸和响应式间距，不随列宽拉长。保留显式起止点覆盖。

- 2026-10-07：v2.3.1，修复 overlay 全选 Checkbox 与首列遮罩退出时序不一致的残影；保留进入渐显与键盘聚焦。

- 2026-09-28：同步 Indicator 的统一命中与状态视觉；列宽手柄复用组件默认视觉和整边命中。

- 2026-09-21：统一使用文档、源码属性表与 Site / AI 阅读入口；仅文档修订，不改变组件行为。

- 2026-09-01：v2.3.0，未显式固定列宽时，表头不换行 min-content 参与 Table 自动总最小宽度。
- 2026-09-01：v2.2.1，表头跟随 Table 新响应曲线，在常见窄屏容器收敛到每侧 2px，并明确相邻列最小视觉间距为 4px。
- 2026-08-14：v2.2.0，普通、selection、actions 与 overlay 角色表头的左右 padding 改为按 Table 容器宽度响应，范围为 2px 到 12px。
- 2026-08-06：v2.1.0，普通数据列的 `resizable` 默认值改为 `true`；声明 `columnId` 后即可拖动改宽，固定列可显式传入 `resizable={false}`；selection/actions 角色列保持不可拖动。
- 2026-08-03：v1.9.2，selection Checkbox 的 1px 增量改为固定 `0.0625rem` 特例，不再复用边框 Token。
- 2026-08-03：v1.9.1，selection 全选 Checkbox 与数据行统一使用 Token 计算的 17px Table 组合尺寸；独立 Checkbox 默认值不变。

- 2026-07-12：v2.0.1，适配 Indicator line 全高命中带；表头视觉恢复 1×16 贴右缘。
- 2026-07-01：v2.0.0，新增 `label` 并把可排序列元数据注册给 DataTable / TableToolbar。
- 2026-06-30：v1.9.0，overlay selection 标题渐隐改为固定约 14px → 26px，视觉对齐 Table Demo 表格一，不再随标题或列宽变化。
- 2026-06-30：v1.8.0，接入 Table Context 列注册协议，供 TableBody 首次加载时按真实表头顺序生成 Skeleton rows。
- 2026-06-30：v1.7.1，移除表头真实首尾单元格的静态外缘圆角，避免默认 divided 表头分割线在两端弯曲；overlay 浮动控件块圆角保留。
- 2026-06-24：v1.7.0，overlay blur 复用 `progressive-blur.ts` 通用能力，移除组件内旧窄 strip 实现。
- 2026-06-24：v1.6.9，overlay 宽度回调到约 35px，但 strip 分布压在前 65% 内并降低 blur 半径，让模糊早于块宽结束。
- 2026-06-24：v1.6.8，overlay 默认宽度再减半为约 26px，并压缩后续 strip 分布，让右侧过渡更早结束。
- 2026-06-24：v1.6.7，回到已有模糊效果的窄分段 Progressive Blur；移除额外延伸的 blur surface，恢复首段宽 strip + 后续窄 strip 的覆盖方式。
- 2026-06-24：v1.6.6，恢复多层 progressive backdrop 机制，改为 6 层全宽渐隐 mask，保留模糊效果并避免硬分段边缘。
- 2026-06-24：v1.6.5，overlay 控件宽度与 blur surface 宽度解耦，blur surface 额外向内容方向延伸，确保覆盖到相邻表头文字产生模糊。
- 2026-06-24：v1.6.4，blur surface 默认恢复 `.1%` 不可见合成触发面，并调整 alpha mask 曲线，恢复 backdrop-filter 模糊采样。
- 2026-06-24：v1.6.3，overlay blur 从多层 strip 改为单层全宽 blur surface + alpha mask，消除放大后可见的色块边缘。
- 2026-06-24：v1.6.2，TableHeader 首尾与 overlay 可见块补齐行同款圆角；overlay 默认宽度与 strip 尺寸减半，strip tint 默认归零。
- 2026-06-24：v1.6.1，overlay 角色表头的渐进模糊改为 hover 才显示，并收敛为 8 层宽首段 + 重叠窄条带。
- 2026-06-23：v1.6.0，新增角色列 `roleLayout="overlay"` 覆盖布局，selection/actions 表头可贴左右边缘并使用反向多层透明模糊渐变遮罩。
- 2026-06-23：v1.5.0，新增 `as="selection/actions"` 角色；选择表头内置当前渲染行全选 Checkbox，操作表头默认隐藏且允许自定义标题。
- 2026-06-22：v1.4.1，参考 MUI / Ant Design / HeroUI 等主流表格的数值方向语义，正式定义 ascending 使用 ArrowsUp，descending 使用 ArrowsDown；明确未声明 `defaultSort` 时不会隐式按第一列升序。
- 2026-06-22：v1.4.0，新增 `defaultSortActive`；开启后默认排序方向也显示激活态与图标，交互循环改为“默认 → 反向 → 无排序 → 默认”；撤销 v1.3.1 的 `sortable` 必需结论，恢复自动排序能力判断。
- 2026-06-22：v1.3.1，将 `sortable` 确立为排序能力的显式开关；未声明时不再因同名行字段自动启用交互。`defaultSort` 继续自动隐含该能力。
- 2026-06-22：v1.3.0，新增 `defaultSort="ascending | descending"`，由 TableHead 同时声明默认排序列和方向；声明该 prop 时自动启用列排序。
- 2026-06-22：v1.2.3，按列表向下阅读语义修正排序图标映射：ascending 使用 ArrowsDown，descending 使用 ArrowsUp。
- 2026-06-22：v1.2.2，将“默认方向无激活视觉”收窄为仅适用于 `defaultSort` 命中列；其他列恢复为 ascending / descending 均显示激活态与图标。
- 2026-06-22：v1.2.1，默认排序方向改为非激活视觉且不显示图标，只有反向排序显示 ArrowsUp / ArrowsDown；图标与文字间距改为 0。
- 2026-06-22：v1.2.0，恢复排序激活图标；ascending / descending 分别使用内置 ArrowsUp / ArrowsDown；可排序文字与图标统一接入 40% → 100% 通用 hover 规则；明确原始值自动比较、派生列使用 sorter 的类型决策。
- 2026-06-22：v1.1.1，表头列宽 Indicator 改为常态 1px × 16px，并与表头水平中线居中对齐。
- 2026-06-20：v1.1.0，移除列标题右侧排序箭头，保留点击排序与 aria-sort。
- 2026-06-19：v1.0.0，新增排序与 Resizable 接入。