@weitutech/by-components 1.2.31 → 1.2.33

package/lib/by-components.common.js

@@ -78969,8 +78969,8 @@ var pair_number_input_component = normalizeComponent(
 )
 
 /* harmony default export */ var pair_number_input = (pair_number_input_component.exports);
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/form/comps/custom-date-picker.vue?vue&type=template&id=78d80522
-var custom_date_pickervue_type_template_id_78d80522_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/form/comps/custom-date-picker.vue?vue&type=template&id=9d8d406a
+var custom_date_pickervue_type_template_id_9d8d406a_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -79040,7 +79040,7 @@ var custom_date_pickervue_type_template_id_78d80522_render = function render() {
     }, [_vm._v(" " + _vm._s(char) + " ")]);
   }) : [_vm._v(_vm._s(_vm.activeShortcutLabel))]], 2) : _vm._e()], 1)], 2);
 };
-var custom_date_pickervue_type_template_id_78d80522_staticRenderFns = [];
+var custom_date_pickervue_type_template_id_9d8d406a_staticRenderFns = [];
 
 // EXTERNAL MODULE: ./node_modules/moment/moment.js
 var moment = __webpack_require__(9412);
@@ -79051,6 +79051,17 @@ var moment_default = /*#__PURE__*/__webpack_require__.n(moment);
 
 
 
