# @edx/tinymce-language-selector 中文文档

规范地址：https://npmcn.com/package/%40edx/tinymce-language-selector/

版本：1\.1\.0
npm 元数据更新时间：2026-07-10T14:30:01.555Z
中文译文更新时间：2026-11-14T05:04:06.786Z
软件包许可：AGPL-3\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/%40edx/tinymce-language-selector
原文对照：https://npmcn.com/package/%40edx/tinymce-language-selector/?lang=original
项目主页：https://github.com/edx/tinymce-language-selector#readme
源码仓库：https://github.com/edx/tinymce-language-selector

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

- 包体积（解压后）：1.6 MB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2020-06-29T19:34:57.860Z
- 最新版本发布：2020-06-29T19:34:58.141Z
- 近 30 天下载量：2315（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

TinyMCE 5 的插件,允许用户指定文字是否用外语写出,使用哪种语言.

## 安装

```sh
npm install @edx/tinymce-language-selector
```

也可以使用：`pnpm add @edx/tinymce-language-selector`、`yarn add @edx/tinymce-language-selector`、`bun add @edx/tinymce-language-selector`

## README

![Image](https://npmcn.com/package/%40edx/tinymce-language-selector/docs/language-selector.gif)

# 说明

这是TinyMCE 5的插件,允许用户指定其文字用何种语言来写. 插件包装 想要的文本输入 `span` 带有标签的标签 `lang` 指定语言的属性。 未指定文本假定为 以页面语言写出。 这有助于生成的文本符合WCAG 2.0 3.1.2 部件的语言: 内容中每个段落或短语的人类语言可以按程序确定......”

插件用于创建新段落。 当你需要改变语言时,它也会起作用 (详见下文Caveats一节)。 最好的结果是不要选择任何文本 并只需在打字时改变不同语言模式.

# 安装

这是作为国家防范机制的一揽子计划公布的.

`npm install @edx/tinymce-language-selector`

# 使用量

导入插件以添加到 TinyMCE 的插件管理器 :

`import '@edx/tinymce-language-selector'`

确保小MCE已经导入, 因为插件需要访问全局 `tinymce` 变量.

然后可以像TinyMCE的内置插件一样使用插件. 当配置小MCE时, 确保修改 `extended_valid_elements` 允许 `span` 带有标签 `lang` 属性或属性 `id` 属性和去除空格 `span` 标记 :

`extended_valid_elements: 'span[lang|id] -span'`

# 发展

我们正在利用 [语义发布工作流程](https://github.com/semantic-release/semantic-release#commit-message-format) 创建新版本,并向 npm 发布软件包.

# 洞穴

-   由于TinyMCE的测试框架如何具体,Repo目前不包含任何单元测试. 这个 仅进行了手动测试.
-   一个已知的限制是,你不能选择和更改跨越多个 HTML 标记的文本语言 (除格式化外). 错误将升至用户 。 您可以选择和更改任意语言 大于一款,但该款不包含任何已在其内的任何语文.
-   因此我们直接修改 `innerText` 按钮 节点。 我不确定这与国际化和非违约的造型如何配合.

## 常见问题

### @edx/tinymce-language-selector 是什么？

TinyMCE 5 的插件,允许用户指定文字是否用外语写出,使用哪种语言\.

### 如何安装 @edx/tinymce-language-selector？

在项目目录运行 npm install @edx/tinymce-language-selector，或使用 pnpm add / yarn add / bun add。

### @edx/tinymce-language-selector 支持 TypeScript 吗？

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

### @edx/tinymce-language-selector 支持 ESM 还是 CommonJS？

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

### @edx/tinymce-language-selector 可以商用吗？

@edx/tinymce-language-selector 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @edx/tinymce-language-selector 的下载量有多少？

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

### @edx/tinymce-language-selector 还在维护吗？

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