「通道」Ex.yoAction

优先读取Ex.yoAmbient构造继承属性集。

1. 基本介绍

按钮和操作专用，ExAction/ExButton 专用的处理。

按钮专用过滤函数，主要过滤几个区域的核心按钮：

1. Open区
2. Batch区
3. Search区
4. Extra区
5. Row区
6. Extension扩展（全区域）

2. 核心执行逻辑

该函数的核心执行逻辑如：

1. 调用yoAmbient初始化继承属性。
2. 顺序计算/无序计算（针对state中的op变量定义）。
3. 执行前缀过滤。

3. 默认值

3.1. 默认的顺序配置：

{
     "op.open": [
         "op.open.add",
         "op.open.filter"
     ],
     "op.batch": [
         "op.batch.edit",
         "op.batch.delete"
     ],
     "op.extra": [
         "op.extra.column",
         "op.extra.export",
         "op.extra.import"
     ],
     "op.add": [
         "op.submit.add",
         "op.submit.reset"
     ],
     "op.edit": [
         "op.submit.save",
         "op.submit.delete",
         "op.submit.reset"
     ]
}

3.2. 列表区域图示

带*的是存在配置的区域。

列表页

|--------------------------------------------------|
| *Open    *Batch               Search      *Extra |
|--------------------------------------------------|
|  Row                                             |
|  Row                                             |
|  Row                                             |
|  Row                                             |
|  Row                                             |
|--------------------------------------------------|

表单页

|--------------------------------------------------|
|                                     *Add / *Edit |
|--------------------------------------------------|
|  Form (Grid)                                     |
|                                                  |
|                                                  |
|                                                  |
|                                                  |
|--------------------------------------------------|

3.3. 各项详解

后边两个区域Add提交区/Edit提交区主要位于内置的表单页，除开上边的五个核心区域以外，还会根据 op.extension前缀对应的配置来追加自定义按钮，以完成按钮的配置流程。

「通道」Ex.yoAmbient

1. 基本介绍

该方法为高频使用方法，几乎所有的组件需要继承属性时调用该方法生成inherit属性集。

2. 核心属性

计算继承属性（统一继承属性专用处理），统一继承的属性：

1. 基本属性：

   • $app：应用数据，DataObject
   • $user：登录用户数据，Object
   • $router：路由数据，DataRouter
   • $menus：菜单专用数据，DataObject
   • $profile: 登录用户Profile信息
   • $parent: 父记录专用数据
   • $submitting：redux防重复提交专用
   • $hotel：旧系统专用

2. 标识符专用属性，读取属性中的 $identifier 模型标识符。

3. 特殊禁用变量：$disabled 属性。

4. 提交状态变量

   • $submitting：正在提交
   • $loading：正在加载
   • $dirty：脏数据
   • $collapsed：菜单开合处理

5. 选中项：$selected

6. 函数处理，继承函数前缀：rx, do, fn。

7. 特殊引用

   • reference：父引用
   • react：根引用

8. 插件配置

   • $plugins：插件继承

9. 选项$options处理，执行_seekOption方法：

10. 编程配置 config 合并到 uniform.config中形成最终配置。

11. Assist数据提取，从 props 和 state 中提取，之后处理 rxAssist 中部函数。

12. 动态操作符：$opKey 注入

13. 附加配置：$record 专用处理

    • 外层变量是单变量，用于记录拷贝
    • 如果是数组，必定会在 Form 中选择方式，那可直接走 Assist
    • 外层变量会在config过程中引入特殊属性rowData用于记录外层选中记录

14. 配置处理完过后冻结，调用：freeze

3. 属性继承表

4. 函数核心

4.1. _seekOption

在$options属性构造过程中，原始的uniform.$options = yoOption(reference);已经被废弃，采用新的 _seekOption/_seekOptionPre方法执行计算

1. 先调用_seekOptionPre方法
2. 再调用_seekOption方法

配置源头来自于几处：

1. props属性中的$options变量存储的配置信息。
2. state状态中$options/options两个变量，options是旧系统专用变量（暂时不废弃），$options是统一过后的新变量。
3. 如果存在$hoc（执行过资源绑定），那么读取_module节点（远程加本地），使用module.options执行再合并。

4.2. $record/$parent

这两个变量都用于存储父记录数据

• $parent：父记录专用数据（旧系统模式），标准格式Object
• $record：扩展模块才出现的专用数据，附加额外的父类数据结构
  • rowData：DialogEditor中用来存储选中行的数据信息。

类似下边布局

