@weitutech/by-components 1.1.206 → 1.1.208

package/lib/by-components.umd.js

@@ -91070,8 +91070,8 @@ var ByCommonSelector_component = normalizeComponent(
 )
 
 /* harmony default export */ var ByCommonSelector = (ByCommonSelector_component.exports);
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-82.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/batch-query-selector/BatchQuerySelector.vue?vue&type=template&id=16c8bfda
-var BatchQuerySelectorvue_type_template_id_16c8bfda_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-82.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/batch-query-selector/BatchQuerySelector.vue?vue&type=template&id=6782df62
+var BatchQuerySelectorvue_type_template_id_6782df62_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -91111,24 +91111,32 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_render = function render() {
     return _c('el-option', {
       key: item[_vm.valueKey],
       class: {
-        'option-with-desc': _vm.hasDescContent(item)
+        'option-with-desc': _vm.hasDescContent(item),
+        'option-with-alias': _vm.hasAliasContent(item)
       },
       attrs: {
         "label": item[_vm.labelKey],
         "value": item[_vm.valueKey],
         "disabled": _vm.isOptionDisabled(item)
       }
-    }, [_vm.hasDescContent(item) ? [_c('span', {
+    }, [_vm.hasDescContent(item) || _vm.hasAliasContent(item) ? [_c('span', {
+      staticClass: "option-label-wrap"
+    }, [_c('span', {
       staticClass: "option-label",
       attrs: {
         "title": String(item[_vm.labelKey])
       }
-    }, [_vm._v(_vm._s(item[_vm.labelKey]))]), _c('span', {
+    }, [_vm._v(_vm._s(item[_vm.labelKey]))]), _vm.hasAliasContent(item) ? _c('span', {
+      staticClass: "option-alias",
+      attrs: {
+        "title": String(item[_vm.aliasKey])
+      }
+    }, [_vm._v(_vm._s(item[_vm.aliasKey]))]) : _vm._e()]), _vm.hasDescContent(item) ? _c('span', {
       staticClass: "option-desc",
       attrs: {
         "title": String(item[_vm.descKey])
       }
-    }, [_vm._v(_vm._s(item[_vm.descKey]))])] : _vm._e()], 2);
+    }, [_vm._v(_vm._s(item[_vm.descKey]))]) : _vm._e()] : _vm._e()], 2);
   }), _vm.hasMoreOptions ? _c('el-option', {
     staticClass: "load-more-option",
     attrs: {
@@ -91168,34 +91176,26 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_render = function render() {
     staticClass: "popover-title"
   }, [_vm._v("批量输入")]), _c('div', {
     staticClass: "input-type-selector"
-  }, [_c('el-radio', {
-    attrs: {
-      "label": 'id'
-    },
-    model: {
-      value: _vm.inputType,
-      callback: function ($$v) {
-        _vm.inputType = $$v;
-      },
-      expression: "inputType"
-    }
-  }, [_vm._v("ID")]), _c('el-radio', {
-    attrs: {
-      "label": 'name'
-    },
-    model: {
-      value: _vm.inputType,
-      callback: function ($$v) {
-        _vm.inputType = $$v;
+  }, _vm._l(_vm.effectiveBatchInputOptions, function (opt) {
+    return _c('el-radio', {
+      key: opt.value,
+      attrs: {
+        "label": opt.value
       },
-      expression: "inputType"
-    }
-  }, [_vm._v("名称")])], 1), _c('el-input', {
+      model: {
+        value: _vm.inputType,
+        callback: function ($$v) {
+          _vm.inputType = $$v;
+        },
+        expression: "inputType"
+      }
+    }, [_vm._v(_vm._s(opt.label))]);
+  }), 1), _c('el-input', {
     staticClass: "batch-input-textarea",
     attrs: {
       "type": "textarea",
       "rows": 10,
-      "placeholder": _vm.inputType === 'id' ? '请输入ID，多个ID用换行、逗号、分号、空格分隔' : '请输入名称，多个名称用换行、逗号、分号、空格分隔'
+      "placeholder": _vm.batchInputPlaceholder
     },
     model: {
       value: _vm.batchInputContent,
@@ -91242,7 +91242,7 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_render = function render() {
     }
   })])], 1) : _vm._e()], 1)]);
 };
-var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
+var BatchQuerySelectorvue_type_template_id_6782df62_staticRenderFns = [];
 
 ;// ./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib/index.js??clonedRuleSet-82.use[1]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/batch-query-selector/BatchQuerySelector.vue?vue&type=script&lang=js
 
@@ -91257,6 +91257,7 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
 
 
 
