Skip to content

国际化

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

注意点

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

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 方法可以切换当前使用的语言。

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

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

覆盖语言包

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

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

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

Locale.add(messages)

支持的语言

语言文件名版本
简体中文zh-CNv0.2.20
繁体中文(台湾)zh-TWv0.2.20
繁体中文(香港)zh-HKv0.2.20
英文en-USv0.2.20
泰文th-THv0.2.20
越南文vi-VNv0.2.20

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

Released under the MIT License.

Released under the MIT License.