# 层级、变换与性能 元素摆好位置之后,还会遇到三类问题:层级怎么沿树生效、怎么缩放旋转与混合、什么时候该缓存。这三件事都写在元素属性上,不需要额外的图层对象。理解它们的前提是渲染树:层级、变换与缓存都沿着父子关系生效,不是全局开关。
## 前置知识 阅读本篇前,建议先读完: - [容器与坐标](./container-and-coordinates.md) - [通用参数](./common-props.md) ## 渲染树、层级与绘制顺序 元素组成一棵渲染树:子元素相对父元素定位,绘制顺序、变换与缓存都沿父子关系生效。同一父级下的兄弟按 `zIndex` 从小到大绘制,命中顺序相反;`zIndex` 只在兄弟之间比较,父级的 `zIndex` 带着整棵子树参与父级兄弟的排序。`zIndex` 与 `hidden` 的完整语义见[通用参数页](./common-props.md#zindex)。 UI 栈也遵循同一套规则。控制器把每个打开的面板当作 UI 容器下的兄弟,按栈顺序分配递增的 `zIndex`;面板之间的遮挡由打开顺序与显示策略决定,面板内部的 `zIndex` 只影响这棵子树内部。先看面板在哪个栈、哪个位置,再看面板内部的兄弟顺序。 ## 变换:scale、rotate 与 transform `scale` 是 `[x, y]` 数组,分别表示横向与纵向缩放比例;`rotate` 的单位是弧度,不是角度。两者都作用在元素自己的坐标系里,锚点就是变换中心:缩放与旋转都绕锚点进行。默认锚点在左上角;改成 `[0.5, 0.5]` 后,同一个缩放或旋转会绕中心进行,元素的视觉位置与扩展方向都会跟着改变。 `scale` 与 `rotate` 是底层 `transform` 的简写:`transform` 属性可以直接接收一个 `Transform` 对象,用来表达更一般的矩阵与平移。日常写界面用 `scale` / `rotate` 就够了;需要直接替换整个变换矩阵时再传 `transform`,本篇不展开构造方式。 ```tsx // scale 写 [x, y];rotate 写弧度。两者都是 transform 的简写属性 // 同一个变换换锚点:anc 决定绕哪个点缩放 / 旋转 ``` `scale` 只写一个数字不会生效。需要等比缩放时写 `scale={[1.2, 1.2]}`,需要压扁时分别给两个值。`rotate` 想转 30 度要写 `Math.PI / 6`;写成 `30` 会转很多圈。 `container` 默认开启缓存。对默认缓存的容器做 `scale` 或 `rotate` 时,引擎会先画出缓存图,再对这张图做变换;缓存图被缩放或旋转后会重新采样,边缘可能发糊。需要清晰变换时,给做变换的容器加 `nocache`,让子元素按变换直接绘制。 下面四组对比同一个 `scale` 或 `rotate` 在 `anc={[0, 0]}` 与 `anc={[0.5, 0.5]}` 下的差异。每组锚点位置的白点就是变换中心:`anc={[0, 0]}` 以左上角为基准,缩放向右下方展开、旋转绕左上角扫过;`anc={[0.5, 0.5]}` 以中心为基准,缩放向四周展开、旋转绕中心转动,两者的视觉位置也不同。 ## 变换沿树传递 父级的平移、缩放、旋转会复合到子级。父级移动,子级跟着移动;父级放大,子级的坐标与尺寸都按放大后的比例理解;父级旋转,子级的局部坐标轴也跟着旋转。子元素不需要知道父级做了哪些变换,它只按自己的局部坐标描述内容。 ```tsx // 父容器放大 1.5 倍;加 nocache 让子元素按变换直接绘制,避免缓存图被重采样 ``` 子矩形的 `loc` 仍是 `[0, 0, 140, 100]`,但父级放大后,它在画布上占 210×150。文字也一起放大,包括字形。要反过来「让子元素不跟着放大」,不能靠给子元素写一个 0.667 的 `scale` 去抵消——父级变换已经作用在整棵子树上;正确做法是把需要独立缩放的内容移出这个父级,放到另一个不被缩放的容器里。 嵌套变换不要用「把每层坐标累加成屏幕坐标」的心算。按树逐层理解:先看元素在父容器里的局部坐标,再看父容器在它自己父级里的位置与变换。需要跨元素比较位置时,用事件里的 `absoluteX` / `absoluteY`(画布坐标),不要自己把若干层的 `x` / `y` 相加。 下面左侧的父容器放大了 1.5 倍,子元素仍按局部坐标写;右侧是同一棵子树未缩放的参考。 ## 缓存:cache 与 nocache {#缓存与脏更新} 默认值只作判断起点:`container` 默认缓存;`text`、`image` 与全部 `g-*` 图形默认不缓存。 - 什么时候开:结构复杂、内容稳定、重复绘制成本高的子树。 - 什么时候不开:内容频繁变化、子树很小,或者缓存的维护成本超过收益。 `cache` 用于打开缓存,`nocache` 用于关闭缓存。两者都在元素创建时决定,`nocache` 优先级更高;不要把它当成运行时反复切换的开关,需要改变缓存策略时应当重新创建元素。 ```tsx // 静态复杂子树:内容不变、绘制成本高,开缓存 // 频繁变化的子树:文字随时会被改写,不开缓存 ``` ## composite `composite` 默认 `source-over`。值取 `GlobalCompositeOperation`(见 [MDN 的 composite 文档](https://developer.mozilla.org/zh-CN/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation)),例如 `multiply`、`screen`、`overlay`、`lighter`。它影响当前绘制结果与已绘制内容的混合方式,不改变布局与命中区域。 ```tsx // composite 默认 source-over;这里用 multiply 让上层与已绘制内容混合 ``` 下面三组是相同的重叠图形,分别使用 `source-over`、`multiply` 与 `screen`。 ## 性能:缓存的代价 缓存用离屏画布换绘制次数:每帧少画一遍子树,代价是多占一份画布内存,内容变化时还要重画整块缓存。嵌套缓存会叠加内存占用,只在绘制成本确实高的地方开。没有确认有性能问题之前,先不开缓存。 ## 边界与注意 - `scale` 必须是 `[x, y]` 数组。写成数字不会生效,也不会报错。 - `rotate` 的单位是弧度。想转 30 度要写 `Math.PI / 6`,不是 `30`。 - 锚点是变换中心:缩放与旋转都绕锚点进行,改锚点会连同变换一起改变视觉位置。 - 父级变换会作用在整棵子树上;子元素不能用自己的 `scale` 抵消父级缩放,需要独立缩放时把内容移出该父级。 - `cache` / `nocache` 在元素创建时决定,`nocache` 优先级更高;不要把它当成运行时反复切换的开关。 - `composite` 影响绘制结果的混合方式,不改变布局与命中区域。