@ibiz-template/runtime 0.1.11 → 0.1.12

package/src/controller/control/exp-bar/exp-bar.controller.ts

@@ -0,0 +1,425 @@
+import {
+  IControl,
+  IDEGrid,
+  IDER1N,
+  IExpBar,
+  IDEList,
+  IDEDataView,
+  INavigatable,
+} from '@ibiz/model-core';
+import { RuntimeError, RuntimeModelError } from '@ibiz-template/core';
+import {
+  IExpBarControlState,
+  IExpBarControlEvent,
+  IExpBarControlController,
+  IMDControlController,
+  IToolbarController,
+  LoadEvent,
+  EventBase,
+  INavViewMsg,
+  IViewLayoutPanelController,
+} from '../../../interface';
+import { calcDeCodeNameById } from '../../../model';
+import { calcNavParams } from '../../../utils';
+import { ControlController } from '../../common';
+import { ControllerEvent } from '../../utils';
+
+type XDataControlModel = IDEGrid | IDEList | IDEDataView;
+
+/**
+ * 导航部件控制器
+ *
+ * @author zk
+ * @date 2023-05-29 04:05:46
+ * @export
+ * @class ExpBarControlController
+ * @extends {ControlController<T, S, E>}
+ * @implements {IExpBarControlController<T, S, E>}
+ * @template T
+ * @template S
+ * @template E
+ */
+export class ExpBarControlController<
+    T extends IExpBar = IExpBar,
+    S extends IExpBarControlState = IExpBarControlState,
+    E extends IExpBarControlEvent = IExpBarControlEvent,
+  >
+  extends ControlController<T, S, E>
+  implements IExpBarControlController<T, S, E>
+{
+  protected get _evt(): ControllerEvent<IExpBarControlEvent> {
+    return this.evt;
+  }
+
+  /**
+   * 当前路由视图的层级
+   *
+   * @author zk
+   * @date 2023-07-11 10:07:20
+   * @readonly
+   * @type {(number | undefined)}
+   * @memberof ExpBarControlController
+   */
+  get routeDepth(): number | undefined {
+    return this.view.modal.routeDepth;
+  }
+
+  /**
+   * 多数据部件类型
+   *
+   * @author zk
+   * @date 2023-05-29 08:05:30
+   * @type {string}
+   * @memberof ExpBarControlController
+   */
+  xDataType!: string;
+
+  /**
+   * 导航栏key名称 默认srfkey 多导航视图类 由子类重写
+   *
+   * @author zk
+   * @date 2023-07-10 03:07:53
+   * @memberof ExpBarControlController
+   */
+  navKeyName = 'srfkey';
+
+  protected initState(): void {
+    super.initState();
+    this.state.query = '';
+  }
+
+  /**
+   * 加载
+   *
+   * @author zk
+   * @date 2023-05-29 05:05:17
+   * @return {*}  {Promise<IData[]>}
+   * @memberof ExpBarControlController
+   */
+  load(): Promise<IData[]> {
+    return this.xDataController.load({ isInitialLoad: true });
+  }
+
+  /**
+   * 多数据部件控制器
+   *
+   * @author zk
+   * @date 2023-05-29 03:05:07
+   * @readonly
+   * @type {IGridController}
+   * @memberof ExpBarControlController
+   */
+  get xDataController(): IMDControlController {
+    const controller = this.view.getController(this.model.xdataControlName!);
+    if (!controller) {
+      throw new RuntimeModelError(
+        this.model,
+        `无法获取多数据部件[${this.model.xdataControlName}]控制器`,
+      );
+    }
+    return controller as IMDControlController;
+  }
+
+  /**
+   * 工具栏
+   * @author lxm
+   * @date 2023-07-31 07:01:25
+   * @readonly
+   * @type {(IToolbarController | undefined)}
+   */
+  get toolbarController(): IToolbarController | undefined {
+    const controller = this.view.getController(
+      `${this.model.xdataControlName!.split('_')[0]}_toolbar`,
+    );
+    return controller as IToolbarController;
+  }
+
+  /**
+   * 多数据部件模型
+   *
+   * @author zk
+   * @date 2023-05-29 03:05:15
+   * @readonly
+   * @type {(IDEGrid | null)}
+   * @memberof ExpBarControlController
+   */
+  get XDataModel(): XDataControlModel | undefined {
+    const control: XDataControlModel | undefined = this.model.controls?.find(
+      (item: IControl) => {
+        return item.name === this.model.xdataControlName;
+      },
+    );
+    return control;
+  }
+
+  /**
+   * 创建完成
+   *
+   * @author zk
+   * @date 2023-05-29 10:05:22
+   * @protected
+   * @return {*}  {Promise<void>}
+   * @memberof ExpBarControlController
+   */
+  protected async onCreated(): Promise<void> {
+    await super.onCreated();
+    this.childNames.push(this.model.xdataControlName!);
+    const appDataEntity = await ibiz.hub.getAppDataEntity(
+      this.model.appDataEntityId!,
+      this.context.srfappid,
+    )!;
+    if (appDataEntity) {
+      const searchFields = appDataEntity.appDEFields?.filter(field => {
+        return field.enableQuickSearch;
+      });
+      const placeHolders: string[] = [];
+      searchFields?.forEach(searchField => {
+        if (searchField?.lnlanguageRes && searchField.lnlanguageRes.lanResTag) {
+          placeHolders.push(
+            ibiz.i18n.t(
+              searchField.lnlanguageRes.lanResTag,
+              searchField.logicName,
+            ),
+          );
+        } else if (searchField?.logicName) {
+          placeHolders.push(searchField.logicName);
+        }
+      });
+      if (placeHolders.length > 0) {
+        this.state.placeHolder = placeHolders.join('、');
+      }
+    }
+  }
+
+  /**
+   * 组件挂载
+   *
+   * @author zk
+   * @date 2023-05-29 09:05:55
+   * @protected
+   * @return {*}  {Promise<void>}
+   * @memberof ExpBarControlController
+   */
+  protected async onMounted(): Promise<void> {
+    super.onMounted();
+    if (this.xDataController) {
+      this.xDataController.evt.on('onActive', event => {
+        this.xDataActive(event);
+      });
+      this.xDataController.evt.on('onLoadSuccess', event => {
+        this.xDataLoadSuccess(event);
+      });
+      this.xDataController.evt.on('onBeforeLoad', () => {
+        const searchParams: IParams = {};
+        if (this.state.query) {
+          searchParams.query = this.state.query;
+        }
+        this.xDataController.state.searchParams = searchParams;
+      });
+    }
+
+    if (this.toolbarController) {
+      this.xDataController.evt.on('onSelectionChange', async event => {
+        // 更新工具栏状态
+        this.toolbarController!.calcButtonState(
+          event.data[0],
+          this.model.appDataEntityId,
+        );
+      });
+    }
+  }
+
+  /**
+   * 多数据部件加载成功 设置默认选中
+   *
+   * @author zk
+   * @date 2023-05-30 04:05:40
+   * @memberof ExpBarControlController
+   */
+  xDataLoadSuccess(event: LoadEvent): void {
+    if (event.isInitialLoad) {
+      // 只处理默认第一次加载
+      if (this.state.srfnav && this.routeDepth) {
+        // 路由srfnav回显
+        this.defaultNavBySrfnav();
+      } else {
+        // 默认选中第一条并导航
+        this.defaultNavByFirstItem();
+      }
+    }
+  }
+
+  /**
+   * 默认通过路由上的srfnav导航
+   * @author lxm
+   * @date 2023-08-10 04:04:08
+   * @protected
+   */
+  protected defaultNavBySrfnav(): void {
+    // 找到选中项，如果没有就模拟选中数据
+    const selectItem = this.xDataController?.state.items.find(
+      item => item[this.navKeyName] === this.state.srfnav,
+    );
+    if (selectItem) {
+      // 在多数据部件里面选项设置回显。
+      this.xDataController.setSelection([selectItem]);
+    }
+    // 此时不需要导航占位push路由，只要有个key触发绘制下级视图就行。
+    this._evt.emit('onNavViewChange', {
+      navViewMsg: { key: this.state.srfnav },
+      context: this.context,
+    });
+  }
+
+  /**
+   * 导航页面首次打开且没有回显时，
+   * 默认取第一条数据进行导航
+   * 对于不同的导航，第一条可导航的数据可能定义不同，可以重写改方法。
+   * @author lxm
+   * @date 2023-08-10 03:58:15
+   * @protected
+   */
+  protected defaultNavByFirstItem(): void {
+    const data = this.xDataController.state.items[0];
+    if (!data) {
+      return;
+    }
+    // 默认选中并激活第一项
+    this.xDataController.setActive(data);
+    this.xDataController.setSelection([data]);
+  }
+
+  /**
+   * 多数据激活
+   *
+   * @author zk
+   * @date 2023-05-29 03:05:36
+   * @param {IData} data
+   * @memberof ExpBarControlController
+   */
+  xDataActive(event: EventBase): void {
+    const { data, context, params } = event;
+    const navViewMsg = this.getNavViewMsg(data[0], context, params);
+    this._evt.emit('onNavViewChange', { navViewMsg });
+  }
+
+  /**
+   * 解析参数
+   *
+   * @author zk
+   * @date 2023-05-29 04:05:52
+   * @param {IDETabViewPanel} tabViewPanel
+   * @return {*}
+   * @memberof ExpBarControlController
+   */
+  prepareParams(
+    XDataModel: INavigatable & { appDataEntityId?: string },
+    data: IData,
+    context: IContext,
+    params: IParams,
+  ): { context: IContext; params: IParams } {
+    const {
+      navDER,
+      navFilter,
+      navigateContexts,
+      navigateParams,
+      appDataEntityId,
+    } = XDataModel;
+    const model = {
+      deName: appDataEntityId ? calcDeCodeNameById(appDataEntityId) : undefined,
+      navFilter,
+      pickupDEFName: (navDER as IDER1N)?.pickupDEFName,
+      navContexts: navigateContexts,
+      navParams: navigateParams,
+    };
+    const originParams = {
+      context,
+      params,
+      data,
+    };
+    const { resultContext, resultParams } = calcNavParams(model, originParams);
+    // 合并SrfNav
+    const tempContext = Object.assign(context.clone(), resultContext, {
+      currentSrfNav: data[this.navKeyName],
+    });
+    const tempParams = { ...resultParams };
+    return { context: tempContext, params: tempParams };
+  }
+
+  /**
+   * 计算导航视图
+   *
+   * @author zk
+   * @date 2023-05-30 03:05:19
+   * @return {*}  {Promise<IAppView>}
+   * @memberof ExpBarControlController
+   */
+  public calcViewModelId(): string | undefined {
+    if (
+      ['GRID', 'DATAVIEW', 'LIST'].includes(this.XDataModel?.controlType || '')
+    ) {
+      return (this.XDataModel as INavigatable).navAppViewId!;
+    }
+    throw new RuntimeError('多节点视图由子类实现');
+  }
+
+  /**
+   * 获取导航视图
+   *
+   * @author zk
+   * @date 2023-06-29 03:06:41
+   * @param {IDETabViewPanel} tabViewPanel
+   * @return {*}  {Promise<INavViewMsg>}
+   * @memberof TabExpPanelController
+   */
+  public getNavViewMsg(
+    data: IData,
+    context: IContext,
+    params: IParams,
+  ): INavViewMsg {
+    const viewModelId = this.calcViewModelId();
+    const result = this.prepareParams(this.XDataModel!, data, context, params);
+    return {
+      key: data[this.navKeyName],
+      context: result.context,
+      params: result.params,
+      viewId: viewModelId,
+    };
+  }
+
+  /**
+   * 是否显示部件头部
+   * @author lxm
+   * @date 2023-08-02 07:54:18
+   * @protected
+   * @return {*}  {boolean}
+   */
+  protected calcControlHeaderVisible(): boolean {
+    const hasToolbar = !!this.toolbarController;
+    if (!hasToolbar && this.layoutPanel) {
+      const controller = this.layoutPanel.panelItems.control_toolbar;
+      if (controller) {
+        controller.state.visible = false;
+      }
+    }
+    return (
+      hasToolbar ||
+      !!(this.model.showTitleBar && this.model.title) ||
+      !!this.model.enableSearch
+    );
+  }
+
+  setLayoutPanel(panel: IViewLayoutPanelController): void {
+    super.setLayoutPanel(panel);
+
+    panel.evt.on('onMounted', () => {
+      const showHeader = this.calcControlHeaderVisible();
+      if (!showHeader) {
+        const controller = this.layoutPanel!.panelItems.control_header;
+        if (controller) {
+          controller.state.visible = false;
+        }
+      }
+    });
+  }
+}

