目录— 个文件
⌕
目录加载中…
…/contents/simple/moveAction.ts
1
2
3import { Enum, Node, tween, TweenEasing, UITransform, v3, Vec3 } from "cc";
4import BaseAction from "../baseAction";
5
6export enum MoveFromType {
7 left = "left",
8 right = "right",
9 up = "up",
10 down = "down",
11}
12Enum(MoveFromType)
13
14export interface MoveAniUseData {
15 /**
16 * 隐藏位置
17 */
18 hide?: Vec3,
19 /**
20 * 显示位置
21 */
22 show?: Vec3,
23 /**
24 * 移动方向
25 */
26 fromType?: keyof typeof MoveFromType,
27 /**
28 * 动画曲线
29 */
30 easing?: TweenEasing,
31}
32
33export default class MoveAction extends BaseAction {
34
35 /**
36 * 动画显示
37 */
38 protected show(node: Node, onComplete?: (target?: object | undefined) => void) {
39
40
41 const data = this.getChangeData(node, "show");
42 if (!data) {
43 onComplete && onComplete(node);
44 return;
45 }
46
47 node.setPosition(data.hide);
48 return tween(node).to(this.currentConfig.duration!, { position: data.show }, { easing: data.easing || 'backOut', onComplete }).start();
49 }
50 /**
51 * 动画隐藏
52 */
53 protected hide(node: Node, onComplete?: (target?: object | undefined) => void) {
54 const data = this.getChangeData(node, "hide");
55 if (!data) {
56 onComplete && onComplete(node);
57 return;
58 }
59 return tween(node).to(this.currentConfig.duration!, { position: data.hide }, { easing: data.easing || 'backIn', onComplete }).start();
60 }
61
62 private getChangeData(node: Node, type: "show" | "hide") {
63 const useData: MoveAniUseData | undefined = this.currentConfig.useData;
64 let showPosition: Vec3 = null as any;
65 let hidePosition: Vec3 = null as any;
66 if (!useData?.show || !useData?.hide) {
67 const fromType = useData?.fromType || "down";
68
69 const offset = v3(0, 0, 0);
70 const transform = node.getComponent(UITransform);
71 if (!transform) {
72 console.error("未找到 UITransform组件,不能设置移动");
73 return null;
74 }
75
76 const parentTransform = node.parent?.getComponent(UITransform);
77 if (!parentTransform && !useData?.show && !useData?.hide) {
78 console.error("请先设置'show'或者'hide'属性");
79 return null;
80 }
81 const edgeHidePosition = v3(0, 0, 0);
82 switch (fromType) {
83 case "left":
84 offset.x = transform.width;
85 if (parentTransform)
86 edgeHidePosition.x = -(parentTransform.width * parentTransform.anchorX) - transform.width * (1 - transform.anchorX);
87 break;
88 case "right":
89 offset.x = -transform.width;
90 if (parentTransform)
91 edgeHidePosition.x = parentTransform.width * (1 - parentTransform.anchorX) + transform.width * transform.anchorX;
92
93 break;
94 case "up":
95 offset.y = -transform.height;
96 if (parentTransform)
97 edgeHidePosition.y = parentTransform.height * (1 - parentTransform.anchorY) + transform.height * transform.anchorY;
98 break;
99 case "down":
100 offset.y = transform.height;
101 if (parentTransform)
102 edgeHidePosition.y = -(parentTransform.height * parentTransform.anchorY) - transform.height * (1 - transform.anchorY);
103 break;
104
105 default:
106 break;
107 }
108 if (type == "show") {
109 if (!useData?.show) {
110 hidePosition = useData?.hide || v3(edgeHidePosition);
111 showPosition = hidePosition.clone().add(offset);
112 }
113 else {
114 showPosition = useData.show.clone();
115 hidePosition = useData?.hide || showPosition.clone().subtract(offset);
116 }
117
118 }
119 else {
120 if (!useData?.hide) {
121 showPosition = useData?.show || v3(node.position);
122 hidePosition = showPosition.clone().subtract(offset);
123 }
124 else {
125 hidePosition = useData.hide.clone();
126 showPosition = useData?.show || hidePosition.clone().add(offset);
127 }
128 }
129
130
131 }
132 else {
133 showPosition = useData.show;
134 hidePosition = useData.hide;
135 }
136 return {
137 show: showPosition,
138 hide: hidePosition,
139 easing: useData?.easing
140 }
141 }
142
143}
讲解144 行
位移动画动作实现人工通读
moveAction.ts
按 fromType 方向或显式 show、hide 坐标,计算节点在父节点内的移入移出位置,用 tween 修改 position。未给坐标时依据节点与父节点的 UITransform 尺寸和锚点推算屏幕边缘位置。
先看 show 的分支,再读 getChangeData 里四种方向的偏移与锚点计算,注意坐标是相对父节点的本地坐标。
特殊处理与易错点
- 易错点show 会立即把节点 setPosition 到隐藏位置再 tween,节点会先跳一下。L47
- 边界只有 show 与 hide 都缺时才走方向推算;缺一个时用另一个加减偏移量补齐。L66
- 单位偏移量取自 UITransform 的宽高,位置是相对父节点的本地坐标。L86
- 边界getChangeData 返回 null 时直接回调完成,不产生动画,外层 Promise 仍会正常结束。L43
18注释隐藏位置
22注释显示位置
26注释移动方向
30注释动画曲线
33注释MoveAction:MoveAction 是「基础动作」目录下的实现/辅助。辅助实现文件,配合同目录的入口类使用
38方法算出显示与隐藏坐标,先把节点放到隐藏坐标,再缓动到显示坐标。
53方法算出隐藏坐标,在时长内把节点缓动过去,默认缓动 backIn。
62方法依据 useData 与 fromType 推算显示、隐藏两个坐标并附带缓动,无法推算时返回 null。