InteractiveHtmlBom组件分组功能使用指南

组件分组功能原理

InteractiveHtmlBom是一款用于生成交互式BOM表的工具，其核心功能之一是对电子元件进行智能分组。在实际PCB设计中，经常会出现多个相同型号的元件分布在电路板不同位置的情况。通过分组功能，可以将这些相同元件合并显示，大大简化BOM表的查看和管理。

分组字段配置方法

分组功能通过--group-fields参数实现，该参数指定用于分组的元件属性字段。常见的使用场景是按照元件型号(PART_NUMBER)进行分组：

python generate_interactive_bom.py design.json --group-fields "PART_NUMBER"

常见配置误区

很多用户会遇到分组效果不符合预期的情况，这通常是由于错误地同时使用了--extra-fields参数。该参数实际上会同时影响分组字段和显示字段，导致非预期的分组行为。

错误示例：

--group-fields "PART_NUMBER" --extra-fields "PART_NUMBER,Y"

正确做法是明确区分分组字段和显示字段：

--group-fields PART_NUMBER --show-fields Value,Footprint,PART_NUMBER,Y

显示字段与分组字段的关系

• 分组字段：决定哪些元件会被合并为一组
• 显示字段：控制BOM表中显示的列信息

两者需要分开配置才能获得预期的分组效果。如果希望某字段既用于分组又显示在表中，需要在两个参数中都包含它。

界面交互功能

InteractiveHtmlBom生成的BOM表具有丰富的交互功能：

1. 列显示控制：可以隐藏/显示特定列
2. 元件筛选：通过复选框选择显示/隐藏特定元件
3. 重置功能：通过菜单中的"Reset all settings"可以清除所有本地存储的界面配置

这些界面设置会保存在浏览器的本地存储中，不会影响原始数据文件。当需要恢复默认视图时，使用重置功能即可。

最佳实践建议

1. 优先使用PART_NUMBER作为分组字段，这是最常用的元件标识
2. 对于需要特殊处理的元件，可以考虑添加额外分组字段
3. 显示字段应包含足够的设计信息，如Value、Footprint等
4. 定期清理浏览器缓存，特别是在分享BOM表给他人查看时

通过合理配置分组功能，可以显著提高PCB设计审查和元件采购的效率，特别是在处理包含大量重复元件的大型设计时。