cy-element-ui 1.1.26 → 1.1.28

package/lib/CyTabDialog.js

@@ -605,7 +605,7 @@ __webpack_require__.r(__webpack_exports__);
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, "TabDialogDirective", function() { return /* binding */ tabDialog_TabDialogDirective; });
 
-// CONCATENATED MODULE: ./node_modules/vue-loader/lib/loaders/templateLoader.js??vue-loader-options!./node_modules/vue-loader/lib??vue-loader-options!./packages/cy/tabDialog/src/main.vue?vue&type=template&id=1a478a44
+// CONCATENATED MODULE: ./node_modules/vue-loader/lib/loaders/templateLoader.js??vue-loader-options!./node_modules/vue-loader/lib??vue-loader-options!./packages/cy/tabDialog/src/main.vue?vue&type=template&id=509a6ce0
 var render = function () {
   var _vm = this
   var _h = _vm.$createElement
@@ -706,7 +706,7 @@ var staticRenderFns = []
 render._withStripped = true
 
 
-// CONCATENATED MODULE: ./packages/cy/tabDialog/src/main.vue?vue&type=template&id=1a478a44
+// CONCATENATED MODULE: ./packages/cy/tabDialog/src/main.vue?vue&type=template&id=509a6ce0
 
 // EXTERNAL MODULE: ./packages/dialog/index.js + 5 modules
 var dialog = __webpack_require__(49);
@@ -764,7 +764,14 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 //
 //
 //
+//
+//
+//
+//
+//
+//
 
+// 引入 Element UI 底层 Dialog 组件（直接引用源码而非全量注册）
 
 
 
@@ -779,7 +786,7 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 			type: Boolean,
 			default: false
 		},
-		// Dialog 的标题，也可通过具名 slot
+		// Dialog 的标题，也可通过具名 slot 自定义
 		title: {
 			type: String,
 			default: ''
@@ -809,7 +816,7 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 			type: Boolean,
 			default: false
 		},
-		// 是否在 Dialog 出现时将 body或上层 滚动锁定
+		// 是否在 Dialog 出现时将 body 或上层滚动锁定
 		lockScroll: {
 			type: Boolean,
 			default: true
@@ -844,7 +851,7 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 			type: Boolean,
 			default: false
 		},
