@skyfox2000/webui 1.4.27 → 1.5.0

package/src/locales/default.ts

@@ -0,0 +1,204 @@
+export const defaultLocale = {
+   "webui": {
+      // 通用
+      "common": {
+         "confirm": "确定",
+         "cancel": "取消",
+         "yes": "是",
+         "no": "否",
+         "close": "关闭",
+         "save": "保存",
+         "saveAs": "另存为",
+         "delete": "删除",
+         "edit": "编辑",
+         "add": "新增",
+         "upload": "上传",
+         "download": "下载",
+         "preview": "预览",
+         "choose": "选择",
+         "placeholder": "请输入{0}"
+      },
+      
+      // 布局相关
+      "layout": {
+         "header": {
+            "exitPlatform": "退出平台",
+            "exitSystem": "退出系统",
+            "confirmExit": "确定退出？",
+            "exitConfirmMessage": "是否退出平台，<br />清除用户缓存信息？"
+         },
+         "menu": {
+            // "close" 使用 common 中的定义
+         }
+      },
+      
+      // 工具面板相关
+      "toolpanel": {
+         "tool": "工具",
+         "searchResult": "搜索结果",
+         "list": "列表",
+         "listView": "列表视图",
+         "grid": "网格",
+         "gridView": "网格视图",
+         "expand": "展开",
+         "collapse": "收起",
+         "expandPanel": "展开面板",
+         "collapsePanel": "收起面板",
+         "searchPlaceholder": "搜索工具..."
+      },
+      
+      // 工具栏相关
+      "toolbar": {
+         // "add" 使用 common 中的定义
+      },
+      
+      // 列表操作相关
+      "listOperate": {
+         "confirmDelete": "是否删除此记录？"
+         // "yes" 和 "no" 使用 common 中的定义
+      },
+      
+      // 对话框相关
+      "dialog": {
+         "fileUpload": "文件上传",
+         "templateFileManager": "模板文件管理",
+         "batchImportUser": "批量导入用户",
+         // "close", "cancel", "saveAs", "save" 使用 common 中的定义
+         "uploadFile": "上传文件"
+      },
+      
+      // 表格操作相关
+      "tableOperate": {
+         "confirmDelete": "是否删除此记录？"
+         // "edit", "delete", "yes" 和 "no" 使用 common 中的定义
+      },
+      
+      // 抽屉相关
+      "drawer": {
+         // "cancel", "saveAs", "save" 使用 common 中的定义
+      },
+      
+      // 上传组件相关
+      "upload": {
+         "unsupportedFileType": "文件类型不支持",
+         "fileSizeExceedsLimit": "文件大小超过 {0}MB 限制",
+         "maxFilesReached": "最多上传 {0} 个文件",
+         "deleteSuccess": "删除文件成功！",
+         "onlineOffline": "上线或下线",
+         "online": "上线",
+         "offline": "下线",
+         "uploading": "上传中",
+         "uploadComplete": "上传完成",
+         "uploadFailed": "上传失败",
+         "onlineStatus": "在线",
+         "offlineStatus": "已下线",
+         "pendingUpload": "待上传",
+         "chooseFile": "选择文件",
+         "chooseDirectory": "选择目录",
+         "download": "下载",
+         "preview": "预览",
+         "confirmDeleteFile": "确定删除该文件吗？",
+         "delete": "删除",
+         "fileMustBe": "文件必须为 {0}",
+         "singleFileMax": "单文件最大 {0}MB",
+         "maxFiles": "最多 {0} 个文件"
+      },
+      
+      // 图片上传相关
+      "imageUpload": {
+         "loadImageFailed": "加载图片失败:"
+      },
+      
+      // 时间选择器相关
+      "timePicker": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 选择器相关
+      "select": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 开关组件相关
+      "switch": {
+         "error": "Switch组件必须有且只有两个选项"
+      },
+      
+      // 文本域相关
+      "textarea": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 代码编辑器相关
+      "aceEditor": {
+         "title": "代码编辑器"
+      },
+      
+      // 穿梭框相关
+      "transfer": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 级联选择器相关
+      "cascader": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 日期选择器相关
+      "datePicker": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 属性编辑器相关
+      "propEditor": {
+         "configName": "配置名",
+         "configValue": "请输入配置值",
+         "inputConfigValue": "请输入{0}"
+      },
+      
+      // 输入框相关
+      "input": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 自动完成相关
+      "autoComplete": {
+         "placeholder": "{0}并选择" // 使用 common.placeholder 并添加特定文本
+      },
+      
+      // 单选框相关
+      "radio": {
+         "noData": "无数据",
+         "all": "全部"
+      },
+      
+      // 树选择器相关
+      "treeSelect": {
+         // "placeholder" 使用 common 中的定义
+      },
+      
+      // 错误页面相关
+      "error": {
+         "pageNotFound": "页面不存在或者没有权限访问页面！",
+         "forbidden": "您没有权限访问当前页面！"
+      },
+      
+      // Excel导入相关
+      "excelForm": {
+         "chooseExcelFile": "请选择Excel文件",
+         "chooseCsvFile": "请选择CSV文件",
+         "chooseExcelOrCsvFile": "请选择Excel或CSV文件",
+         "validateDataRules": "待验证数据规则",
+         "validateDuplicateData": "待验证重复数据",
+         "uploadAddressNotConfigured": "未配置文件上传地址！",
+         "fileProcessingFailed": "文件处理失败，请检查文件格式！",
+         "dataSaveFailed": "数据保存失败，请稍后再试！",
+         "validationError": "验证异常",
+         "onlyExcelAllowed": "只能上传Excel文件!",
+         "onlyCsvAllowed": "只能上传CSV文件!",
+         "onlyExcelOrCsvAllowed": "只能上传Excel文件或CSV文件!",
+         "csvProcessingFailed": "CSV文件处理失败",
+         "followingMustBeUnique": "以下{0}必须唯一"
+      }
+   }
+}

