表单渲染中, 有些表单的显示有不同条件, 比如需要上一个表单的开关打开,或者文本内容为 xxxx, 或者需要大于或等于或小于指定值, 或者需要选中某个选项, 或者需满足以上多个条件或在满足多个条件中的一个, 有 n 种场景选择, 这样就需要条件显示配置功能, 来满足多样化需求
预览
架构实现
条件显示,其实就是该表单和其他表单的逻辑关系,我们可以合理的利用或(||)且(&&)逻辑运算符来实现
如
(A && B) || (A && (B || C || D && (F && (G || H && (L && O && P)))) && E) && D
实现出能匹配出以上等不同复杂类型表达式的组件, 差不多条件显示功能难点没有了
思考
观察以上表达式, 有以下几个特点
- 只有且或两个逻辑表达式
- 关系层级嵌套多, 可能会嵌套 n 层, 层数不确定
综合以上两个原因, 可以利用两个按钮来表示并和或, 然后使用 vue 的递归组件来实现关系的层级嵌套, 这样就能在不同层级下的组件样式保持一致
实现
递归组件
定义: 组件是可以在它们自己的模板中调用自身的。不过它们只能通过 name 选项来做这件事:
如:
json
{
"name": "stack-overflow", // 组件名称
"template": "<div><stack-overflow></stack-overflow></div>" // 模板内部调用自身
}
步骤原理
我们首先来实现下如下的表达式:
如:
A || (B && C)
上文说过, 只有两个逻辑运算符, 且、或, 观察 A || (B && C)
, 除了逻辑运算符外, 还有条件 A、B、C, 这个条件具有多样性, 且可配
我们可以定义一个下拉框(不使用按钮,不然后面循环嵌套按钮太多,样式太丑), 包含并组、或组、条件, 可以理解并组和或组就是一个数组, 数组内有不同的条件, 并组就是每个条件必须满足,或组就是不同条件满足其中一个即可
html
<el-select v-model="result.type" placeholder="请选择" @change="onChange">
<el-option v-for="item in groupSelect" :key="item.value" :label="item.label" :value="item.value"> </el-option>
</el-select>
js
export default {
data() {
return {
groupSelect: [
{
value: "andgroup",
label: "+并组",
},
{
value: "orgroup",
label: "+或组",
},
{
value: "data",
label: "条件",
},
],
};
},
};
样式如下
一个下拉框, 一个增加条件按钮和一个删除按钮
上文也说过下拉框的作用, 增加条件按钮其实和下拉框的条件按钮功能一致的, 不过为了方便新增条件做的快捷按钮, 删除按钮指的是删除当前条件或子条件
观察如 A || (B && C)
表达式, 满足 A 或者满足 B 且满足 C, 整体是一个或组, 相信大家通过我对或和且命名为或组和且组就能理解到, 或组和且组都是一个数组.或组数组内部有两条数据, 一个是条件 A, 一个是并组, 并组数组内部有两条数据, 条件 B 和条件 C
综合以上分析, 递归组件的使用场景就是在并组和或组内部配置子条件, 子条件包括条件、或组、并组, 然后子条件内部的并组和或组又有子条件, 只要有子条件就可能会有或组和并组, 不断递归下去,直到最底层的是条件, 不能再有子条件为止
所以可以设计成如下数据格式:
json
{
"showRule": {
"type": "orgroup",
"result": [
{
"type": "data",
"data": "A"
},
{
"type": "andgroup",
"result": [
{
"type": "data",
"data": "B"
},
{
"type": "data",
"data": "C"
}
]
}
]
}
}
以上数据转换为表达式就是:
js
(
'A' or ('B' and 'C')
)
来分析下该数据格式, 其中 type 字段, 值有 orgroup、andgroup、data
, 代表或组、并组、条件, 或组和并组是一个数组 result, 数组内部可以是或组、并组、条件, 如果 type 为 data, 则没有 result, 为 data 对象,即条件
那我们根据以上数据接口来实现递归组件
子组件 ConditionGroup
template
html
<Transition>
<div v-show="result.type && result.type !== 'data'">
<div v-for="(item, index) in result.result" :key="index">
<ConditionGroup :result="item" @update="handleUpdateForce" @delete="handleDelete" :index="index" :fieldList="fieldList" />
</div>
<div v-if="result.result && result.result.length >= 2"></div>
</div>
</Transition>
<div v-show="result.type && result.type == 'data'">
<ConditionTanc ref="ConditionTanc" :data="result.data" @end="handleUpdateForce" :fieldList="fieldList"></ConditionTanc>
</div>
script
js
export default {
name: "ConditionGroup",
props: {
result: {
type: Object,
default() {
return {};
},
},
fieldList: {
type: Array,
default() {
return [];
},
},
},
};
父组件 ConditionModule
template
html
<ConditionGroup :result="result" @update="handleUpdateForce" />
script
js
export default {
data() {
return {
result: {},
};
},
};
通过不断的向子组件或递归组件传递 result, 利用 vue 的双向数据绑定, 来实现配置
其中需要注意一点
因为是数据是通过配置的形式, 不知道是并组、或组还是条件, 所以在最顶层的时候是只透传了空对象, 我们需要在增加并组、或组还是条件的时候判断类型然后生成对应字段
如:
js
if (!this.result.type) return;
if (!this.result.result && this.result.type != "data") {
this.result.result = [];
}
if (this.result.type == "data" && !this.result.data) {
this.result.data = {};
}
this.result.control = true;
switch (this.result.type) {
case "orgroup":
this.result.result.push({ typ: "orgroup", result: [] });
break;
e;
case "andgroup":
this.result.result.push({ type: "andgroup", result: [] });
break;
case "data":
this.result.result.push({ type: "data", data: {} });
break;
}
这样就能生成 n 层嵌套的数据
条件生成
这个条件是什么, 是需要其他表单达到什么条件, 比如大于等于某个值, 选择某个选项等
所以要有三个条件
- 获取其他表单的数据
- 判断是等于不等于、包含不包含逻辑运算
- 表单的值是固定的还是用户输入的, 比如下拉选择框是固定的几个选项, 不可能让用户随意配置, 必须在固定几个选项的基础上进行选择
获取数据
我相信大家应该也看到上面代码的 fieldList 字段, 该字段就是全局表单列表, 该数据列表我是通过 reative 进行数据的状态管理, 配置的数据就能在全局(所有组件)共享(访问), 这样就能获取其他表单配置
js
const allFormList = formStore?.get("allFormList");
const fieldResult = [];
// 获取显示条件所有字段列表(详情请看源代码)
toRaw(allFormList)?.forEach((item) => {
window.VueContext.$Flex.getFormDataList(item, fieldResult, this.data.fieldName);
});
this.leftField = fieldResult;
动态生成逻辑运算符
是确定表单显示条件值是否满足, 如 a 是否包含字符串 c, a.includes('c'), b 是否不等于 2, b != 2
js
export default {
data() {
return {
logicList: [
{ value: "=", label: "等于" },
{ value: "!=", label: "不等于" },
],
};
},
methods: {
getLogic() {
const item = this.fieldList.find((item) => {
if (this.table && this.table.length > 0) {
if (item.value == this.table[0].field) {
return item;
}
}
});
if (item && item.options && item.multiple) {
return [
{ value: "in", label: "包含" },
{ value: "not in", label: "不包含" },
];
}
if (item && item.switch) {
return [
{
value: "=",
label: "等于",
},
];
}
return this.logicList;
},
},
};
值类型
默认情况下是常量, 然后用户输入指定值, 如果是选择框,下拉框等, 就是选项,获取该表单配置固定选项值,作为最后的条件值, 如果是 switch, 则是布尔, 值只能为 true 或 false
js
{
data(){
return {
typeList: [
{
rule: [],
value: "常量",
label: "常量",
},
],
}
},
computed: {
newtypeList() {
const item = this.fieldList.find((item) => {
if (this.table && this.table.length > 0) {
if (item.value == this.table[0].field) {
return item;
}
}
});
if (item && item.options) {
return [
{
rule: [],
value: "选项",
label: "选项",
},
];
}
if (item && item.switch) {
return [
{
value: "布尔",
label: "布尔",
},
];
}
return this.typeList;
},
}
}
这样就能保证数据的准确性和安全性, 规范规则, 否则会出现要求 switch(开关)的值为'abc', 要求下拉框(固定值 a,b,c)的值等于 7, 会出现各种牛头不对马嘴的情况
具体的选项值的获取等请移步到源码中
表达式
数据生成后, 如果嵌套递归很多, 我相信大家很难准确的知道其中的逻辑关系, 想在某个地方添加一个或组, 可能都很难找对, 所以为了方便查看其中的逻辑关系, 程序实时生成表达式
js
function filterCondition(result) {
if (result.type == "andgroup" || result.type == "orgroup") {
const b = result.result.map((item) => filterCondition(item)).join(result.type == "andgroup" ? '<span class="and">and</span>' : '<span class="or">or</span>');
const a = `<span class='kh ${result.type}'>(${b})</span>`;
return a;
} else if (result.type == "data") {
return `<span class='data kh'>${getDataConditionRelate(result)}</span>`;
} else {
return "";
}
}
function getDataConditionRelate(data) {
if (Object.keys(data.data).length == 0) return "空";
const fieldData = data.data;
const field = fieldData.field;
let value;
if (fieldData.type == "选项") {
const rightField = fieldData.value;
value = `${JSON.stringify(rightField)}`;
} else if (fieldData.type == "常量" || fieldData.type == "布尔") {
value = fieldData.value;
}
return `${field} ${fieldData.logic} ${value}`;
}
显示条件
通过以上方式我们能生成每个表单的显示条件配置数据, 那如何来实际控制表单的显示隐藏?
首先我们需要监听表单值的改变, 这样才能实时来实现显示与隐藏
定义了一个 hooks
js
import { watch, getCurrentInstance, ComponentInternalInstance } from "vue";
function useWatch(props: any) {
const vm = getCurrentInstance() as ComponentInternalInstance;
// 预览模式下才有效
if (!props.data.fieldName && !props.item.controlItems) {
watch(
() => props.data[props.item.data.fieldName],
(val, oldVal) => {
if (props.item.data.action && props.item.data.action.onChange) {
window.VApp.$Flex.funcExec(props.item.data.action.onChange, vm.proxy, [val, oldVal, props.data]);
}
vm.emit("change");
},
{
deep: true,
}
);
}
}
export { useWatch };
然后在每个表单组件中这样引用, 就不需要多余的逻辑来实现数据的改变
js
import { useWatch } from "../../utils/customHooks";
export default defineComponent{
setup(props){
useWatch(props);
}
}
所以组件改变的时候会触发 change 方法, 我们就可以写组件的显示隐藏逻辑
下面是核心代码, 详细代码请看源码
js
function conditionChange(data: any) {
if (data.type == "andgroup") {
const result = data.result
.map((item: any) => {
const r = conditionChange(item);
return r;
})
.find((item: boolean) => {
return item == false;
});
return result === undefined ? true : result;
} else if (data.type == "orgroup") {
const result = data.result
.map((item: any) => {
const r = conditionChange(item);
return r;
})
.find((item: boolean) => {
return item == true;
});
return result === undefined ? false : result;
} else if (data.type == "data") {
const result = data.data;
const formResults: any = props.formResult;
const value = formResults[result.field];
let isShow = false;
switch (result.logic) {
case "=":
isShow = value == result.value;
break;
case "!=":
isShow = value != result.value;
break;
case "in":
if (Array.isArray(value)) {
value.find((item) => {
if (result.value.include(item)) {
isShow = result.value.includes(item);
return item;
}
});
} else {
isShow = result.value.includes(value);
}
break;
case "not in":
if (Array.isArray(value)) {
value.find((item) => {
if (!result.value.include(item)) {
isShow = !result.value.includes(item);
return item;
}
});
} else {
isShow = !result.value.includes(value);
}
break;
}
return isShow;
}
}
总结
通过以上剖丝薄茧, 我相信大家对动态表单显示与隐藏的判断应该了如指掌了, 如果要阅读源码, 请移步