+
 /* harmony default export */ var BatchQuerySelectorvue_type_script_lang_js = ({
   name: 'BatchQuerySelector',
   props: {
@@ -91291,7 +91292,18 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
       default: 'name'
     },
     /**
-     * 描述字段名
+     * 别名字段名（拼接在名称后展示）
+     * 配置后，下拉选项会在名称（labelKey）右侧紧邻位置拼接展示该字段对应的内容；
+     * 仅影响下拉项的显示，不会改变 labelKey 字段本身、选中后 tag 的展示文本，
+     * 也不会影响批量输入按"名称"匹配的逻辑（仍以 labelKey 精确匹配）；
+     * 该字段默认不参与搜索匹配，如需让别名参与搜索，请将字段名同时加入 extraSearchKeys
+     */
+    aliasKey: {
+      type: String,
+      default: 'alias'
+    },
+    /**
+     * 描述字段名(显示在选项右侧)
      * 配置后，下拉选项会在名称右侧展示该字段对应的描述内容；
      * 该字段默认不参与搜索匹配，如需让描述参与搜索，请将字段名同时加入 extraSearchKeys
      */
@@ -91369,6 +91381,19 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
       type: Function,
       default: null
     },
+    /**
+     * 自定义批量输入项配置
+     * 数组结构：[{ label: '邮箱', field: 'email' }, { label: '工号', field: 'jobNumber' }]
+     * - 未配置（或空数组、全部不合法）时，保持默认行为不变：批量输入弹窗展示固定的「ID」「名称」两个选项；
+     * - 配置后，会用配置项替换默认的「ID」「名称」单选按钮，每一项展示 label，按对应 field 进行精确匹配（忽略大小写、忽略首尾空白），
+     *   匹配逻辑与原 ID/名称完全一致，只是参与匹配的字段由用户指定；
+     * - 若同时配置了 customMapFunction，customMapFunction 收到的第二个参数 inputType 将是当前选中项的 field 值；
+     *   默认场景下（未配置本属性）该参数仍为 'id' / 'name'，与既有用法完全兼容。
+     */
+    batchInputOptions: {
+      type: Array,
+      default: () => []
+    },
     // 每页加载数量
     pageSize: {
       type: Number,
@@ -91431,6 +91456,46 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
     searchFieldKeys() {
       const extras = Array.isArray(this.extraSearchKeys) ? this.extraSearchKeys.filter(k => typeof k === 'string' && k.trim() !== '') : [];
       return [...new Set([this.labelKey, this.valueKey, ...extras])];
+    },
+    /**
+     * 实际生效的批量输入项配置：
+     * - 当 batchInputOptions 提供了合法配置时，使用用户配置（value 即为 field 字段名）；
+     * - 否则回退为默认的「ID / 名称」两项，值仍为 'id' / 'name'，确保既有行为完全不变。
+     */
+    effectiveBatchInputOptions() {
+      const list = Array.isArray(this.batchInputOptions) ? this.batchInputOptions : [];
+      const normalized = list.filter(o => o && typeof o.field === 'string' && o.field.trim() !== '').map(o => ({
+        label: o.label != null && String(o.label).trim() !== '' ? String(o.label) : o.field,
+        value: o.field,
+        field: o.field
+      }));
+      if (normalized.length > 0) return normalized;
+      return [{
+        label: 'ID',
+        value: 'id',
+        field: this.valueKey
+      }, {
+        label: '名称',
+        value: 'name',
+        field: this.labelKey
+      }];
+    },
+    /** 当前选中的批量输入项对应的真实匹配字段 */
+    currentBatchInputField() {
+      const list = this.effectiveBatchInputOptions;
+      const found = list.find(o => o.value === this.inputType);
+      return found ? found.field : list[0] ? list[0].field : '';
+    },
+    /** 当前选中的批量输入项对应的展示文本（用于 placeholder） */
+    currentBatchInputLabel() {
+      const list = this.effectiveBatchInputOptions;
+      const found = list.find(o => o.value === this.inputType);
+      return found ? found.label : list[0] ? list[0].label : '';
+    },
+    /** 批量输入文本框 placeholder */
+    batchInputPlaceholder() {
+      const label = this.currentBatchInputLabel || '';
+      return `请输入${label}，多个${label}用换行、逗号、分号、空格分隔`;
     }
   },
   watch: {
@@ -91461,6 +91526,19 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
       } else {
         this.removeScrollListener();
       }
+    },
+    /**
+     * 当批量输入项配置变化（或首次解析完成）时，
+     * 若当前 inputType 已不在可选列表中，则回退到第一项，避免 radio 选中态丢失。
+     */
+    effectiveBatchInputOptions: {
+      handler(list) {
+        if (!Array.isArray(list) || list.length === 0) return;
+        if (!list.some(o => o.value === this.inputType)) {
+          this.inputType = list[0].value;
+        }
+      },
+      immediate: true
     }
   },
   created() {
@@ -91476,6 +91554,12 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
       const val = option[this.descKey];
       return val !== undefined && val !== null && String(val).trim() !== '';
     },