+const DEFAULT_FORMAT_BY_TYPE = {
+  daterange: 'YYYY-MM-DD',
+  datetimerange: 'YYYY-MM-DD HH:mm:ss',
+  monthrange: 'YYYY-MM',
+  date: 'YYYY-MM-DD',
+  datetime: 'YYYY-MM-DD HH:mm:ss',
+  month: 'YYYY-MM',
+  year: 'YYYY',
+  week: 'YYYY-MM-DD'
+};
+const FORM_FIELD_TYPE = 'customDatePicker';
 /* harmony default export */ var custom_date_pickervue_type_script_lang_js = ({
   name: 'ByCustomDatePicker',
   props: {
@@ -79078,6 +79089,23 @@ var moment_default = /*#__PURE__*/__webpack_require__.n(moment);
       type: String,
       default: ''
     },
+    /**
+     * 日期选择器类型（透传 el-date-picker 的 type）
+     * 默认 daterange；常见：daterange / datetimerange / monthrange
+     * 注意：Form 配置里字段 type 固定为 customDatePicker，请用本属性或 otherOption.type 指定面板类型
+     */
+    pickerType: {
+      type: String,
+      default: ''
+    },
+    /**
+     * 绑定值格式（moment 格式，也兼容 Element 的 yyyy/dd 写法）
+     * 不传时按 pickerType 自动推断，如 daterange → YYYY-MM-DD
+     */
+    valueFormat: {
+      type: String,
+      default: ''
+    },
     /**
      * 快捷按钮展示方式
      * external: 快捷按钮在输入框右侧（默认，保持原有样式）
@@ -79098,43 +79126,81 @@ var moment_default = /*#__PURE__*/__webpack_require__.n(moment);
     };
   },
   computed: {
+    /** 实际生效的面板类型 */
+    resolvedPickerType() {
+      const fromProp = this.normalizePickerType(this.pickerType);
+      if (fromProp) return fromProp;
+      const fromOther = this.normalizePickerType(this.otherOption && this.otherOption.type);
+      if (fromOther) return fromOther;
+      return 'daterange';
+    },
+    /** 实际生效的输出格式（moment） */
+    resolvedValueFormat() {
+      const raw = this.valueFormat || this.otherOption && this.otherOption.valueFormat || DEFAULT_FORMAT_BY_TYPE[this.resolvedPickerType] || 'YYYY-MM-DD';
+      return this.toMomentDateFormat(raw);
+    },
+    /** 是否包含时分秒（用于快捷项起止时刻） */
+    includesTime() {
+      return /H{1,2}|m{1,2}|s{1,2}/.test(this.resolvedValueFormat);
+    },
     shortcuts() {
+      const fmt = this.resolvedValueFormat;
+      const rangeOfDay = dayMoment => ({
+        start_time: dayMoment.clone().startOf('day').format(fmt),
+        end_time: this.includesTime ? dayMoment.clone().endOf('day').format(fmt) : dayMoment.clone().startOf('day').format(fmt)
+      });
+      const yesterday = rangeOfDay(moment_default()().subtract(1, 'days'));
+      const today = rangeOfDay(moment_default()());
       return [{
         label: '上月',
-        start_time: moment_default()().subtract(1, 'months').startOf('month').format('YYYY-MM-DD'),
-        end_time: moment_default()().subtract(1, 'months').endOf('month').format('YYYY-MM-DD'),
+        start_time: moment_default()().subtract(1, 'months').startOf('month').format(fmt),
+        end_time: moment_default()().subtract(1, 'months').endOf('month').format(fmt),
         key: 'last_month'
       }, {
         label: '昨天',
-        start_time: moment_default()().subtract(1, 'days').format('YYYY-MM-DD'),
-        end_time: moment_default()().subtract(1, 'days').format('YYYY-MM-DD'),
+        start_time: yesterday.start_time,
+        end_time: yesterday.end_time,
         key: 'yesterday'
       }, {
         label: '今天',
-        start_time: moment_default()().startOf('day').format('YYYY-MM-DD'),
-        end_time: moment_default()().startOf('day').format('YYYY-MM-DD'),
+        start_time: today.start_time,
+        end_time: today.end_time,
         key: 'today'
       }, {
         label: '本周',
-        start_time: moment_default()().startOf('isoWeek').format('YYYY-MM-DD'),
-        end_time: moment_default()().endOf('isoWeek').format('YYYY-MM-DD'),
+        start_time: moment_default()().startOf('isoWeek').format(fmt),
+        end_time: moment_default()().endOf('isoWeek').format(fmt),
         key: 'week'
       }, {
         label: '本月',
-        start_time: moment_default()().startOf('month').format('YYYY-MM-DD'),
-        end_time: moment_default()().endOf('month').format('YYYY-MM-DD'),
+        start_time: moment_default()().startOf('month').format(fmt),
+        end_time: moment_default()().endOf('month').format(fmt),
         key: 'month'
       }];
     },
     dateOptions() {
+      const {
+        type: _type,
+        valueFormat: _valueFormat,
+        format: userFormat,
+        ...restOther
+      } = this.otherOption || {};
+      const pickerType = this.resolvedPickerType;
+      const elementFormat = this.toElementDateFormat(this.resolvedValueFormat);
+      const needDefaultTime = pickerType === 'datetimerange' || pickerType === 'datetime';
       return {
         startPlaceholder: '开始时间',
         endPlaceholder: '结束时间',
-        type: 'daterange',
         rangeSeparator: '至',
         size: 'mini',
         active: '',
-        ...this.otherOption
+        format: userFormat || elementFormat,
+        ...(needDefaultTime ? {
+          defaultTime: ['00:00:00', '23:59:59']
+        } : {}),
+        ...restOther,
+        // 最终以解析后的 pickerType 为准，避免 Form 的 type=customDatePicker 或旧配置干扰
+        type: pickerType
       };
     },
     panelDateOptions() {
@@ -79199,10 +79265,25 @@ var moment_default = /*#__PURE__*/__webpack_require__.n(moment);
     this.destroyShortcutTagObserver();
   },
   methods: {
+    normalizePickerType(type) {
+      if (!type || type === FORM_FIELD_TYPE) return '';
+      return type;
+    },
+    /** Element 格式(yyyy/dd) → moment 格式(YYYY/DD) */
+    toMomentDateFormat(fmt) {
+      return String(fmt).replace(/yyyy/g, 'YYYY').replace(/dd/g, 'DD');
+    },
+    /** moment 格式 → Element 展示格式 */
+    toElementDateFormat(fmt) {
+      return String(fmt).replace(/YYYY/g, 'yyyy').replace(/DD/g, 'dd');
+    },
+    formatMomentValue(val) {
+      return moment_default()(val).format(this.resolvedValueFormat);
+    },
     syncActiveFromValue(newValue) {
       if (Array.isArray(newValue) && newValue.length) {
-        const start = moment_default()(newValue[0]).format('YYYY-MM-DD');
-        const end = moment_default()(newValue[1]).format('YYYY-MM-DD');
+        const start = this.formatMomentValue(newValue[0]);
+        const end = this.formatMomentValue(newValue[1]);
         let matchedKey = '';
         this.shortcuts.forEach(item => {
           if (item.start_time === start && item.end_time === end) {
@@ -79229,12 +79310,13 @@ var moment_default = /*#__PURE__*/__webpack_require__.n(moment);
           });
         }
       } else {
-        const formattedDates = e.map(item => moment_default()(item).format('YYYY-MM-DD'));
+        const list = Array.isArray(e) ? e : [e];
+        const formattedDates = list.map(item => this.formatMomentValue(item));
         this.$emit('input', formattedDates);
         if (this.startTimeField && this.endTimeField) {
           this.$emit('range-change', {
-            startTime: formattedDates[0],
-            endTime: formattedDates[1]
+            startTime: formattedDates[0] || '',
+            endTime: formattedDates[1] || ''
           });
         }
 
@@ -79344,8 +79426,8 @@ var moment_default = /*#__PURE__*/__webpack_require__.n(moment);
 ;
 var custom_date_picker_component = normalizeComponent(
   comps_custom_date_pickervue_type_script_lang_js,
-  custom_date_pickervue_type_template_id_78d80522_render,
-  custom_date_pickervue_type_template_id_78d80522_staticRenderFns,
+  custom_date_pickervue_type_template_id_9d8d406a_render,
+  custom_date_pickervue_type_template_id_9d8d406a_staticRenderFns,
   false,
   null,
   null,
@@ -94686,8 +94768,8 @@ ByDialogService.install = function (Vue) {
   Vue.prototype.$byDialog = ByDialogService;
 };
 /* harmony default export */ var by_dialog_ByDialogService = (ByDialogService);
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/cascader-panel/ByCascaderPanel.vue?vue&type=template&id=727f392c
-var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/cascader-panel/ByCascaderPanel.vue?vue&type=template&id=3691e51e
+var ByCascaderPanelvue_type_template_id_3691e51e_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -94706,7 +94788,10 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
   }, [_vm._v("可选(" + _vm._s(_vm.selectedCount) + "/" + _vm._s(_vm.totalCount) + ")")]) : _vm._e(), _c('div', {
     staticClass: "search-section"
   }, [_c('div', {
-    staticClass: "search-container"
+    staticClass: "search-container",
+    class: {
+      'has-dropdown-filter': _vm.showDropdownFilter
+    }
   }, [_c('div', {
     staticClass: "search-input-wrap",
     class: {
@@ -94805,7 +94890,37 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
     slot: "reference"
   }, [_c('i', {
     staticClass: "el-icon-edit-outline"
-  })])], 1)], 1) : _vm._e()], 1), _vm.showRefreshBtn ? _c('el-tooltip', {
+  })])], 1)], 1) : _vm._e()], 1), _vm.showDropdownFilter ? _c('div', {
+    staticClass: "dropdown-filter-group"
+  }, [_vm.dropdownFilterTitle ? _c('span', {
+    staticClass: "dropdown-filter-title"
+  }, [_vm._v(_vm._s(_vm.dropdownFilterTitle) + "：")]) : _vm._e(), _c('el-select', {
+    staticClass: "dropdown-filter-select",
+    attrs: {
+      "placeholder": _vm.dropdownFilterPlaceholder,
+      "clearable": "",
+      "size": "mini",
+      "disabled": _vm.panelViewMode
+    },
+    on: {
+      "change": _vm.handleDropdownFilterChange
+    },
+    model: {
+      value: _vm.dropdownFilterValue,
+      callback: function ($$v) {
+        _vm.dropdownFilterValue = $$v;
+      },
+      expression: "dropdownFilterValue"
+    }
+  }, _vm._l(_vm.normalizedDropdownFilterOptions, function (opt) {
+    return _c('el-option', {
+      key: 'df-' + opt.value,
+      attrs: {
+        "label": opt.label,
+        "value": opt.value
+      }
+    });
+  }), 1)], 1) : _vm._e(), _vm.showRefreshBtn ? _c('el-tooltip', {
     attrs: {
       "content": _vm.refreshTooltip,
       "placement": "top",
@@ -94847,8 +94962,8 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
     directives: [{
       name: "show",
       rawName: "v-show",
-      value: _vm.searchInput === '' || !_vm.isShowSearch,
-      expression: "searchInput === '' || !isShowSearch"
+      value: !_vm.isFilterView,
+      expression: "!isFilterView"
     }],
     ref: "cascaderPanel",
     staticClass: "cascader-panel-inner",
@@ -94864,6 +94979,17 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
       "expand-change": _vm.handleExpandChange,
       "change": _vm.handleValueChange
     },
+    scopedSlots: _vm._u([{
+      key: "default",
+      fn: function ({
+        node,
+        data
+      }) {
+        return [_vm._v(" " + _vm._s(node.label)), _vm.showDropdownFilter && _vm.getNodeFilterFieldText(data) ? _c('span', {
+          staticClass: "node-filter-field"
+        }, [_vm._v(_vm._s(_vm.getNodeFilterFieldText(data)))]) : _vm._e()];
+      }
+    }], null, false, 181072543),
     model: {
       value: _vm.mainPanelValue,
       callback: function ($$v) {
@@ -94871,12 +94997,12 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
       },
       expression: "mainPanelValue"
     }
-  }) : _vm._e(), _vm.searchOptions.length > 0 ? _c('el-cascader-panel', {
+  }) : _vm._e(), _vm.viewOptions.length > 0 ? _c('el-cascader-panel', {
     directives: [{
       name: "show",
       rawName: "v-show",
-      value: _vm.searchInput !== '' && _vm.isShowSearch,
-      expression: "searchInput !== '' && isShowSearch"
+      value: _vm.isFilterView,
+      expression: "isFilterView"
     }],
     ref: "searchCascaderPanel",
     staticClass: "cascader-panel-inner",
@@ -94885,13 +95011,24 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
     },
     attrs: {
       "append-to-body": false,
-      "options": _vm.searchOptions,
+      "options": _vm.viewOptions,
       "props": _vm.cascaderProps
     },
     on: {
       "expand-change": _vm.handleExpandChange,
       "change": _vm.handleSearchValueChange
     },
+    scopedSlots: _vm._u([{
+      key: "default",
+      fn: function ({
+        node,
+        data
+      }) {
+        return [_vm._v(" " + _vm._s(node.label)), _vm.showDropdownFilter && _vm.getNodeFilterFieldText(data) ? _c('span', {
+          staticClass: "node-filter-field"
+        }, [_vm._v(_vm._s(_vm.getNodeFilterFieldText(data)))]) : _vm._e()];
+      }
+    }], null, false, 181072543),
     model: {
       value: _vm.searchPanelValue,
       callback: function ($$v) {
@@ -94899,13 +95036,7 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
       },
       expression: "searchPanelValue"
     }
-  }) : _vm._e(), _vm.isShowSearch && _vm.searchOptions.length === 0 ? _c('div', {
-    directives: [{
-      name: "show",
-      rawName: "v-show",
-      value: _vm.searchInput !== '',
-      expression: "searchInput !== ''"
-    }],
+  }) : _vm._e(), _vm.isFilterView && _vm.viewOptions.length === 0 ? _c('div', {
     staticClass: "empty-search"
   }, [_c('el-empty', {
     attrs: {
@@ -94987,7 +95118,7 @@ var ByCascaderPanelvue_type_template_id_727f392c_render = function render() {
     staticClass: "empty-state"
   }, [_vm._v("暂无选中项")]) : _vm._e()], 2)])])])]);
 };
