Skip to content

多语言

TechUI 内置了一套轻量级、自研的全局多语言解决方案。它采用按需异步加载策略,无需集成第三方库即可实现应用级的国际化支持。

详细文档

本页仅为功能速览。如需了解完整的初始化配置、语义结构及语言切换实现,请查阅 多语言系统完整文档

核心特性

  • 开箱即用:集成于全局服务 $tService 中,无需繁琐配置。
  • 按需加载:自动侦测环境,仅加载当前所需的语言包(如 cn, hk, en),减少资源体积。
  • 响应式:切换语言后,所有组件与状态自动更新。

基础使用

在任意组件中,通过注入全局 i18n 函数即可获取翻译文本。

javascript
import { inject } from 'vue';

// 1. 注入 i18n 函数
const { i18n } = inject('$global');

// 2. 获取静态文本
const text = i18n('universal.confirm'); // 输出: "确定"

// 3. 获取带参数的动态文本
const msg = i18n('panicAlert.device.content', { 
  deviceA: 'PC', 
  deviceB: 'Mobile' 
});

支持范围与展望

当前支持: 目前官方内置支持三种标准语言环境:

  • cn:简体中文
  • hk:繁体中文(香港)
  • en:英语

功能限制与展望: 当前版本暂不支持自定义语言扩展业务文案覆盖。 这意味着您目前只能使用 TechUI 预设的语言包。我们计划在后续版本中开放注册接口,允许开发者挂载自定义语言包或复用 i18n 管道来管理业务文案。