|--------------------------------------------------|
|  Form (Grid)                                     |
|                                                  |
|                                                  |
|                                                  |
|--------------------------------------------------|
|  Row                                             |
|  Row                                             |
|  Row                                             |
|--------------------------------------------------|

• $parent存储的是Form(Grid)表单的完整数据。
• $record.rowData存储的是字段中某一行的数据（子表单增删改）。

4.3. $record/$options

• $options用于继承配置内容，元数据继承。
• $record用于继承数据内容，数据继承。

「通道」Ex.yoAtomComponent

「通道」Ex.yoAtomContainer

「通道」Ex.yoComponent

yoAmbient函数对应的别名函数，代码逻辑一模一样，yoAmbient等价函数。

「通道」Ex.yoContainer

「通道」Ex.yoControl

优先读取Ex.yoAmbient构造继承属性集。

1. 基本介绍

输入配置的基本信息如（四大基本组件）：

{
    "type": "COMPONENT / LIST / FORM / CONTAINER",
    "sign": "64位随机加密字符串，组件创建时生成，后期可验证属性的版本。"
}

代码执行流程如下

1. type = CONTAINER：调用_seekContainer处理容器配置。
2. type <> CONTAINER的类型：
   1. 先调用_seekContainer处理容器配置。
   2. 再调用_seekComponent处理组件配置。

2. 核心流程解析

2.1. _seekContainer

componentName存在时才能构造容器配置，否则传入的attrs为空对象。

函数签名：

const _seekContainer = (attrs = {}, control = {}, componentType)

主要是构造attrs.container对象，输入的control数据结构如下：

{
     containerConfig: "容器基础配置信息",
     containerName: "「Required」容器名称，必须包含该配置"
}

构造的container的数据结构如下：

{
    key: "设置成控件主键 control.key",
    pageId: "读取控件中关联页面ID control.pageId",
    name: "设置成containerName的值",
    config: "读取containerConfig，否则就直接置空 {}",
    componentType: "函数中的第三参"
}

2.2. _seekComponent

函数签名：

