# @fibrae/semi-json-viewer-core 中文文档

规范地址：https://npmcn.com/package/%40fibrae/semi-json-viewer-core/

版本：0\.7\.0
npm 元数据更新时间：2026-11-14T10:22:12.162Z
中文译文更新时间：2026-11-14T17:04:06.372Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fibrae/semi-json-viewer-core
原文对照：https://npmcn.com/package/%40fibrae/semi-json-viewer-core/?lang=original
项目主页：https://semi-design-next.pages.dev/
源码仓库：https://github.com/smile-alive/semi-design-next

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

- 包体积（解压后）：341 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-28T08:32:09.908Z
- 最新版本发布：2026-11-14T10:22:11.856Z
- 近 30 天下载量：2349（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Semi's JsonViewer的无框架 JSON 查看器和编辑核心

## 安装

```sh
npm install @fibrae/semi-json-viewer-core
```

也可以使用：`pnpm add @fibrae/semi-json-viewer-core`、`yarn add @fibrae/semi-json-viewer-core`、`bun add @fibrae/semi-json-viewer-core`

## README

# @fibrae/semi-json-viewer-core (英语)

[简体中文](https://npmcn.com/package/%40fibrae/semi-json-viewer-core/README.zh-CN.md)

JsonViewer在"Sime Design Next"中背后的框架-不可知编辑核心,由VS代码中的JSON取景和编辑执行而来. 考虑到容器元素和JSON文本,它提供渲染,编辑,搜索和替换,完成和格式化. 大多数用户通过每个框架的UI软件包中的JsonViewer和JsonViewer基础在 `@fibrae/semi-foundation` 取决于此软件包.

## 安装

```sh
pnpm add @fibrae/semi-json-viewer-core
```

它没有同伴或运行时间依赖关系(`jsonc-parser` 捆绑到 `dist`) (中文(简体) ). 该套件没有样式;JsonViewer组件提供.

## 使用量

```ts
import { JsonViewer } from '@fibrae/semi-json-viewer-core';

const viewer = new JsonViewer(container, '{"name": "semi"}', { readOnly: true });
viewer.layout();
// release when no longer needed
viewer.dispose();
```

构造器 : `new JsonViewer(container: HTMLElement, value: string, options?: JsonViewerOptions)`。 。 。 .

| 选项 | 说明 |
| --- | --- |
| `lineHeight` | 线高 |
| `autoWrap` | 是否自动包裹行 |
| `readOnly` | 内容是否只读 |
| `formatOptions` | 格式化,与 `tabSize`, (中文(简体) ), `insertSpaces` 财务报告和审定财务报表 `eol` |
| `completionOptions` | 完成, 与 `staticCompletions` |
| `customRenderRule` | 习惯组合生成规则 `{ match, render }`时 `match` 是一个字符串, a `RegExp` 或者说 `(value, pathChain, tokenType) => boolean` |
| `prefixCls` | 类名前缀 |
| `ariaLabel` | 仅读时滚动区域的名称,可编辑时的文本框的名称 |

实例方法 : `layout()`, (中文(简体) ), `resetMeasuredHeights()`, (中文(简体) ), `getModel()`, (中文(简体) ), `getSearchWidget()`, (中文(简体) ), `format()` 财务报告和审定财务报表 `dispose()`,加上公共财产 `emitter`。每个实例都将其事件和工人隔离在自己的命名空间中,所以你必须呼叫 `dispose()` 当完成.

导出类型 : `JsonViewerOptions`, (中文(简体) ), `CompletionOptions`, (中文(简体) ), `FormattingOptions`, (中文(简体) ), `TokenRenderType` 财务报告和审定财务报表 `CustomRenderRule`。组件文件在 [网站/内容/加/json-viewer](https://npmcn.com/website/content/plus/json-viewer)。 。 。 .

## 内部

`src/tokens` 处理词典分析并突出JSON文本:

-   `tokenize.ts` 识别分隔符、关键词、字符串、数字和注释,并记录括号嵌入深度.
-   `tokenizationJsonModelPart.ts` 保存整个文档的符号状态,并在内容变化时标记受影响的行.
-   `jsonModelToken.ts` 进行增量分析,只计算变化,在闲置时间完成背景 `IdleDeadline`。 。 。 .
-   `offsetRange.ts` 提供相抵范围内的合并、相接、转移和封隔操作,用来约束需要重算的内容.

语言服务使用网络工人。 构建时的插件 `vite.semi.ts` 插入工人源,运行时从blob URL开始.

## 相关软件包

取决于 `@fibrae/semi-foundation`。不取决于其他的Semi软件包.

## 发展

`pnpm build` 运行 `vp pack` 在此软件包目录中,发布带有类型声明的单项无害环境管理文件。 测试、油漆和打字检查,见 [捐款额](https://npmcn.com/CONTRIBUTING.md#%E5%B8%B8%E7%94%A8%E5%91%BD%E4%BB%A4) 在寄存器根处.

## 常见问题

### @fibrae/semi-json-viewer-core 是什么？

Semi's JsonViewer的无框架 JSON 查看器和编辑核心

### 如何安装 @fibrae/semi-json-viewer-core？

在项目目录运行 npm install @fibrae/semi-json-viewer-core，或使用 pnpm add / yarn add / bun add。

### @fibrae/semi-json-viewer-core 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fibrae\_\_semi-json-viewer-core 是否存在。

### @fibrae/semi-json-viewer-core 支持 ESM 还是 CommonJS？

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

### @fibrae/semi-json-viewer-core 可以商用吗？

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

### @fibrae/semi-json-viewer-core 的下载量有多少？

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

### @fibrae/semi-json-viewer-core 还在维护吗？

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