@douyinfe/semi-foundation 2.99.2 → 2.99.3

package/cascader/foundation.ts

@@ -16,9 +16,13 @@ import {
     isValid,
     calcMergeType,
     getKeysByValuePath,
-    getKeyByPos
+    getKeyByPos,
+    KeyMapProps,
+    getValueOrKey
 } from './util';
 import { strings } from './constants';
+
+export type { KeyMapProps };
 import isEnterPress from '../utils/isEnterPress';
 import { ESC_KEY } from '../utils/keyCode';
 
@@ -171,6 +175,7 @@ export interface BasicCascaderProps {
     virtualizeInSearch?: Virtualize;
     checkRelation?: string;
     remote?: boolean;
+    keyMaps?: KeyMapProps;
     onClear?: () => void;
     triggerRender?: (props: BasicTriggerRenderProps) => any;
     onListScroll?: (e: any, panel: BasicScrollPanelProps) => void;
@@ -407,8 +412,8 @@ export default class CascaderFoundation extends BaseFoundation<CascaderAdapter,
     }
 
     collectOptions(init = false) {
-        const { treeData, value, defaultValue } = this.getProps();
-        const keyEntities = convertDataToEntities(treeData);
+        const { treeData, value, defaultValue, keyMaps } = this.getProps();
+        const keyEntities = convertDataToEntities(treeData, keyMaps);
         this._adapter.rePositionDropdown();
         let cacheValue;
         /* when mount */
@@ -442,7 +447,8 @@ export default class CascaderFoundation extends BaseFoundation<CascaderAdapter,
         if (!sugInput) {
             return [];
         }
-        const { treeNodeFilterProp, filterTreeNode, filterLeafOnly, remote } = this.getProps();
+        const { treeNodeFilterProp, filterTreeNode, filterLeafOnly, remote, keyMaps } = this.getProps();
+        const realFilterProp = treeNodeFilterProp !== 'label' ? treeNodeFilterProp : get(keyMaps, 'label', 'label');
         const entities = Object.values(keyEntities ?? this.getState('keyEntities')) as BasicEntity[];
 
         if (remote) {
@@ -458,7 +464,7 @@ export default class CascaderFoundation extends BaseFoundation<CascaderAdapter,
                 if (_notExist) {
                     return false;
                 }
-                const filteredPath = this.getItemPropPath(key, treeNodeFilterProp, keyEntities);
+                const filteredPath = this.getItemPropPath(key, realFilterProp, keyEntities);
                 return filter(sugInput, data, filterTreeNode, filteredPath);
             })
             .filter(item => (filterTreeNode && !filterLeafOnly) || this._isLeaf(item.data))
@@ -531,7 +537,8 @@ export default class CascaderFoundation extends BaseFoundation<CascaderAdapter,
         const filterable = this._isFilterable();
         const loadingActive = [...activeKeys].filter(i => loadingKeys.has(i));
         const normalizedValue = normalizedArr(value);
-        const valuePath = onChangeWithObject && isObject(normalizedValue[0]) ? normalizedValue.map(i => i.value) : normalizedValue;
+        const keyMaps = this.getProp('keyMaps');
+        const valuePath = onChangeWithObject && isObject(normalizedValue[0]) ? getValueOrKey(normalizedValue, keyMaps) : normalizedValue;
         const selectedKeys = getKeysByValuePath(valuePath);
         let updateStates: Partial<BasicCascaderInnerData> = {};
 
@@ -1121,7 +1128,8 @@ export default class CascaderFoundation extends BaseFoundation<CascaderAdapter,
     }
 
     getFilteredData() {
-        const { treeNodeFilterProp, filterSorter } = this.getProps();
+        const { treeNodeFilterProp, filterSorter, keyMaps } = this.getProps();
+        const realFilterProp = treeNodeFilterProp !== 'label' ? treeNodeFilterProp : get(keyMaps, 'label', 'label');
         const { filteredKeys, keyEntities, inputValue } = this.getStates();
         const filteredList: BasicData[] = [];
         const filteredKeyArr = [...filteredKeys];
@@ -1131,7 +1139,7 @@ export default class CascaderFoundation extends BaseFoundation<CascaderAdapter,
                 return;
             }
             const pathData = this.getItemPropPath(key, []);
