@ibiz-template/vue3-components 0.7.40-alpha.9 → 0.7.41-alpha.0

package/es/panel-component/nav-pos-index/nav-pos-index.controller.mjs

@@ -1,4 +1,4 @@
-import { PanelItemController, Modal, ViewMode } from '@ibiz-template/runtime';
+import { PanelItemController, ViewMode, Modal } from '@ibiz-template/runtime';
 import { routerCallback } from '@ibiz-template/vue3-util';
 import { notNilEmpty } from 'qx-util';
 import { NavPosIndexState } from './nav-pos-index.state.mjs';
@@ -14,10 +14,10 @@ class NavPosIndexController extends PanelItemController {
   constructor() {
     super(...arguments);
     /**
-     * 导航视图的modal
-     * @author lxm
-     * @date 2023-05-12 09:47:52
+     * @exposedoc
+     * @description 导航视图的modal
      * @type {{ [key: string]: IModal }}
+     * @memberof NavPosIndexController
      */
     __publicField(this, "viewModals", {});
     /**
@@ -28,30 +28,28 @@ class NavPosIndexController extends PanelItemController {
      */
     __publicField(this, "router");
     /**
-     * 是否关闭后自动跳转上一个页面
-     * @author lxm
-     * @date 2023-05-25 08:43:49
+     * @exposedoc
+     * @description 是否关闭后自动跳转上一个页面
      * @type {boolean}
+     * @memberof NavPosIndexController
      */
     __publicField(this, "autoGoLast", true);
     /**
-     * 无缓存
-     * @author lxm
-     * @date 2024-04-22 04:12:41
-     * @readonly
+     * @exposedoc
+     * @description 禁止缓存
      * @type {boolean}
+     * @memberof NavPosIndexController
      */
     __publicField(this, "noCache", false);
     /**
-     * 自定义补充参数
-     *
-     * @author zk
-     * @date 2023-09-27 03:09:02
+     * @exposedoc
+     * @description 面板项参数
      * @type {IData}
-     * @memberof NavPosController
+     * @memberof NavPosIndexController
      */
     __publicField(this, "rawItemParams", {});
     /**
+     * @exposedoc
      * @description 当前导航key
      * @type {string}
      * @memberof NavPosIndexController
@@ -66,20 +64,20 @@ class NavPosIndexController extends PanelItemController {
     this.router = router;
   }
   /**
-   * 当前视图的路由层级，非路由模式不存在。
-   * @author lxm
-   * @date 2023-05-09 12:46:26
+   * @exposedoc
+   * @description 当前视图的路由层级，非路由模式不存在。
    * @readonly
+   * @type {(number | undefined)}
+   * @memberof NavPosIndexController
    */
   get routeDepth() {
     return this.panel.view.modal.routeDepth;
   }
   /**
-   * 导航标签页控制器
-   * @author lxm
-   * @date 2023-05-10 08:41:54
+   * @description 导航标签页控制器
    * @readonly
    * @type {(NavTabsController | undefined)}
+   * @memberof NavPosIndexController
    */
   get navTabs() {
     return this.panel.panelItems.nav_tabs;
@@ -109,10 +107,10 @@ class NavPosIndexController extends PanelItemController {
     this.noCache = this.rawItemParams.expcache === "NO_CACHE";
   }
   /**
-   * 改变显示视图
-   * @author lxm
-   * @date 2023-05-25 01:28:49
+   * @exposedoc
+   * @description 改变显示视图
    * @param {string} key
+   * @memberof NavPosIndexController
    */
   changeView(key) {
     var _a;
@@ -122,11 +120,16 @@ class NavPosIndexController extends PanelItemController {
     }
   }
   /**
-   * 路由变更,新视图进缓存并初始化，已有的就只切换。
-   * @author lxm
-   * @date 2023-05-25 03:07:07
-   * @param {{ currentKey: string; fullPath: string }} { currentKey }
-   * @return {*}
+   * @description 路由变更,新视图进缓存并初始化，已有的就只切换。
+   * @param {{
+   *     currentKey: string;
+   *     fullPath: string;
+   *   }} {
+   *     currentKey,
+   *     fullPath,
+   *   }
+   * @returns {*}  {void}
+   * @memberof NavPosIndexController
    */
   onRouteChange({
     currentKey,
@@ -182,21 +185,22 @@ class NavPosIndexController extends PanelItemController {
     }
   }
   /**
-   * 监听视图创建，获取并监听视图控制器
-   * @author lxm
-   * @date 2023-05-25 03:03:22
+   * @description 监听视图创建，获取并监听视图控制器
    * @param {EventBase} event
+   * @memberof NavPosIndexController
    */
   onViewCreated(event) {
     const { view } = event;
     const key = this.state.currentKey;
+    const viewKey = "".concat(view.model.codeName, "-").concat(view.id);
     if (this.navTabs) {
       this.navTabs.updateViewInfo(key, {
+        viewKey,
         caption: view.model.caption,
         sysImage: view.model.sysImage
       });
       view.evt.on("onViewInfoChange", ({ caption, dataInfo }) => {
-        this.navTabs.updateViewInfo(key, { caption, dataInfo });
+        this.navTabs.updateViewInfo(key, { viewKey, caption, dataInfo });
       });
     }
     if (this.navBreadcrumb) {
@@ -225,10 +229,10 @@ class NavPosIndexController extends PanelItemController {
     }
   }
   /**
-   * 删除单个缓存
-   * @author lxm
-   * @date 2023-05-09 02:19:09
+   * @exposedoc
+   * @description 删除单个缓存
    * @param {string} key
+   * @memberof NavPosIndexController
    */
   removeCache(key) {
     const index = this.state.cacheKeys.indexOf(key);
@@ -243,20 +247,20 @@ class NavPosIndexController extends PanelItemController {
     }
   }
   /**
-   * 清空缓存
-   * @author lxm
-   * @date 2023-05-09 02:19:55
+   * @exposedoc
+   * @description 清空缓存
+   * @memberof NavPosIndexController
    */
   clearCache() {
     this.state.cacheKeys = [this.currentKey];
     this.viewModals = {};
   }
   /**
-   * 关闭视图
-   * 走modal的dismiss,会走一遍视图内部的校验，不通过则不会关闭
-   * @author lxm
-   * @date 2023-05-25 03:10:23
-   * @param {string} keys
+   * @exposedoc
+   * @description 关闭视图
+   * @param {string[]} keys
+   * @returns {*}  {Promise<void>}
+   * @memberof NavPosIndexController
    */
   async closeViewByKeys(keys) {
     this.autoGoLast = false;
@@ -269,14 +273,11 @@ class NavPosIndexController extends PanelItemController {
     this.autoGoLast = true;
   }
   /**
-   * 自身的dismiss相关操作
-   *
-   * @author chitanda
-   * @date 2023-07-12 22:07:09
+   * @description 自身的dismiss相关操作
    * @protected
    * @param {string} key
    * @param {IModalData} modal
-   * @return {*}
+   * @memberof NavPosIndexController
    */
   dismiss(key, modal) {
     routerCallback.close(key, modal);
@@ -292,10 +293,11 @@ class NavPosIndexController extends PanelItemController {
     }
   }
   /**
-   * 返回上一个页面或上一层空白路由
-   * @author lxm
-   * @date 2023-05-25 06:46:27
+   * @exposedoc
+   * @description 返回上一个页面或上一层空白路由
    * @protected
+   * @returns {*}  {void}
+   * @memberof NavPosIndexController
    */
   goLast() {
     const lastKey = this.state.operateSort.pop();
@@ -318,12 +320,9 @@ class NavPosIndexController extends PanelItemController {
     }
   }
   /**
-   * 处理自定义补充参数 [{key:'name',value:'data'}] => {name:'data'}
-   *
-   * @author zk
-   * @date 2023-09-27 03:09:55
+   * @description 处理自定义补充参数 [{key:'name',value:'data'}] => {name:'data'}
    * @protected
-   * @memberof NavPosController
+   * @memberof NavPosIndexController
    */
   handleRawItemParams() {
     var _a;

package/es/panel-component/nav-pos-index/nav-pos-index.d.ts

@@ -3,11 +3,23 @@ import { IPanelRawItem } from '@ibiz/model-core';
 import { EventBase } from '@ibiz-template/runtime';
 import { NavPosIndexController } from './nav-pos-index.controller';
 import './nav-pos-index.scss';
+/**
+ * 首页导航占位
+ * @primary
+ * @description 首页中视图导航组件，使用keepAlive存储导航视图信息与缓存。
+ * @panelitemparams {name:expcache,parameterType:string,defaultvalue:-,description:当值为NO_CACHE时禁用缓存，即每次导航切换时都是重新绘制新的视图，否则使用keepAlive包裹绘制的导航视图}
+ */
 export declare const NavPosIndex: import("vue").DefineComponent<{
+    /**
+     * @description 导航占位模型数据
+     */
     modelData: {
         type: PropType<IPanelRawItem>;
         required: true;
     };
+    /**
+     * @description 导航占位控制器
+     */
     controller: {
         type: typeof NavPosIndexController;
         required: true;
@@ -17,10 +29,16 @@ export declare const NavPosIndex: import("vue").DefineComponent<{
     onViewCreated: (event: EventBase) => void;
     c: NavPosIndexController;
 }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * @description 导航占位模型数据
+     */
     modelData: {
         type: PropType<IPanelRawItem>;
         required: true;
     };
+    /**
+     * @description 导航占位控制器
+     */
     controller: {
         type: typeof NavPosIndexController;
         required: true;

package/es/panel-component/nav-pos-index/nav-pos-index.mjs

@@ -1,4 +1,4 @@
-import { defineComponent, createVNode, resolveComponent } from 'vue';
+import { resolveComponent, createVNode, defineComponent } from 'vue';
 import { useNamespace, onRouteChange } from '@ibiz-template/vue3-util';
 import { useRouter, useRoute } from 'vue-router';
 import { NavPosIndexController } from './nav-pos-index.controller.mjs';
@@ -8,10 +8,16 @@ import './nav-pos-index.css';
 const NavPosIndex = /* @__PURE__ */ defineComponent({
   name: "IBizNavPosIndex",
   props: {
+    /**
+     * @description 导航占位模型数据
+     */
     modelData: {
       type: Object,
       required: true
     },
+    /**
+     * @description 导航占位控制器
+     */
     controller: {
       type: NavPosIndexController,
       required: true

package/es/panel-component/nav-pos-index/nav-pos-index.state.d.ts

@@ -1,42 +1,39 @@
 import { INavViewMsg, PanelItemState } from '@ibiz-template/runtime';
 /**
- * 导航占位状态
- *
- * @author lxm
- * @date 2023-02-07 06:04:27
+ * @description 导航占位状态
  * @export
  * @class NavPosIndexState
  * @extends {PanelItemState}
  */
 export declare class NavPosIndexState extends PanelItemState {
     /**
-     * 当前导航视图标识
-     * @author lxm
-     * @date 2023-05-25 06:24:48
+     * @exposedoc
+     * @description 当前导航视图标识
      * @type {string}
+     * @memberof NavPosIndexState
      */
     currentKey: string;
     /**
-     * 缓存的视图标识
-     * @author lxm
-     * @date 2023-05-25 06:25:21
+     * @exposedoc
+     * @description 缓存的视图标识
      * @type {string[]}
+     * @memberof NavPosIndexState
      */
     cacheKeys: string[];
     /**
-     * 导航视图详细信息
-     * @author lxm
-     * @date 2023-05-25 07:07:05
-     * @type {INavViewMsg[]}
+     * @exposedoc
+     * @description 导航视图详细信息
+     * @type {{ [p: string]: INavViewMsg }}
+     * @memberof NavPosIndexState
      */
     navViewMsgs: {
         [p: string]: INavViewMsg;
     };
     /**
-     * 导航的视图的操作顺序
-     * @author lxm
-     * @date 2023-05-25 06:25:34
+     * @exposedoc
+     * @description 导航的视图的操作记录
      * @type {string[]}
+     * @memberof NavPosIndexState
      */
     operateSort: string[];
 }

package/es/panel-component/nav-pos-index/nav-pos-index.state.mjs

@@ -11,31 +11,31 @@ class NavPosIndexState extends PanelItemState {
   constructor() {
     super(...arguments);
     /**
-     * 当前导航视图标识
-     * @author lxm
-     * @date 2023-05-25 06:24:48
+     * @exposedoc
+     * @description 当前导航视图标识
      * @type {string}
+     * @memberof NavPosIndexState
      */
     __publicField(this, "currentKey", "");
     /**
-     * 缓存的视图标识
-     * @author lxm
-     * @date 2023-05-25 06:25:21
+     * @exposedoc
+     * @description 缓存的视图标识
      * @type {string[]}
+     * @memberof NavPosIndexState
      */
     __publicField(this, "cacheKeys", ["RouterShell"]);
     /**
-     * 导航视图详细信息
-     * @author lxm
-     * @date 2023-05-25 07:07:05
-     * @type {INavViewMsg[]}
+     * @exposedoc
+     * @description 导航视图详细信息
+     * @type {{ [p: string]: INavViewMsg }}
+     * @memberof NavPosIndexState
      */
     __publicField(this, "navViewMsgs", {});
     /**
-     * 导航的视图的操作顺序
-     * @author lxm
-     * @date 2023-05-25 06:25:34
+     * @exposedoc
+     * @description 导航的视图的操作记录
      * @type {string[]}
+     * @memberof NavPosIndexState
      */
     __publicField(this, "operateSort", []);
   }

package/es/panel-component/nav-tabs/nav-tabs.controller.d.ts

@@ -13,28 +13,33 @@ export declare class NavTabsController extends PanelItemController<IPanelRawItem
     state: NavTabsState;
     protected createState(): NavTabsState;
     /**
-     * 当前视图的路由层级，非路由模式不存在。
-     * @author lxm
-     * @date 2023-05-09 12:46:26
+     * @description 当前视图的路由层级，非路由模式不存在。
+     * @exposedoc
      * @readonly
      */
     get routeDepth(): number | undefined;
     /**
-     * 导航占位控制器
-     * @author lxm
-     * @date 2023-05-09 02:35:48
+     * @description 导航占位控制器
+     * @exposedoc
      * @readonly
      * @type {(NavPosIndexController | undefined)}
      */
     get navPos(): NavPosIndexController | undefined;
     /**
-     * 获取tabItem
-     * @author lxm
-     * @date 2023-05-09 02:04:11
+     * @description 获取tabItem
+     * @exposedoc
      * @param {string} key
      * @return {*}
      */
     findTabItem(key: string): TabMsg | undefined;
+    /**
+     * @description 通过视图标识获取tabItem
+     * @exposedoc
+     * @param {string} key
+     * @return {*}  {(TabMsg | undefined)}
+     * @memberof NavTabsController
+     */
+    findTabItemByViewKey(key: string): TabMsg | undefined;
     /**
      * 点击处理
      * @author lxm
@@ -44,28 +49,31 @@ export declare class NavTabsController extends PanelItemController<IPanelRawItem
     onTabClick(key: string): void;
     /**
      * 更新视图信息
-     * @author lxm
-     * @date 2023-05-09 01:40:34
+     *
      * @param {string} key
-     * @param {{ caption?: string; dataInfo?: string; sysImage?: ISysImage }} info
+     * @param {{
+     *       viewKey: string;
+     *       caption?: string;
+     *       dataInfo?: string;
+     *       sysImage?: ISysImage;
+     *     }} info
+     * @memberof NavTabsController
      */
     updateViewInfo(key: string, info: {
+        viewKey?: string;
         caption?: string;
         dataInfo?: string;
         sysImage?: ISysImage;
     }): void;
     /**
-     * 删除某个key对应的数据
-     * 仅处理组件自身维护的数据
-     * @author lxm
-     * @date 2023-05-25 03:18:20
+     * @description 删除某个key对应的数据，仅处理组件自身维护的数据
+     * @exposedoc
      * @param {string} key
      */
     removeCache(key: string): void;
     /**
-     * 删除分页
-     * @author lxm
-     * @date 2023-05-09 02:08:46
+     * @description 删除分页
+     * @exposedoc
      * @param {string} key
      */
     onTabRemove(key: string): void;
@@ -76,16 +84,17 @@ export declare class NavTabsController extends PanelItemController<IPanelRawItem
      */
     removeOther(): void;
     /**
-     * 删除所有的标签页
+     * @description 删除所有的标签页
+     * @exposedoc
      * @author lxm
      * @date 2023-05-09 02:50:01
      */
     removeAll(): void;
     /**
-     * 刷新项（解决主信息更新之后界面ui未刷新）
-     *
-     * @author tony001
-     * @date 2024-06-28 08:06:11
+     * @description 刷新项（解决主信息更新之后界面ui未刷新）
+     * @exposedoc
+     * @param {string} key
+     * @memberof NavTabsController
      */
     refreshItemUI(key: string): void;
 }

package/es/panel-component/nav-tabs/nav-tabs.controller.mjs

@@ -1,5 +1,5 @@
 import { PanelItemController } from '@ibiz-template/runtime';
-import { reject, isNil } from 'ramda';
+import { isNil, reject } from 'ramda';
 import { nextTick } from 'vue';
 import { NavTabsState } from './nav-tabs.state.mjs';
 
@@ -10,18 +10,16 @@ class NavTabsController extends PanelItemController {
     return new NavTabsState((_a = this.parent) == null ? void 0 : _a.state);
   }
   /**
-   * 当前视图的路由层级，非路由模式不存在。
-   * @author lxm
-   * @date 2023-05-09 12:46:26
+   * @description 当前视图的路由层级，非路由模式不存在。
+   * @exposedoc
    * @readonly
    */
   get routeDepth() {
     return this.panel.view.modal.routeDepth;
   }
   /**
-   * 导航占位控制器
-   * @author lxm
-   * @date 2023-05-09 02:35:48
+   * @description 导航占位控制器
+   * @exposedoc
    * @readonly
    * @type {(NavPosIndexController | undefined)}
    */
@@ -29,15 +27,24 @@ class NavTabsController extends PanelItemController {
     return this.panel.panelItems.nav_pos_index;
   }
   /**
-   * 获取tabItem
-   * @author lxm
-   * @date 2023-05-09 02:04:11
+   * @description 获取tabItem
+   * @exposedoc
    * @param {string} key
    * @return {*}
    */
   findTabItem(key) {
     return this.state.tabItems.find((item) => item.key === key);
   }
+  /**
+   * @description 通过视图标识获取tabItem
+   * @exposedoc
+   * @param {string} key
+   * @return {*}  {(TabMsg | undefined)}
+   * @memberof NavTabsController
+   */
+  findTabItemByViewKey(key) {
+    return this.state.tabItems.find((item) => item.viewKey === key);
+  }
   /**
    * 点击处理
    * @author lxm
@@ -50,13 +57,18 @@ class NavTabsController extends PanelItemController {
   }
   /**
    * 更新视图信息
-   * @author lxm
-   * @date 2023-05-09 01:40:34
+   *
    * @param {string} key
-   * @param {{ caption?: string; dataInfo?: string; sysImage?: ISysImage }} info
+   * @param {{
+   *       viewKey: string;
+   *       caption?: string;
+   *       dataInfo?: string;
+   *       sysImage?: ISysImage;
+   *     }} info
+   * @memberof NavTabsController
    */
   updateViewInfo(key, info) {
-    const findItem = this.findTabItem(key);
+    const findItem = info.viewKey ? this.findTabItemByViewKey(info.viewKey) : this.findTabItem(key);
     if (findItem) {
       Object.assign(findItem, reject(isNil, info));
       this.refreshItemUI(key);
@@ -66,10 +78,8 @@ class NavTabsController extends PanelItemController {
     }
   }
   /**
-   * 删除某个key对应的数据
-   * 仅处理组件自身维护的数据
-   * @author lxm
-   * @date 2023-05-25 03:18:20
+   * @description 删除某个key对应的数据，仅处理组件自身维护的数据
+   * @exposedoc
    * @param {string} key
    */
   removeCache(key) {
@@ -79,9 +89,8 @@ class NavTabsController extends PanelItemController {
     }
   }
   /**
-   * 删除分页
-   * @author lxm
-   * @date 2023-05-09 02:08:46
+   * @description 删除分页
+   * @exposedoc
    * @param {string} key
    */
   onTabRemove(key) {
@@ -107,7 +116,8 @@ class NavTabsController extends PanelItemController {
     }
   }
   /**
-   * 删除所有的标签页
+   * @description 删除所有的标签页
+   * @exposedoc
    * @author lxm
    * @date 2023-05-09 02:50:01
    */
@@ -119,10 +129,10 @@ class NavTabsController extends PanelItemController {
     }
   }
   /**
-   * 刷新项（解决主信息更新之后界面ui未刷新）
-   *
-   * @author tony001
-   * @date 2024-06-28 08:06:11
+   * @description 刷新项（解决主信息更新之后界面ui未刷新）
+   * @exposedoc
+   * @param {string} key
+   * @memberof NavTabsController
    */
   refreshItemUI(key) {
     const tempItem = {

package/es/panel-component/nav-tabs/nav-tabs.d.ts

@@ -7,11 +7,22 @@ export interface dropdownAction {
     text: string;
     value?: string;
 }
+/**
+ * 分页导航
+ * @primary
+ * @description 首页下的分页导航标签，使用el-tabs组件将所有打开的视图进行tab分页展示，点击可快速切换。
+ */
 export declare const NavTabs: import("vue").DefineComponent<{
+    /**
+     * @description 分页导航模型数据
+     */
     modelData: {
         type: PropType<IPanelRawItem>;
         required: true;
     };
+    /**
+     * @description 分页导航控制器
+     */
     controller: {
         type: typeof NavTabsController;
         required: true;
@@ -23,10 +34,16 @@ export declare const NavTabs: import("vue").DefineComponent<{
     onTabRemove: (key: string) => void;
     handleCommand: (command: dropdownAction) => void;
 }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * @description 分页导航模型数据
+     */
     modelData: {
         type: PropType<IPanelRawItem>;
         required: true;
     };
+    /**
+     * @description 分页导航控制器
+     */
     controller: {
         type: typeof NavTabsController;
         required: true;