-var ByCascaderPanelvue_type_template_id_727f392c_staticRenderFns = [];
+var ByCascaderPanelvue_type_template_id_3691e51e_staticRenderFns = [];
 
 ;// ./src/utils/cascaderUtils.js
 
@@ -95159,6 +95290,58 @@ class CascaderUtils {
     return result;
   }
 
+  /**
+   * 判断节点指定字段是否匹配下拉筛选值
+   * @param {Object} node
+   * @param {String} field
+   * @param {*} filterValue
+   * @returns {Boolean}
+   */
+  static isFilterFieldMatched(node, field, filterValue) {
+    if (!node || !field || filterValue === null || filterValue === undefined || filterValue === '') {
+      return false;
+    }
+    const raw = node[field];
+    if (raw === null || raw === undefined || raw === '') {
+      return false;
+    }
+    return String(raw).trim() === String(filterValue).trim();
+  }
+
+  /**
+   * 按数据字段过滤树：保留字段匹配的节点及其祖先路径
+   * @param {Array} tree - 树形数据
+   * @param {String} field - 数据中用于筛选的字段名
+   * @param {*} filterValue - 下拉选中值
+   * @param {Object} cascaderProps - 级联配置
+   * @returns {Array} 过滤后的树
+   */
+  static filterTreeByField(tree, field, filterValue, cascaderProps) {
+    if (!Array.isArray(tree) || !field || filterValue === null || filterValue === undefined || filterValue === '') {
+      return tree || [];
+    }
+    const childrenKey = cascaderProps && cascaderProps.children || 'children';
+    const result = [];
+    tree.forEach(node => {
+      const children = node[childrenKey];
+      const hasChildren = Array.isArray(children) && children.length > 0;
+      if (hasChildren) {
+        const matchedChildren = this.filterTreeByField(children, field, filterValue, cascaderProps);
+        if (matchedChildren.length > 0) {
+          result.push({
+            ...node,
+            [childrenKey]: matchedChildren
+          });
+        }
+      } else if (this.isFilterFieldMatched(node, field, filterValue)) {
+        result.push({
+          ...node
+        });
+      }
+    });
+    return result;
+  }
+
   /**
    * 获取叶子节点的值
    * @param {Array} tree - 树形数据
@@ -95610,6 +95793,13 @@ class CascaderUtils {
 
 
 
+
+
+
+
+
+
+
 /* harmony default export */ var ByCascaderPanelvue_type_script_lang_js = ({
   name: 'ByCascaderPanel',
   props: {
@@ -95724,6 +95914,15 @@ class CascaderUtils {
     refreshing: {
       type: Boolean,
       default: false
+    },
+    /**
+     * 下拉筛选配置。外部传入且 enabled 不为 false、并指定 field 时才展示下拉框。
+     * { enabled, title, placeholder, options: [{ label, value }], field }
+     * field 为数据中用于过滤和展示的字段名。
+     */
+    dropdownFilter: {
+      type: Object,
+      default: null
     }
   },
   data() {
@@ -95743,7 +95942,9 @@ class CascaderUtils {
       // 防止循环更新的标志
       batchSearchVisible: false,
       // 批量搜索弹窗显示状态
-      batchSearchContent: '' // 批量搜索输入内容
+      batchSearchContent: '',
+      // 批量搜索输入内容
+      dropdownFilterValue: '' // 下拉筛选当前值，未开启时不使用
     };
   },
   computed: {
@@ -95816,6 +96017,61 @@ class CascaderUtils {
           this.searchSelectedValues = value ? [value] : [];
         }
       }
+    },
+    // 是否展示下拉筛选（外部有配置且指定了数据字段才展示）
+    showDropdownFilter() {
+      const cfg = this.dropdownFilter;
+      return !!(cfg && typeof cfg === 'object' && cfg.enabled !== false && cfg.field);
+    },
+    dropdownFilterPlaceholder() {
+      return this.dropdownFilter && this.dropdownFilter.placeholder || '请选择';
+    },
+    dropdownFilterTitle() {
+      const title = this.dropdownFilter && this.dropdownFilter.title;
+      return title != null && String(title).trim() !== '' ? String(title).trim() : '';
+    },
+    dropdownFilterField() {
+      return this.dropdownFilter && this.dropdownFilter.field || '';
+    },
+    normalizedDropdownFilterOptions() {
+      const opts = this.dropdownFilter && this.dropdownFilter.options || [];
+      return opts.map(opt => {
+        if (opt != null && typeof opt === 'object') {
+          return {
+            label: opt.label != null ? opt.label : opt.value,
+            value: opt.value != null ? opt.value : opt.label
+          };
+        }
+        return {
+          label: String(opt),
+          value: opt
+        };
+      });
+    },
+    hasActiveDropdownFilter() {
+      return this.showDropdownFilter && this.dropdownFilterValue !== '' && this.dropdownFilterValue !== null && this.dropdownFilterValue !== undefined;
+    },
+    // 下拉筛选后的展示树；未筛选时等于完整 processed 树，保证原有逻辑不变
+    displayOptions() {
+      if (!this.hasActiveDropdownFilter) {
+        return this.filteredOptions;
+      }
+      return CascaderUtils.filterTreeByField(this.filteredOptions, this.dropdownFilterField, this.dropdownFilterValue, this.cascaderProps);
+    },
+    isFilterView() {
+      if (this.searchInput !== '' && this.isShowSearch) {
+        return true;
+      }
+      return this.hasActiveDropdownFilter;
+    },
+    viewOptions() {
+      if (this.searchInput !== '' && this.isShowSearch) {
+        return this.searchOptions;
+      }
+      if (this.hasActiveDropdownFilter) {
+        return this.displayOptions;
+      }
+      return [];
     }
   },
   watch: {
@@ -95855,6 +96111,9 @@ class CascaderUtils {
             // 普通模式下的全选判断
             this.isAllSelected = this.selectedCount === this.totalCount;
           }
+          if (this.hasActiveDropdownFilter) {
+            this.updateFilterAllSelectedState();
+          }
         } else {
           // 单选模式：最多只能有一个选中项
           if (newVal.length > 1) {
@@ -95871,6 +96130,11 @@ class CascaderUtils {
       if (val) {
         this.batchSearchVisible = false;
       }
+    },
+    showDropdownFilter(val) {
+      if (!val) {
+        this.dropdownFilterValue = '';
+      }
     }
   },
   mounted() {
@@ -95942,6 +96206,11 @@ class CascaderUtils {
       this.filteredOptions = this.processOptions(this.options);
       this.countTotalItems();
       this.updateSelectedItems();
+      if (this.searchInput) {
+        this.handleSearch();
+      } else if (this.hasActiveDropdownFilter) {
+        this.syncFilterViewSelection();
+      }
     },
     // 处理选项数据，添加禁用状态
     processOptions(options) {
@@ -96030,10 +96299,14 @@ class CascaderUtils {
       this.searchInput = this.searchInput.trim();
       if (this.searchInput === '') {
         this.isShowSearch = false;
+        this.searchOptions = [];
+        if (this.hasActiveDropdownFilter) {
+          this.syncFilterViewSelection();
+        }
         return;
       }
       this.isShowSearch = false;
-      this.searchOptions = CascaderUtils.searchInTree(this.filteredOptions, this.searchInput, this.cascaderProps);
+      this.searchOptions = CascaderUtils.searchInTree(this.displayOptions, this.searchInput, this.cascaderProps);
 
       // 只设置搜索范围内的选中值
       this.searchSelectedValues = CascaderUtils.getSearchSelectedValues(this.selectedValues, this.searchOptions, this.cascaderProps);
@@ -96070,7 +96343,7 @@ class CascaderUtils {
     handleExpandChange(values = []) {
       if (values.length === 1) {
         this.$nextTick(() => {
-          const panel = this.$refs.cascaderPanel || this.$refs.searchCascaderPanel;
+          const panel = this.isFilterView ? this.$refs.searchCascaderPanel || this.$refs.cascaderPanel : this.$refs.cascaderPanel || this.$refs.searchCascaderPanel;
           if (panel) {
             const menus = panel.menus;
             const targetNode = menus[0].find(node => node.value == values[0]);
@@ -96110,15 +96383,15 @@ class CascaderUtils {
         this.$emit('input', emitValue);
       });
     },
-    // 搜索模式值变化处理
+    // 搜索 / 下拉筛选视图值变化处理
     handleSearchValueChange(value) {
-      // 获取搜索面板中所有可能的叶子节点值
-      const searchLeafValues = CascaderUtils.getLeafValues(this.searchOptions, this.cascaderProps);
+      // 获取当前筛选/搜索视图中所有可能的叶子节点值
+      const viewLeafValues = CascaderUtils.getLeafValues(this.viewOptions, this.cascaderProps);
       if (this.isMultiple) {
-        // 多选模式：从主选择列表中移除搜索范围内的项，然后添加搜索面板中选中的项
+        // 多选模式：从主选择列表中移除视图范围内的项，然后添加视图中选中的项
         this.selectedValues = this.selectedValues.filter(path => {
           const leafValue = path[path.length - 1];
-          return !searchLeafValues.includes(leafValue);
+          return !viewLeafValues.includes(leafValue);
         });
         this.selectedValues = [...this.selectedValues, ...this.searchSelectedValues];
       } else {
@@ -96188,15 +96461,26 @@ class CascaderUtils {
         // 单选模式下不支持全选
         return;
       }
-      if (this.isAllSelected) {
+      const config = {
+        disabledField: this.disabledField,
+        disabledValue: this.disabledValue,
+        disabledCheck: this.disabledCheck
+      };
+      if (this.hasActiveDropdownFilter) {
+        const viewPaths = CascaderUtils.getAllLeafPaths(this.displayOptions, config, this.cascaderProps);
+        const viewLeafSet = new Set(viewPaths.map(path => path[path.length - 1]));
+        if (this.isAllSelected) {
+          this.selectedValues = this.selectedValues.filter(path => !viewLeafSet.has(path[path.length - 1]));
+        } else {
+          const preserved = this.selectedValues.filter(path => !viewLeafSet.has(path[path.length - 1]));
+          this.selectedValues = [...preserved, ...viewPaths];
+        }
+        this.searchSelectedValues = CascaderUtils.getSearchSelectedValues(this.selectedValues, this.viewOptions, this.cascaderProps);
+        this.updateSelectedItems();
+      } else if (this.isAllSelected) {
         this.selectedValues = [];
         this.selectedItems = [];
       } else {
-        const config = {
-          disabledField: this.disabledField,
-          disabledValue: this.disabledValue,
-          disabledCheck: this.disabledCheck
-        };
         // 无论是普通模式还是聚合模式，全选时都选择所有可选的叶子节点
         this.selectedValues = CascaderUtils.getAllLeafPaths(this.filteredOptions, config, this.cascaderProps);
         this.updateSelectedItems();
@@ -96349,6 +96633,54 @@ class CascaderUtils {
       }
       this.$emit('refresh');
     },
+    getNodeFilterFieldText(data) {
+      if (!this.showDropdownFilter || !this.dropdownFilterField || !data) {
+        return '';
+      }
+      const val = data[this.dropdownFilterField];
+      if (val === null || val === undefined || val === '') {
+        return '';
+      }
+      return `(${val})`;
+    },
+    updateFilterAllSelectedState() {
+      if (!this.hasActiveDropdownFilter) {
+        return;
+      }
+      const config = {
+        disabledField: this.disabledField,
+        disabledValue: this.disabledValue,
+        disabledCheck: this.disabledCheck
+      };
+      const viewPaths = CascaderUtils.getAllLeafPaths(this.displayOptions, config, this.cascaderProps);
+      if (viewPaths.length === 0) {
+        this.isAllSelected = false;
+        return;
+      }
+      const selectedLeafSet = new Set(this.selectedValues.map(path => path[path.length - 1]));
+      this.isAllSelected = viewPaths.every(path => selectedLeafSet.has(path[path.length - 1]));
+    },
+    syncFilterViewSelection() {
+      this.searchSelectedValues = CascaderUtils.getSearchSelectedValues(this.selectedValues, this.viewOptions, this.cascaderProps);
+      this.$nextTick(() => {
+        if (this.viewOptions.length > 0) {
+          this.handleSearchExpand();
+        }
+      });
+    },
+    handleDropdownFilterChange() {
+      if (this.searchInput) {
+        this.handleSearch();
+        return;
+      }
+      this.isShowSearch = false;
+      this.searchOptions = [];
+      if (this.hasActiveDropdownFilter) {
+        this.syncFilterViewSelection();
+      } else {
+        this.searchSelectedValues = [];
+      }
+    },
     // 处理批量搜索
     handleBatchSearch() {
       if (!this.batchSearchContent.trim()) {
@@ -96471,8 +96803,8 @@ class CascaderUtils {
 ;
 var ByCascaderPanel_component = normalizeComponent(
   cascader_panel_ByCascaderPanelvue_type_script_lang_js,
-  ByCascaderPanelvue_type_template_id_727f392c_render,
-  ByCascaderPanelvue_type_template_id_727f392c_staticRenderFns,
+  ByCascaderPanelvue_type_template_id_3691e51e_render,
+  ByCascaderPanelvue_type_template_id_3691e51e_staticRenderFns,
   false,
   null,
   null,
@@ -96481,8 +96813,8 @@ var ByCascaderPanel_component = normalizeComponent(
 )
 
 /* harmony default export */ var ByCascaderPanel = (ByCascaderPanel_component.exports);
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/cascader-panel-pro/ByCascaderPanelPro.vue?vue&type=template&id=961f637e
-var ByCascaderPanelProvue_type_template_id_961f637e_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/cascader-panel-pro/ByCascaderPanelPro.vue?vue&type=template&id=21ca97ff
+var ByCascaderPanelProvue_type_template_id_21ca97ff_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -96501,7 +96833,10 @@ var ByCascaderPanelProvue_type_template_id_961f637e_render = function render() {
   }, [_vm._v("可选(" + _vm._s(_vm.selectedCount) + "/" + _vm._s(_vm.totalCount) + ")")]) : _vm._e(), _c('div', {
     staticClass: "search-section"
   }, [_c('div', {
-    staticClass: "search-container"
+    staticClass: "search-container",
+    class: {
+      'has-dropdown-filter': _vm.showDropdownFilter
+    }
   }, [_c('div', {
     staticClass: "search-input-wrap",
     class: {
@@ -96597,7 +96932,37 @@ var ByCascaderPanelProvue_type_template_id_961f637e_render = function render() {
     slot: "reference"
   }, [_c('i', {
     staticClass: "el-icon-edit-outline"
-  })])], 1)], 1) : _vm._e()], 1), _vm.showRefreshBtn ? _c('el-tooltip', {
+  })])], 1)], 1) : _vm._e()], 1), _vm.showDropdownFilter ? _c('div', {
+    staticClass: "dropdown-filter-group"
+  }, [_vm.dropdownFilterTitle ? _c('span', {
+    staticClass: "dropdown-filter-title"
+  }, [_vm._v(_vm._s(_vm.dropdownFilterTitle) + "：")]) : _vm._e(), _c('el-select', {
+    staticClass: "dropdown-filter-select",
+    attrs: {
+      "placeholder": _vm.dropdownFilterPlaceholder,
+      "clearable": "",
+      "size": "mini",
+      "disabled": _vm.panelViewMode
+    },
+    on: {
+      "change": _vm.handleDropdownFilterChange
+    },
+    model: {
+      value: _vm.dropdownFilterValue,
+      callback: function ($$v) {
+        _vm.dropdownFilterValue = $$v;
+      },
+      expression: "dropdownFilterValue"
+    }
+  }, _vm._l(_vm.normalizedDropdownFilterOptions, function (opt) {
+    return _c('el-option', {
+      key: 'df-' + opt.value,
+      attrs: {
+        "label": opt.label,
+        "value": opt.value
+      }
+    });
+  }), 1)], 1) : _vm._e(), _vm.showRefreshBtn ? _c('el-tooltip', {
     attrs: {
       "content": _vm.refreshTooltip,
       "placement": "top",
@@ -96638,8 +97003,8 @@ var ByCascaderPanelProvue_type_template_id_961f637e_render = function render() {
     directives: [{
       name: "show",
       rawName: "v-show",
-      value: _vm.searchInput === '' || !_vm.isShowSearch,
-      expression: "searchInput === '' || !isShowSearch"
+      value: !_vm.isFilterView,
+      expression: "!isFilterView"
     }],
     ref: "cascaderPanel",
     staticClass: "cascader-panel-inner",
@@ -96655,44 +97020,41 @@ var ByCascaderPanelProvue_type_template_id_961f637e_render = function render() {
       "column-min-width": _vm.columnMinWidth,
       "column-max-width": _vm.columnMaxWidth,
       "disabled-config": _vm.disabledConfig,
-      "is-view-mode": _vm.panelViewMode
+      "is-view-mode": _vm.panelViewMode,
+      "filter-field": _vm.showDropdownFilter ? _vm.dropdownFilterField : ''
     },
     on: {
       "input": _vm.onMainPanelInput,
       "change": _vm.handleValueChange,
       "store-ready": _vm.schedulePanelSyncFromExternalValue
     }
-  }) : _vm._e(), _vm.searchOptions.length > 0 ? _c('VirtualCascaderPanel', {
+  }) : _vm._e(), _vm.viewOptions.length > 0 ? _c('VirtualCascaderPanel', {
     directives: [{
       name: "show",
       rawName: "v-show",
-      value: _vm.searchInput !== '' && _vm.isShowSearch,
-      expression: "searchInput !== '' && isShowSearch"
+      value: _vm.isFilterView,
+      expression: "isFilterView"
     }],
     ref: "searchCascaderPanel",
     staticClass: "cascader-panel-inner",
     attrs: {
       "value": _vm.compactSearchPanelValue,
       "sync-value-from-parent": false,
-      "options": _vm.searchOptions,
+      "options": _vm.viewOptions,
       "props": _vm.cascaderProps,
       "height": _vm.computedPanelHeight - 20,
       "column-min-width": _vm.columnMinWidth,
       "column-max-width": _vm.columnMaxWidth,
       "disabled-config": _vm.disabledConfig,
-      "is-view-mode": _vm.panelViewMode
+      "is-view-mode": _vm.panelViewMode,
+      "filter-field": _vm.showDropdownFilter ? _vm.dropdownFilterField : ''
     },
     on: {
       "input": _vm.onSearchPanelInput,
-      "change": _vm.handleSearchValueChange
+      "change": _vm.handleSearchValueChange,
+      "store-ready": _vm.syncSearchPanelSelection
     }
-  }) : _vm._e(), _vm.isShowSearch && _vm.searchOptions.length === 0 ? _c('div', {
-    directives: [{
-      name: "show",
-      rawName: "v-show",
-      value: _vm.searchInput !== '',
-      expression: "searchInput !== ''"
-    }],
+  }) : _vm._e(), _vm.isFilterView && _vm.viewOptions.length === 0 ? _c('div', {
     staticClass: "empty-search"
   }, [_c('el-empty', {
     attrs: {
@@ -96763,7 +97125,7 @@ var ByCascaderPanelProvue_type_template_id_961f637e_render = function render() {
     staticClass: "empty-state"
   }, [_vm._v("暂无选中项")])], 1)])])])]);
 };
-var ByCascaderPanelProvue_type_template_id_961f637e_staticRenderFns = [];
+var ByCascaderPanelProvue_type_template_id_21ca97ff_staticRenderFns = [];
 
 ;// ./src/components/cascader-panel-pro/cascaderStorePro.js
 
@@ -97055,14 +97417,22 @@ class CascaderUtilsPro {
       minWidth = 180,
       maxWidth = 420,
       extraPadding = 56,
-      hasCheckbox = true
+      hasCheckbox = true,
+      filterField = ''
     } = options;
     if (!nodes || nodes.length === 0) {
       return minWidth;
     }
     let maxLabelWidth = 0;
     nodes.forEach(node => {
-      maxLabelWidth = Math.max(maxLabelWidth, this.measureCascaderLabelWidth(node.label));
+      let text = node.label || '';
+      if (filterField) {
+        const extra = node.raw && node.raw[filterField];
+        if (extra !== null && extra !== undefined && extra !== '') {
+          text += ` (${extra})`;
+        }
+      }
+      maxLabelWidth = Math.max(maxLabelWidth, this.measureCascaderLabelWidth(text));
     });
     const checkboxWidth = hasCheckbox ? 28 : 0;
     const arrowWidth = 24;
@@ -97221,6 +97591,58 @@ class CascaderUtilsPro {
     return result;
   }
 
+  /**
+   * 判断节点指定字段是否匹配下拉筛选值
+   * @param {Object} node
+   * @param {String} field
+   * @param {*} filterValue
+   * @returns {Boolean}
+   */
+  static isFilterFieldMatched(node, field, filterValue) {
+    if (!node || !field || filterValue === null || filterValue === undefined || filterValue === '') {
+      return false;
+    }
+    const raw = node[field];
+    if (raw === null || raw === undefined || raw === '') {
+      return false;
+    }
+    return String(raw).trim() === String(filterValue).trim();
+  }
+
+  /**
+   * 按数据字段过滤树：保留字段匹配的节点及其祖先路径
+   * @param {Array} tree - 树形数据
+   * @param {String} field - 数据中用于筛选的字段名
+   * @param {*} filterValue - 下拉选中值
+   * @param {Object} cascaderProps - 级联配置
+   * @returns {Array} 过滤后的树
+   */
+  static filterTreeByField(tree, field, filterValue, cascaderProps) {
+    if (!Array.isArray(tree) || !field || filterValue === null || filterValue === undefined || filterValue === '') {
+      return tree || [];
+    }
+    const childrenKey = cascaderProps && cascaderProps.children || 'children';
+    const result = [];
+    tree.forEach(node => {
+      const children = node[childrenKey];
+      const hasChildren = Array.isArray(children) && children.length > 0;
+      if (hasChildren) {
+        const matchedChildren = this.filterTreeByField(children, field, filterValue, cascaderProps);
+        if (matchedChildren.length > 0) {
+          result.push({
+            ...node,
+            [childrenKey]: matchedChildren
+          });
+        }
+      } else if (this.isFilterFieldMatched(node, field, filterValue)) {
+        result.push({
+          ...node
+        });
+      }
+    });
+    return result;
+  }
+
   /**
    * 基于扁平 store 快速搜索（父节点命中时直接复用 raw 子树，跳过子级遍历）
    */
@@ -97764,8 +98186,8 @@ class CascaderUtilsPro {
     return paths;
   }
 }
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/cascader-panel-pro/VirtualCascaderPanel.vue?vue&type=template&id=05f77638
-var VirtualCascaderPanelvue_type_template_id_05f77638_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/cascader-panel-pro/VirtualCascaderPanel.vue?vue&type=template&id=7d8ff846
+var VirtualCascaderPanelvue_type_template_id_7d8ff846_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -97846,7 +98268,9 @@ var VirtualCascaderPanelvue_type_template_id_05f77638_render = function render()
             }
           }, [_c('span')])], 1) : _vm._e(), _c('span', {
             staticClass: "el-cascader-node__label"
-          }, [_vm._v(_vm._s(item.label))]), !item.isLeaf ? _c('span', {
+          }, [_vm.filterField ? [_vm._v(" " + _vm._s(item.label)), _vm.getFilterFieldText(item) ? _c('span', {
+            staticClass: "node-filter-field"
+          }, [_vm._v(_vm._s(_vm.getFilterFieldText(item)))]) : _vm._e()] : [_vm._v(_vm._s(item.label))]], 2), !item.isLeaf ? _c('span', {
             staticClass: "el-cascader-node__postfix"
           }, [_c('i', {
             staticClass: "el-icon-arrow-right el-cascader-node__icon-arrow"
@@ -97856,7 +98280,7 @@ var VirtualCascaderPanelvue_type_template_id_05f77638_render = function render()
     })], 1);
   }), 0);
 };
