构建可遍历的嵌套分类树结构:TypeScript + React 实战指南

落晨吖_1831

落晨吖_1831

2026-10-18

605人浏览

原创

构建可遍历的嵌套分类树结构:TypeScript + React 实战指南

本文介绍如何设计一个真正支持多层嵌套、属性可枚举且父子关系清晰的分类树结构,解决因对象字面量覆盖导致父类实例丢失、子项无法访问父级信息等常见问题,并提供 react 渲染时的安全遍历方案。

本文介绍如何设计一个真正支持多层嵌套、属性可枚举且父子关系清晰的分类树结构,解决因对象字面量覆盖导致父类实例丢失、子项无法访问父级信息等常见问题,并提供 react 渲染时的安全遍历方案。

在前端开发中,构建分类树(如商品类目、导航菜单)常需兼顾类型安全、运行时可遍历性与层级语义完整性。原始代码的问题核心在于:categories.pets 创建了 Category 实例,却立即被一个匿名对象覆盖,导致 pets 实例被丢弃——子属性(如 dishes)不再属于 Category 类型,自然没有 title,也无法追溯其父级。

✅ 正确做法:将子项作为自有 getter 动态挂载到 Category 实例上

class Category {
  constructor(readonly title: string) {} // 建议直接使用 public readonly title,更简洁
}

const categories = {
  get pets() {
    const pets = new Category('Pets');
    Object.defineProperty(pets, 'dishes', {
      get() {
        return new Category('Dishes'); // 子项也是 Category 实例
      },
      enumerable: true, // ✅ 关键:确保可被 Object.entries 遍历
      configurable: true,
    });
    return pets;
  },
  get cloth() {
    const cloth = new Category('Cloth');
    Object.defineProperty(cloth, 'accessories', {
      get() {
        return new Category('Accessories');
      },
      enumerable: true,
      configurable: true,
    });
    return cloth;
  }
};

? Object.defineProperty 是关键:它让 dishes 成为 pets 实例的可枚举自有属性,而非新对象的临时字段。这样 categories.pets 返回的是真正的 Category 实例,且 Object.keys(categories.pets) 或 Object.entries(...) 能正确获取 'dishes'。

? React 渲染:安全遍历嵌套树(过滤私有属性)

由于 Category 实例包含 title(公有)和 _title(若保留原私有字段名),直接 Object.entries(category) 会暴露内部字段(如 _title),导致渲染异常或报错。推荐两种防御式处理:

react-pro
react-pro

你是一位 React 专家,擅长高级 Hook、性能优化、状态管理和现代 React 模式。适用场景:高级 Hook 模式...

下载

方案一(推荐):使用 TypeScript 私有字段(ES2022+)

class Category {
  #title: string; // 真正私有,不会出现在 Object.keys 中
  constructor(title: string) {
    this.#title = title;
  }
  get title() {
    return this.#title;
  }
}

此时 Object.entries(pets) 仅返回 { dishes: Category },无需额外过滤。

方案二:运行时过滤下划线开头属性(兼容性更强)


    {Object.entries(categories).map(([slug, category]) => (
  • {category.title}
    • {/* 过滤掉 _title 等非业务属性 */} {Object.entries(category) .filter(([key]) => !key.startsWith('_')) .map(([subSlug, subCategory]) => (
    • {subCategory.title}
    • ))}
    ))}

⚠️ 注意事项与最佳实践

  • 避免对象字面量覆盖:永远不要在 getter 中 return { ... } 替换已创建的类实例,否则丢失类型、方法和继承链。
  • 显式声明 enumerable: true:Object.defineProperty 默认 enumerable: false,务必显式设置,否则 Object.entries 不可见。
  • 考虑扁平化 + parentId 方案:对于超深/动态树(如 CMS 类目),建议改用数组扁平结构 + parentId 映射,配合 useMemo 构建树形,更易维护、搜索和更新。
  • 类型提示增强:可为 categories 添加接口,明确每个 key 的返回类型:
    interface Categories {
      readonly pets: Category & { readonly dishes: Category };
      readonly cloth: Category & { readonly accessories: Category };
    }

通过以上改造,categories.pets.dishes 不仅可被 new Product(...) 正确构造,其父级 pets.title 也能在 JSX 中自然访问——真正实现结构即语义,实例即节点的健壮树形设计。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

react typescript

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4966

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1229

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4884

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

960

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1876

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3505

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4553

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3000

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

948

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 12.2万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习