package/src/controller/control/exp-bar/index.ts

@@ -0,0 +1,3 @@
+export * from './calendar-exp-bar.controller';
+export * from './exp-bar.controller';
+export * from './tree-exp-bar.controller';

package/src/controller/control/exp-bar/tree-exp-bar.controller.ts

@@ -0,0 +1,178 @@
+import { RuntimeError, RuntimeModelError } from '@ibiz-template/core';
+import { IDETree, IDETreeNode, ITreeExpBar } from '@ibiz/model-core';
+import {
+  ITreeExpBarState,
+  ITreeExpBarEvent,
+  ITreeExpBarController,
+  ITreeController,
+  ITreeEvent,
+  ITreeNodeData,
+  INavViewMsg,
+} from '../../../interface';
+import { ExpBarControlController } from './exp-bar.controller';
+
+/**
+ * 树导航栏控制器
+ *
+ * @export
+ * @class TreeExpBarController
+ * @extends {ExpBarControlController<ITreeExpBar, ITreeExpBarState, ITreeExpBarEvent>}
+ * @implements {ITreeExpBarController}
+ */
+export class TreeExpBarController
+  extends ExpBarControlController<
+    ITreeExpBar,
+    ITreeExpBarState,
+    ITreeExpBarEvent
+  >
+  implements ITreeExpBarController
+{
+  /**
+   * 默认展开节点集合
+   * @author lxm
+   * @date 2023-08-08 05:35:12
+   * @type {string[]}
+   */
+  defaultExpandedKeys?: string[];
+
+  get xDataController(): ITreeController {
+    const controller = this.view.getController(this.model.xdataControlName!);
+    if (!controller) {
+      throw new RuntimeModelError(
+        this.model,
+        `无法获取多数据部件[${this.model.xdataControlName}]控制器`,
+      );
+    }
+    return controller as ITreeController;
+  }
+
+  /**
+   * 导航栏key
+   *
+   * @author zk
+   * @date 2023-07-10 03:07:11
+   * @memberof TreeExpBarController
+   */
+  navKeyName = 'id' as const;
+
+  /**
+   * 有导航视图的节点模型标识集合
+   * @author lxm
+   * @date 2023-08-10 06:33:14
+   * @type {string[]}
+   */
+  navNodeModelIds: string[] = [];
+
+  /**
+   * 获取指定节点模型
+   *
+   * @param {string} nodeId
+   * @return {*}  {(IDETreeNode | undefined)}
+   * @memberof TreeExpBarController
+   */
+  getNodeModel(nodeId: string): IDETreeNode | undefined {
+    const { detreeNodes } = this.XDataModel as IDETree;
+    let nodeModel: IDETreeNode | undefined;
+    if (detreeNodes) {
+      detreeNodes.forEach(node => {
+        if (node.id === nodeId) {
+          nodeModel = node;
+        }
+      });
+    }
+    return nodeModel;
+  }
+
+  /**
+   * 多数据激活
+   *
+   * @author zk
+   * @date 2023-05-29 03:05:36
+   * @param {IData} data
+   * @memberof ExpBarControlController
+   */
+  xDataActive(event: ITreeEvent['onActive']['event']): void {
+    const { nodeData } = event;
+    // 树导航处理onActive使用树节点数据
+    super.xDataActive({ ...event, data: [nodeData] });
+  }
+
+  /**
+   *  获取导航视图
+   *
+   * @author zk
+   * @date 2023-06-29 03:06:41
+   * @param {IDETabViewPanel} tabViewPanel
+   * @return {*}  {Promise<INavViewMsg>}
+   * @memberof TabExpPanelController
+   */
+  public getNavViewMsg(
+    node: ITreeNodeData,
+    context: IContext,
+    params: IParams,
+  ): INavViewMsg {
+    const nodeId = node.id;
+    const deData = node.deData || node;
+    const nodeModel = this.getNodeModel(node.nodeId);
+    if (!nodeModel) {
+      throw new RuntimeError(`找不到${node.nodeId}的节点模型`);
+    }
+    const result = this.prepareParams(nodeModel, deData, context, params);
+    result.context.currentSrfNav = nodeId;
+    return {
+      key: nodeId,
+      viewId: nodeModel.navAppViewId,
+      ...result,
+    };
+  }
+
+  protected defaultNavByFirstItem(): void {
+    const data = this.xDataController.state.items.find(node => {
+      // 根节点不显示的时候排除根节点
+      if (
+        !this.xDataController.model.rootVisible &&
+        this.xDataController.state.rootNodes.includes(node)
+      ) {
+        return false;
+      }
+      // 没有导航视图的时候，返回第一条出现的数据
+      if (this.state.noNeedNavView) {
+        return true;
+      }
+      // 需要导航视图的时候，返回第一个配置了导航视图的节点数据
+      return this.navNodeModelIds.includes(node.nodeId);
+    });
+    if (!data) {
+      return;
+    }
+    // 默认选中并激活第一项
+    this.xDataController.setActive(data);
+    this.xDataController.setSelection([data]);
+  }
+
+  protected async onCreated(): Promise<void> {
+    await super.onCreated();
+
+    // 初始化带导航的节点标识ids
+    const { detreeNodes } = this.XDataModel as IDETree;
+    detreeNodes?.forEach(node => {
+      if (node.navAppViewId) {
+        this.navNodeModelIds.push(node.id!);
+      }
+    });
+
+    // 计算树的默认展开集合
+    if (this.state.srfnav) {
+      const expandedKeys: string[] = [];
+      this.state.srfnav.split(':').forEach((item, index) => {
+        if (index === 0) {
+          expandedKeys.push(item);
+        } else {
+          expandedKeys.push(`${expandedKeys[index - 1]}:${item}`);
+        }
+      });
+      expandedKeys.pop(); // 删除最后一个
+      this.defaultExpandedKeys = expandedKeys;
+    }
+  }
+}