TableHead

定义 Table 的列标题，可承载排序操作与列宽调整，帮助用户理解和组织表格数据。

我们正在让 SnowUI 组件成为 AI 对话中可直接操作的界面。目前对话交互能力仍在建设中；本页展示网站用法，支持的对话平台与组件版本将在验证后公布。 AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。

如何使用

作为表头行的标题单元格。DataTable 协调数据排序；列宽调整与数据排序是两项独立能力，不把 resizable 当成 sortable。

columnId 对齐列；resizable 控制调宽，排序状态通过独立 sortDirection / onSortChange 表达。
selection 角色使用 DataTable 的全选控件；parts 配置默认 Indicator / Checkbox，显式标题自行配置。

导入

import { TableHead } from '@snowui-design-system/components';

用法

对齐

可调整尺寸

API 参考

属性	类型	默认值	示例	描述
`responsiveHide`	`boolean`	`true`	`responsiveHide`	关闭横向滚动时允许该普通列自动隐藏；false 始终保留。第一普通列和角色列不隐藏。
`columnId`	`string`	`—`	`columnId="Example"`	稳定列标识；角色列使用内置标识默认行为：普通列必填。
`label`	`string`	`—`	`label="Example"`	可读列名：供 TableToolbar 排序列表和列宽手柄使用。排序列表未传时沿用 columnId；列宽手柄未传时使用本地化的通用名称，不朗读内部 columnId。
`sortDirection`	`"ascending" \| "descending"`	`—`	`sortDirection="ascending"`	独立受控排序方向默认行为：context 推导。
`defaultSort`	`"ascending" \| "descending"`	`—`	`defaultSort="ascending"`	声明表格默认按当前列的正序或反序排列；同时使当前列可排序
`defaultSortActive`	`boolean`	`false`	`defaultSortActive`	使 `defaultSort` 的默认方向也显示激活态和图标，并将交互循环扩展为可取消排序
`roleLayout`	`TableRoleLayout`	`—`	`roleLayout={value}`	覆盖当前角色表头的角色列布局；普通表头忽略默认行为：Table context。
`onSortChange`	`(direction: "ascending" \| "descending" \| undefined) => void`	`—`	`onSortChange={(value) => { /* handle value */ }}`	独立使用时的三态排序回调
`resizable`	`boolean`	`—`	`resizable`	是否显示列宽手柄；显式设置优先于上下文默认值默认行为：Table：`false`；DataTable：`true`。
`minWidth`	`number`	`64`	`minWidth={42}`	列宽调节的下限，单位 CSS px；仅在列宽调节能力启用时参与夹取。
`maxWidth`	`number`	`Infinity`	`maxWidth={42}`	列宽调节的上限，单位 CSS px；默认 Infinity 表示不额外限制。
`align`	`"start" \| "center" \| "end"`	`"start"`	`align="start"`	表头内容对齐：start 为起始侧，center 居中，end 为末端；不改变数据排序。
`children`	`Snippet`	`—`	`<TableHead>Content</TableHead>`	表头标题内容，无参数；支持文字、Icon、资源图标及组件组合；可排序时放入内置排序按钮，selection 角色由内置全选控件承担。
`parts`	`ComponentPartsOf<{ Indicator: typeof Indicator; Checkbox: typeof Checkbox; }>`	`—`	`parts={partsOptions}`	配置内置列宽 Indicator 与全选 Checkbox；不配置显式子内容。