跳到主要内容

本地化

Editor widget 支持本地化功能,使开发者能够以不同语言显示标签、消息和提示信息。该功能对于面向多语言用户的应用程序至关重要。本地化可通过为 widget 配置自定义翻译集来实现。

该库内置了三种语言环境:

  • 中文
  • 英文
  • 德文

您也可以应用自定义语言环境。

默认语言环境

默认使用英文语言环境:

应用语言环境

要应用内置语言环境,请从 "@svar-ui/svelte-core" 导入 Locale 对象,从 "@svar-ui/core-locales" 导入核心语言包,从 "@svar-ui/editor-locales" 导入内置语言环境,然后将所需语言的 words 属性添加到 Locale 标签中。

示例:

import { Locale } from "@svar-ui/svelte-core";
import { cn } from "@svar-ui/editor-locales";
import { cn as cnCore } from "@svar-ui/core-locales";

<Locale words={{ ...cn, ...cnCore }}>

以下配置可使 Editor widget 以德文显示文本。myLang 对象包含键值对,其中键为 Editor 使用的默认英文字符串,值为对应的德文翻译。Locale 组件包裹 Editor 并应用指定的翻译。

<script>
import { Locale } from "@svar-ui/svelte-core";
import { Editor } from "@svar-ui/svelte-editor";

const myLang = {
"This field is required": "Dieses Feld ist erforderlich",
"Invalid value": "Ungültiger Wert",
Yes: "Ja",
No: "Nein",
Save: "Speichern",
Cancel: "Abbrechen",
};
</script>

<Locale words={{ editor:myLang }}>
<Editor />
</Locale>

要应用自定义语言环境,需要为其创建一个对象(或修改现有对象),并为所有 Editor 文本标签提供翻译(可以是任意所需语言)。您还需要添加来自 corecalendar 组件("@svar-ui/core-locales")的标签。详情请参阅 Core 本地化

韩文语言示例:

const ko = {
editor: {
"Invalid value": 잘못된 값,
// other
},
core:{ ... },
calendar: { ... }
};

相关示例: 语言环境