package/src/locales/index.ts

@@ -0,0 +1,290 @@
+import { createI18n } from "vue-i18n";
+import { defaultLocale } from "./default";
+
+// 定义语言包类型
+export interface LocaleMessages {
+   [key: string]: any;
+}
+
+/**
+ * 深度合并两个对象
+ * @param target 目标对象
+ * @param source 源对象
+ * @returns 合并后的对象
+ */
+function deepMerge(target: any, source: any): any {
+   const result = { ...target };
+   
+   for (const key in source) {
+      if (source.hasOwnProperty(key)) {
+         if (typeof source[key] === 'object' && source[key] !== null && !Array.isArray(source[key])) {
+            // 如果源值是对象且不是数组，则递归合并
+            result[key] = deepMerge(result[key] || {}, source[key]);
+         } else {
+            // 否则直接赋值
+            result[key] = source[key];
+         }
+      }
+   }
+   
+   return result;
+}
+
+// 语言显示名称映射（从 public/locales/languages.json 加载）
+export let LOCALE_DISPLAY_NAMES: Record<string, string> = {};
+
+// 支持的语言包映射
+const loadedMessages: Record<string, LocaleMessages> = {
+   "zh-CN": deepMerge({}, defaultLocale)
+};
+
+// 创建i18n实例
+export const i18n = createI18n({
+   legacy: false, // 使用Composition API模式
+   locale: "zh-CN", // 默认语言
+   fallbackLocale: "en-US", // 回退语言
+   messages: loadedMessages,
+   silentTranslationWarn: true, // 禁用翻译警告
+   fallbackWarn: false, // 禁用回退警告
+   missingWarn: false, // 禁用缺失警告
+});
+
+/**
+ * 从云端加载可用语言列表
+ */
+async function loadAvailableLanguages(): Promise<void> {
+   try {
+      const response = await fetch('/locales/languages.json');
+      if (!response.ok) {
+         throw new Error('Failed to load available languages');
+      }
+      const languages = await response.json();
+      LOCALE_DISPLAY_NAMES = languages;
+   } catch (error) {
+      console.error('Error loading available languages:', error);
+      throw error; // 抛出错误，让调用方处理
+   }
+}
+
+/**
+ * 从云端加载语言包
+ */
+async function loadLocaleFromCloud(locale: string): Promise<LocaleMessages> {
+   try {
+      const response = await fetch(`/locales/${locale}.json`);
+      if (!response.ok) {
+         throw new Error(`Failed to load locale ${locale}`);
+      }
+      const cloudMessages = await response.json();
+      
+      // 使用深度合并更新语言包
+      if (loadedMessages[locale]) {
+         return deepMerge(loadedMessages[locale], cloudMessages);
+      }
+      return cloudMessages;
+   } catch (error) {
+      console.error(`Error loading locale ${locale}:`, error);
+      // 如果加载失败，返回现有语言包或空对象
+      return loadedMessages[locale] || {};
+   }
+}
+
+/**
+ * 从localStorage获取缓存的语言包
+ */
+function getCachedLocale(locale: string): LocaleMessages | null {
+   try {
+      const cached = localStorage.getItem(`locale_cache_${locale}`);
+      if (cached) {
+         const data = JSON.parse(cached);
+         return data.messages;
+      }
+   } catch (error) {
+      console.error(`Error reading cached locale ${locale}:`, error);
+   }
+   return null;
+}
+
+/**
+ * 缓存语言包到localStorage
+ */
+function cacheLocale(locale: string, messages: LocaleMessages): void {
+   try {
+      const data = {
+         messages,
+         timestamp: Date.now()
+      };
+      localStorage.setItem(`locale_cache_${locale}`, JSON.stringify(data));
+   } catch (error) {
+      console.error(`Error caching locale ${locale}:`, error);
+   }
+}
+
+/**
+ * 获取所有可用语言代码
+ */
+export function getAvailableLocales(): string[] {
+   return Object.keys(LOCALE_DISPLAY_NAMES);
+}
+
+/**
+ * 添加新的语言（预留扩展接口）
+ */
+export function addLocaleOption(locale: string, displayName: string): void {
+   LOCALE_DISPLAY_NAMES[locale] = displayName;
+}
+
+/**
+ * 为插件提供的接口：修改指定语言的内容
+ * @param locale 语言代码
+ * @param key 翻译键
+ * @param value 翻译值
+ */
+export function setTranslation(
+   locale: string,
+   key: string,
+   value: string
+): void {
+   if (!loadedMessages[locale]) {
+      loadedMessages[locale] = {};
+   }
+   
+   // 将键转换为嵌套对象结构
+   const keyParts = key.split('.');
+   const nestedObj: any = {};
+   let current = nestedObj;
+   
+   for (let i = 0; i < keyParts.length - 1; i++) {
+      current[keyParts[i]] = {};
+      current = current[keyParts[i]];
+   }
+   current[keyParts[keyParts.length - 1]] = value;
+   
+   // 使用深度合并更新语言包
+   loadedMessages[locale] = deepMerge(loadedMessages[locale], nestedObj);
+   i18n.global.setLocaleMessage(locale, loadedMessages[locale]);
+}
+
+/**
+ * 为插件提供的接口：批量修改指定语言的内容
+ * @param locale 语言代码
+ * @param translations 翻译对象
+ */
+export function setTranslations(
+   locale: string,
+   translations: Record<string, any>
+): void {
+   if (!loadedMessages[locale]) {
+      loadedMessages[locale] = {};
+   }
+   // 使用深度合并而不是简单的 Object.assign
+   loadedMessages[locale] = deepMerge(loadedMessages[locale], translations);
+   i18n.global.setLocaleMessage(locale, loadedMessages[locale]);
+}
+
+/**
+ * 为插件提供的接口：获取当前i18n实例的messages
+ * @param locale 语言代码（可选，不传则获取所有语言）
+ */
+export function getI18nMessages(
+   locale?: string
+): Record<string, LocaleMessages> | LocaleMessages {
+   if (locale) {
+      return loadedMessages[locale] || {};
+   }
+   return loadedMessages;
+}
+
+/**
+ * 加载语言包 - 使用缓存优先策略
+ */
+async function loadLocale(locale: string): Promise<void> {
+   // 优先使用缓存
+   const cachedMessages = getCachedLocale(locale);
+   if (cachedMessages) {
+      loadedMessages[locale] = cachedMessages;
+      i18n.global.setLocaleMessage(locale, cachedMessages);
+   }
+
+   // 异步后台更新：无论是否有缓存，都后台检查更新
+   setTimeout(async () => {
+      try {
+         // 后台异步加载最新语言包并直接更新缓存和内存
+         const freshMessages = await loadLocaleFromCloud(locale);
+         loadedMessages[locale] = freshMessages;
+         i18n.global.setLocaleMessage(locale, freshMessages);
+         cacheLocale(locale, freshMessages);
+      } catch (error) {
+         console.error("[Locale] Background update failed:", error);
+      }
+   }, 0); // 立即执行，不阻塞界面
+}
+
+/**
+ * 初始化语言 - 使用缓存优先+异步后台加载策略
+ */
+export async function initLang(): Promise<void> {
+   try {
+      // 先加载可用语言列表
+      await loadAvailableLanguages();
+   } catch (error) {
+      console.error('Failed to load available languages:', error);
+      // 如果加载语言列表失败，抛出错误让调用方处理
+      throw error;
+   }
+   
+   const savedLocale = localStorage.getItem("language") || "zh-CN";
+
+   // 设置当前语言
+   i18n.global.locale.value = savedLocale;
+   localStorage.setItem("language", savedLocale);
+
+   // 统一调用loadLocale处理缓存，不加载，由后面代码
+   await loadLocale(savedLocale);
+}
+
+/**
+ * 设置语言
+ */
+export async function setLang(locale: string): Promise<void> {
+   // 加载语言包
+   await loadLocale(locale);
+
+   // 设置当前语言
+   i18n.global.locale.value = locale;
+   localStorage.setItem("language", locale);
+}
+
+/**
+ * 获取当前语言
+ */
+export function getLang(type: "code" | "display" = "code"): string {
+   const locale = i18n.global.locale.value;
+   return type === "display" ? LOCALE_DISPLAY_NAMES[locale] : locale;
+}
+
+/**
+ * 获取可用语言列表（用于下拉选择）
+ */
+export function getAvailableLanguages(): Array<{ label: string; key: string }> {
+   return Object.keys(LOCALE_DISPLAY_NAMES).map((locale) => ({
+      label: LOCALE_DISPLAY_NAMES[locale],
+      key: locale,
+   }));
+}
+
+// 翻译函数 - 优化回退逻辑
+export function $t(key: string, params?: Record<string, any>): string {
+   try {
+      // @ts-ignore
+      const result = i18n.global.t(key, params);
+      // 如果返回的是翻译键本身，说明没有找到翻译，返回空字符串让fallback生效
+      return result;
+   } catch (error) {
+      // 如果翻译出错，返回空字符串让fallback生效
+      return key;
+   }
+}
+
+// 默认导出 i18n 实例
+export default i18n;