@fibrae/semi-json-viewer-core

中文文档
0.7.0发布于 2026/11/14MITES Module零依赖构建来源已验证近 30 天下载 2349

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

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 内部
  4. 相关软件包
  5. 发展

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

简体中文

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

安装

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

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

使用量

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。 。 。 .

内部

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 在此软件包目录中,发布带有类型声明的单项无害环境管理文件。 测试、油漆和打字检查,见 捐款额 在寄存器根处.

版本与发布记录

@fibrae/semi-json-viewer-core 共发布 10 个版本,首次发布于 2026/10/28;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.0latest2026/11/14今天
0.6.02026/11/113 天前
0.5.02026/11/086 天前
0.4.02026/11/077 天前
0.3.12026/11/0410 天前
0.3.02026/11/0212 天前

关于 @fibrae/semi-json-viewer-core 的常见问题

@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 和提交记录判断。