-var VirtualCascaderPanelvue_type_template_id_05f77638_staticRenderFns = [];
+var VirtualCascaderPanelvue_type_template_id_7d8ff846_staticRenderFns = [];
 
 ;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"185687ec-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.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/cascader-panel-pro/VirtualList.vue?vue&type=template&id=43cb1148
 var VirtualListvue_type_template_id_43cb1148_render = function render() {
@@ -98340,6 +98764,11 @@ class SelectionStatePro {
     syncValueFromParent: {
       type: Boolean,
       default: true
+    },
+    // 下拉筛选字段名：有值时在节点名称后展示该字段内容
+    filterField: {
+      type: String,
+      default: ''
     }
   },
   data() {
@@ -98456,7 +98885,8 @@ class SelectionStatePro {
       const width = CascaderUtilsPro.getCascaderColumnWidth(columnNodes, {
         minWidth: this.columnMinWidth,
         maxWidth: this.columnMaxWidth,
-        hasCheckbox: this.multiple || this.checkStrictly
+        hasCheckbox: this.multiple || this.checkStrictly,
+        filterField: this.filterField
       });
       return {
         width: width + 'px',
@@ -98464,6 +98894,17 @@ class SelectionStatePro {
         maxWidth: width + 'px'
       };
     },
+    getFilterFieldText(item) {
+      if (!this.filterField || !item) {
+        return '';
+      }
+      const raw = item.raw || item;
+      const val = raw[this.filterField];
+      if (val === null || val === undefined || val === '') {
+        return '';
+      }
+      return `(${val})`;
+    },
     rebuildStore() {
       this.store = buildCascaderStore(this.options, this.disabledConfig, this.props, CascaderUtilsPro);
       this.selection = new SelectionStatePro(this.store);
@@ -98773,8 +99214,8 @@ class SelectionStatePro {
 ;
 var VirtualCascaderPanel_component = normalizeComponent(
   cascader_panel_pro_VirtualCascaderPanelvue_type_script_lang_js,
-  VirtualCascaderPanelvue_type_template_id_05f77638_render,
-  VirtualCascaderPanelvue_type_template_id_05f77638_staticRenderFns,
+  VirtualCascaderPanelvue_type_template_id_7d8ff846_render,
+  VirtualCascaderPanelvue_type_template_id_7d8ff846_staticRenderFns,
   false,
   null,
   null,
@@ -98930,6 +99371,15 @@ var VirtualCascaderPanel_component = normalizeComponent(
     columnMaxWidth: {
       type: Number,
       default: 420
+    },
+    /**
+     * 下拉筛选配置。外部传入且 enabled 不为 false、并指定 field 时才展示下拉框。
+     * { enabled, title, placeholder, options: [{ label, value }], field }
+     * field 为数据中用于过滤和展示的字段名。
+     */
+    dropdownFilter: {
+      type: Object,
+      default: null
     }
   },
   data() {
@@ -98957,7 +99407,8 @@ var VirtualCascaderPanel_component = normalizeComponent(
       searchLeafSetCache: null,
       panelSyncTimer: null,
       // 外部 v-model 回显同步中，避免与用户操作冲突
-      isExternalSync: false
+      isExternalSync: false,
+      dropdownFilterValue: ''
     };
   },
   computed: {
@@ -99058,6 +99509,59 @@ var VirtualCascaderPanel_component = normalizeComponent(
           this.searchSelectedValues = value ? [value] : [];
         }
       }
+    },
+    showDropdownFilter() {
+      const cfg = this.dropdownFilter;
+      return !!(cfg && typeof cfg === 'object' && cfg.enabled !== false && cfg.field);
+    },
+    dropdownFilterPlaceholder() {
+      return this.dropdownFilter && this.dropdownFilter.placeholder || '请选择';
+    },
+    dropdownFilterTitle() {
+      const title = this.dropdownFilter && this.dropdownFilter.title;
+      return title != null && String(title).trim() !== '' ? String(title).trim() : '';
+    },
+    dropdownFilterField() {
+      return this.dropdownFilter && this.dropdownFilter.field || '';
+    },
+    normalizedDropdownFilterOptions() {
+      const opts = this.dropdownFilter && this.dropdownFilter.options || [];
+      return opts.map(opt => {
+        if (opt != null && typeof opt === 'object') {
+          return {
+            label: opt.label != null ? opt.label : opt.value,
+            value: opt.value != null ? opt.value : opt.label
+          };
+        }
+        return {
+          label: String(opt),
+          value: opt
+        };
+      });
+    },
+    hasActiveDropdownFilter() {
+      return this.showDropdownFilter && this.dropdownFilterValue !== '' && this.dropdownFilterValue !== null && this.dropdownFilterValue !== undefined;
+    },
+    displayOptions() {
+      if (!this.hasActiveDropdownFilter) {
+        return this.filteredOptions;
+      }
+      return CascaderUtilsPro.filterTreeByField(this.filteredOptions, this.dropdownFilterField, this.dropdownFilterValue, this.cascaderProps);
+    },
+    isFilterView() {
+      if (this.searchInput !== '' && this.isShowSearch) {
+        return true;
+      }
+      return this.hasActiveDropdownFilter;
+    },
+    viewOptions() {
+      if (this.searchInput !== '' && this.isShowSearch) {
+        return this.searchOptions;
+      }
+      if (this.hasActiveDropdownFilter) {
+        return this.displayOptions;
+      }
+      return [];
     }
   },
   watch: {
@@ -99083,6 +99587,9 @@ var VirtualCascaderPanel_component = normalizeComponent(
     searchInput(val) {
       if (!val) {
         this.clearSearchState();
+        if (this.hasActiveDropdownFilter) {
+          this.prepareFilterView();
+        }
         return;
       }
       this.scheduleSearch();
@@ -99110,6 +99617,9 @@ var VirtualCascaderPanel_component = normalizeComponent(
           } else if (panel && panel.store && panel.selection && this.aggregationMode) {
             this.isAllSelected = panel.selection.size() === panel.store.totalLeafCount && panel.store.totalLeafCount > 0;
           }
+          if (this.hasActiveDropdownFilter) {
+            this.updateFilterAllSelectedState();
+          }
         } else {
           if (newVal.length > 1) {
             this.selectedItems = [newVal[newVal.length - 1]];
@@ -99124,6 +99634,11 @@ var VirtualCascaderPanel_component = normalizeComponent(
       if (val) {
         this.batchSearchVisible = false;
       }
+    },
+    showDropdownFilter(val) {
+      if (!val) {
+        this.dropdownFilterValue = '';
+      }
     }
   },
   mounted() {
@@ -99177,6 +99692,9 @@ var VirtualCascaderPanel_component = normalizeComponent(
           this.selectedValues = selection.getCheckedPaths();
         }
         panel.bumpSelectionView();
+        if (this.hasActiveDropdownFilter) {
+          this.updateFilterAllSelectedState();
+        }
         return;
       }
       if (selection.isCompactSelection()) {
@@ -99184,11 +99702,17 @@ var VirtualCascaderPanel_component = normalizeComponent(
         this.selectedCount = selection.size();
         this.isAllSelected = selection.size() === store.totalLeafCount;
         panel.bumpSelectionView();
+        if (this.hasActiveDropdownFilter) {
+          this.updateFilterAllSelectedState();
+        }
         return;
       }
       this.selectedValues = selection.getCheckedPaths();
       this.updateSelectedItems();
       panel.bumpSelectionView();
+      if (this.hasActiveDropdownFilter) {
+        this.updateFilterAllSelectedState();
+      }
     },
     /**
      * 用户操作（勾选/全选/清除/删除）统一提交：更新展示 + emit，标记内部更新防回显覆盖
@@ -99442,6 +99966,11 @@ var VirtualCascaderPanel_component = normalizeComponent(
       } else {
         this.updateSelectedItems();
       }
+      if (this.searchInput) {
+        this.scheduleSearch();
+      } else if (this.hasActiveDropdownFilter) {
+        this.prepareFilterView();
+      }
     },
     // 处理选项数据，添加禁用状态（浅拷贝，避免 JSON 深拷贝大数据卡顿）
     processOptions(options) {
@@ -99527,13 +100056,20 @@ var VirtualCascaderPanel_component = normalizeComponent(
       const keyword = this.searchInput.trim();
       if (!keyword) {
         this.clearSearchState();
+        if (this.hasActiveDropdownFilter) {
+          this.prepareFilterView();
+        }
         return;
       }
-      const panel = this.$refs.cascaderPanel;
-      if (panel && panel.store) {
-        this.searchOptions = CascaderUtilsPro.searchFromStore(panel.store, keyword, this.cascaderProps);
+      if (this.hasActiveDropdownFilter) {
+        this.searchOptions = CascaderUtilsPro.searchInTree(this.displayOptions, keyword, this.cascaderProps);
       } else {
-        this.searchOptions = CascaderUtilsPro.searchInTree(this.filteredOptions, keyword, this.cascaderProps);
+        const panel = this.$refs.cascaderPanel;
+        if (panel && panel.store) {
+          this.searchOptions = CascaderUtilsPro.searchFromStore(panel.store, keyword, this.cascaderProps);
+        } else {
+          this.searchOptions = CascaderUtilsPro.searchInTree(this.filteredOptions, keyword, this.cascaderProps);
+        }
       }
       this.searchLeafSetCache = new Set(CascaderUtilsPro.getLeafValues(this.searchOptions, this.cascaderProps));
       this.searchSelectedValues = this.getSearchSelectedPathsFromMain(this.searchLeafSetCache);
@@ -99565,7 +100101,7 @@ var VirtualCascaderPanel_component = normalizeComponent(
       if (this.searchLeafSetCache) {
         return this.searchLeafSetCache;
       }
-      return new Set(CascaderUtilsPro.getLeafValues(this.searchOptions, this.cascaderProps));
+      return new Set(CascaderUtilsPro.getLeafValues(this.viewOptions, this.cascaderProps));
     },
     syncSearchPanelSelection() {
       const searchPanel = this.$refs.searchCascaderPanel;
@@ -99585,12 +100121,46 @@ var VirtualCascaderPanel_component = normalizeComponent(
     },
     // 搜索模式下的展开处理
     handleSearchExpand() {
-      if (this.$refs.searchCascaderPanel && this.searchOptions.length > 0) {
-        const firstOption = this.searchOptions[0];
+      if (this.$refs.searchCascaderPanel && this.viewOptions.length > 0) {
+        const firstOption = this.viewOptions[0];
         const valueKey = this.cascaderProps.value || 'value';
         this.$refs.searchCascaderPanel.expandPathValues([firstOption[valueKey]], true);
       }
     },
+    prepareFilterView() {
+      this.searchLeafSetCache = new Set(CascaderUtilsPro.getLeafValues(this.displayOptions, this.cascaderProps));
+      this.$nextTick(() => {
+        this.syncSearchPanelSelection();
+        this.handleSearchExpand();
+      });
+    },
+    handleDropdownFilterChange() {
+      if (this.searchInput) {
+        this.scheduleSearch();
+        return;
+      }
+      this.clearSearchState();
+      if (this.hasActiveDropdownFilter) {
+        this.prepareFilterView();
+      }
+    },
+    updateFilterAllSelectedState() {
+      if (!this.hasActiveDropdownFilter) {
+        return;
+      }
+      const viewPaths = CascaderUtilsPro.getAllLeafPaths(this.displayOptions, this.disabledConfig, this.cascaderProps);
+      if (viewPaths.length === 0) {
+        this.isAllSelected = false;
+        return;
+      }
+      const panel = this.$refs.cascaderPanel;
+      if (panel && panel.selection && panel.selection.selectedLeafSet) {
+        this.isAllSelected = viewPaths.every(path => panel.selection.selectedLeafSet.has(path[path.length - 1]));
+        return;
+      }
+      const selectedLeafSet = new Set(this.selectedValues.map(path => path[path.length - 1]));
+      this.isAllSelected = viewPaths.every(path => selectedLeafSet.has(path[path.length - 1]));
+    },
     // 值变化处理（面板勾选）
     handleValueChange() {
       this.commitUserSelectionChange();
@@ -99682,6 +100252,26 @@ var VirtualCascaderPanel_component = normalizeComponent(
       }
       const panel = this.$refs.cascaderPanel;
       const searchPanel = this.$refs.searchCascaderPanel;
+      if (this.hasActiveDropdownFilter && panel && panel.selection && panel.store) {
+        const viewPaths = CascaderUtilsPro.getAllLeafPaths(this.displayOptions, this.disabledConfig, this.cascaderProps);
+        const viewLeafSet = new Set(viewPaths.map(path => path[path.length - 1]));
+        if (this.isAllSelected) {
+          viewLeafSet.forEach(leaf => {
+            panel.selection.selectedLeafSet.delete(leaf);
+          });
+        } else {
+          viewLeafSet.forEach(leaf => {
+            panel.selection.selectedLeafSet.add(leaf);
+          });
+        }
+        panel.selection._reconcileAllRoots();
+        panel.bumpSelectionView();
+        if (searchPanel && searchPanel.selection) {
+          this.syncSearchPanelSelection();
+        }
+        this.commitUserSelectionChange();
+        return;
+      }
       if (this.isAllSelected) {
         this.clearPanelSelectionState(panel);
         this.clearPanelSelectionState(searchPanel);
@@ -99807,6 +100397,9 @@ var VirtualCascaderPanel_component = normalizeComponent(
       if (this.panelViewMode) return;
       this.searchInput = '';
       this.clearSearchState();
+      if (this.hasActiveDropdownFilter) {
+        this.prepareFilterView();
+      }
       this.$emit('refresh');
     },
     // 处理批量搜索
@@ -99935,8 +100528,8 @@ var VirtualCascaderPanel_component = normalizeComponent(
 ;
 var ByCascaderPanelPro_component = normalizeComponent(
   cascader_panel_pro_ByCascaderPanelProvue_type_script_lang_js,
-  ByCascaderPanelProvue_type_template_id_961f637e_render,
-  ByCascaderPanelProvue_type_template_id_961f637e_staticRenderFns,
+  ByCascaderPanelProvue_type_template_id_21ca97ff_render,
+  ByCascaderPanelProvue_type_template_id_21ca97ff_staticRenderFns,
   false,
   null,
   null,