cocosCreator 之 节点组件
创始人
2025-05-31 00:07:24

cocosCreator版本: 3.7


简介

cocosCreator的工作流程是通过节点–组件来实现的,节点作为场景中的基本单位, 而不同功能的组件挂载在节点之上,来完成页面的搭建。

Node1SceneCommponet1_1Commponet1_2Node2Commponet2_1Commponet2_2Node3Commponet3_1Commponet3_2

比如Canvas节点的组成组件部分:

请添加图片描述

UI变换组件画布组件布局组件脚本组件cc.UITransformCanvascc.Canvascc.WidgetmainScene

在cocosCreator中,脚本也可以作为组件嵌入到节点中。每个不同功能的节点都是由各种组件组成。

比如,Sprite节点的组成组件部分:
请添加图片描述
比如,Button节点的组成组件部分:

简单的理解就如官方文档所说: 场景由多个节点构成,节点作为实体,不同功能的组件挂载到节点上。参考:节点和组件


![请添加图片描述](https://img-blog.csdnimg.cn/706f122971044b23b09ec9a28c48e0c0.png)

脚本访问节点

在组件脚本中,访问当前脚本的所在节点,我们可以使用通过this.node访问。

基本属性:
请添加图片描述

  • postion 节点位置相关,使用方法:
// 通过接口方法使用
this.node.setPosition(100, 50, 0);
this.node.setPosition(new Vec3(100, 50, 0));
// 通过变量使用
this.node.position = new Vec3(100, 50, 0);
  • rotation 节点旋转相关,使用方法:
this.node.setRotationFromEuler(90, 0, 0);
  • scale 节点缩放相关,使用方法:
this.node.setScale(2, 2, 2);

常用属性:

  • 激活相关
this.node.active = true;				// 激活节点
this.node.active = false;				// 

激活后的节点,该节点和所有子节点上的组件都会被启用

  • 节点是否有效相关
// 通常用于检测节点是否销毁的判定
let isValid = this.node.isValid;
  • 获取节点的子节点相关
let children = this.node.children;				// 获取子节点的数组相关,不包含子节点的子节点
let length = this.node.children.length;		// 获取子节点的数量
  • 更换节点的父节点相关
// 父节点为parentNode, 子节点为this.node
// 方法1
this.node.parent = parentNode;
// 方法2, 注意removeFromParent的参数要为false, 否则会清空节点上绑定的事件和action等
this.node.removeFromParent(false);
parentNode.addChild(this.node);
  • 创建新节点
let node = new Node("Box");
node.setPostion(0, 0, 0);
// 创建的节点不会主动添加到场景中,需要手动添加
director.getScene().addChild(node);
  • 克隆节点相关,主要接口使用:instantiate
@property(Node)
private bulletNode: Node = null;start() {let scene = director.getScene();let newNode = instantiate(bulletNode);newNode.setPosition(0, 0, 0);scene.addChild(newNode);
}

关于克隆节点相关,也可以通过预制体来构建

@property({type: Prefab})
private bulletNode: Prefab = null; start() {// ...
}
  • 销毁节点相关
// 使用this.node.destory() 
// 它并不是立即被移除,而是在当前帧逻辑更新结束后,执行
this.node.destory()

注意:destoryremoveFromParent二者相比, 后者并不会从内从中释放,引擎内部仍会持有它的数据。

如果一个节点不再使用,就调用它的destory就可以了,否则会导致内存泄漏。


脚本访问节点组件

脚本访问同节点下的其他组件可使用接口:getComponent

// 访问该组件所在的节点
let curNode = this.node; // 访问该节点下下的组件, 脚本也作为组件,使用脚本的名字即可
let label = this.node.getComponent(Label);
let script = this.node.getComponent("MainScene");

脚本访问其他节点或组件, 一般通过属性检查器Property来设定,比如:
请添加图片描述

@property({type: Button, tooltip: "这是一个按钮"})
public backBtn: Button = null!;start() {this.backBtn.position = new Vec3(0, 0, 0);
}

更多参考:访问节点和其他组件


组件

cocosCreator中的组件主要由两大类:

  • 2D渲染组件
  • UI组件

2D渲染组件主要有:

精灵组件文本组件遮罩组件绘图组件富文本组件骨骼组件地图组件Sprite2D渲染组件LabelMaskGraphicsRichTextSpineTiled

UI组件主要有:

画布组件UI变换组件对齐组件容器组件输入组件滚动容器组件进度条组件滑动器组件其他CanvasUI组件UITransformWidgetLayoutEditBoxScrollViewProgressBarSlider...

继承于Componet的类都被称为组件类,其对象被称为组件。需要注意的是:组件的不能由构造函数创建,必须通过节点来创建,这样节点就能够操控组件的生命周期。

@ccclass("MyComponent")
class MyComponent extends Component {// 
}// 创建组件
const componet = this.node.addComponent(MyComponent);
// 销毁组件
this.node.removeComponet(MyComponet);

同一节点上的组件执行顺序按照属性检查器来的排列顺序从上到下的执行, 可以通过齿轮按钮向上移动/向下移动来控制。

如果使用脚本控制的话,可以使用executionOrder来设定,比如:

import { _decorator, Component, Button} from 'cc';
const { ccclass, property, executionOrder} = _decorator;@ccclass('mainScene')
// 数值越小,越先执行。默认为0
// 仅对onLoad, onEnable, start, update, lateUpdate有效, 对onDisable, onDestory无效
@executionOrder(-1)
export class mainScene extends Component {
}

详情参考:组件和组件执行顺序

相关内容

热门资讯

吸猫伐是什么意思 吸猫是吸哪里 作为铲屎官,相信对于网络上流行的各种与猫咪相关的梗都是了然于心的,什么吸猫啦,撸猫啦,云养猫啦……等...
世界上最漂亮的人 世界上最漂亮... 此前在某网上,选出了全球265万颜值姣好的女性。从这些数量庞大的女性群体中,人们投票选出了心目中最美...
重庆属于哪个省份的 重庆在中国... 重庆有多大,大到超出我们的想象,重庆作为我国4个直辖市之一,印象里应该跟京津沪面积差不多,可事实上却...
阿西吧是什么意思 阿西吧相当于... 即使你没有受到过任何外语培训,你也懂四国语言。汉语:你好英语:Shit韩语:阿西吧(아,씨발! )日...