29 lines
1.3 KiB
Plaintext
29 lines
1.3 KiB
Plaintext
|
---
|
||
|
|
title: 概览
|
||
|
|
description: 了解 Record 包如何在数据驱动界面中传递当前记录。
|
||
|
|
order: 1
|
||
|
|
toc:
|
||
|
|
- id: package-role
|
||
|
|
title: 包的职责
|
||
|
|
- id: capabilities
|
||
|
|
title: 主要能力
|
||
|
|
- id: design-boundary
|
||
|
|
title: 设计边界
|
||
|
|
---
|
||
|
|
|
||
|
|
## 包的职责 {#package-role}
|
||
|
|
|
||
|
|
`@workspace/record` 是一个无 UI 的 React 记录上下文层。这里的“记录”不是特定对象类型：除 `undefined` 和 `null` 外，数字、布尔值、字符串、数组、函数和普通对象都可以作为记录。它让后代组件读取当前值，而不需要逐层传递 `record` prop。
|
||
|
|
|
||
|
|
## 主要能力 {#capabilities}
|
||
|
|
|
||
|
|
- 使用 `RecordProvider` 提供当前记录。
|
||
|
|
- 使用 `useRecord` 读取上下文，或通过显式记录覆盖上下文。
|
||
|
|
- 使用 `useFieldValue` 按类型安全的点路径读取嵌套字段。
|
||
|
|
- 使用 `RecordsIterator` 为列表中的每条数据创建隔离的记录上下文。
|
||
|
|
- 使用 `OptionalRecordProvider` 让组件同时支持独立使用和上下文组合。
|
||
|
|
|
||
|
|
## 设计边界 {#design-boundary}
|
||
|
|
|
||
|
|
该包不负责请求、缓存、分页、表单状态或 UI。请求层只需把已加载的值交给 Provider 或 Iterator。`undefined` 和 `null` 表示没有可提供的记录；`0`、`false` 和空字符串仍是有效记录。表单中的实时输入值仍应由表单状态读取。
|