# UI 性能 多数简单 UI 不需要特别的性能优化。渲染系统会按需更新,缓存也默认开在合适的元素上;按常规方式写,性能通常已经足够。下面是一组日常习惯,用来减少不必要的绘制与内存占用,按需采用即可。 ## 前置知识 阅读本篇前,建议先读完: - [层级、变换与性能](../basics/layer-transform-performance.md) - [UI 系统](./ui-system.md) ## 元素平铺与分组 同一层里堆很多兄弟元素,会让一次更新牵动整层。更新会沿父链标脏,父容器需要重新遍历并绘制受影响的部分;兄弟越多,重复的工作越明显。按更新频率分组:把一起变化、且不常变的元素放进同一个 `container`,把频繁变化的元素单独放。不要为了分组嵌得太深,层级越深,布局、绘制与命中遍历的递归也越深。 不推荐把静态内容与频繁变化的内容全部平铺在同一层: ```tsx ``` 推荐把不常变的内容收进一个容器,把变化的文字单独放: ```tsx ``` ## 长列表:Scroll 与 Page 不得不平铺一长串元素时,用 `Scroll` 或 `Page`。`Scroll` 按**直接子元素**的包围盒计算总长度,并把视口外的直接子元素隐藏:不绘制、不命中,元素与状态仍保留。因此每一行都要直接挂在 `Scroll` 下,不要先用一个大容器把全部内容包起来,否则 `Scroll` 只能看到一整块内容。 `Scroll` 适合需要连续滚动、行高不固定的列表。`Page` 只渲染当前页,适合页数固定、单页内容复杂或总条目更多的情况;代价是翻页而不是滚动。简单列表先用 `Scroll`,更大或更复杂的列表再考虑 `Page`。 ```tsx {rows.map(row => ( ))} ``` ```tsx {page => { return rowsOfPage(page).map(row => ( )); }} ``` `Scroll` 与 `Page` 的参数见[内置组件:布局](./builtin-layout.md)。 ## 渲染函数中的自我更新 不要在元素的渲染函数里调用它自己的更新方法。渲染函数已经在绘制这个元素,再次触发更新会形成递归;开发环境会输出警告,指出元素类型与 `uid`。需要随时间变化的内容,改由响应式状态或外部的定时逻辑驱动,让渲染函数只读取当前值。 不推荐在渲染函数里更新自身: ```tsx const render = () => { element.value?.update(); }; ; ``` ## cache 与 nocache `container`、`container-custom` 与 `custom` 默认缓存;`text`、`image` 与全部 `g-*` 默认不缓存。缓存适合结构复杂、内容稳定、重复绘制成本高的子树;一行文字、一个矩形,或者每帧都在变的进度与动画,直接绘制通常更便宜。 默认缓存的容器如果只装一行简单文字,可以加 `nocache` 省掉离屏画布与贴回。默认不缓存的元素如果内容复杂且很少变化,可以加 `cache` 复用绘制结果。`nocache` 优先于 `cache`;两者都可以随 props 动态修改,切换时会按新状态启用或清理缓存。没有必要每帧反复切换,但不要把它们当成创建后不可改的固定值。 ```tsx ``` ```tsx ``` 缓存的默认值与开关语义见[层级、变换与性能](../basics/layer-transform-performance.md#缓存与脏更新)。 ## 像素风:抗锯齿与高清 抗锯齿控制缩放时的插值。像素图的边缘本来就是硬边,插值会把边缘变成半透明过渡,放大后容易发虚;因此像素图应使用 `noanti`。`hd` 只对开启缓存的元素有效:缓存的本来就是 1x 像素数据时,按设备像素比放大不会增加信息,可以配 `hd={false}` 减少缓存开销。 ```tsx ``` `hd` 与 `anti` / `noanti` 的完整说明见[通用参数](../basics/common-props.md)。 ## 显隐:hidden 与条件渲染 需要显示或隐藏一块内容时,优先用 `hidden`。它只跳过绘制与命中,元素、组件状态、事件监听与按键作用域都还在;再次显示时直接恢复,不需要重新创建。不要用条件表达式卸载元素,也不要把它移到画面外或把颜色调成透明:前两种会改变树结构或布局,后一种仍然参与绘制与命中。 不推荐用条件表达式切换显隐: ```tsx { open.value ? : null; } ``` 推荐用 `hidden`: ```tsx ``` 只有确认一块长期不用、体积又大的子树需要释放时,才用条件渲染卸载。更多条件与列表写法见[条件渲染与循环渲染](./conditional-and-list-rendering.md)。