TableHeader 使用手册

v1.1.0 · @snowui-design-system/components

许可阅读：首次阅读组件文档、源码或 npm 使用流程，先读完整 LICENSE；同任务同版本去重。公开 API 配置与内部实现修改分别按许可处理；全部组件使用统一运行包，源码权益以许可为准。

组件介绍

组织 Table 的表头行，明确各列含义，并保留原生表格的表头语义。

使用选择

作为 Table 的表头区域，包含表头 TableRow 与 TableHead；保持原生表格语义。

放在 Table 内，使用 TableRow 组织 TableHead。
只承担表头区域语义；排序、列宽与选择分别由对应 TableHead 和 DataTable 配置。

快速开始

以下示例展示推荐的基本组合。更多场景与组合限制见后文。

<script lang="ts">	import { TableHeader, Table, TableBody, TableCell, TableRow, TableHead } from '@snowui-design-system/components';</script> <Table ariaLabel="SnowUI component catalog columns" minWidth={680}>	<TableHeader><TableRow>		<TableHead columnId="component">Component</TableHead>		<TableHead columnId="package">Package</TableHead>		<TableHead columnId="category">Category</TableHead>		<TableHead columnId="updated">Last updated</TableHead>		<TableHead columnId="status" align="end">Documentation</TableHead>	</TableRow></TableHeader>	<TableBody><TableRow rowId="button"><TableCell columnId="component">Button</TableCell><TableCell columnId="package">components</TableCell><TableCell columnId="category">Basic</TableCell><TableCell columnId="updated">Today</TableCell><TableCell columnId="status" align="end">Published</TableCell></TableRow></TableBody></Table>

API

关键字	类型	默认值	描述
children	`Snippet`	—	表头行内容，无参数；使用 TableRow 组合 TableHead，保持 thead 语义。

未重新声明的继承能力请查所属基础组件文档；本表只列本组件源码具名公开属性。

使用边界与详细说明

Keyword

Keyword	说明
component	当前组件公开契约

根节点必须保持 thead。

TableHeader 样式覆盖

先阅读完整 LICENSE；同任务、同版本、同范围去重。

优先用组件公开 Props 匹配合适样式，尽可能保留原有视觉。确需改写时按样式选择与改写顺序使用自己的 class（含项目已有 Tailwind）或实例 style。以下名称来自源码实际消费的公开 override；先核对目标作用域，不修改私有 DOM。采用 SnowUI Token 时选择正确类别，外部应用不被要求安装一方 utilities。

本组件源文件没有直接消费已登记的专属 override。组合子组件的样式通过公开 parts 或显式 child 配置；不要凭名称猜测变量。

设计指南 · Token · 组合边界

TableHeader 类型与状态

必填属性：无具名必填属性。

可双向绑定：本组件未声明具名双向绑定属性；状态更新通过公开回调或所属宿主处理。

继承声明：Omit<FrameProps, "children">。继承能力以基类公开文档为准；Omit 中的字段已排除，不能按基类原样使用。

共享 Frame API · 返回 API

以下为公开属性实际引用的类型声明，来自源码；Svelte Snippet 表示内容片段，ComponentProps 表示对应组件的 Props。