InteractiveHtmlBom项目中的字段显示控制技巧

在KiCad的InteractiveHtmlBom插件使用过程中，控制BOM表中显示哪些字段是一个常见需求。本文将详细介绍如何通过命令行参数精确控制BOM表的字段显示，避免重复字段，并理解字段排列的基本规则。

字段显示控制参数解析

InteractiveHtmlBom提供了两个关键参数来控制BOM表中的字段显示：

1. --show-fields：明确指定要在BOM表中显示的字段列表
2. --group-fields：指定用于组件分组的字段列表

需要注意的是，--extra-fields参数实际上是一个快捷方式，它会自动将指定字段添加到默认的显示和分组字段列表中（默认包含Value和Footprint）。因此，当需要完全自定义显示字段时，应该避免使用--extra-fields，而是直接使用--show-fields和--group-fields参数。

默认字段的特殊性

BOM表中有两个特殊字段具有固定位置：

• Reference字段：始终显示在表格最左侧
• Quantity字段：始终显示在表格最右侧

这两个字段的位置无法通过参数调整，是InteractiveHtmlBom的固定设计。其他自定义字段则会按照在--show-fields参数中指定的顺序显示在这两个固定字段之间。

实际应用建议

1. 避免字段重复：不要同时使用--extra-fields和--show-fields，这会导致字段重复显示

2. 完全自定义字段集示例：

   --show-fields "PartNumber,Case,Value_SCH" --group-fields "PartNumber,Case"
   

3. 表格列调整：虽然生成时无法调整列顺序，但在生成的HTML界面中，用户可以通过拖放方式重新排列中间字段列的位置（Reference和Quantity除外）

总结

掌握InteractiveHtmlBom的字段显示控制技巧可以显著提高BOM表的可读性和实用性。关键在于理解不同参数的作用机制，特别是--show-fields和--group-fields的配合使用，以及默认字段的特殊处理方式。通过合理配置这些参数，用户可以创建出完全符合项目需求的BOM表布局。