Haze项目中的绘制路径优化方案探讨

背景介绍

Haze是一个用于实现模糊效果的开源UI组件库。在现有实现中，Haze采用了一种"烟雾和镜子"的绘制方式：所有模糊区域都在haze布局节点中绘制，而hazeChild节点仅负责更新大小、形状等信息，供haze修饰符读取以确定绘制位置。

当前架构的问题

这种设计导致了几个关键问题：

1. 子节点不参与实际绘制过程
2. 模糊效果的层级控制不够灵活
3. 中间节点的内容可能被忽略

这些问题具体表现为：当需要在模糊效果和子节点之间插入其他UI元素时，系统无法正确处理这些中间内容的显示层级。

提出的解决方案

核心思路是将绘制路径反转：

1. 让haze节点创建图形层并存储在HazeState中
2. 每个hazeChild节点使用该图形层在本地应用模糊效果

这种反转带来了以下优势：

• 模糊效果可以在子节点本地应用
• 解决了子节点不参与绘制的问题
• 提高了模糊效果的精确控制

技术实现考量

方案一：可选模式

将新的绘制模式作为可选功能提供，开发者可以根据需求选择使用传统模式或反转模式。这种实现相对简单，但需要维护两套绘制逻辑。

方案二：层级感知模式

引入hazeAncestor修饰符，开发者需要手动应用于中间祖先节点。该修饰符会创建额外的图形层，子节点在应用效果时会考虑所有祖先层的叠加效果。这种方案更复杂但提供了更精确的控制。

权衡与取舍

反转绘制路径虽然解决了现有问题，但也引入了新的限制：位于haze和hazeChild之间的任何绘制内容将被忽略。这是因为子节点直接绘制了父节点的模糊效果，跳过了中间层级。

实施建议

对于初期版本，建议采用方案一作为过渡，因为它：

1. 实现难度较低
2. 保持向后兼容
3. 为开发者提供灵活性

方案二虽然更完善，但考虑到复杂度和开发周期，更适合作为后续迭代的目标。

总结

Haze项目的绘制路径优化是一个典型的架构权衡案例。通过反转绘制路径，可以解决多个现存问题，但也需要谨慎处理由此带来的新限制。分阶段实施的策略既能快速解决问题，又能为未来的功能扩展奠定基础。