# @hanzo/data 中文文档

规范地址：https://npmcn.com/package/%40hanzo/data/

版本：1\.4\.8
npm 元数据更新时间：2026-11-17T07:13:39.611Z
中文译文更新时间：2026-11-17T08:13:33.581Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40hanzo/data
原文对照：https://npmcn.com/package/%40hanzo/data/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：684 kB，160 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react \>=19\.2\.8，@hanzo/ui \>=8\.28\.0，@hanzo/gui \>=8\.3\.5
- 首次发布：2024-07-24T11:47:16.677Z
- 最新版本发布：2026-11-17T07:13:39.428Z
- 近 30 天下载量：13333（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 17 个）

## 中文简介

Hanzo Data——跨平台,由元数据驱动的数据应用组件(类型字段,记录表,kanban board,记录细节,保存视图)在@hanzo/gui上. 通用对象/字段/记录/视图层,可赋予我们任何基于基础的客户关系管理、客户关系管理或商业应用

## 安装

```sh
npm install @hanzo/data
```

也可以使用：`pnpm add @hanzo/data`、`yarn add @hanzo/data`、`bun add @hanzo/data`

## README

# @hanzo/数据

跨平台、元数据驱动 **数据应用组件** 用于任何 [半藏基地](https://github.com/hanzoai/base)\-后置应用——CRM,CMS,商业,或一次性内部工具. 一种模式(类型) **字段** → **记录** → **视图**)在任何地方,在网络上,在本地(iOS)和桌面上制作,因为它是建立在 [`@hanzo/gui`](https://github.com/hanzoai/gui) 并绘制 [`@hanzo/ui`](https://npmcn.com/package/%40hanzo/ui)'记录套件——表qq板,过滤器,排序,组,内置编辑,保存视图.

对象是一组被打字的字段。 记录是这些字段的值。 每一个视图——表、板、细节——都通过登记册发送,从这个模型中得出,所以,增加一个字段类型就是: **一次登记**从来没有 `switch` 编辑. 商业应用软件(CMM/CMS/ERP)只是一套对这些组件的看法.

## 安装

```sh
bun add @hanzo/data @hanzo/ui @hanzo/gui
```

`@hanzo/ui`, (中文(简体) ), `@hanzo/gui` 财务报告和审定财务报表 `react` 是同龄人。 把它挂起来 `<Hanzo>` (单位:千美元) @hanzo/ui root)和单元格,卡片和编辑都跟随主题. 环绕记录 表面在 `<Density value="compact">` 记录密度: 32px行和 控件, 8px 沟道, 13px 文本; 没有它, 表格将保留 44px 行和 编辑工具包的36px.

## 旗舰: `RecordsView`

一个外壳将任何收藏变成一个记录表面——一个工具栏(视图开关、搜索、过滤器构建器、排序构建器、棋盘组合),通过一个 **数据表** 或一个 **董事会**,由单人驱动 `ViewConfig`. 演示式+数据注入:主机提供原始记录和持续回调;视图拥有交互状态.

```tsx
import { RecordsView, type FieldDefinition } from '@hanzo/data'

<RecordsView
  fields={fields}
  records={records}                              // raw rows; the view applies search + filter + sort
  onOpen={openDetail}                            // expand a record
  onEditCommit={(rec, field, value) => save(rec, field, value)}  // inline cell / board edit
  onCreate={createRecord}
  savedViews={{ views, activeId, onSelect, onSave, onDelete, deletable }}  // optional named views; deletable(id) keeps built-ins
/>
```

-   **数据表** ——点击-按键头,拖放-调整大小+拖放-重排列,用页眉选择行选择全部,内置单元格编辑(字段自有编辑器),页码,悬浮-回放打开,诚实地空入/装入.
-   **董事会** 由选定/状态/boolean/关系字段组合的 kanban; 将卡拖到另一个行并释放出记录补丁( 乐观, 失败时返回) .
-   **详细记录** - 题为 " 可选内在编辑的栏目 " ,其中 `related` 插槽 . **记录格式** ——创建/编辑形式.

风景的规则结合 `match`数字 : `and` (所有规则,默认)或 `or` (任何一种);两条规则之间的词交换. 数字、金钱和日期也过滤 `between` 两个值, 任意一端开着, 一个结束一天的距离 需要整个一天.

**服务器的一页.** 收藏量太大,无法保存,主机在查询时运行该视图,并通过它带回的一页 `remote`:记录显示为给定,从不重新过滤,寻呼器读取总计.

```tsx
<RecordsView
  fields={fields}
  records={page.items}                                       // already searched, filtered, sorted
  view={view}
  onViewChange={setView}                                     // the host re-queries on every change
  remote={{ page: page.page, total: page.total, onPage: setPageNumber }}
/>
```

