hy-virtual-tree 2.1.4 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## Changelog
 
+### 2.3.0
+
+_2026-06-01_
+
+（1）新增 renderLabel 自定义节点文本
+
+### 2.2.0
+
+_2026-06-01_
+
+（1）新增 filterMethod参数的返回参数，可按需判断每一项是否要独立校验
+
 ### 2.1.4
 
 _2026-05-28_

package/dist/index.js

@@ -1,4 +1,4 @@
-/* hy-virtual-tree v2.1.4 */
+/* hy-virtual-tree v2.3.0 */
 import './svg_bundle.js';
 const isString = (e) => typeof e === 'string';
 const isNumber = (e) => typeof e === 'number';
@@ -8682,6 +8682,13 @@ function useFilter(config, filterMethod, tree = {
     const hiddenNodeKeySet = new Set([]);
     const hiddenExpandIconKeySet = new Set([]);
     let doFilter;
+    function useFilterMethod(filterMethod, filterAll, ...args) {
+        const params = filterMethod(...args);
+        if (isObject(params)) {
+            return { type: params.force ? 'all' : 'default', value: params.value };
+        }
+        return { type: filterAll ? 'all' : 'default', value: params };
+    }
     // 通用过滤方法
     function commitFilter(params, filterAll = true) {
         if (!isFunction(filterMethod)) {
@@ -8702,11 +8709,12 @@ function useFilter(config, filterMethod, tree = {
             let total = 0;
             let hasFilterResult = false;
             nodes.forEach((node) => {
+                const { type: filterType, value: filterValue } = useFilterMethod(filterMethod, filterAll, params, node.data, node);
                 family.push(node);
                 if (!hasFilterResult) {
-                    hasFilterResult = !!(filterMethod && filterMethod(params, node.data, node));
+                    hasFilterResult = filterValue;
                 }
-                if (isShow || (filterMethod && filterMethod(params, node.data, node))) {
+                if ((isShow && filterType !== 'all') || filterValue) {
                     family.forEach((member) => {
                         expandKeySet.add(member.key);
                     });
@@ -8793,11 +8801,12 @@ function useFilter(config, filterMethod, tree = {
             let hasFilterResult = false;
             nodes.forEach((node) => {
                 const isLeaf = isFilterLeaf(node);
+                const { type: filterType, value: filterValue } = useFilterMethod(filterMethod, filterAll, params, node.data, node);
                 family.push(node);
                 if (!hasFilterResult) {
-                    hasFilterResult = !!(filterMethod && filterMethod(params, node.data, node));
+                    hasFilterResult = filterValue;
                 }
-                if (isShow || (filterMethod && filterMethod(params, node.data, node))) {
+                if ((isShow && filterType !== 'all') || filterValue) {
                     family.forEach((member) => {
                         expandKeySet.add(member.key);
                     });
@@ -8886,12 +8895,13 @@ function useFilter(config, filterMethod, tree = {
             let total = 0;
             let hasFilterResult = false;
             nodes.forEach((node) => {
+                const { type: filterType, value: filterValue } = useFilterMethod(filterMethod, filterAll, params, node.data, node);
                 family.push(node);
                 if (!hasFilterResult) {
-                    hasFilterResult = !!(filterMethod && filterMethod(params, node.data, node));
+                    hasFilterResult = filterValue;
                 }
                 // if (tree.hiddenNodeKeySet.has(node.key)) return
-                if (isShow || (filterMethod && filterMethod(params, node.data, node))) {
+                if ((isShow && filterType !== 'all') || filterValue) {
                     family.forEach((member) => {
                         expandKeySet.add(member.key);
                     });
@@ -9069,14 +9079,28 @@ const useIcon = (config, data, node) => {
         return new Icon({ svgName: 'hy-tree-personnel', width: 16, height: 16 });
     }
 };
+// 获取节点文本处理
+const getLabelHandler = (data, node, config) => {
+    if (config.renderLabel && isFunction(config.renderLabel)) {
+        const value = config.renderLabel(data, node);
+        if (isBoolean(value) && value) {
+            return node.label || '';
+        }
+        else {
+            return value || '';
+        }
+    }
+    return node.label || '';
+};
 // 生成内容节点
-const useContent = (data, node) => {
+const useContent = (data, node, config) => {
     return createVNode('div', (vnode) => {
-        vnode.el.innerHTML = node.label || '';
-        if (node.label) {
+        const label = getLabelHandler(data, node, config);
+        vnode.el.innerHTML = label;
+        if (label) {
             const tooltip = new Tooltip({
                 bind: vnode.el,
-                content: node.label,
+                content: label,
                 placement: 'top',
                 trigger: 'hover-overflow'
             });
@@ -9098,11 +9122,11 @@ const generateTotalStats = (data, node) => {
 };
 // 自定义渲染元素
 const customRender = (options) => {
-    const { fn, node, parent, className, defaultFn } = options || {};
+    const { fn, node, parent, className, config, defaultFn } = options || {};
     let value;
     // 没有传入的自定义函数则使用默认函数
     if (!fn || !isFunction(fn)) {
-        value = defaultFn && isFunction(defaultFn) ? defaultFn(node.data, node) : undefined;
+        value = defaultFn && isFunction(defaultFn) ? defaultFn(node.data, node, config) : undefined;
     }
     // 自定义函数处理
     else {
@@ -9121,7 +9145,7 @@ const customRender = (options) => {
         return value;
     }
     if (isBoolean(value) && value) {
-        value = defaultFn && isFunction(defaultFn) ? defaultFn(node.data, node) : undefined;
+        value = defaultFn && isFunction(defaultFn) ? defaultFn(node.data, node, config) : undefined;
         if (value) {
             className && value.el.classList.add(className);
             parent && value.mount(parent);
@@ -9844,13 +9868,14 @@ class VirtualTree {
                         fn: config.renderStatus,
                         node: item,
                         className: 'hy-tree-node__status',
+                        config,
                         defaultFn: (data, node) => {
                             return useStatus(config, data);
                         }
                     });
                 }
                 // 右侧内容
-                rightSlot = customRender({ fn: config.renderRight, node: item, className: 'hy-tree-node__right-content' });
+                rightSlot = customRender({ fn: config.renderRight, node: item, className: 'hy-tree-node__right-content', config });
                 if (!statusSlot && !rightSlot)
                     return;
                 return createVNode('div', (vnode) => {
@@ -9966,17 +9991,18 @@ class VirtualTree {
                                 node: item,
                                 parent: contentContainer,
                                 className: 'hy-tree-node__node-content',
-                                defaultFn: (data, node) => {
+                                config,
+                                defaultFn: (data, node, config) => {
                                     // 图标
-                                    customRender({ fn: config.renderIcon, node, parent: contentContainer, className: 'hy-tree-icon', defaultFn: generateIcon });
+                                    customRender({ fn: config.renderIcon, node, parent: contentContainer, className: 'hy-tree-icon', config, defaultFn: generateIcon });
                                     // 内容
-                                    customRender({ fn: config.renderContent, node, parent: contentContainer, className: 'hy-tree-node__content', defaultFn: useContent });
+                                    customRender({ fn: config.renderContent, node, parent: contentContainer, className: 'hy-tree-node__content', config, defaultFn: useContent });
                                     // 统计
                                     if (isShowCount(this._props.showCount, item)) {
-                                        customRender({ fn: config.renderStats, node, parent: contentContainer, className: 'hy-tree-node__statistics', defaultFn: this._props.statsModel === 'total' ? generateTotalStats : generateStats });
+                                        customRender({ fn: config.renderStats, node, parent: contentContainer, className: 'hy-tree-node__statistics', config, defaultFn: this._props.statsModel === 'total' ? generateTotalStats : generateStats });
                                     }
                                     // 右侧内容
-                                    customRender({ fn: generateRight, node, parent: contentContainer });
+                                    customRender({ fn: generateRight, node, parent: contentContainer, config });
                                 }
                             });
                             // 挂载内容容器

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hy-virtual-tree",
-  "version": "2.1.4",
+  "version": "2.3.0",
   "type": "module",
   "scripts": {
     "dev": "vite",