常用节点和组件接口
在通过访问节点和组件介绍的方法获取到节点或组件实例后,这篇文章将会介绍通过节点和组件实例可以通过哪些常用接口实现我们需要的种种效果和操作。这一篇也可以认为是cc.Node和cc.Component类的API阅读指南,可以配合 API 一起学习理解。
节点状态和层级操作
假设我们在一个组件脚本中,通过this.node
访问当前脚本所在节点。
关闭/激活节点
this.node.active = false;
该操作会关闭节点,意味着:
this.node.active = true;
该操作会激活一个节点:
- 在场景中重新显示该节点和所有子节点,除非子节点单独设置过关闭
- 该节点和所有子节点上的所有组件都会被启用,他们中的
update
方法之后每帧会执行 - 这些组件上如果有
onEnable
方法,这些方法将被执行。
更改节点的父节点
假设父节点为parentNode
,子节点为this.node
您可以:
parentNode.addChild(this.node)
或
this.node.parent = parentNode
这两种方法是等价的。
注意,通过创建和销毁节点介绍的方法创建出新节点后,要为节点设置一个父节点才能正确完成节点的初始化。
索引节点的子节点
this.node.children将返回节点的所有子节点数组。
this.node.childrenCount讲返回节点的子节点数量。
注意以上两个 API 都只会返回节点的直接子节点,不会返回子节点的子节点。
更改节点的变换(位置、旋转、缩放、尺寸)
更改节点位置
分别对 x 轴和 y 轴坐标赋值:
this.node.x = 100;this.node.y = 50;
设置 position 变量:
this.node.position = cc.p(0,0);
使用 setPosition 方法:
node.setPosition(cc.p(0,0));node.setPosition(0,sans-serif; font-size:16px; line-height:25.6px"> 以上两种用法等价。
更改节点旋转
this.node.rotation = 90;
this.node.setRotation(90);
更改节点缩放
this.node.scaleX = 2;this.node.scaleY = 2;
this.node.setScale(2);this.node.setScale(2,2);
以上两种方法等价。setScale
传入单个参数时,会同时修改scaleX
和scaleY
。
更改节点尺寸
this.node.setContentSize(100,100);this.node.setContentSize(cc.p(100,100));
this.node.width = 100;this.node.height = 100;
以上两种方式等价。
更改节点锚点位置
this.node.anchorX = 1;this.node.anchorY = 0;
this.node.setAnchorPoint(1,sans-serif; font-size:16px; line-height:25.6px"> 注意以上这些修改变换的方法会影响到节点上挂载的渲染组件,比如 Sprite 图片的尺寸、旋转等等。
颜色和不透明度
在使用 Sprite,Label 这些基本的渲染组件时,要注意修改颜色和不透明度的操作只能在节点的实例上进行,因为这些渲染组件本身并没有设置颜色和不透明度的接口。
假如我们有一个 Sprite 的实例为mySprite
,如果需要设置它的颜色:
mySprite.node.color = cc.Color.RED;
设置不透明度:
mySprite.node.opacity = 128;
常用组件接口
cc.Component是所有组件的基类,任何组件都包括如下的常见接口(假设我们在该组件的脚本中,以 this 指代本组件):