## 字段类型

`text · longText · number · percent · currency · boolean · select · multiSelect · date · dateTime · email · url · links · phone · rating · relation · json · uuid · fullName · address · files · richText · position · actor`

每个类型都有读数 **显示** 和(可编辑之处) a **投入**@hanzo/ui的唱片包:选择是 **标记** 在其选项的颜色(三十个数据色, `TagColor`)及其编辑器的可搜索菜单有"不..."一行;数个值是一行标签或药丸,有一个 **+N 组合键**; 电子邮件、链接和电话是带有邮件/ https/ 电话目标的药丸; 关系是一个记录芯片 **有远见**; 货币是带有 **货币拾取器** (b) 电话号码和 **调用代码拾取器**{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}一个工具箱的约会 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我 **日历** 在打字日下; 评分一行恒星. 输入承诺编辑, 退出取消 .

## 扩展

登记任何类型——内置或自定义——的渲染器

```tsx
import { registerField } from '@hanzo/data'

registerField('rating', { Display: MyStars, Input: MyStarPicker })
```

## 纯逻辑(可用主机,测试)

排序 / 过滤 / 搜索 / 组 / 视图帮助器是纯和导出( 也在子路径上) `@hanzo/data/{table,board,view}/logic` 这样一个节点主机就可以在没有gui运行时间的情况下导入它们 :

```ts
import { applyView, sortRecords, filterRecords, boardColumns } from '@hanzo/data'
```

## 表面

-   **型号** —— 说 `FieldDefinition`, (中文(简体) ), `FieldType`, (中文(简体) ), `FieldMetadata`, (中文(简体) ), `SelectOption`, (中文(简体) ), `TagColor`, (中文(简体) ), `CurrencyValue`, (中文(简体) ), `LinkValue`, (中文(简体) ), `AddressValue`, (中文(简体) ), `FullNameValue`, (中文(简体) ), `ActorValue`
-   **名单** —— 说 `regions()`, (中文(简体) ), `currencies()` (从Intl,用读者的语言),, `CALLING` (E.164呼叫代码)
-   **视图** —— 说 `RecordsView`, (中文(简体) ), `DataTable`, (中文(简体) ), `BoardView`, (中文(简体) ), `RecordDetail`, (中文(简体) ), `RecordForm`, (中文(简体) ), `RecordCard`, (中文(简体) ), `RecordsToolbar`
-   **初级** —— 说 `Menu`, (中文(简体) ), `MenuItem`, (中文(简体) ), `CheckBox`, (中文(简体) ), `Toggle`, (中文(简体) ), `Calendar`
-   **路由器/登记** —— 说 `FieldDisplay`, (中文(简体) ), `FieldInput`, (中文(简体) ), `isEditable`, (中文(简体) ), `registerField`, (中文(简体) ), `getFieldRenderers`
-   **逻辑** —— 说 `applyView`, (中文(简体) ), `sortRecords`, (中文(简体) ), `filterRecords`, (中文(简体) ), `searchRecords`, (中文(简体) ), `paginate`, (中文(简体) ), `boardColumns`, (中文(简体) ), `movePatch`, (中文(简体) ), `operatorsForType`, (中文(简体) ), `emptyView`, (中文(简体) ), `describeView`,, , , , , , , ,
-   **主题** —— 说 `TAG_TONES`, (中文(简体) ), `tagTone` (数据调色板的标签对作为自定义属性); `tokens` (旧的固定暗色调色板,为呼叫者保留)

• 麻省理工学院 [利比里亚](https://npmcn.com/package/LICENSE.md)HIP-0137 (中文(简体) )`hanzoai/hips`) (中文(简体) ).

## 常见问题

### @hanzo/data 是什么？

Hanzo Data——跨平台,由元数据驱动的数据应用组件\(类型字段,记录表,kanban board,记录细节,保存视图\)在@hanzo/gui上\. 通用对象/字段/记录/视图层,可赋予我们任何基于基础的客户关系管理、客户关系管理或商业应用

### 如何安装 @hanzo/data？

在项目目录运行 npm install @hanzo/data，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.2\.8）、@hanzo/ui（\>=8\.28\.0）、@hanzo/gui（\>=8\.3\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @hanzo/data 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @hanzo/data 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @hanzo/data 可以商用吗？

@hanzo/data 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @hanzo/data 的下载量有多少？

根据 npm 官方下载统计，@hanzo/data 在 2026/10/17 – 2026/11/15 这 30 天内被下载 13,333 次，日均约 444 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @hanzo/data 还在维护吗？

最新版本 1\.4\.8 发布于 2026/11/17（今天）；至今共发布 19 个版本，其中过去 12 个月发布了 17 个；首次发布于 2024/07/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

