@guardian/prosemirror-invisibles

中文文档
3.1.3发布于 2026/04/07MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 4938

在 prosemiror 中显示隐形物的插件

中文使用文档
文档目录4 节
  1. 安装
  2. 使用量
  3. 关于破行隐形和选择的说明
  4. 本地运行

亲子隐形人

简单执行隐形字符 表达器。 。 。 .

演示 在这里.


安装

npm install @guardian/prosemirror-invisibles

使用量

将插件添加到状态并传递您要在文档中显示的隐形物 .

import invisibles, { space, hardBreak, paragraph } from 'prosemirror-invisibles';

new EditorView(document.querySelector("#editor"), {
  state: EditorState.create({
    doc: DOMParser.fromSchema(mySchema).parse(
      document.querySelector("#content")
    ),
    plugins: [
      invisibles([space(), hardBreak(), paragraph()])
    ]
  })
});

并导入 CS 从 prosemirror-invisibles/dist/invisibles.css。 。 。 .

关于破行隐形和选择的说明

在写作时,Chrome,Firefox和Safari都提供有限的反馈,在进行包含换行的选取时——选择和光标在分出内容后才会改变. 下面可以看到一个选择位置, 包括用户看不见的断线:

No clear indication when we've selected across the paragraph boundary. Taken in Firefox

这对代表换行(段落,软回等)的隐形字符来说是成问题的——我们必须包括换行的隐形符,当它们成为选择的一部分时,或者我们冒着误导用户的风险,暗示换行符不在选择的一部分.

将内容包含在代表无形字符的装饰中会给布局和光标行为带来问题,因此目前我们通过在这些装饰中加入一个附加的跨度来作假,当它们成为选择的一部分. 然后我们可以在跨度上增加一个宽度,并给它一个与文本选择相同的背景颜色. 这把拐杖让我们有了我们期望的行为:

Selecting invisibles provides a clear indication when we've selected across the paragraph boundary. Taken in Firefox

在您自己的编辑器中修改这种造型可能是必要的,以确保冒号的颜色和大小正确. 如果这种行为不可取,我们建议取消这种风格。 最后,我们希望这个问题得到更好的解决——任何建议都非常受欢迎!

本地运行

要在当地运行沙盒 :

yarn watch

版本与发布记录

@guardian/prosemirror-invisibles 共发布 21 个版本,首次发布于 2018/08/22;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.1.3latest2026/04/077 个月前
3.1.12024/07/302 年前
3.0.32023/01/063 年前
3.0.22022/11/164 年前
3.0.12022/11/034 年前
3.0.02022/11/034 年前

其他发布通道:alpha → 1.3.0。

关于 @guardian/prosemirror-invisibles 的常见问题

@guardian/prosemirror-invisibles 是什么?

在 prosemiror 中显示隐形物的插件

如何安装 @guardian/prosemirror-invisibles?

在项目目录运行 npm install @guardian/prosemirror-invisibles,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:prosemirror-model(^1.18.2)、prosemirror-state(^1.4.2)、prosemirror-view(^1.29.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@guardian/prosemirror-invisibles 支持 TypeScript 吗?

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

@guardian/prosemirror-invisibles 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@guardian/prosemirror-invisibles 可以商用吗?

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

@guardian/prosemirror-invisibles 的下载量有多少?

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

@guardian/prosemirror-invisibles 还在维护吗?

最新版本 3.1.3 发布于 2026/04/07(7 个月前);至今共发布 21 个版本,其中过去 12 个月发布了 1 个;首次发布于 2018/08/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。