@94ai-plus/common-locale

Common UI Plus 的 Vue 3 国际化运行时，提供中文、英文、日语、西语、印尼语、泰语、他加禄语、葡萄牙语语言包、响应式语言切换、语言注册和可选的 vue-i18n 适配器。

HomePage

官网 · 项目仓库 · 全局配置

Installation

yarn add @94ai-plus/common-locale vue

Usage

在应用创建时注入上下文；使用 CommonUI 时，也可通过 createCommonUI({ locale }) 完成注入。

import { createApp } from 'vue'
import { createLocale, installLocale, zhCn } from '@94ai-plus/common-locale'
import App from './App.vue'

const app = createApp(App)
const locale = createLocale(zhCn)
installLocale(app, locale)
app.mount('#app')

组件内使用：

<script setup lang="ts">
import { useLocale } from '@94ai-plus/common-locale'
const { t, setLocale } = useLocale()
</script>

<template>
  <button @click="setLocale('en-US')">{{ t('common.confirm') }}</button>
</template>

• createLocale() 默认中文，内置 zh-CN、en-US、ja、es、id、th、tl、pt；通过 registerLanguage({ name, messages }) 注册其他语言。
• 总入口具名导出 zhCn、enUs、ja、es、id、th、tl、pt。语言包也可从 @94ai-plus/common-locale/zh-cn、/en-us、/ja、/es、/id、/th、/tl、/pt 默认导入，独立子路径可按需打包。
• useLocale() 读取当前应用注入的上下文；顶层导出的 t() 使用独立的默认上下文，不随某个应用的配置自动切换。
• createVueI18nAdapter(composer) 可配合已有 vue-i18n composer，再由 installLocale 注入，无需强制安装 vue-i18n。
• 本包不依赖 Element Plus，也不翻译任意按钮插槽内容。CommonUI 会为内置语言选择对应的 Element Plus 语言包，显式 elementPlusLocale 优先；他加禄语使用本仓库适配包。

Contributors

感谢每一位参与项目建设的贡献者！

以上为随本版本发布的贡献者统计快照，统计日期与分支见图中说明；仅统计 Git 非合并提交，头像使用姓名首字母，不是 GitLab 个人照片。

License

本项目采用 MIT License 开源许可。

Copyright (c) 2026-present Jiahe Zou, 94 Intelligent Technology Co., Ltd.