-            const itemSearchPath = pathData.map(item => item[treeNodeFilterProp]);
+            const itemSearchPath = pathData.map(item => item[realFilterProp]);
             const isDisabled = this._isOptionDisabled(key, keyEntities);
             filteredList.push({
                 data: item.data,
@@ -1171,7 +1179,8 @@ export default class CascaderFoundation extends BaseFoundation<CascaderAdapter,
 
     handleTagRemoveInTrigger = (pos: string) => {
         const { treeData } = this.getStates();
-        const key = getKeyByPos(pos, treeData);
+        const { keyMaps } = this.getProps();
+        const key = getKeyByPos(pos, treeData, keyMaps);
         this.handleTagRemoveByKey(key);
     }
 }

package/cascader/util.ts

@@ -1,10 +1,19 @@
 import {
     isNull,
     isUndefined,
-    isEqual
+    isEqual,
+    get
 } from 'lodash';
 import { strings, VALUE_SPLIT } from './constants';
 
+export interface KeyMapProps {
+    value?: string;
+    label?: string;
+    disabled?: string;
+    children?: string;
+    isLeaf?: string;
+}
+
 function getPosition(level: any, index: any) {
     return `${level}-${index}`;
 }
@@ -54,23 +63,39 @@ export function filter(sugInput: string, option: any, filterTreeNode: any, filte
 /**
  * Traverse all the data by `treeData`.
  */
-function traverseDataNodes(treeNodes: any, callback: any) {
+function traverseDataNodes(treeNodes: any, callback: any, keyMaps?: KeyMapProps) {
+    const realValueName = get(keyMaps, 'value', 'value');
+    const realChildrenName = get(keyMaps, 'children', 'children');
+
     const processNode = (node: any, ind?: any, parent?: any) => {
-        const children = node ? node.children : treeNodes;
+        const children = node ? node[realChildrenName] : treeNodes;
         let item: any = null;
         // Process node if is not root
         if (node) {
-            const key = parent ? `${parent.key}${VALUE_SPLIT}${node.value}` : `${node.value}`;
+            const nodeValue = node[realValueName];
+            const key = parent ? `${parent.key}${VALUE_SPLIT}${nodeValue}` : `${nodeValue}`;
             const pos = parent ? getPosition(parent.pos, ind) : `${ind}`;
+            
+            // Map original fields to standard field names if keyMaps is provided
+            const mappedData = { ...node };
+            if (keyMaps) {
+                Object.entries(keyMaps).forEach(([standardKey, originalKey]) => {
+                    const value = node[originalKey as string];
+                    if (!isUndefined(value)) {
+                        mappedData[standardKey] = value;
+                    }
+                });
+            }
+            
             item = {
-                data: { ...node },
+                data: mappedData,
                 ind,
                 key,
                 pos,
                 level: parent ? parent.level + 1 : 0,
                 parentKey: parent ? parent.key : null,
                 path: parent ? [...parent.path, key] : [key],
-                valuePath: parent ? [...parent.valuePath, node.value] : [node.value]
+                valuePath: parent ? [...parent.valuePath, nodeValue] : [nodeValue]
             };
 
             callback(item);
@@ -106,18 +131,20 @@ export function getValuePathByKey(key: string) {
     return key.split(VALUE_SPLIT);
 }
 
-export function getKeyByPos(pos: string, treeData: any) {
+export function getKeyByPos(pos: string, treeData: any, keyMaps?: KeyMapProps) {
+    const realValueName = get(keyMaps, 'value', 'value');
+    const realChildrenName = get(keyMaps, 'children', 'children');
     const posArr = pos.split('-').map(item => Number(item));
     let resultData = treeData;
-    let valuePath = [];
+    const valuePath: (string | number)[] = [];
     posArr.forEach((item, index) => {
-        resultData = index === 0 ? resultData[item] : resultData?.children?.[item];
-        valuePath.push(resultData?.value);
+        resultData = index === 0 ? resultData[item] : resultData?.[realChildrenName]?.[item];
+        valuePath.push(resultData?.[realValueName]);
     });
     return getKeyByValuePath(valuePath);
 }
 
-export function convertDataToEntities(dataNodes: any) {
+export function convertDataToEntities(dataNodes: any, keyMaps?: KeyMapProps) {
     const keyEntities: any = {};
 
     traverseDataNodes(dataNodes, (data: any) => {
@@ -132,10 +159,24 @@ export function convertDataToEntities(dataNodes: any) {
             entity.parent.children = entity.parent.children || [];
             entity.parent.children.push(entity);
         }
-    });
+    }, keyMaps);
     return keyEntities;
 }
 
+/**
+ * Get the value from data item using keyMaps mapping.
+ * Similar to Tree/TreeSelect's getValueOrKey.
+ * When keyMaps maps value to a custom field (e.g., 'id'), use that field;
+ * otherwise fall back to 'value'.
+ */
+export function getValueOrKey(data: any, keyMaps?: KeyMapProps) {
+    const valueName = get(keyMaps, 'value', 'value');
+    if (Array.isArray(data)) {
+        return data.map(item => get(item, valueName));
+    }
+    return get(data, valueName);
+}
+
 export function calcMergeType(autoMergeValue: boolean, leafOnly: boolean): string {
     let mergeType: string;
     if (leafOnly) {

package/lib/cjs/cascader/foundation.d.ts

@@ -1,4 +1,6 @@
 import BaseFoundation, { DefaultAdapter } from '../base/foundation';
+import { KeyMapProps } from './util';
+export type { KeyMapProps };
 export interface BasicData {
     data: BasicCascaderData;
     disabled: boolean;
@@ -115,6 +117,7 @@ export interface BasicCascaderProps {
     virtualizeInSearch?: Virtualize;
     checkRelation?: string;
     remote?: boolean;
+    keyMaps?: KeyMapProps;
     onClear?: () => void;
     triggerRender?: (props: BasicTriggerRenderProps) => any;
     onListScroll?: (e: any, panel: BasicScrollPanelProps) => void;

package/lib/cjs/cascader/foundation.js

@@ -56,7 +56,10 @@ class CascaderFoundation extends _foundation.default {
       const {
         treeData
       } = this.getStates();
-      const key = (0, _util.getKeyByPos)(pos, treeData);
+      const {
+        keyMaps
+      } = this.getProps();
+      const key = (0, _util.getKeyByPos)(pos, treeData, keyMaps);
       this.handleTagRemoveByKey(key);
     };
   }
@@ -199,9 +202,10 @@ class CascaderFoundation extends _foundation.default {
     const {
       treeData,
       value,
-      defaultValue
+      defaultValue,
+      keyMaps
     } = this.getProps();
-    const keyEntities = (0, _util.convertDataToEntities)(treeData);
+    const keyEntities = (0, _util.convertDataToEntities)(treeData, keyMaps);
     this._adapter.rePositionDropdown();
     let cacheValue;
     /* when mount */
@@ -238,8 +242,10 @@ class CascaderFoundation extends _foundation.default {
       treeNodeFilterProp,
       filterTreeNode,
       filterLeafOnly,
-      remote
+      remote,
+      keyMaps
     } = this.getProps();
+    const realFilterProp = treeNodeFilterProp !== 'label' ? treeNodeFilterProp : (0, _get2.default)(keyMaps, 'label', 'label');
     const entities = Object.values(keyEntities !== null && keyEntities !== void 0 ? keyEntities : this.getState('keyEntities'));
     if (remote) {
       return entities.filter(item => !item._notExist).filter(item => filterTreeNode && !filterLeafOnly || this._isLeaf(item.data)).map(item => item.key);
@@ -253,7 +259,7 @@ class CascaderFoundation extends _foundation.default {
       if (_notExist) {
         return false;
       }
-      const filteredPath = this.getItemPropPath(key, treeNodeFilterProp, keyEntities);
+      const filteredPath = this.getItemPropPath(key, realFilterProp, keyEntities);
       return (0, _util.filter)(sugInput, data, filterTreeNode, filteredPath);
     }).filter(item => filterTreeNode && !filterLeafOnly || this._isLeaf(item.data)).map(item => item.key);
   }
@@ -328,7 +334,8 @@ class CascaderFoundation extends _foundation.default {
     const filterable = this._isFilterable();
     const loadingActive = [...activeKeys].filter(i => loadingKeys.has(i));
     const normalizedValue = (0, _util.normalizedArr)(value);
-    const valuePath = onChangeWithObject && (0, _isObject2.default)(normalizedValue[0]) ? normalizedValue.map(i => i.value) : normalizedValue;
+    const keyMaps = this.getProp('keyMaps');
+    const valuePath = onChangeWithObject && (0, _isObject2.default)(normalizedValue[0]) ? (0, _util.getValueOrKey)(normalizedValue, keyMaps) : normalizedValue;
     const selectedKeys = (0, _util.getKeysByValuePath)(valuePath);
     let updateStates = {};
     const selectedKey = selectedKeys.length > 0 ? selectedKeys[0] : undefined;
@@ -954,8 +961,10 @@ class CascaderFoundation extends _foundation.default {
   getFilteredData() {
     const {
       treeNodeFilterProp,
-      filterSorter
+      filterSorter,
+      keyMaps
     } = this.getProps();
+    const realFilterProp = treeNodeFilterProp !== 'label' ? treeNodeFilterProp : (0, _get2.default)(keyMaps, 'label', 'label');
     const {
       filteredKeys,
       keyEntities,
@@ -969,7 +978,7 @@ class CascaderFoundation extends _foundation.default {
         return;
       }
       const pathData = this.getItemPropPath(key, []);
-      const itemSearchPath = pathData.map(item => item[treeNodeFilterProp]);
+      const itemSearchPath = pathData.map(item => item[realFilterProp]);
       const isDisabled = this._isOptionDisabled(key, keyEntities);
       filteredList.push({
         data: item.data,

package/lib/cjs/cascader/util.d.ts

@@ -1,3 +1,10 @@
+export interface KeyMapProps {
+    value?: string;
+    label?: string;
+    disabled?: string;
+    children?: string;
+    isLeaf?: string;
+}
 export declare function isValid(val: any): boolean;
 export declare function normalizedArr(val: any): any[];
 /**
@@ -8,6 +15,13 @@ export declare function filter(sugInput: string, option: any, filterTreeNode: an
 export declare function getKeysByValuePath(valuePath: (string | number)[][] | (string | number)[]): string[];
 export declare function getKeyByValuePath(valuePath: (string | number)[]): string;
 export declare function getValuePathByKey(key: string): string[];
-export declare function getKeyByPos(pos: string, treeData: any): string;
-export declare function convertDataToEntities(dataNodes: any): any;
+export declare function getKeyByPos(pos: string, treeData: any, keyMaps?: KeyMapProps): string;
+export declare function convertDataToEntities(dataNodes: any, keyMaps?: KeyMapProps): any;
+/**
+ * Get the value from data item using keyMaps mapping.
+ * Similar to Tree/TreeSelect's getValueOrKey.
+ * When keyMaps maps value to a custom field (e.g., 'id'), use that field;
+ * otherwise fall back to 'value'.
+ */
+export declare function getValueOrKey(data: any, keyMaps?: KeyMapProps): any;
 export declare function calcMergeType(autoMergeValue: boolean, leafOnly: boolean): string;

package/lib/cjs/cascader/util.js

@@ -9,9 +9,11 @@ exports.filter = filter;
 exports.getKeyByPos = getKeyByPos;
 exports.getKeyByValuePath = getKeyByValuePath;
 exports.getKeysByValuePath = getKeysByValuePath;
+exports.getValueOrKey = getValueOrKey;
 exports.getValuePathByKey = getValuePathByKey;
 exports.isValid = isValid;
 exports.normalizedArr = normalizedArr;
+var _get2 = _interopRequireDefault(require("lodash/get"));
 var _isUndefined2 = _interopRequireDefault(require("lodash/isUndefined"));
 var _isNull2 = _interopRequireDefault(require("lodash/isNull"));
 var _constants = require("./constants");
@@ -59,23 +61,37 @@ function filter(sugInput, option, filterTreeNode, filteredPath) {
 /**
  * Traverse all the data by `treeData`.
  */
-function traverseDataNodes(treeNodes, callback) {
+function traverseDataNodes(treeNodes, callback, keyMaps) {
+  const realValueName = (0, _get2.default)(keyMaps, 'value', 'value');
+  const realChildrenName = (0, _get2.default)(keyMaps, 'children', 'children');
   const processNode = (node, ind, parent) => {
-    const children = node ? node.children : treeNodes;
+    const children = node ? node[realChildrenName] : treeNodes;
     let item = null;
     // Process node if is not root
     if (node) {
-      const key = parent ? `${parent.key}${_constants.VALUE_SPLIT}${node.value}` : `${node.value}`;
+      const nodeValue = node[realValueName];
+      const key = parent ? `${parent.key}${_constants.VALUE_SPLIT}${nodeValue}` : `${nodeValue}`;
       const pos = parent ? getPosition(parent.pos, ind) : `${ind}`;
+      // Map original fields to standard field names if keyMaps is provided
+      const mappedData = Object.assign({}, node);
+      if (keyMaps) {
+        Object.entries(keyMaps).forEach(_ref => {
+          let [standardKey, originalKey] = _ref;
+          const value = node[originalKey];
+          if (!(0, _isUndefined2.default)(value)) {
+            mappedData[standardKey] = value;
+          }
+        });
+      }
       item = {
-        data: Object.assign({}, node),
+        data: mappedData,
         ind,
         key,
         pos,
         level: parent ? parent.level + 1 : 0,
         parentKey: parent ? parent.key : null,
         path: parent ? [...parent.path, key] : [key],
-        valuePath: parent ? [...parent.valuePath, node.value] : [node.value]
+        valuePath: parent ? [...parent.valuePath, nodeValue] : [nodeValue]
       };
       callback(item);
     }
@@ -104,18 +120,20 @@ function getKeyByValuePath(valuePath) {
 function getValuePathByKey(key) {
   return key.split(_constants.VALUE_SPLIT);
 }
-function getKeyByPos(pos, treeData) {
+function getKeyByPos(pos, treeData, keyMaps) {
+  const realValueName = (0, _get2.default)(keyMaps, 'value', 'value');
+  const realChildrenName = (0, _get2.default)(keyMaps, 'children', 'children');
   const posArr = pos.split('-').map(item => Number(item));
   let resultData = treeData;
-  let valuePath = [];
+  const valuePath = [];
   posArr.forEach((item, index) => {
     var _a;
-    resultData = index === 0 ? resultData[item] : (_a = resultData === null || resultData === void 0 ? void 0 : resultData.children) === null || _a === void 0 ? void 0 : _a[item];
-    valuePath.push(resultData === null || resultData === void 0 ? void 0 : resultData.value);
+    resultData = index === 0 ? resultData[item] : (_a = resultData === null || resultData === void 0 ? void 0 : resultData[realChildrenName]) === null || _a === void 0 ? void 0 : _a[item];
+    valuePath.push(resultData === null || resultData === void 0 ? void 0 : resultData[realValueName]);
   });
   return getKeyByValuePath(valuePath);
 }
-function convertDataToEntities(dataNodes) {
+function convertDataToEntities(dataNodes, keyMaps) {
   const keyEntities = {};
   traverseDataNodes(dataNodes, data => {
     const {
@@ -130,9 +148,22 @@ function convertDataToEntities(dataNodes) {
       entity.parent.children = entity.parent.children || [];
       entity.parent.children.push(entity);
     }
-  });
+  }, keyMaps);
   return keyEntities;
 }
+/**
+ * Get the value from data item using keyMaps mapping.
+ * Similar to Tree/TreeSelect's getValueOrKey.
+ * When keyMaps maps value to a custom field (e.g., 'id'), use that field;
+ * otherwise fall back to 'value'.
+ */
+function getValueOrKey(data, keyMaps) {
+  const valueName = (0, _get2.default)(keyMaps, 'value', 'value');
+  if (Array.isArray(data)) {
+    return data.map(item => (0, _get2.default)(item, valueName));
+  }
+  return (0, _get2.default)(data, valueName);
+}
 function calcMergeType(autoMergeValue, leafOnly) {
   let mergeType;
   if (leafOnly) {

package/lib/cjs/popover/variables.scss

@@ -1,3 +1,5 @@
+$horizontal-rate: 0.24; // 水平方向矫正因子 ignore-semi-css-trans
+
 // Color
 $color-tooltip_arrow-icon-default: unset; // 箭头图标
 $color-popover-bg-default: var(--semi-color-bg-3); // 默认背景色

package/lib/es/cascader/foundation.d.ts

@@ -1,4 +1,6 @@
 import BaseFoundation, { DefaultAdapter } from '../base/foundation';
+import { KeyMapProps } from './util';
+export type { KeyMapProps };
 export interface BasicData {
     data: BasicCascaderData;
     disabled: boolean;
@@ -115,6 +117,7 @@ export interface BasicCascaderProps {
     virtualizeInSearch?: Virtualize;
     checkRelation?: string;
     remote?: boolean;
+    keyMaps?: KeyMapProps;
     onClear?: () => void;
     triggerRender?: (props: BasicTriggerRenderProps) => any;
     onListScroll?: (e: any, panel: BasicScrollPanelProps) => void;

package/lib/es/cascader/foundation.js

@@ -11,7 +11,7 @@ import _get from "lodash/get";
 import _isEqual from "lodash/isEqual";
 import BaseFoundation from '../base/foundation';
 import { findAncestorKeys, calcCheckedKeysForUnchecked, calcCheckedKeysForChecked, calcCheckedKeys, findDescendantKeys, normalizeKeyList } from '../tree/treeUtil';
-import { filter, convertDataToEntities, normalizedArr, isValid, calcMergeType, getKeysByValuePath, getKeyByPos } from './util';
+import { filter, convertDataToEntities, normalizedArr, isValid, calcMergeType, getKeysByValuePath, getKeyByPos, getValueOrKey } from './util';
 import { strings } from './constants';
 import isEnterPress from '../utils/isEnterPress';
 import { ESC_KEY } from '../utils/keyCode';
@@ -49,7 +49,10 @@ export default class CascaderFoundation extends BaseFoundation {
       const {
         treeData
       } = this.getStates();
-      const key = getKeyByPos(pos, treeData);
+      const {
+        keyMaps
+      } = this.getProps();
+      const key = getKeyByPos(pos, treeData, keyMaps);
       this.handleTagRemoveByKey(key);
     };
   }
@@ -192,9 +195,10 @@ export default class CascaderFoundation extends BaseFoundation {
     const {
       treeData,
       value,
-      defaultValue
+      defaultValue,
+      keyMaps
     } = this.getProps();
-    const keyEntities = convertDataToEntities(treeData);
+    const keyEntities = convertDataToEntities(treeData, keyMaps);
     this._adapter.rePositionDropdown();
     let cacheValue;
     /* when mount */
@@ -231,8 +235,10 @@ export default class CascaderFoundation extends BaseFoundation {
       treeNodeFilterProp,
       filterTreeNode,
       filterLeafOnly,
-      remote
+      remote,
+      keyMaps
     } = this.getProps();
+    const realFilterProp = treeNodeFilterProp !== 'label' ? treeNodeFilterProp : _get(keyMaps, 'label', 'label');
     const entities = Object.values(keyEntities !== null && keyEntities !== void 0 ? keyEntities : this.getState('keyEntities'));
     if (remote) {
       return entities.filter(item => !item._notExist).filter(item => filterTreeNode && !filterLeafOnly || this._isLeaf(item.data)).map(item => item.key);
@@ -246,7 +252,7 @@ export default class CascaderFoundation extends BaseFoundation {
       if (_notExist) {
         return false;
       }
-      const filteredPath = this.getItemPropPath(key, treeNodeFilterProp, keyEntities);
+      const filteredPath = this.getItemPropPath(key, realFilterProp, keyEntities);
       return filter(sugInput, data, filterTreeNode, filteredPath);
     }).filter(item => filterTreeNode && !filterLeafOnly || this._isLeaf(item.data)).map(item => item.key);
   }
@@ -321,7 +327,8 @@ export default class CascaderFoundation extends BaseFoundation {
     const filterable = this._isFilterable();
     const loadingActive = [...activeKeys].filter(i => loadingKeys.has(i));
     const normalizedValue = normalizedArr(value);
-    const valuePath = onChangeWithObject && _isObject(normalizedValue[0]) ? normalizedValue.map(i => i.value) : normalizedValue;
+    const keyMaps = this.getProp('keyMaps');
+    const valuePath = onChangeWithObject && _isObject(normalizedValue[0]) ? getValueOrKey(normalizedValue, keyMaps) : normalizedValue;
     const selectedKeys = getKeysByValuePath(valuePath);
     let updateStates = {};
     const selectedKey = selectedKeys.length > 0 ? selectedKeys[0] : undefined;
@@ -947,8 +954,10 @@ export default class CascaderFoundation extends BaseFoundation {
   getFilteredData() {
     const {
       treeNodeFilterProp,
-      filterSorter
+      filterSorter,
+      keyMaps
     } = this.getProps();
+    const realFilterProp = treeNodeFilterProp !== 'label' ? treeNodeFilterProp : _get(keyMaps, 'label', 'label');
     const {
       filteredKeys,
       keyEntities,
@@ -962,7 +971,7 @@ export default class CascaderFoundation extends BaseFoundation {
         return;
       }
       const pathData = this.getItemPropPath(key, []);
-      const itemSearchPath = pathData.map(item => item[treeNodeFilterProp]);
+      const itemSearchPath = pathData.map(item => item[realFilterProp]);
       const isDisabled = this._isOptionDisabled(key, keyEntities);
       filteredList.push({
         data: item.data,

package/lib/es/cascader/util.d.ts

@@ -1,3 +1,10 @@
+export interface KeyMapProps {
+    value?: string;
+    label?: string;
+    disabled?: string;
+    children?: string;
+    isLeaf?: string;
+}
 export declare function isValid(val: any): boolean;
 export declare function normalizedArr(val: any): any[];
 /**
@@ -8,6 +15,13 @@ export declare function filter(sugInput: string, option: any, filterTreeNode: an
 export declare function getKeysByValuePath(valuePath: (string | number)[][] | (string | number)[]): string[];
 export declare function getKeyByValuePath(valuePath: (string | number)[]): string;
 export declare function getValuePathByKey(key: string): string[];
-export declare function getKeyByPos(pos: string, treeData: any): string;
-export declare function convertDataToEntities(dataNodes: any): any;
+export declare function getKeyByPos(pos: string, treeData: any, keyMaps?: KeyMapProps): string;
+export declare function convertDataToEntities(dataNodes: any, keyMaps?: KeyMapProps): any;
+/**
+ * Get the value from data item using keyMaps mapping.
+ * Similar to Tree/TreeSelect's getValueOrKey.
+ * When keyMaps maps value to a custom field (e.g., 'id'), use that field;
+ * otherwise fall back to 'value'.
+ */
+export declare function getValueOrKey(data: any, keyMaps?: KeyMapProps): any;
 export declare function calcMergeType(autoMergeValue: boolean, leafOnly: boolean): string;

package/lib/es/cascader/util.js

@@ -1,3 +1,4 @@
+import _get from "lodash/get";
 import _isUndefined from "lodash/isUndefined";
 import _isNull from "lodash/isNull";
 import { strings, VALUE_SPLIT } from './constants';
@@ -44,23 +45,37 @@ export function filter(sugInput, option, filterTreeNode, filteredPath) {
 /**
  * Traverse all the data by `treeData`.
  */
-function traverseDataNodes(treeNodes, callback) {
+function traverseDataNodes(treeNodes, callback, keyMaps) {
+  const realValueName = _get(keyMaps, 'value', 'value');
+  const realChildrenName = _get(keyMaps, 'children', 'children');
   const processNode = (node, ind, parent) => {
-    const children = node ? node.children : treeNodes;
+    const children = node ? node[realChildrenName] : treeNodes;
     let item = null;
     // Process node if is not root
     if (node) {
-      const key = parent ? `${parent.key}${VALUE_SPLIT}${node.value}` : `${node.value}`;
+      const nodeValue = node[realValueName];
+      const key = parent ? `${parent.key}${VALUE_SPLIT}${nodeValue}` : `${nodeValue}`;
       const pos = parent ? getPosition(parent.pos, ind) : `${ind}`;
+      // Map original fields to standard field names if keyMaps is provided
+      const mappedData = Object.assign({}, node);
+      if (keyMaps) {
+        Object.entries(keyMaps).forEach(_ref => {
+          let [standardKey, originalKey] = _ref;
+          const value = node[originalKey];
+          if (!_isUndefined(value)) {
+            mappedData[standardKey] = value;
+          }
+        });
+      }
       item = {
-        data: Object.assign({}, node),
+        data: mappedData,
         ind,
         key,
         pos,
         level: parent ? parent.level + 1 : 0,
         parentKey: parent ? parent.key : null,
         path: parent ? [...parent.path, key] : [key],
-        valuePath: parent ? [...parent.valuePath, node.value] : [node.value]
+        valuePath: parent ? [...parent.valuePath, nodeValue] : [nodeValue]
       };
       callback(item);
     }
@@ -89,18 +104,20 @@ export function getKeyByValuePath(valuePath) {
 export function getValuePathByKey(key) {
   return key.split(VALUE_SPLIT);
 }
-export function getKeyByPos(pos, treeData) {
+export function getKeyByPos(pos, treeData, keyMaps) {
+  const realValueName = _get(keyMaps, 'value', 'value');
+  const realChildrenName = _get(keyMaps, 'children', 'children');
   const posArr = pos.split('-').map(item => Number(item));
   let resultData = treeData;
-  let valuePath = [];
+  const valuePath = [];
   posArr.forEach((item, index) => {
     var _a;
-    resultData = index === 0 ? resultData[item] : (_a = resultData === null || resultData === void 0 ? void 0 : resultData.children) === null || _a === void 0 ? void 0 : _a[item];
-    valuePath.push(resultData === null || resultData === void 0 ? void 0 : resultData.value);
+    resultData = index === 0 ? resultData[item] : (_a = resultData === null || resultData === void 0 ? void 0 : resultData[realChildrenName]) === null || _a === void 0 ? void 0 : _a[item];
+    valuePath.push(resultData === null || resultData === void 0 ? void 0 : resultData[realValueName]);
   });
   return getKeyByValuePath(valuePath);
 }
-export function convertDataToEntities(dataNodes) {
+export function convertDataToEntities(dataNodes, keyMaps) {
   const keyEntities = {};
   traverseDataNodes(dataNodes, data => {
     const {
@@ -115,9 +132,22 @@ export function convertDataToEntities(dataNodes) {
       entity.parent.children = entity.parent.children || [];
       entity.parent.children.push(entity);
     }
-  });
+  }, keyMaps);
   return keyEntities;
 }
+/**
+ * Get the value from data item using keyMaps mapping.
+ * Similar to Tree/TreeSelect's getValueOrKey.
+ * When keyMaps maps value to a custom field (e.g., 'id'), use that field;
+ * otherwise fall back to 'value'.
+ */
+export function getValueOrKey(data, keyMaps) {
+  const valueName = _get(keyMaps, 'value', 'value');
+  if (Array.isArray(data)) {
+    return data.map(item => _get(item, valueName));
+  }
+  return _get(data, valueName);
+}
 export function calcMergeType(autoMergeValue, leafOnly) {
   let mergeType;
   if (leafOnly) {

package/lib/es/popover/variables.scss

@@ -1,3 +1,5 @@
+$horizontal-rate: 0.24; // 水平方向矫正因子 ignore-semi-css-trans
+
 // Color
 $color-tooltip_arrow-icon-default: unset; // 箭头图标
 $color-popover-bg-default: var(--semi-color-bg-3); // 默认背景色

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@douyinfe/semi-foundation",
-    "version": "2.99.2",
+    "version": "2.99.3",
     "description": "",
     "scripts": {
         "clean": "rimraf lib",
@@ -14225,8 +14225,8 @@
         }
     },
     "dependencies": {
-        "@douyinfe/semi-animation": "2.99.2",
-        "@douyinfe/semi-json-viewer-core": "2.99.2",
+        "@douyinfe/semi-animation": "2.99.3",
+        "@douyinfe/semi-json-viewer-core": "2.99.3",
         "@mdx-js/mdx": "^3.0.1",
         "async-validator": "^3.5.0",
         "classnames": "^2.2.6",
@@ -14247,7 +14247,7 @@
         "*.scss",
         "*.css"
     ],
-    "gitHead": "59e8cd9364e406b5097b86455646171863e10466",
+    "gitHead": "59a386b5f5a0cbeaa6f7cc14b4f28a67d8062af2",
     "devDependencies": {
         "@babel/plugin-transform-runtime": "^7.15.8",
         "@babel/preset-env": "^7.15.8",

package/popover/variables.scss

@@ -1,3 +1,5 @@
+$horizontal-rate: 0.24; // 水平方向矫正因子 ignore-semi-css-trans
+
 // Color
 $color-tooltip_arrow-icon-default: unset; // 箭头图标
 $color-popover-bg-default: var(--semi-color-bg-3); // 默认背景色