+    // 判断选项是否有可展示的别名内容（拼接在名称后）
+    hasAliasContent(option) {
+      if (!this.aliasKey) return false;
+      const val = option[this.aliasKey];
+      return val !== undefined && val !== null && String(val).trim() !== '';
+    },
     // 判断选项是否禁用
     isOptionDisabled(option) {
       // 如果提供了自定义禁用方法，则使用自定义方法判断
@@ -91689,8 +91773,10 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
         // 获取匹配的完整选项对象
         matchedItems = this.optionsList.filter(item => matchedValues.includes(item[this.valueKey]));
       } else {
-        // 默认映射逻辑：ID 和 名称 均采用精确匹配（忽略大小写、忽略首尾空白）
-        const searchKey = this.inputType === 'id' ? this.valueKey : this.labelKey;
+        // 默认映射逻辑：按当前选中的批量输入项对应的字段进行精确匹配（忽略大小写、忽略首尾空白）
+        // - 默认场景下 inputType 为 'id'/'name'，searchKey 解析为 valueKey/labelKey，行为与原先一致；
+        // - 配置了 batchInputOptions 时，searchKey 即为用户指定的 field 字段。
+        const searchKey = this.currentBatchInputField;
 
         // 从完整的 optionsList 中查找精确命中的项
         matchedItems = this.optionsList.filter(item => {
@@ -91774,8 +91860,8 @@ var BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns = [];
 ;
 var BatchQuerySelector_component = normalizeComponent(
   batch_query_selector_BatchQuerySelectorvue_type_script_lang_js,
-  BatchQuerySelectorvue_type_template_id_16c8bfda_render,
-  BatchQuerySelectorvue_type_template_id_16c8bfda_staticRenderFns,
+  BatchQuerySelectorvue_type_template_id_6782df62_render,
+  BatchQuerySelectorvue_type_template_id_6782df62_staticRenderFns,
   false,
   null,
   null,
@@ -97720,8 +97806,8 @@ var ByCardView_component = normalizeComponent(
 )
 
 /* harmony default export */ var ByCardView = (ByCardView_component.exports);
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-82.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/card-selector/ByCardSelector.vue?vue&type=template&id=0a667b47
-var ByCardSelectorvue_type_template_id_0a667b47_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-82.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/card-selector/ByCardSelector.vue?vue&type=template&id=43f85144
+var ByCardSelectorvue_type_template_id_43f85144_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -97730,12 +97816,12 @@ var ByCardSelectorvue_type_template_id_0a667b47_render = function render() {
       'is-disabled': _vm.disabled,
       'by-card-selector--no-check': !_vm.showCheckmark
     }],
-    style: _vm.directionStyle,
+    style: _vm.rootStyle,
     attrs: {
       "role": "listbox",
       "aria-multiselectable": _vm.multiple ? 'true' : 'false'
     }
-  }, _vm._l(_vm.options, function (item, index) {
+  }, [_vm._l(_vm.options, function (item, index) {
     return _c('div', {
       key: _vm.optionKey(item, index),
       staticClass: "by-card-selector__card",
@@ -97835,9 +97921,29 @@ var ByCardSelectorvue_type_template_id_0a667b47_render = function render() {
     }, [_vm.isSelected(item) ? _c('i', {
       staticClass: "el-icon-check by-card-selector__check-icon"
     }) : _vm._e()]) : _vm._e()])], 2);
-  }), 0);
+  }), _vm.hasGroupTooltip ? _c('div', {
+    staticClass: "by-card-selector__suffix",
+    attrs: {
+      "role": "note"
+    }
+  }, [_c('el-tooltip', {
+    attrs: {
+      "content": _vm.groupTooltipText,
+      "placement": "top",
+      "open-delay": 300
+    }
+  }, [_c('span', {
+    staticClass: "by-card-selector__suffix-trigger",
+    on: {
+      "click": function ($event) {
+        $event.stopPropagation();
+      }
+    }
+  }, [_c('i', {
+    staticClass: "el-icon-question"
+  })])])], 1) : _vm._e()], 2);
 };
-var ByCardSelectorvue_type_template_id_0a667b47_staticRenderFns = [];
+var ByCardSelectorvue_type_template_id_43f85144_staticRenderFns = [];
 
 ;// ./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib/index.js??clonedRuleSet-82.use[1]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/card-selector/ByCardSelector.vue?vue&type=script&lang=js
 
