函数: findTreeNodeItem()

function findTreeNodeItem<T>(
   data, 
   val, 
   key?, 
   children?): T | undefined;

定义于: tree.ts:116

从树形数据中按 key 字段查找并返回匹配的那一项（深度优先，命中即返回）。

类型参数

类型参数	默认类型
T	any

参数

参数	类型	描述
data	T[]	数组数据，平级或树形数组皆可
val	T[keyof T]	目标节点在 key 字段上的值（应唯一）
key	keyof T	查找所依据的键名，默认 'id'
children	keyof T	子级集合的键名，默认 'children'

返回值

T | undefined

匹配到的节点本身；未找到时返回 undefined

备注

只取目标节点本身；若需要其直接父级请用 getTreeParentItem，需要「根 → 目标」完整链路请用 getTreeParentList。

示例

const list = [
  {
    name: 'option1', id: 1,
    children: [
      { name: 'option1.1', id: 3 },
    ],
  },
  { name: 'option2', id: 2 },
]

findTreeNodeItem(list, 3, 'id', 'children')
// => { name: 'option1.1', id: 3 }