React 组件
UGTable 基础表格
提供原生表格语义、稳定行列布局、横向溢出与样式扩展。排序、筛选、列拖拽、编辑和虚拟滚动属于独立的高级表格。
导入方式
按需从包入口导入组件,并在应用入口引入一次样式文件。
tsx
import {
UGTable,
UGTableHeader,
UGTableBody,
UGTableRow,
UGTableHead,
UGTableCell,
} from '@ug666/ui-react'基础用法
用组合式子组件表达表头、数据行和单元格,业务内容保持清晰。
| 成员 | 职责 | 团队 | 状态 |
|---|---|---|---|
| 林木 | 设计负责人 | 设计系统 | 在线 |
| 阿青 | 前端开发 | Web 平台 | 审阅中 |
| 子墨 | 产品经理 | 产品体验 | 离线 |
| 小北 | 移动端开发 | 跨端平台 | 在线 |
行样式与信息密度
通过 bordered、striped 和 size 统一控制常用表格外观;业务强调色仍由数据语义决定。
| 环境 | 域名 | 最后发布 |
|---|---|---|
| Production | ui.ug666.dev | 5 分钟前 |
| Preview | preview-128.ug666.dev | 刚刚 |
| 构建任务 | 分支 | 耗时 |
|---|---|---|
| docs-build | main | 42s |
| package-check | release | 18s |
空数据与横向溢出
空状态保持合法表格结构;列宽超过容器时由 UGTable 提供横向滚动。
| 名称 | 负责人 | 更新时间 |
|---|---|---|
| 暂无数据 | ||
| 项目 | 仓库 | 负责人 | 环境 | 更新时间 |
|---|---|---|---|---|
| UG UI | ug666/ug-ui | 林木 | Production | 刚刚 |
代码示例
基础表格只负责结构和视觉;复杂数据能力使用后续独立的高级表格。
tsx
import { UGTable, UGTableBody, UGTableCell, UGTableHead, UGTableHeader, UGTableRow } from '@ug666/ui-react'
export function MembersTable() {
return (
<UGTable>
<UGTableHeader>
<UGTableRow>
<UGTableHead>成员</UGTableHead>
<UGTableHead>职责</UGTableHead>
<UGTableHead className="text-right">状态</UGTableHead>
</UGTableRow>
</UGTableHeader>
<UGTableBody>
<UGTableRow>
<UGTableCell className="font-medium">林木</UGTableCell>
<UGTableCell>设计负责人</UGTableCell>
<UGTableCell className="text-right">在线</UGTableCell>
</UGTableRow>
</UGTableBody>
</UGTable>
)
}属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| UGTable | TableHTMLAttributes | — | 基础 table 容器,提供横向溢出和原生表格语义。 |
| scrollRegionLabel | string | '数据表格滚动区域' | 横向滚动容器的可访问名称。 |
| scrollRegionTabIndex | number | 0 | 滚动容器的 Tab 顺序;设为 -1 时只允许编程聚焦。 |
| size | 'sm' | 'md' | 'lg' | 'md' | 统一控制表头高度、字号和单元格内边距。 |
| bordered | boolean | false | 显示完整外边框和单元格分隔线。 |
| striped | boolean | false | 为偶数数据行增加弱背景。 |
| hoverable | boolean | true | 启用数据行悬停反馈。 |
| UGTableHeader | HTMLAttributes<HTMLTableSectionElement> | — | 表头区域,对应 thead。 |
| UGTableBody | HTMLAttributes<HTMLTableSectionElement> | — | 表格主体,对应 tbody。 |
| UGTableRow | HTMLAttributes<HTMLTableRowElement> | — | 数据行,对应 tr,内置分隔线和悬停反馈。 |
| UGTableHead | ThHTMLAttributes | — | 表头单元格,对应 th。 |
| UGTableCell | TdHTMLAttributes | — | 数据单元格,对应 td,支持 colSpan、rowSpan 和对齐样式。 |