shop-wx/doc/wot-design-uni/docs/guide/locale.md

国际化

Wot UI 默认使用中文语言，同时支持多语言切换，如果你希望使用其他语言，你可以参考下面的方案。

:::warning 注意点 目前组件库发布到 npm 上的包是未经编译的vue与ts，而 Vite 会将预构建的依赖项缓存到 node_modules/.vite，组件库的国际化的实现是基于reactive实现的数据共享，在dev阶段就会出现页面使用预构建产物中的国际化数据，而组件库使用组件库内部的国际化数据，所以在非uni_modules模式引入时，需要在vite.config.ts中增加以下配置:

import { defineConfig } from 'vite'
import uni from '@dcloudio/vite-plugin-uni'

export default defineConfig({
  ...
  optimizeDeps: {
    exclude: process.env.UNI_PLATFORM === 'h5' && process.env.NODE_ENV === 'development' ? ['wot-design-uni'] : []
  }
  ...
})

使用optimizeDeps.exclude在预构建中强制排除wot-design-uni模块，在uni_modules模式下，不需要做任何处理。

:::

使用其他语言

我们通过 Locale 组件实现多语言支持，使用 Locale.use 方法可以切换当前使用的语言。

import { Locale } from 'wot-design-uni'
// 引入英文语言包
import enUS from 'wot-design-uni/locale/lang/en-US'

Locale.use('en-US', enUS)

覆盖语言包

通过 Locale.add 方法可以实现文案的修改和扩展，示例如下：

import { Locale } from 'wot-design-uni'

const messages = {
  'zh-CN': {
    calendar: {
      title: '请选择日期' // 将'选择日期'修改为'请选择日期'
    }
  }
}

Locale.add(messages)

支持的语言

语言	文件名	版本
简体中文	zh-CN	v0.2.20
繁体中文（台湾）	zh-TW	v0.2.20
繁体中文（香港）	zh-HK	v0.2.20
英语	en-US	v0.2.20
泰语	th-TH	v0.2.20
越南语	vi-VN	v0.2.20
阿拉伯语	ar-SA	v1.3.12
德语	de-DE	v1.3.12
西班牙语	es-ES	v1.3.12
葡萄牙语	pt-PT	v1.3.12
法语	fr-FR	v1.3.12
日语	ja-JP	v1.3.12
韩语	ko-KR	v1.3.12
土耳其语	tr-TR	v1.3.12
俄语	ru-RU	v1.3.12

如果你需要使用其他的语言，欢迎贡献 PR，只需在这里添加一个语言配置文件即可。