目录— 个文件
⌕
目录加载中…
…/contents/simple/scaleAction.ts
1import { Node, tween, TweenEasing, v3, Vec3, Widget } from "cc";
2import BaseAction from "../baseAction";
3
4/**
5 * 数据
6 */
7export interface ScaleAniUseData {
8 /**
9 * 隐藏缩放
10 */
11 hide?: Vec3,
12 /**
13 * 显示缩放
14 */
15 show?: Vec3,
16 /**
17 * 动画曲线
18 */
19 easing?: TweenEasing,
20}
21
22export default class ScaleAction extends BaseAction {
23 /**
24 * 动画显示
25 */
26 protected show(node: Node, onComplete?: (target?: object | undefined) => void) {
27 const useData: ScaleAniUseData | undefined = this.currentConfig.useData;
28 const toScale = useData?.show || v3(node.scale.x, node.scale.y, 1);
29 const fromScale = useData?.hide || v3(0, 0, 1);
30 node.setScale(fromScale);
31 //scale会影响适配,所以执行完成动画后重新更新适配
32 const updateAlignment = (target: Node) => {
33 const widget = target?.getComponent(Widget);
34 if (!widget) {
35 return;
36 }
37 widget.updateAlignment();
38 target.children.forEach(element => {
39 updateAlignment(element);
40 });
41 }
42
43
44 return tween(node).to(this.currentConfig.duration!, { scale: toScale }, {
45 easing: useData?.easing || 'backOut', onComplete: (target) => {
46 updateAlignment(node);
47 onComplete?.(target);
48
49 }
50 }).start();
51 }
52
53 /**
54 * 动画隐藏
55 */
56 protected hide(node: Node, onComplete?: (target?: object | undefined) => void) {
57 const useData: ScaleAniUseData | undefined = this.currentConfig.useData;
58 const hideScale = useData?.hide || v3(0, 0, 1);
59 return tween(node).to(this.currentConfig.duration!, { scale: hideScale }, { easing: useData?.easing || 'backIn', onComplete }).start();
60 }
61
62}
63
讲解64 行
缩放动画动作实现人工通读
scaleAction.ts
用 tween 修改节点 scale,实现从隐藏缩放到显示缩放的弹出与反向收起,默认隐藏缩放为 0 0 1,显示沿用调用前的缩放。显示完成后递归刷新自身与所有子节点的 Widget 对齐,避免缩放影响适配。
先看 show 的起始缩放设置,再看 updateAlignment 的递归刷新,最后看 hide。
特殊处理与易错点
- 设计show 结束后对节点及全部子节点递归调用 Widget.updateAlignment,弥补缩放对适配的影响。L32
- 边界未传 show 缩放时用节点当前 scale,但 z 固定为 1;未传 hide 时用 0 0 1。L28
- 易错点show 先把节点缩放到隐藏值,若当前 scale 已是 0 且未传显示缩放,动画会原地不动。L30
- 边界hide 的起点取节点当前缩放,缓动到隐藏值,默认 backIn。L57
11注释隐藏缩放
15注释显示缩放
19注释动画曲线
22注释ScaleAction:ScaleAction 是「基础动作」目录下的实现/辅助。辅助实现文件,配合同目录的入口类使
26方法先记录目标缩放,把节点缩到隐藏值,再缓动到目标并在完成时刷新 Widget 对齐。
32注释scale会影响适配,所以执行完成动画后重新更新适配
56方法在时长内把节点缩放缓动到隐藏缩放,默认 0 0 1。