TableCell

在 Table 的数据行中展示一个单元格，支持文字、组件与自定义内容，默认以单行截断控制长内容。

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

如何使用

作为 TableRow 中的数据单元格。选择列与操作列角色只在启用相应能力的 DataTable 中成立；显式内容替换该单元格默认内容。

放在 TableRow 内，通过 columnId 对齐列；lines / tooltip 控制长内容展示。
选择列与操作列由 DataTable 启用；actions 单元格的显式 children 替换默认操作。

导入

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

用法

对齐

组合

换行

API 参考

属性	类型	默认值	示例	描述
`columnId`	`string`	`—`	`columnId="Example"`	与表头共享列宽
`lines`	`false \| 1 \| 2 \| 3`	`1`	`lines={value}`	截断行数，false 关闭
`tooltip`	`TooltipProp`	`true`	`tooltip={value}`	溢出后展示完整或自定义提示
`onTruncate`	`(isTruncated: boolean) => void`	`—`	`onTruncate={(value) => { /* handle value */ }}`	真实溢出状态变化
`align`	`"start" \| "center" \| "end"`	`"start"`	`align="start"`	内容对齐默认行为：start。
`roleLayout`	`TableRoleLayout`	`—`	`roleLayout={value}`	覆盖当前角色单元格的角色列布局；普通单元格忽略默认行为：Table context。
`nowrap`	`boolean`	`—`	`nowrap`	文字不换行；与 row 同用时同时禁止 flex 子项换行默认行为：`true`（lines=2/3 时 false）。
`singleLine`	`boolean`	`false`	`singleLine`	单行图文预设只作用于内部内容，不改变 td 的原生表格布局；启用 row、nowrap、单行及至少4px间距。用 Text lines={1} 管理可收缩文字及全文提示。
`skeleton`	`boolean`	`false`	`skeleton`	TableBody 内部 Skeleton rows 协议；渲染非交互占位内容并关闭截断
`children`	`Snippet`	`—`	`<TableCell>Content</TableCell>`	单元格内容，无参数；actions 角色提供显式内容时替换默认操作，选择角色仍由 DataTable 协议管理。
`parts`	`ComponentPartsOf<{ Tooltip: typeof Tooltip; Checkbox: typeof Checkbox; }>`	`—`	`parts={partsOptions}`	配置内置截断 Tooltip 和选择 Checkbox；只作用于当前单元格拥有的默认实例。