# @haklex/rich-ext-nested-doc 中文文档

规范地址：https://npmcn.com/package/%40haklex/rich-ext-nested-doc/

版本：0\.66\.0
npm 元数据更新时间：2026-11-15T13:30:08.083Z
中文译文更新时间：2026-11-17T06:32:15.320Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40haklex/rich-ext-nested-doc
原文对照：https://npmcn.com/package/%40haklex/rich-ext-nested-doc/?lang=original
项目主页：https://github.com/Innei/haklex#readme
源码仓库：https://github.com/Innei/haklex

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

- 包体积（解压后）：127 kB，32 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react \>=19，lexical ^0\.53\.0，react-dom \>=19，lucide-react ^1\.0\.0，@lexical/react ^0\.53\.0，@lexical/markdown ^0\.53\.0，@haklex/rich-editor ^0\.66\.0，@haklex/rich-editor-ui ^0\.66\.0，@haklex/rich-style-token ^0\.66\.0
- 首次发布：2026-03-06T17:35:59.020Z
- 最新版本发布：2026-11-15T13:30:07.742Z
- 近 30 天下载量：13393（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：178（近 12 个月 178 个）

## 中文简介

Haklex 丰富编辑器的 Nersted 文档扩展名

## 安装

```sh
npm install @haklex/rich-ext-nested-doc
```

也可以使用：`pnpm add @haklex/rich-ext-nested-doc`、`yarn add @haklex/rich-ext-nested-doc`、`bun add @haklex/rich-ext-nested-doc`

## README

# @haklex/rich-ex-nested-doc 页面存档备份,存于互联网档案馆

嵌入子文档作为卡块的已嵌入文档扩展名 .

## 安装

```bash
pnpm add @haklex/rich-ext-nested-doc
```

## 同伴依赖关系

| 软件包 | 版本 |
| --- | --- |
| `@lexical/react` | `^0.45.0` |
| `lexical` | `^0.45.0` |
| `lucide-react` | `^1.0.0` |
| `react` | `>= 19` |
| `react-dom` | `>= 19` |

## 使用量

### 在编辑器配置中注册节点

```ts
import { nestedDocEditNodes } from '@haklex/rich-ext-nested-doc';

const editorConfig = {
  nodes: [...nestedDocEditNodes],
};
```

用于静态/只读渲染 :

```ts
import { nestedDocNodes } from '@haklex/rich-ext-nested-doc/static';

const staticConfig = {
  nodes: [...nestedDocNodes],
};
```

### 使用嵌入的 Doc 插件

```tsx
import { NestedDocPlugin } from '@haklex/rich-ext-nested-doc';

function EditorPlugins() {
  return <NestedDocPlugin />;
}
```

### 在程序上插入嵌入式文档

```ts
import { INSERT_NESTED_DOC_COMMAND } from '@haklex/rich-ext-nested-doc';

editor.dispatchCommand(INSERT_NESTED_DOC_COMMAND, { docId: '...' });
```

### 提供对话框编辑器上下文

```tsx
import {
  NestedDocDialogEditorProvider,
  useNestedDocDialogEditor,
} from '@haklex/rich-ext-nested-doc';

function App() {
  return (
    <NestedDocDialogEditorProvider>
      <Editor />
    </NestedDocDialogEditorProvider>
  );
}
```

### 使用渲染器和装饰器

```tsx
import { NestedDocEditDecorator } from '@haklex/rich-ext-nested-doc';
import { NestedDocRenderer, NestedDocStaticDecorator } from '@haklex/rich-ext-nested-doc/static';
```

### 覆盖渲染器

`NestedDocStaticDecorator` 解决 `RendererWrapper`,因此下游应用程序可以通过在下游注册一个组件来取代整个静态UI `NESTED_DOC_NODE_KEY` 位置 :

```tsx
import {
  NESTED_DOC_NODE_KEY,
  type NestedDocRendererProps,
} from '@haklex/rich-ext-nested-doc/static';

const MyNestedDocRenderer = ({ contentState }: NestedDocRendererProps) => {
  // custom preview / card / drawer UI
  return <div>{/* ... */}</div>;
};

const rendererConfig = {
  [NESTED_DOC_NODE_KEY]: MyNestedDocRenderer,
};
```

当未提供覆盖时, 默认的装饰器 UI( 审查框架 + 对话框 打开) 被作为- 位置使用 .

### 标记倒置变压器

```ts
import { NESTED_DOC_BLOCK_TRANSFORMER } from '@haklex/rich-ext-nested-doc';

const transformers = [NESTED_DOC_BLOCK_TRANSFORMER];
```

### 导入样式

```ts
import '@haklex/rich-ext-nested-doc/style.css';
```

## 出口

### 节点

-   `NestedDocNode` -- 静态( 只读) 节点
-   `NestedDocEditNode` -- 使用交互式 UI 编辑节点
-   `$createNestedDocNode()` 编号 : `$isNestedDocNode()` - 语言辅助人员
-   `nestedDocNodes` -- 用于配置注册的静态节点阵列
-   `nestedDocEditNodes` -- 用于配置注册的编辑节点数组

### 制作人/装饰人

-   `NestedDocRenderer` -- 静态渲染器
-   `NestedDocEditDecorator` -- 编辑-模式装饰器
-   `NestedDocStaticDecorator` - 静态-模式装饰器(通过 `RendererWrapper`(中文(简体) )
-   `NESTED_DOC_NODE_KEY` - 说吧 `'NestedDoc'` 常数 `RendererConfig` 搜索档
-   `NestedDocRendererProps` 在槽上注册的自定义渲染器的道具形状

### 插件

-   `NestedDocPlugin` -- 嵌入巢道克插件编辑器
-   `INSERT_NESTED_DOC_COMMAND` -- 程序插入的语法命令

### A. 背景情况

-   `NestedDocDialogEditorProvider` -- 巢居 doc 对话框编辑器的上下文提供者
-   `useNestedDocDialogEditor` -- 访问 nocked doc 对话框编辑器上下文的钩头

### 变形器

-   `NESTED_DOC_BLOCK_TRANSFORMER` - Markdown块变压器

### 类型

-   系列化节点类型和有效载荷接口均被输出用于类型安全使用.

### 子路径导出

| 路径 | 说明 |
| --- | --- |
| `@haklex/rich-ext-nested-doc` | 全部出口(编辑+静态) |
| `@haklex/rich-ext-nested-doc/static` | 仅静态( 无重UI 道口) |
| `@haklex/rich-ext-nested-doc/style.css` | 样式表 |

## 哈克历克的一部分

此软件包是 [哈克历](https://npmcn.com/package/README.md) 丰富的编辑生态系统.

## 许可证

麻省理工学院

## 常见问题

### @haklex/rich-ext-nested-doc 是什么？

Haklex 丰富编辑器的 Nersted 文档扩展名

### 如何安装 @haklex/rich-ext-nested-doc？

在项目目录运行 npm install @haklex/rich-ext-nested-doc，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19）、lexical（^0\.53\.0）、react-dom（\>=19）、lucide-react（^1\.0\.0）、@lexical/react（^0\.53\.0）、@lexical/markdown（^0\.53\.0）、@haklex/rich-editor（^0\.66\.0）、@haklex/rich-editor-ui（^0\.66\.0）、@haklex/rich-style-token（^0\.66\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @haklex/rich-ext-nested-doc 支持 TypeScript 吗？

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

### @haklex/rich-ext-nested-doc 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @haklex/rich-ext-nested-doc 可以商用吗？

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

### @haklex/rich-ext-nested-doc 的下载量有多少？

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

### @haklex/rich-ext-nested-doc 还在维护吗？

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

