zmdms-utils 0.0.72 → 0.0.74

package/src/locales/use-translation.ts

@@ -0,0 +1,76 @@
+import { useTranslation, Trans } from "react-i18next";
+import type { TOpionsEx } from "./t-options";
+import { getTFuncArgs } from "./t-options";
+
+type Prams = Parameters<typeof useTranslation>;
+type NS = Prams[0];
+type Options = Prams[1];
+
+type EnhanceTFunc = (
+  key: string,
+  defaultValueOrOptions: string | TOpionsEx
+) => string;
+
+/**
+ * 这里只是简单代理一下useTranslation，方便后续扩展或添加其他逻辑
+ * @param ns 命名空间 大多数情况下都不需要传入这个参数，除非你用到了命名空间。
+ * @param options 其他参数 大多数情况下，都不需要关注这个参数。
+ * options.keyPrefix 为所有翻译键添加前缀
+ *  // JSON 文件：{ "greeting": { "welcome": "Welcome" } }
+ *  const { t } = useTranslation('common', { keyPrefix: 'greeting' });
+ *  // 使用时省略前缀
+ *  t('welcome'); // 等价于 t('greeting:welcome')
+ * @returns { t, i18n, ready }
+ * t: 翻译方法
+ * i18n: i18next实例 访问 i18next 的完整 API（如切换语言、加载命名空间）
+ * i18n.changeLanguage('zh-CN'); 使用它切换语言，可以触发组件渲染。但是当前项目中是使用全局刷新的模式，来更新语言的。
+ * ready: 是否加载完成
+ */
+function useZtTranslation(ns?: NS, options?: Options) {
+  const { t: _tOld, i18n, ready } = useTranslation(ns, options);
+
+  // 扩展t方法，用于处理嵌套的翻译键
+  const tEnhance: EnhanceTFunc = (key, defaultValueOrOptions) => {
+    const { defaultValue, options } = getTFuncArgs(defaultValueOrOptions);
+
+    if (!key) {
+      // 情况1：键名为空，返回默认值或键名
+      console.error(
+        `tEnhance: 请不要传入空 key 值进行 t 函数执行，这将会导致直接返回空字符串！`
+      );
+      return defaultValue || key;
+    }
+    if (!i18n.exists(key)) {
+      // 情况2：键名不存在，返回默认值或键名
+      console.error(
+        `tEnhance: i18n-key '${key}' 不存在，请检查对应的 @/locales/resources/locales/xx.json 中是否存在对应值`
+      );
+      return defaultValue || key;
+    }
+    try {
+      return _tOld(key, options);
+    } catch (error) {
+      console.warn(`tEnhance: t 函数执行异常，请检查! key=${key}, err=`, error);
+      return defaultValue || key || "unknown";
+    }
+  };
+
+  return {
+    /**
+     * t函数的使用方式：基本上使用1、2两种方式就可以了。
+     * 1、t('key') // 基础用法
+     * 2、t('greeting', { name: 'John' }); // 对应 JSON: "greeting": "Hello {{name}}"
+     * 3、t('auth:login'); // 显式指定命名空间
+     *
+     * 关于t函数的第二个参数的说明。
+     * 为了防止一些异常情况，翻译失败。可以传入一个默认值。这个默认值就是原本的中文就行。
+     * 1、t('key', '默认值');
+     * 2、t('key', { defaultValue: '默认值', ...otherOptions });
+     */
+    t: tEnhance,
+    i18n,
+    ready,
+  };
+}
+
+export { useZtTranslation as useTranslation, Trans };

package/src/locales//345/244/232/350/257/255/350/250/200.md

@@ -0,0 +1 @@
+# React 项目多语言

package/src/microAppCreator.ts

