@bomdi/codebox

中文文档
2.0.1发布于 2026/11/08ISCCommonJS零依赖构建来源已验证近 30 天下载 7690

Editor.js 的代码语法加亮工具

此软件包已被标记为弃用

Deprecated: use @clepit/core, whose editor ships a code block. See https://clepit.com

中文使用文档
文档目录7 节
  1. 折旧
  2. 设置
  3. 使用量
  4. 配置参数
  5. 产出数据
  6. 将数据保存为组件
  7. 作者

代码框

折旧

此套件不再保留. 它的继任者是 隐藏。 。 。 .

Clepit是来自同一支队伍的块式编辑和渲染器. 其编辑器搭载了带有语法突出的代码块,因此已不需要CodeBox了.

现有安装继续工作. 以下文件仍供遗产使用.

代码语法突出显示工具 编辑.js

设置

通过国家预防机制安装软件包

npm i @bomdi/codebox

添加到模块/应用程序

import CodeBox from '@bomdi/codebox';
OR
const CodeBox = require('@bomdi/codebox');

使用量

添加代码框 tools 属性.

const CodexEditor = require('@editorjs/editorjs');

let editor = new CodexEditor({
  ...

  tools: {
    ...
    codeBox: {
      class: CodeBox,
      config: {
        themeURL: 'https://cdn.jsdelivr.net/gh/highlightjs/[email protected]/build/styles/dracula.min.css', // Optional
        themeName: 'atom-one-dark', // Optional
        useDefaultTheme: 'light' // Optional. This also determines the background color of the language select drop-down
      }
    },
  }

  ...
});

配置参数

所有参数都是可选的

外地类型说明
主题URLstringURL 指向 CSS 文件,可供您使用 突出显示.js。这也可以指向您自定义的 CSS 语法文件 。 若为 主题URL 提供, 主题Name 财务报告和审定财务报表 默认主题 将被忽略
主题Namestring任何一个 已接受的主题名称 用于 突出显示.js。只需要名称,而不是完整的URL(例如"a11y-dark"). 若为 主题Name 提供, 默认主题 将被忽略
默认主题string代码框 有两个默认主题 - 1 光和 1 暗。 您可以通过传递字符串指定应用什么默认值 光线 或者说 "黑暗" 转到此参数。 注意设置 主题URL 或者说 主题Name 覆盖主代码块的设置, 但是, 语言选择元素/ 下拉菜单的背景由这个值设置

如果没有指定参数, CodeBox 默认为暗主题.

产出数据

CodeBox 返回以下数据

{
  "type": "codeBox",
  "data": {
    "code": "consttest = newTest();.codeBoxTextArea{\n  width: 100%;\n  min-height: 30px;\n  padding: 10px;\n  border-radius: 2px 2px 2px 0;\n  border: none !important;\n  outline: none !important;\n  font: 14px monospace;\n}\n\n.codeBoxSelectDiv{\n  display: flex;\n  flex-direction: column;\n  justify-content: flex-start;\n  align-items: flex-start;\n  position: relative;\n}",
    "language": "css",
    "theme": "https://cdn.jsdelivr.net/gh/highlightjs/[email protected]/build/styles/atom-one-dark.min.css"
  }
}

将数据保存为组件

如果您使用反应, 您可以将保存的数据传递到库中 编辑器 以渲染代码块组件

import { CodeBoxOutput } from 'editorjs-react-renderer';

const data = {
  "type": "codeBox",
  "data": {
    "code": ".codeBoxTextArea{\n  width: 100%;\n  min-height: 30px;\n  padding: 10px;\n  border-radius: 2px 2px 2px 0;\n  border: none !important;\n  outline: none !important;\n  font: 14px monospace;\n}\n\n.codeBoxSelectDiv{\n  display: flex;\n  flex-direction: column;\n  justify-content: flex-start;\n  align-items: flex-start;\n  position: relative;\n}",
    "language": "css",
    "theme": "https://cdn.jsdelivr.net/gh/highlightjs/[email protected]/build/styles/atom-one-dark.min.css"
  }
};

const CodeBlock = () => CodeBoxOutput(data);

export default CodeBlock;

作者

德夫·朱尤

联系我们

学习

版本与发布记录

@bomdi/codebox 共发布 15 个版本,首次发布于 2020/02/12;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.1latest2026/11/08今天
2.0.02022/09/064 年前
1.0.122021/04/105 年前
1.0.112021/04/105 年前
1.0.102020/02/206 年前
1.0.92020/02/196 年前

关于 @bomdi/codebox 的常见问题

@bomdi/codebox 是什么?

Editor.js 的代码语法加亮工具注意:该包已被作者标记为弃用——Deprecated: use @clepit/core, whose editor ships a code block. See https://clepit.com

如何安装 @bomdi/codebox?

在项目目录运行 npm install @bomdi/codebox,或使用 pnpm add / yarn add / bun add。

@bomdi/codebox 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/bomdi__codebox 是否存在。

@bomdi/codebox 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@bomdi/codebox 可以商用吗?

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

@bomdi/codebox 的下载量有多少?

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

@bomdi/codebox 还在维护吗?

最新版本 2.0.1 发布于 2026/11/08(今天);至今共发布 15 个版本,其中过去 12 个月发布了 1 个;首次发布于 2020/02/12。作者已将其标记为弃用,新项目建议寻找替代方案。