FigmaToCode项目中组旋转问题的技术解析

问题现象

在FigmaToCode项目中，当处理包含旋转属性的组(group)时，HTML渲染出现了不正确的旋转效果。具体表现为：

1. 组的旋转角度被错误地应用了两次：一次直接应用于组本身，另一次又应用于组内的子元素
2. 当组内元素本身也有旋转属性时，旋转效果会叠加，导致最终渲染角度与设计不符
3. 多层嵌套的组结构会使问题更加明显，旋转偏差会不断累积放大

技术背景

Figma的API在处理组旋转时有一个特殊行为：当一个组被旋转时，API不仅会返回组的旋转属性，还会自动将相同的旋转角度应用到组内的所有子元素上。这意味着：

• 如果一个组旋转45度，组内的每个子元素也会被标记为旋转45度
• 如果子元素本身也有旋转属性(比如30度)，最终实际渲染时会叠加这两个旋转角度(变成75度)

问题根源

FigmaToCode项目在转换过程中，直接使用了Figma API返回的旋转数据，没有对这种特殊的旋转叠加行为进行处理。这导致了：

1. 组的旋转被正确应用
2. 组内子元素的旋转也被应用(但实际上Figma已经自动应用了一次)
3. 结果就是旋转效果被重复应用，导致最终渲染角度不正确

解决方案

正确的处理方式应该是在转换过程中：

1. 识别出组的旋转角度
2. 对于组内的每个子元素，从其旋转角度中减去组的旋转角度
3. 只保留差值部分作为子元素的实际旋转属性

例如：

• 组旋转45度
• 子元素旋转45度(由Figma自动添加)
• 处理后：子元素旋转0度(45-45)

或者：

• 组旋转45度
• 子元素旋转90度(设计指定45度+Figma自动添加45度)
• 处理后：子元素旋转45度(90-45)

实现建议

在代码实现上，建议：

1. 在遍历节点树时，维护一个"当前累积旋转角度"的变量
2. 遇到组节点时，记录其旋转角度并更新累积值
3. 处理子节点时，用子节点的旋转角度减去累积值
4. 离开组节点时，恢复之前的累积值

这种方法可以正确处理多层嵌套的组结构，确保每层旋转都能被正确计算而不重复应用。

总结

Figma API的这种特殊行为确实容易造成混淆，但理解了其工作原理后，解决方案相对直接。关键在于识别并补偿Figma自动添加的旋转效果，确保最终渲染结果与设计意图一致。这个问题也提醒我们，在使用设计工具的API时，必须充分理解其数据模型和行为特性，才能实现准确的转换。