const _seekComponent = (attrs = {}, control = {}) => {

直接构造组件配置，输入的control数据结构如下：

{
    componentConfig: "组件基础配置信息",
    componentData: "当前组件依赖的数据信息",
    componentName: "当前组件名称"
}

构造的最终attrs数据结构如下：

{
    key: "设置成控件主键 control.key",
    pageId: "读取控件中关联页面ID control.pageId",
    name: "设置成componentName的值",
    config: "设置成componentConfig，否则直接置空",
    source: "设置成componentData，作为当前组件专用数据源"
}

3. 容器/组件

动态渲染过程中，最终形成的jsx的数据结构如：

<!-- 容器层 -->
<Container>
    <!-- 组件层 -->
    <Component/>
</Container>

4. 后端动态输入

后端动态输入的结构来自于UI_CONTROL, UI_LIST, UI_FORM几张表，完整数据结构如下：

{
    
}

「通道」Ex.yoDialog

「通道」Ex.yoDynamic

优先读取Ex.yoAmbient构造继承属性集。

1. 基本介绍

动态扩展配置，前置调用yoAmbient方法处理统一配置，然后追加配置：

（新版移除了$identifier，挪动到yoAmbient中，静态动态都会使用）

1. 追加$controls控件配置信息，直接继承$controls配置数据
2. 初始化数据 $inited，直接继承初始化表单数据（表单专用）
3. $mode，表单模式，ADD | EDIT传入
4. $fabric，Ox的Fabric引擎专用变量，存储了fabric相关配置信息

2. 属性继承表

3. 关于$inited

1. 默认读取props中的$inited变量作为继承的表单初始化数据
2. 如果当前组件的状态state中生成了新的$inited数据
   • 子表单专用，使用state中的$inited数据构造子表单初始化数据
   • 构造rxView函数用于更改当前状态中的表单初始化数据

    $inited
---------------> props（低优先级）
                                 $inited, rxView
          ------ state（高优先级）------------------> 子组件
          |        |
       $inited     |
          |        |
          ---------|

「通道」Ex.yoExtension

• 区域执行
• prefix 参数
• • 打开区域：op.open
• • 批量区域：op.batch
• • 额外区域：op.extra
• • 搜索区域：op.search
• • Tab页区域：op.tab
• • 列 Row 的区域：op.row

「通道」Ex.yoFilter

优先读取Ex.yoDynamic构造继承属性集。

1. 基本介绍

查询表单专用，构造查询信息，内置先调用yoDynamic处理。

1. 初始化表单值$inited，赋予connector的连接符。
2. rxClose构造，可关闭子表单。

2. $inited

该方法会为表单数据追加connector字段（搜索条件表单专用）。

「通道」Ex.yoForm

优先读取Ex.yoAmbient构造继承属性集。

1. 基本介绍

该函数的处理内容：

1. form 基本配置处理
2. assist 赋值数据处理
3. control 控件配置 magic：处理Ajax专用 control：控件配置 addon：处理AddOn
4. dialog 窗口专用配置
5. config 核心配置
6. $inited 初始化数据
7. 表单处理专用 $identifier：统一标识符 $mode：表单模式，ADD/EDIT $addKey：添加表单的组件

2. 属性继承表

2.1. 构造config属性

2.2. 特殊继承属性

3. 表单布局计算

3.1. 配置数据源

1. addOn.form：通过编程部分拿到的 form 信息
2. S0（前端静态文件）_form：前端静态配置（主配置）——通常静态form使用此配置
3. S1（前端上表单）_formUp：前端静态配置（辅助配置）
4. S2（前端下表单）_formDown：前端静态配置（辅助配置）
5. D0（后端动态文件）form：后端主配置
6. D1（后端上表单）formUp：后端主配置
7. D2（后端下表单）formDown：后端主配置 布局最终顺序：

表单布局顺序       模式1     模式2     模式3
addon.form
        S1                           o
        D1
        S0        o         o        o
        D0                  o        o
        S2                           o
        D2

有了上述结构后，可根据资源文件和远程配置构造不同的表单布局字段数据（2 x 3合计六个维度）。

3.2. 关于表单的权限说明

（略）后期补充

3.3. 专用配置的格式

主要是补充 additional 的格式信息

「通道」Ex.yoFormAdd

优先读取Ex.yoAmbient构造继承属性集，当前版本提供给ExListXxx组件内部专用。

1. 基本介绍

该方法近似于yoList，但该属性集是传递给表单，附带了表单属性集。

2. 构造属性表

3. 核心

3.1. 关于模型标识符

该方法在内部使用，为静态标识符，所以只支持静态模式下的identifier模型标识符读取，不从远程获取， 远程获取会在OxList组件中完成，而不是ExListXxx组件中。

3.2. rxClose

关闭回调函数可以被子表单使用，子表单提交完成后通常会调用rxClose函数关闭表单返回到列表界面， 返回时还会重新加载列表。

「通道」Ex.yoFormEdit

优先读取Ex.yoAmbient构造继承属性集，当前版本提供给ExListXxx组件内部专用。

1. 基本介绍

该方法近似于yoList，但该属性集是传递给表单，附带了表单属性集。

2. 构造属性表

3. 核心

3.1. 关于模型标识符

该方法在内部使用，为静态标识符，所以只支持静态模式下的identifier模型标识符读取，不从远程获取， 远程获取会在OxList组件中完成，而不是ExListXxx组件中。

3.2. 关于插件

pluginRow插件在表单中本身作为了行控制，所以内置子表单的字段控制直接设置成该函数

• 如果列表中数据不可编辑，那么表单中的数据不可编辑（只读）。
• 如果列表中数据不可删除，那么表单中的数据不可删除。

编辑/删除两种操作在列表和表单中维持一致性。

「通道」Ex.yoGrid

「通道」Ex.yoListBatch

优先读取Ex.yoAmbient构造继承属性集，当前版本提供给ExListXxx组件内部专用。

1. 基本介绍

统一处理Batch区域按钮操作，所有的ExListXxx组件共享，主要包含：基础配置：op.batch + 扩展配置：+ op.extension，其中 op.extension 中的配置如：

{
    region: "op.batch.xxx"
}

2. 构造属性表

3. 核心

3.1. 关于选中

批量操作启用时，<Table/>中会根据批量操作种类设置多选框，一旦有一个操作合法则会提供多选框， 多选框操作变量为$selected，它为批量操作提供了数据选中依据，为了防止用户选错，当任何选项都未选中时， 批量操作会被禁用。

3.2. 关于编辑

批量编辑是Zero Ui提供的固定功能，op.batch.edit，该功能会根据当前记录的列信息和视图信息（columnFull/columnMy）来计算 最终可编辑的属性表，属性信息支持不同种类，其控件内容也不同。

「通道」Ex.yoListExtra

优先读取Ex.yoAmbient构造继承属性集，当前版本提供给ExListXxx组件内部专用。

1. 基本介绍

统一处理Extra区域按钮操作，所有的ExListXxx组件共享，主要包含：基础配置：op.extra + 扩展配置：+ op.extension，其中 op.extension 中的配置如：

{
    region: "op.extra.xxx"
}

关于 $columns/$columnsMy 的注入，这个区域也会需要，但由于数据结构不同，而一直没有出问题，这部分暂时不执行代码合并。重复代码部分如：

     editorRef.config.forEach((config = {}) => {

         const {component = {}} = config;
         const editorRef = component.config;

         editorRef.$columns = $columns;
         editorRef.$columnsMy = $columnsMy;
     });

2. 构造属性表

3. 核心

3.1. 关于列视图

列视图在构造过程中层次如下：

|-------------------------------------------- 全列 |
|--------------------------------------     业务列 |
|------------------------------ ACL控制      可见列 |
|------------------------ 保存               视图列 |

最终关系：

1. 全列 = 系统列（不可见） + 业务列（可见）
2. 业务列 = ACL可见（$columns） + ACL不可见（权限控制列）
3. ACL可见列 = 我的视图列（$columnsMy） + 视图未选中列

3.2. 三个基础函数

该函数会构造三个核心函数，对应三个系统按钮

「通道」Ex.yoListGrid

「通道」Ex.yoListOpen

优先读取Ex.yoAmbient构造继承属性集，当前版本提供给ExListXxx组件内部专用。

1. 基本介绍

统一处理Open区域按钮操作，所有的ExListXxx组件共享，主要包含：基础配置：op.open + 扩展配置：+ op.extension，其中 op.extension 中的配置如：

{
    region: "op.open.xxx"
}

2. 构造属性表

（无）

3. 核心

3.1. 清除

针对op.open.filter执行查询条件清除按钮的禁用和启用提示，如果执行了列过滤，则启用该按钮，如果未执行，则不启用该按钮，根据$condition来。

「通道」Ex.yoListSearch

优先读取Ex.yoAmbient构造继承属性集，当前版本提供给ExListXxx组件内部专用。

1. 基本介绍

*: 这个函数和其他yoList有一定区别，主要在属性构造上。

基础搜索/高级搜索工具栏专用，基本逻辑类似于yoFormAdd/yoFormEdit，提供给查询表单用的属性集。

2. 构造属性表

3. 核心

3.1. 关于搜索模式

搜索模式可以通过search.enabled和search.advanced两个选项来执行开启和禁用：

1. search.enabled：启用基础搜索（搜索框）。
2. search.advanced：启用高级搜索（搜索表单）。

3.2. 查询条件

影响ExListXxx的条件有三个状态值：$filters, $condition, $query：

• $query：主条件，包括从外置传入的条件
• $condition：列过滤专用条件
• $filters：当前组件操作的条件（基础搜索和高级搜索）

「通道」Ex.yoPolymorphism

1. 基本介绍

动态扩展配置，前置调用yoAmbient方法处理统一配置，之后追加：

1. 直接读取fromHoc中的grid配置
2. 如果传入了专用表单配置，则处理form表单配置，填充$form变量
3. state中的$query读取
4. state中的config.options中读取$identifier
5. 构造$inited中的$identifier

2. 构造属性表

3. 核心

3.1. 特定场景

对应特定界面处理，目前常用于X_CATEGORY和X_TABULAR的管理。

|--------------------------------------------------|
|  Menu  |  Content ( List )                       |
|        |  Row                                    |
|        |  Row                                    |
|        |  Row                                    |
|        |  Row                                    |
|        |  Row                                    |
|        |  Row                                    |
|--------------------------------------------------|

• 左边部分是选择。
• 右边部分是一个完整带有List界面的主界面（ExListXxx页）。

「通道」Ex.yoQrCond

「通道」Ex.yoQrQBE

「通道」Ex.yoQrTag

「通道」Ex.yoRender

1. 基本介绍

（高频函数）执行渲染拦截的专用函数：

1. $ready = true，执行渲染。
2. $ready = false，不执行渲染，只 Loading。

2. 核心

2.1. 加载

该函数不提供属性集，主要用于加载，它和xtReady的区别点在于：

• xtReady：自定义组件专用economy目录下的所有组件。
• yoRender：Extension组件专用extension/ecosystem目录下的扩展组件。

2.2. 过渡

这个函数主要为过渡效果量身打造。

「通道」Ex.yoTabPage

1. 基本介绍

该函数用于构造<Tabs/>中每一页专用的配置，该值最终会构造<Tabs.?abPane/>元素。

核心逻辑

1. 根据tabs.count运算可打开的页签数，超过限制不再打开。
2. 如果打开了新的页签，旧页签是否处于禁用状态（防止不专注工作副总用）。

「通道」Ex.yoTplAccount

「通道」Ex.yoTplHeader

「通道」Ex.yoTplNavigation

「通道」Ex.yoTplSider