@@ -16,11 +16,32 @@ export function update(props: any) {
  * @param microAppOptions 微应用的一些配置
  */
 export interface IMicroAppOptions {
+  /**
+   * @deprecated 该属性已废弃，无意义
+   */
   microAppContainerId: string; // 微应用加载的dom容器 id
   microAppKey: string; // 微应用的唯一key值 用途：1. qiankun下的路由前缀；2. 主、子通信时的标识
+  /**
+   * @deprecated 该属性已废弃，无意义
+   */
   microAppRoot: any; // 微应用根节点实例
-  microAppMountHandle?: (props: any) => void; // 微应用每次进入都会调用的方法
-  microAppUnMountHandle?: (props: any) => void; // 微应用每次切出/卸载 都会调用的方法
+  /**
+   * 只会在微应用初始化的时候调用一次，下次微应用重新进入时会直接调用 mount 钩子，不会再重复触发 bootstrap
+   * 通常我们可以在这里做一些全局变量的初始化，比如不会在 unmount 阶段被销毁的应用级别的缓存等。
+   **/
+  microAppBootstrapHandle?: () => void;
+  /**
+   * 应用每次进入都会调用 mount 方法，通常我们在这里触发应用的渲染方法
+   */
+  microAppMountHandle: (props: any) => void;
+  /**
+   * 应用每次 切出/卸载 会调用的方法，通常在这里我们会卸载微应用的应用实例
+   */
+  microAppUnMountHandle: (props: any) => void;
+  /**
+   * 可选生命周期钩子，仅使用 loadMicroApp 方式加载微应用时生效
+   */
+  microAppUpdateHandle?: (props: any) => void;
 }
 export function initMicroApp(render: any, microAppOptions: IMicroAppOptions) {
   // 初始加载应用
@@ -32,9 +53,10 @@ export function initMicroApp(render: any, microAppOptions: IMicroAppOptions) {
   // 2. 进入微前端环境的运行逻辑
   const {
     microAppKey,
-    microAppRoot,
+    microAppBootstrapHandle,
     microAppMountHandle,
     microAppUnMountHandle,
+    microAppUpdateHandle,
   } = microAppOptions;
 
   // 唯一key没传 给出开发提示
@@ -47,15 +69,20 @@ export function initMicroApp(render: any, microAppOptions: IMicroAppOptions) {
    * 通常我们可以在这里做一些全局变量的初始化，比如不会在 unmount 阶段被销毁的应用级别的缓存等。
    */
   async function bootstrap() {
-    console.log("微应用 bootstraped");
+    console.log(`微应用==${microAppKey}==bootstraped`);
+    if (microAppBootstrapHandle) {
+      microAppBootstrapHandle();
+    }
   }
 
   /**
    * 应用每次进入都会调用 mount 方法，通常我们在这里触发应用的渲染方法
    */
   async function mount(props: any) {
-    console.log("微应用 mount");
-    microAppMountHandle && microAppMountHandle(props);
+    console.log(`微应用==${microAppKey}==mount`);
+    if (microAppMountHandle) {
+      microAppMountHandle(props);
+    }
     render(props);
   }
 
@@ -63,13 +90,25 @@ export function initMicroApp(render: any, microAppOptions: IMicroAppOptions) {
    * 应用每次 切出/卸载 会调用的方法，通常在这里我们会卸载微应用的应用实例
    */
   async function unmount(props: any) {
-    console.log("微应用 unmount", props);
-    microAppUnMountHandle && microAppUnMountHandle(props);
+    console.log(`微应用==${microAppKey}==unmount`);
+    if (microAppUnMountHandle) {
+      microAppUnMountHandle(props);
+    }
+  }
+  /**
+   * 应用每次 切出/卸载 会调用的方法，通常在这里我们会卸载微应用的应用实例
+   */
+  async function update(props: any) {
+    console.log(`微应用==${microAppKey}==update`);
+    if (microAppUpdateHandle) {
+      microAppUpdateHandle(props);
+    }
   }
 
   return {
     bootstrap,
     mount,
     unmount,
+    update,
   };
 }

package/src/request.ts

@@ -10,7 +10,7 @@ import { Crypto } from "./crypto";
 import { TOKEN_KEY } from "./constants";
 
 const defaultOptions: IOtherOptions = {
-  TenantId: "000000",
+  // TenantId: "000000", // 租户ID不需要了
   Authorization: "Basic em1kbXM6em1kbXNfc2VjcmV0",
   timeout: 60000,
 };
@@ -66,8 +66,9 @@ export class AxiosRequest {
   // 设置axios方法默认值
   private defaultSetting() {
     // 设置默认请求头
-    this.instanceAxios.defaults.headers.common["Tenant-Id"] =
-      this.otherOptions.TenantId;
+    // 租户ID只有登录的时候才需要传递
+    // this.instanceAxios.defaults.headers.common["Tenant-Id"] =
+    //   this.otherOptions.TenantId;
     this.instanceAxios.defaults.headers.common["Authorization"] =
       this.otherOptions.Authorization;
 
@@ -406,7 +407,7 @@ export interface IOtherOptions {
     callback?: () => void
   ) => void;
   modalConfirm?: (msg: string, callback?: () => void) => void;
-  /** token相关值 */
+  /** @deprecated 租户ID，只有登录接口 需要 传递。 */
   TenantId?: string;
   /** auth值 */
   Authorization?: string;