-		// 是否放到tagsView中，即当前app-views下面，此属性true时，appendToBody无效
+		// 是否放到 tagsView 中（即当前 app-views 下面）；此属性为 true 时 appendToBody 无效
 		appendToTagsView: {
 			type: Boolean,
 			default: false
@@ -861,18 +868,21 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 	},
 	data: function data() {
 		return {
-			// 判断dialog是否已经放到对应的div下
+			// 判断 dialog 是否已经放到对应的 div 下
 			rendered: false,
+			// 自管遮罩层的 z-index
 			modelZIndex: 1000,
+			// 自管遮罩层的高度（根据父容器动态计算）
 			modelHeight: 0,
-			// 当前app-views的dom元素
+			// 当前 app-views 的 dom 元素
 			parentDom: null,
-			// 当前el-dialog的dom元素
+			// 当前 el-dialog 的 dom 元素
 			elDialogDom: null
 		};
 	},
 
 	watch: {
+		// 监听 visible：控制 dialog 显示/隐藏、挂载位置、键盘事件、遮罩层级
 		visible: {
 			immediate: true,
 			handler: function handler(val) {
@@ -882,20 +892,20 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 					this.$emit('open');
 					external_vue_default.a.nextTick(function () {
 						var dom = _this.$el;
-						// 首次打开
+						// 首次打开时处理挂载位置
 						if (!_this.rendered) {
 							_this.rendered = true;
 							if (_this.appendToTagsView) {
-								// 将当前dialog挪到当前app-views里面 app-container
+								// 将当前 dialog 挪到当前 app-views 里面的 app-container
 								_this.parentDom = dom.closest('.app-container');
 								if (!_this.parentDom) _this.parentDom = document.body;
 								_this.parentDom.append(dom);
 							} else if (_this.appendToBody) {
-								// 将当前dialog挪到当前body里面
+								// 将当前 dialog 挪到当前 body 里面
 								_this.parentDom = document.body;
 								_this.parentDom.append(dom);
 							}
-							// 添加键盘监听事件
+							// 添加键盘监听事件（用于 ESC 关闭）
 							if (_this.closeOnPressEscape) {
 								document.addEventListener('keydown', _this.escKeyDown);
 							}
@@ -903,9 +913,9 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 
 						setTimeout(function () {
 							if (_this.parentDom) _this.modelHeight = _this.parentDom.scrollHeight + 'px';
-							// 当前VDialog不在body中时
+							// 当前 VDialog 不在 body 中时
 							if (!_this.parentDom || _this.parentDom.tagName.toUpperCase() !== 'BODY') {
-								// 获取el-dialog的宽度，如果大于app-views的宽度，则el-dialog不居中显示
+								// 获取 el-dialog 的宽度，如果大于 app-views 的宽度，则 el-dialog 不居中显示
 								var elDialogWidth = dom.getElementsByClassName('el-dialog')[0].clientWidth;
 								if (!_this.parentDom || elDialogWidth < _this.parentDom.clientWidth) {
 									dom.getElementsByClassName('el-dialog')[0].style.left = '50%';
@@ -917,41 +927,70 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 							dom.getElementsByClassName('el-dialog')[0].style.marginTop = _this.top;
 						}, 50);
 
-						// 获取el-dialog的z-index，赋值给model，用于处理model的层级问题
+						// 获取 el-dialog 的 z-index，赋值给 model，用于处理 model 的层级问题
 						_this.elDialogDom = dom.children[1];
 						setTimeout(function () {
 							_this.modelZIndex = _this.elDialogDom.style.zIndex;
 						}, 50);
 					});
 				} else {
-					// immediate=true时，首次打开不需要触发close事件
+					// immediate=true 时，首次打开不需要触发 close 事件
 					if (this.rendered) this.$emit('close');
 				}
 			}
 		}
 	},
 	methods: {
+		/**
+   * 打开回调，透传 open 事件
+   * @fires {Event} open
+   * @returns {void}
+   */
 		handleOpen: function handleOpen() {
 			this.$emit('open');
 		},
+
+
+		/**
+   * 打开动画结束回调，透传 opened 事件
+   * @fires {Event} opened
+   * @returns {void}
+   */
 		handleOpened: function handleOpened() {
 			this.$emit('opened');
 		},
+
+
+		/**
+   * 关闭回调：同步 visible 并透传 close 事件
+   * @fires {Event} update:visible
+   * @fires {Event} close
+   * @returns {void}
+   */
 		handleClose: function handleClose() {
 			this.$emit('update:visible', false);
 			this.$emit('close');
 		},
+
+
+		/**
+   * 关闭动画结束回调，透传 closed 事件
+   * @fires {Event} closed
+   * @returns {void}
+   */
 		handleClosed: function handleClosed() {
 			this.$emit('closed');
 		},
 
 
-		/**
-     * 监听esc键
-     */
+		/**
+   * 监听 esc 键，按层级优先级关闭最上层 dialog
+   * @param {KeyboardEvent} event - 键盘事件对象
+   * @returns {void}
+   */
 		escKeyDown: function escKeyDown(event) {
 			if (event.keyCode === 27) {
-				// 获取body下的直接子节点中的已打开的vDialog
+				// 获取 body 下的直接子节点中的已打开的 VDialog
 				var bodyVDialogDomArr = [];
 				var bodyChildrenArr = document.body.childNodes;
 				for (var i = 0; i < bodyChildrenArr.length; i++) {
@@ -960,23 +999,23 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 						bodyVDialogDomArr.push(item);
 					}
 				}
-				// 判断body中是否有已打开的vDialog，如果有，优先关闭body下的vDialog
+				// 判断 body 中是否有已打开的 VDialog，如果有，优先关闭 body 下的 VDialog
 				if (bodyVDialogDomArr.length > 0) {
-					// 获取当前cy-tab-dialog在当前body中的下标
+					// 获取当前 cy-tab-dialog 在当前 body 中的下标
 					var curDomIndex = [].indexOf.call(bodyVDialogDomArr, this.$el);
 					if (curDomIndex === bodyVDialogDomArr.length - 1) {
 						this.handleClose();
 					}
 				} else if (document.getElementById('tags-view-container') && this.parentDom.parentElement.getAttribute('include_name')) {
-					// 获取当前app-views对应的include_name值
+					// 获取当前 app-views 对应的 include_name 值
 					var includeName = this.parentDom.parentElement.getAttribute('include_name');
-					// 根据includeName获取tagsView中的tag标签页
+					// 根据 includeName 获取 tagsView 中的 tag 标签页
 					var tagDom = document.getElementById('tags-view-container').querySelectorAll('[include_name=' + includeName + ']');
 					if (tagDom && tagDom[0]) {
-						// 判断此标签页是否为选中状态，只有选中状态中的vDialog才可以进行关闭
+						// 判断此标签页是否为选中状态，只有选中状态中的 VDialog 才可以进行关闭
 						if (tagDom[0].className.split(' ').includes('active')) {
 							var vDialogList = this.parentDom.getElementsByClassName('cy-tab-dialog-opened');
-							// 获取当前cy-tab-dialog在当前app-views中的下标
+							// 获取当前 cy-tab-dialog 在当前 app-views 中的下标
 							var _curDomIndex = [].indexOf.call(vDialogList, this.$el);
 							if (_curDomIndex === vDialogList.length - 1) {
 								this.handleClose();
@@ -989,6 +1028,11 @@ var external_vue_default = /*#__PURE__*/__webpack_require__.n(external_vue_);
 			}
 		}
 	},
+
+	/**
+  * 组件销毁前移除键盘监听，避免内存泄漏
+  * @returns {void}
+  */
 	beforeDestroy: function beforeDestroy() {
 		document.removeEventListener('keydown', this.escKeyDown);
 	}

package/lib/CyTreeSelect.js

@@ -213,7 +213,7 @@ module.exports = require("element-ui/lib/utils/shared");
 // ESM COMPAT FLAG
 __webpack_require__.r(__webpack_exports__);
 
-// CONCATENATED MODULE: ./node_modules/vue-loader/lib/loaders/templateLoader.js??vue-loader-options!./node_modules/vue-loader/lib??vue-loader-options!./packages/cy/treeSelect/src/main.vue?vue&type=template&id=5e4054a3
+// CONCATENATED MODULE: ./node_modules/vue-loader/lib/loaders/templateLoader.js??vue-loader-options!./node_modules/vue-loader/lib??vue-loader-options!./packages/cy/treeSelect/src/main.vue?vue&type=template&id=7e2add3e
 var render = function () {
   var _vm = this
   var _h = _vm.$createElement
@@ -273,7 +273,7 @@ var render = function () {
                   1
                 )
               : _vm._e(),
-            _vm.showCheckStrictly
+            _vm.showCheckStrictly && _vm.multiple
               ? _c(
                   "div",
                   { staticClass: "cy-tree-select-select-con-t" },
@@ -304,9 +304,9 @@ var render = function () {
                   attrs: {
                     data: _vm.treeOptions,
                     "show-checkbox": _vm.multiple,
-                    "node-key": _vm.defaultOptions.id,
+                    "node-key": _vm.treeFieldMap.id,
                     "check-strictly": !_vm.isCheckStrictly,
-                    props: _vm.defaultOptions,
+                    props: _vm.treeFieldMap,
                     "expand-on-click-node": false,
                     "default-expand-all": _vm.defaultExpandAll,
                     "filter-node-method": _vm.filterNode,
@@ -339,7 +339,7 @@ var render = function () {
                         _vm._s(
                           _vm.checkedArr
                             .map(function (item) {
-                              return item[_vm.defaultOptions.label]
+                              return item[_vm.treeFieldMap.label]
                             })
                             .join()
                         )
@@ -391,7 +391,7 @@ var staticRenderFns = []
 render._withStripped = true
 
 
-// CONCATENATED MODULE: ./packages/cy/treeSelect/src/main.vue?vue&type=template&id=5e4054a3
+// CONCATENATED MODULE: ./packages/cy/treeSelect/src/main.vue?vue&type=template&id=7e2add3e
 
 // EXTERNAL MODULE: ./packages/checkbox/index.js + 5 modules
 var packages_checkbox = __webpack_require__(16);
@@ -455,7 +455,17 @@ var tree = __webpack_require__(46);
 //
 //
 //
+//
+//
+//
+//
+//
+//
+//
+//
+//
 
+// 引入 Element UI 底层组件，避免走全量注册
 
 
 
@@ -469,55 +479,66 @@ var tree = __webpack_require__(46);
 		ElInput: input["default"],
 		ElTree: tree["default"]
 	},
+	// 自定义 v-model：使用 value 作为 prop，change 作为回调事件
 	model: {
 		prop: 'value',
 		event: 'change'
 	},
 	props: {
+		// 绑定值：单选时为节点 id（String/Number），多选时为 id 数组
 		value: {
 			type: [String, Number, Array],
 			default: ''
 		},
 
+		// 树形数据源（children 嵌套结构）
 		options: {
 			type: Array,
 			default: []
 		},
 
+		// 未选中时的占位提示文本
 		placeholder: {
 			type: String,
 			default: ''
 		},
 
+		// 组件尺寸（medium / small / mini）
 		size: {
 			type: String
 		},
 
+		// 是否显示搜索过滤输入框
 		filterable: {
 			type: Boolean,
 			default: false
 		},
 
+		// 是否显示「父子节点联动」开关
 		showCheckStrictly: {
 			type: Boolean,
 			default: true
 		},
 
+		// 父子节点是否互相关联（默认联动）
 		checkStrictly: {
 			type: Boolean,
 			default: true
 		},
 
+		// 是否显示清空按钮
 		clearable: {
 			type: Boolean,
 			default: false
 		},
 
+		// 是否多选模式（多选时树节点带 checkbox）
 		multiple: {
 			type: Boolean,
 			default: false
 		},
 
+		// 树节点字段映射配置：指定 id / label / children 对应的字段名
 		defaultOptions: {
 			type: Object,
 			default: function _default() {
@@ -529,16 +550,19 @@ var tree = __webpack_require__(46);
 			}
 		},
 
+		// 触发区域（reference）的自定义样式
 		vStyle: {
 			type: [Array, String, Object],
 			default: ''
 		},
 
+		// 弹出层自定义类名
 		popperClass: {
 			type: String,
 			default: ''
 		},
 
+		// 是否默认展开所有节点
 		defaultExpandAll: {
 			type: Boolean,
 			default: false
@@ -546,18 +570,40 @@ var tree = __webpack_require__(46);
 	},
 	data: function data() {
 		return {
+			// 当前是否父子联动（受 checkStrictly 控制）
 			isCheckStrictly: true,
+			// 弹出层是否展开
 			popoverOpen: false,
+			// 鼠标是否悬浮在图标区（控制清空/箭头图标切换）
 			isClearIcon: false,
 
+			// 原始树数据（来自 options）
 			treeOptions: [],
+			// 扁平化后的树数据（便于按 id 反查节点）
 			treeArr: [],
+			// 搜索关键字
 			filterText: '',
+			// 搜索命中的节点 id 集合
 			matchedNodeIds: []
 		};
 	},
 
 	computed: {
+		/**
+   * 字段映射配置：将用户传入的 defaultOptions 与默认值合并，
+   * 保证 children / label / id 三个 key 始终存在，
+   * 避免只传部分字段时取到的 key 为 undefined 而导致层级/选中/搜索失效
+   * @returns {Object} 合并后的字段映射
+   */
+		treeFieldMap: function treeFieldMap() {
+			return Object.assign({ children: 'children', label: 'label', id: 'id' }, this.defaultOptions);
+		},
+
+
+		/**
+   * 根据 value 反查当前选中节点对象数组，用于回显文本
+   * @returns {Array} 选中节点对象数组
+   */
 		checkedArr: function checkedArr() {
 			var _this = this;
 
@@ -565,20 +611,21 @@ var tree = __webpack_require__(46);
 				var arr = [];
 				this.value && this.value.forEach(function (id) {
 					var cItem = _this.treeArr.filter(function (tItem) {
-						return tItem[_this.defaultOptions.id] === id;
+						return tItem[_this.treeFieldMap.id] === id;
 					})[0];
 					if (cItem) arr.push(cItem);
 				});
 				return arr;
 			} else {
 				var cItem = this.treeArr.filter(function (tItem) {
-					return tItem[_this.defaultOptions.id] === Number(_this.value);
+					return tItem[_this.treeFieldMap.id] === Number(_this.value);
 				})[0];
 				return cItem ? [cItem] : [];
 			}
 		}
 	},
 	watch: {
+		// 监听 checkStrictly：同步到内部状态 isCheckStrictly
 		checkStrictly: {
 			immediate: true,
 			handler: function handler() {
@@ -586,6 +633,7 @@ var tree = __webpack_require__(46);
 			}
 		},
 
+		// 监听 value：变化时重新设置树节点的勾选状态
 		value: {
 			immediate: true,
 			deep: true,
@@ -598,6 +646,7 @@ var tree = __webpack_require__(46);
 			}
 		},
 
+		// 监听 options：数据变化时重新扁平化
 		options: {
 			deep: true,
 			immediate: true,
@@ -607,6 +656,7 @@ var tree = __webpack_require__(46);
 			}
 		},
 
+		// 监听搜索关键字：过滤树节点并自动展开命中节点
 		filterText: function filterText(val) {
 			var _this3 = this;
 
@@ -625,10 +675,25 @@ var tree = __webpack_require__(46);
 	created: function created() {},
 
 	methods: {
+		/**
+   * 树节点过滤方法：根据命中 id 集合决定节点是否显示
+   * @param {*} value - 搜索关键字
+   * @param {Object} data - 当前树节点数据
+   * @returns {boolean}
+   */
 		filterNode: function filterNode(value, data) {
 			if (!value) return true;
-			return this.matchedNodeIds.includes(data[this.defaultOptions.id]);
+			return this.matchedNodeIds.includes(data[this.treeFieldMap.id]);
 		},
+
+
+		/**
+   * 递归查找名称包含关键字的节点 id（父节点命中则连带子节点）
+   * @param {*} value - 搜索关键字
+   * @param {Array} nodes - 待查找的树节点数组
+   * @param {boolean} [parentMatched=false] - 父节点是否已命中
+   * @returns {Array<number>} 命中节点 id 集合
+   */
 		findMatchedNodes: function findMatchedNodes(value, nodes) {
 			var _this4 = this;
 
@@ -637,21 +702,27 @@ var tree = __webpack_require__(46);
 			var matchedIds = [];
 
 			nodes.forEach(function (node) {
-				var currentNodeMatched = node[_this4.defaultOptions.label].indexOf(value) !== -1;
+				var currentNodeMatched = node[_this4.treeFieldMap.label].indexOf(value) !== -1;
 				var shouldShow = currentNodeMatched || parentMatched;
 
 				if (shouldShow) {
-					matchedIds.push(node[_this4.defaultOptions.id]);
+					matchedIds.push(node[_this4.treeFieldMap.id]);
 				}
 
-				if (node[_this4.defaultOptions.children] && node[_this4.defaultOptions.children].length > 0) {
-					var childIds = _this4.findMatchedNodes(value, node[_this4.defaultOptions.children], shouldShow);
+				if (node[_this4.treeFieldMap.children] && node[_this4.treeFieldMap.children].length > 0) {
+					var childIds = _this4.findMatchedNodes(value, node[_this4.treeFieldMap.children], shouldShow);
 					matchedIds = matchedIds.concat(childIds);
 				}
 			});
 
 			return matchedIds;
 		},
+
+
+		/**
+   * 将搜索命中的节点自动展开
+   * @returns {void}
+   */
 		expandMatchedNodes: function expandMatchedNodes() {
 			var _this5 = this;
 
@@ -662,6 +733,12 @@ var tree = __webpack_require__(46);
 				}
 			});
 		},
+
+
+		/**
+   * 根据 value 初始化树节点勾选状态（单选/多选分别处理）
+   * @returns {void}
+   */
 		init: function init() {
 			var _this6 = this;
 
@@ -675,6 +752,16 @@ var tree = __webpack_require__(46);
 				_this6.$refs.tree.setCheckedKeys(arr);
 			});
 		},
+
+
+		/**
+   * 多选时勾选变化回调：向外 emit 选中 id 数组及节点数组
+   * @param {*} value - el-tree 回调的勾选节点数据
+   * @param checkedKeys
+   * @param {Object} checkedNodes - 选中节点对象数组
+   * @fires {Event} change
+   * @returns {void}
+   */
 		treeCheck: function treeCheck(value, _ref) {
 			var _this7 = this;
 
@@ -684,31 +771,57 @@ var tree = __webpack_require__(46);
 			var arr = [];
 			arr = checkedNodes;
 			var idArr = arr.map(function (item) {
-				return item[_this7.defaultOptions.id];
+				return item[_this7.treeFieldMap.id];
 			});
 			this.$emit('change', this.multiple ? idArr : idArr[0], this.multiple ? arr : arr[0]);
 		},
+
+
+		/**
+   * 单选时点击节点回调：直接选中并关闭弹出层
+   * @param {Object} value - 当前点击的树节点对象
+   * @param {Object} node - 节点对象
+   * @param {Object} event - 点击事件对象
+   * @fires {Event} change
+   * @returns {void}
+   */
 		treeClick: function treeClick(value, node, event) {
 			if (this.multiple) return;
 
-			this.$emit('change', value.id, value);
+			this.$emit('change', value[this.treeFieldMap.id], value);
 			this.popoverOpen = false;
 		},
+
+
+		/**
+   * 清空选择：emit 空值并清空树勾选
+   * @fires {Event} change
+   * @returns {void}
+   */
 		handleClear: function handleClear() {
 			this.$emit('change', this.multiple ? [] : '', this.multiple ? [] : null);
 			this.$refs.tree.setCheckedKeys([]);
 		},
+
+
+		/**
+   * 将嵌套树数据拍平为一维数组，并补充父节点 id（pId）便于反查
+   * @param {Array} arr - 输出的一维数组（原地收集）
+   * @param {Array} data - 当前层级的树节点数组
+   * @param {number} pId - 父节点 id
+   * @returns {Array} 拍平后的一维节点数组
+   */
 		turnFormatTreeData: function turnFormatTreeData(arr, data, pId) {
 			var _this8 = this;
 
 			data.forEach(function (item) {
 				var cItem = JSON.parse(JSON.stringify(item));
-				delete cItem[_this8.defaultOptions.children];
+				delete cItem[_this8.treeFieldMap.children];
 				cItem.pId = pId;
 				arr.push(cItem);
 
-				if (item[_this8.defaultOptions.children] && item[_this8.defaultOptions.children].length > 0) {
-					_this8.turnFormatTreeData(arr, item[_this8.defaultOptions.children], item[_this8.defaultOptions.id]);
+				if (item[_this8.treeFieldMap.children] && item[_this8.treeFieldMap.children].length > 0) {
+					_this8.turnFormatTreeData(arr, item[_this8.treeFieldMap.children], item[_this8.treeFieldMap.id]);
 				}
 			});
 			return arr;