Uppy 国际化

Uppy 支持多种语言，默认为英语。您可以通过使用语言包将 Uppy 翻译成所需的语言。

通过 npm 使用语言包

这是推荐的方式。从 npm 安装 @uppy/locales 包，然后选择您想使用的语言：@uppy/locales/lib/LANGUAGE_CODE。

npm i @uppy/core @uppy/locales

import Uppy from "@uppy/core";
import German from "@uppy/locales/lib/de_DE";
// 下面会列出所有可用的语言
const uppy = new Uppy({
  debug: true,
  locale: German,
});

通过 CDN 使用语言包

添加一个包含 Uppy 打包文件和您想使用的语言包的 <script> 标签。您可以从 CDN 列复制粘贴链接。该语言包会自动附加到 Uppy.locales 对象上。

<script src="https://releases.transloadit.com/uppy/v3.17.0/uppy.min.js"></script>
<script src="https://releases.transloadit.com/uppy/locales/v3.3.1/de_DE.min.js"></script>

<script>
  var uppy = new Uppy.Uppy({
    debug: true,
    locale: Uppy.locales.de_DE,
  });
</script>

为特定插件覆盖语言字符串

许多插件都带有自己的语言字符串，我们提供的语言包包含了大部分这些字符串。然而，无论您是否使用语言包，都可以为特定插件覆盖语言字符串。请参阅插件文档以获取其使用的语言字符串列表。

import Uppy from "@uppy/core";
import DragDrop from "@uppy/drag-drop";
import Russian from "@uppy/locales/lib/ru_RU";

const uppy = new Uppy({
  debug: true,
  autoProceed: true,
  locale: Russian,
});
uppy.use(DragDrop, {
  target: ".UppyDragDrop",
  // 我们正在使用 ru_RU 语言包（上面在 Uppy 选项中设置），
  // 但你也可以像这样覆盖特定的字符串：
  locale: {
    strings: {
      browse: "выберите ;-)",
    },
  },
});

语言列表

贡献新语言

如果您会一种我们尚未支持的语言，您可以贡献！以下是操作步骤：

1. 前往 Uppy 的 GitHub 仓库中的 uppy/locales 目录。
2. 前往 en_US.js 并复制其内容，因为英语是最新的语言版本。
3. 点击 “创建新文件” ，按照 language_COUNTRY 格式 命名，确保使用下划线 _ 作为分隔符。例如：en_US、en_GB、ru_RU、ar_AE。变体应该位于末尾，例如塞尔维亚拉丁语与西里尔字母的 sr_RS_Latin。
4. 如果您的语言复数规则与英语不同，请更新 pluralize 实现。如果您不确定如何操作，请在 GitHub 问题 中向我们求助。
5. 粘贴您从 en_US.js 复制的内容，并将其用作翻译字符串到您的语言的起点。
6. 准备就绪后，保存文件 — 这将创建一个 PR，我们会进行审查 🎉 感谢您的贡献！