@@ -97860,6 +97966,9 @@ const DEFAULT_OPTION_PROPS = () => ({
  * @example
  * <by-card-selector v-model="id" :options="list" />
  * <by-card-selector v-model="ids" :options="list" multiple />
+ * <by-card-selector v-model="id" :options="list" :card-width="280" />
+ * <by-card-selector v-model="id" :options="list" :show-checkmark="true" />
+ * <by-card-selector v-model="id" :options="list" tooltips="整组说明文案" />
  */
 /* harmony default export */ var ByCardSelectorvue_type_script_lang_js = ({
   name: 'ByCardSelector',
@@ -97889,12 +97998,20 @@ const DEFAULT_OPTION_PROPS = () => ({
       type: String,
       default: '320px'
     },
-    /** 卡片尺寸 */
+    /** 卡片尺寸（内边距、图标与字号等）；卡片列宽默认由 size 与样式表决定 */
     size: {
       type: String,
       default: 'default',
       validator: v => ['large', 'default', 'small'].includes(v)
     },
+    /**
+     * 每张卡片宽度（像素，组件级统一）。未设置时列宽由 size 对应样式决定。
+     * 合法范围 100–600，小于 100 按 100、大于 600 按 600；可传数字或字符串（如 240、"320px"）。
+     */
+    cardWidth: {
+      type: [Number, String],
+      default: null
+    },
     /** 整组禁用 */
     disabled: {
       type: Boolean,
@@ -97920,10 +98037,18 @@ const DEFAULT_OPTION_PROPS = () => ({
       type: Number,
       default: 3
     },
-    /** 是否在卡片右侧展示圆形打钩选中指示，默认展示 */
+    /**
+     * 组件级说明：有内容时在所有选项之后展示问号，悬停显示提示（与单项内的 tooltip 字段无关）。
+     * 支持字符串或数字；仅空白则整组不展示该问号。
+     */
+    tooltips: {
+      type: [String, Number],
+      default: ''
+    },
+    /** 是否在卡片右侧展示圆形打钩选中指示，默认不展示 */
     showCheckmark: {
       type: Boolean,
-      default: true
+      default: false
     }
   },
   data() {
@@ -97941,17 +98066,51 @@ const DEFAULT_OPTION_PROPS = () => ({
     keyField() {
       return this.optionKeyField || this.mergedOptionProps.value;
     },
-    directionStyle() {
-      if (this.direction !== 'vertical') return {};
-      return {
-        maxHeight: this.verticalMaxHeight
-      };
+    /** 解析后的卡片宽度（px），无效或未传时为 null */
+    resolvedCardWidthPx() {
+      const raw = this.cardWidth;
+      if (raw == null || raw === '') return null;
+      let n;
+      if (typeof raw === 'number' && Number.isFinite(raw)) {
+        n = raw;
+      } else if (typeof raw === 'string') {
+        const s = String(raw).trim().replace(/px$/i, '');
+        n = parseFloat(s);
+      } else {
+        return null;
+      }
+      if (!Number.isFinite(n)) return null;
+      const MIN = 100;
+      const MAX = 600;
+      return Math.min(MAX, Math.max(MIN, Math.round(n)));
+    },
+    /** 根节点样式：纵向高度 + 可选自定义卡片宽度（CSS 变量） */
+    rootStyle() {
+      const style = {};
+      if (this.direction === 'vertical') {
+        style.maxHeight = this.verticalMaxHeight;
+      }
+      if (this.resolvedCardWidthPx != null) {
+        style['--by-card-selector-min'] = `${this.resolvedCardWidthPx}px`;
+      }
+      return style;
     },
     hasCardSlot() {
       return Boolean(this.$scopedSlots && this.$scopedSlots.card || this.$slots && this.$slots.card);
     },
     hasIconSlot() {
       return Boolean(this.$scopedSlots && this.$scopedSlots.icon || this.$slots && this.$slots.icon);
+    },
+    /** 是否展示组件级尾部问号 */
+    hasGroupTooltip() {
+      const t = this.tooltips;
+      if (t == null || t === '') return false;
+      return String(t).trim().length > 0;
+    },
+    /** 传给 el-tooltip 的纯文本 */
+    groupTooltipText() {
+      if (!this.hasGroupTooltip) return '';
+      return String(this.tooltips).trim();
     }
   },
   watch: {
@@ -98140,8 +98299,8 @@ const DEFAULT_OPTION_PROPS = () => ({
 ;
 var ByCardSelector_component = normalizeComponent(
   card_selector_ByCardSelectorvue_type_script_lang_js,
-  ByCardSelectorvue_type_template_id_0a667b47_render,
-  ByCardSelectorvue_type_template_id_0a667b47_staticRenderFns,
+  ByCardSelectorvue_type_template_id_43f85144_render,
+  ByCardSelectorvue_type_template_id_43f85144_staticRenderFns,
   false,
   null,
   null,