@zfqh/uniapp 0.3.16 → 0.3.17

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.3.17](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.3.16...@zfqh/uniapp@0.3.17) (2026-09-03)
+
+**Note:** Version bump only for package @zfqh/uniapp
+
+
+
+
+
 ## [0.3.16](http://10.10.10.16/caoben/front-end/compare/@zfqh/uniapp@0.3.15...@zfqh/uniapp@0.3.16) (2026-09-03)
 
 **Note:** Version bump only for package @zfqh/uniapp

package/docs/api/utils/consts.md

@@ -192,10 +192,37 @@ if (config.mp.envVersion === MP_ENV_VERSION.develop) {
 
 ## LANGUAGE 使用示例
 
-当前语言标识，用于请求 header 和国际化。
+当前语言标识，用于请求 header 和国际化。key 为 uni-app/vue-i18n 的 locale 标识，value 为请求头 `X-Language` 的语言代码。
 
 ```ts
 import { LANGUAGE } from '@zfqh/uniapp';
 
-headers['X-Language'] = LANGUAGE;
+// locale 取 uni.getLocale() / uni.$i18n.global.locale 或宿主传入的 query.locale
+headers['X-Language'] = LANGUAGE[locale];
 ```
+
+### 支持的语言
+
+| 分组 | locale key | 语言 | X-Language 值 |
+| --- | --- | --- | --- |
+| 亚洲语言 | `zh-Hans` | 简体中文 | `zh-CN` |
+| 亚洲语言 | `zh-Hant` | 繁体中文 | `zh-TW` |
+| 亚洲语言 | `ja` | 日语 | `ja-JP` |
+| 亚洲语言 | `ko` | 韩语 | `ko-KR` |
+| 亚洲语言 | `ar` | 阿拉伯语 | `ar-SA` |
+| 亚洲语言 | `fa` | 伊朗语（波斯语） | `fa-IR` |
+| 亚洲语言 | `th` | 泰语 | `th-TH` |
+| 亚洲语言 | `vi` | 越南语 | `vi-VN` |
+| 亚洲语言 | `my` | 缅甸语 | `my-MM` |
+| 亚洲语言 | `km` | 柬埔寨语 | `km-KH` |
+| 欧洲语言 | `en` | 英语 | `en-US` |
+| 欧洲语言 | `fr` | 法语 | `fr-FR` |
+| 欧洲语言 | `es` | 西班牙语 | `es-ES` |
+| 欧洲语言 | `ru` | 俄语 | `ru-RU` |
+| 欧洲语言 | `pt` | 葡萄牙语 | `pt-PT` |
+| 欧洲语言 | `de` | 德语 | `de-DE` |
+| 欧洲语言 | `it` | 意大利语 | `it-IT` |
+| 欧洲语言 | `el` | 希腊语 | `el-GR` |
+| 欧洲语言 | `pl` | 波兰语 | `pl-PL` |
+
+> **提示**：`LANGUAGE[uni.getLocale()]` 仅在对应 locale 已注册到业务侧 vue-i18n `messages` 时才能命中；未注册时 `uni.getLocale()` 会回退到 `fallbackLocale`（`zh-Hans`）。宿主可通过 `query.locale`（如 `?locale=ar`）直接指定语言。

package/lib/apis/request.js

@@ -36,7 +36,7 @@ http.interceptors.request.use((conf) => {
         }
         // #endif
         const header = {
-            'X-Language': LANGUAGE[query.locale || uni.getLocale()],
+            'X-Language': query.xLanguage || LANGUAGE[query.locale || uni.getLocale()],
             'Tenant-Id': tenantId || 1,
             channel,
             terminal,

package/lib/mixins/webview.js

@@ -1,6 +1,6 @@
 import Url from 'url-parse';
 import { stringify, parse } from 'qs';
-import { PLATFORM_CODE, IS_WEBVIEW_ENV, SYSTEM_INFO, TYPES } from '../utils/consts';
+import { PLATFORM_CODE, IS_WEBVIEW_ENV, SYSTEM_INFO, TYPES, LANGUAGE } from '../utils/consts';
 import app from '../configs/app';
 import { requestPermission, openAuthorizeSetting } from '../utils/permit';
 import web from '../configs/web';
@@ -39,6 +39,7 @@ export default {
                 safeTop: SYSTEM_INFO.safeAreaInsets.top,
                 safeBottom: SYSTEM_INFO.safeAreaInsets.bottom,
                 locale: uni.$i18n?.global?.locale,
+                xLanguage: LANGUAGE[uni.$i18n?.global?.locale],
                 accelerate: cdn.isAccelerate ? 1 : undefined,
             };
             if (query.primary) {

package/lib/utils/consts.d.ts

@@ -30,9 +30,22 @@ export declare const LANGUAGE: {
     'zh-Hans': string;
     'zh-Hant': string;
     ja: string;
+    ko: string;
+    ar: string;
+    fa: string;
+    th: string;
+    vi: string;
+    my: string;
+    km: string;
     en: string;
     fr: string;
     es: string;
+    ru: string;
+    pt: string;
+    de: string;
+    it: string;
+    el: string;
+    pl: string;
 };
 export declare const TYPES: {
     readonly MESSAGE: {

package/lib/utils/consts.js

@@ -60,12 +60,27 @@ export var CHANNEL;
     CHANNEL[CHANNEL["\u95E8\u5E97\u7AEF"] = 3] = "\u95E8\u5E97\u7AEF";
 })(CHANNEL || (CHANNEL = {}));
 export const LANGUAGE = {
-    'zh-Hans': 'zh-CN',
-    'zh-Hant': 'zh-TW',
-    ja: 'ja-JP',
-    en: 'en-US',
-    fr: 'fr-FR',
-    es: 'es-ES',
+    // 亚洲语言
+    'zh-Hans': 'zh-CN', // 简体中文
+    'zh-Hant': 'zh-TW', // 繁体中文
+    ja: 'ja-JP', // 日语
+    ko: 'ko-KR', // 韩语
+    ar: 'ar-SA', // 阿拉伯语
+    fa: 'fa-IR', // 伊朗语（波斯语）
+    th: 'th-TH', // 泰语
+    vi: 'vi-VN', // 越南语
+    my: 'my-MM', // 缅甸语
+    km: 'km-KH', // 柬埔寨语
+    // 欧洲语言
+    en: 'en-US', // 英语
+    fr: 'fr-FR', // 法语
+    es: 'es-ES', // 西班牙语
+    ru: 'ru-RU', // 俄语
+    pt: 'pt-PT', // 葡萄牙语
+    de: 'de-DE', // 德语
+    it: 'it-IT', // 意大利语
+    el: 'el-GR', // 希腊语
+    pl: 'pl-PL', // 波兰语
 };
 // webview 与宿主环境通信的消息类型
 export const TYPES = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zfqh/uniapp",
-  "version": "0.3.16",
+  "version": "0.3.17",
   "description": "uniapp公共模块",
   "author": "yinjiazeng@163.com",
   "license": "MIT",
@@ -46,5 +46,5 @@
     "@types/qs": "^6.9.16",
     "@types/url-parse": "^1.4.11"
   },
-  "gitHead": "482fb66642df55a676ac10fb902cba10da3720d2"
+  "gitHead": "d56ac10822cd04b832695122cc7daa21e67d6628"
 }