PrivateNode 类型

继承于 Node

模块: cc

Cocos Creator 场景中的私有节点类。
私有节点在编辑器中不可见，对用户透明。
通常私有节点是被一些特殊的组件创建出来作为父节点的一部分而存在的，理论上来说，它们不是子节点，而是父节点的组成部分。
私有节点有两个非常重要的特性：

1. 它有着最小的渲染排序的 Z 轴深度，并且无法被更改，因为它们不能被显示在其他正常子节点之上。
   
2. 它的定位也是特殊的，对于私有节点来说，父节点包围盒的左下角是它的局部坐标系原点，这个原点相当于父节点的位置减去它锚点的偏移。这样私有节点可以比较容易被控制在包围盒之中。
   目前在引擎中，RichText 和 TileMap 都有可能生成私有节点。

索引

属性（properties）

• groupIndex Integer 节点的分组索引。
• group String 节点的分组。
• position Vec3 节点在父节点坐标系中的位置（x, y）。
• x Number 节点 X 轴坐标。
• y Number 节点 Y 轴坐标。
• z Number 节点 Z 轴坐标。
• rotation Number 该节点旋转角度。
• angle Number 该节点的旋转角度，正值为逆时针方向。
• eulerAngles Vec3 该节点的欧拉角度，用于 3D 节点。
• rotationX Number 该节点 X 轴旋转角度。
• rotationY Number 该节点 Y 轴旋转角度。
• scale Number 节点相对父节点的缩放。
• scaleX Number 节点 X 轴缩放。
• scaleY Number 节点 Y 轴缩放。
• scaleZ Number 节点 Z 轴缩放。
• skewX Number 该节点 X 轴倾斜角度。
• skewY Number 该节点 Y 轴倾斜角度。
• opacity Number 节点透明度，默认值为 255。
• color Color 节点颜色。
• anchorX Number 节点 X 轴锚点位置。
• anchorY Number 节点 Y 轴锚点位置。
• width Number 节点宽度。
• height Number 节点高度。
• zIndex Number zIndex 是用来对节点进行排序的关键属性，它决定一个节点在兄弟节点之间的位置。
• is3DNode Boolean 切换 2D/3D 节点，2D 节点会有更高的运行效率
• up Vec3 获取节点正上方（y 轴）面对的方向，返回值为世界坐标系下的归一化向量
• right Vec3 获取节点正右方（x 轴）面对的方向，返回值为世界坐标系下的归一化向量
• forward Vec3 获取节点正前方（z 轴）面对的方向，返回值为世界坐标系下的归一化向量
• cascadeOpacity Boolean 节点的不透明度值是否影响其子节点，默认值为 true。
• _components Component[]
• _prefab PrefabInfo The PrefabInfo object
• _persistNode Boolean If true, the node is an persist node which won't be destroyed during scene transition....
• name String 该节点名称。
• uuid String 主要用于编辑器的 uuid，在编辑器下可用于持久化存储，在项目构建之后将变成自增的 id。
• children Node[] 节点的所有子节点。
• childrenCount Number 节点的子节点数量。
• active Boolean 当前节点的自身激活状态。
• activeInHierarchy Boolean 表示此节点是否在场景中激活。
• __eventTargets EventTarget[] Register all related EventTargets,...
• parent Node 该节点的父节点。
• _name String
• _objFlags Number
• isValid Boolean 表示该对象是否可用（被 destroy 后将不可用）。

方法

• constructor
• on 在节点上注册指定类型的回调函数，也可以设置 target 用于绑定响应函数的 this 对象。
• once 注册节点的特定事件类型回调，回调会在第一时间被触发后删除自身。
• off 删除之前与同类型，回调，目标或 useCapture 注册的回调。
• targetOff 移除目标上的所有注册事件。
• hasEventListener 检查事件目标对象是否有为特定类型的事件注册的回调。
• emit 通过事件名发送自定义事件
• dispatchEvent 分发事件到事件流中。
• pauseSystemEvents 暂停当前节点上注册的所有节点系统事件，节点系统事件包含触摸和鼠标事件。
• resumeSystemEvents 恢复当前节点上注册的所有节点系统事件，节点系统事件包含触摸和鼠标事件。
• _getCapturingTargets Get all the targets listening to the supplied type of event in the target's capturing phase....
• _getBubblingTargets Get all the targets listening to the supplied type of event in the target's bubbling phase....
• runAction 执行并返回该执行的动作。
• pauseAllActions 暂停本节点上所有正在运行的动作。
• resumeAllActions 恢复运行本节点上所有暂停的动作。
• stopAllActions 停止并且移除所有正在运行的动作列表。
• stopAction 停止并移除指定的动作。
• stopActionByTag 停止并且移除指定标签的动作。
• getActionByTag 通过标签获取指定动作。
• getNumberOfRunningActions 获取运行着的动作加上正在调度运行的动作的总数。
• getPosition 获取节点在父节点坐标系中的位置（x, y, z）。
• setPosition 设置节点在父节点坐标系中的位置。
• getScale 获取节点的缩放，需要传一个 cc.Vec2 或者 cc.Vec3 作为参数来接收返回值。
• setScale 设置节点在本地坐标系中坐标轴上的缩放比例。
• getRotation 获取该节点的 quaternion 旋转角度，需要传一个 cc.Quat 作为参数来接收返回值。
• setRotation 设置该节点的 quaternion 旋转角度。
• getContentSize 获取节点自身大小，不受该节点是否被缩放或者旋转的影响。
• setContentSize 设置节点原始大小，不受该节点是否被缩放或者旋转的影响。
• getAnchorPoint 获取节点锚点，用百分比表示。
• setAnchorPoint 设置锚点的百分比。
• lookAt 通过观察目标来设置 rotation，一般用于 Camera Node 上
• getLocalMatrix 返回局部空间坐标系的矩阵，基于父节点坐标系。
• getWorldMatrix 返回世界空间坐标系的矩阵。
• convertToNodeSpaceAR 将一个点转换到节点 (局部) 空间坐标系。
• convertToWorldSpaceAR 将节点坐标系下的一个点转换到世界空间坐标系。
• convertToNodeSpace 将一个点转换到节点 (局部) 坐标系，并加上锚点的坐标。
• convertToWorldSpace 将一个相对于节点左下角的坐标位置转换到世界空间坐标系。
• getNodeToParentTransform 返回这个将节点（局部）的空间坐标系转换成父节点的空间坐标系的矩阵。
• getNodeToParentTransformAR 返回这个将节点（局部）的空间坐标系转换成父节点的空间坐标系的矩阵。
• getNodeToWorldTransform 返回节点到世界坐标系的仿射变换矩阵。
• getNodeToWorldTransformAR 返回节点到世界坐标仿射变换矩阵。
• getParentToNodeTransform 返回将父节点的坐标系转换成节点（局部）的空间坐标系的矩阵。
• getWorldToNodeTransform
• convertTouchToNodeSpace 将触摸点转换成本地坐标系中位置。
• convertTouchToNodeSpaceAR 转换一个 cc.Touch（世界坐标）到一个局部坐标，该方法基于节点坐标。
• getBoundingBox 返回父节坐标系下的轴向对齐的包围盒。
• getBoundingBoxToWorld 返回节点在世界坐标系下的对齐轴向的包围盒（AABB）。
• addChild 添加子节点，并且可以修改该节点的 局部 Z 顺序和名字。
• cleanup 停止所有正在播放的动作和计时器。
• sortAllChildren 根据子节点的 zIndex 和 arrivalOrder 进行排序，正常情况下开发者不需要手动调用这个函数。
• getDisplayedOpacity 显示透明度是基于自身透明度和父节点透明度计算的。
• getDisplayedColor 显示颜色是基于自身颜色和父节点颜色计算的。
• isCascadeOpacityEnabled 返回节点的不透明度值是否影响其子节点。
• setCascadeOpacityEnabled 启用或禁用级连不透明度，如果级连启用，子节点的不透明度将是父不透明度乘上它自己的不透明度。
• setOpacityModifyRGB 透明度影响颜色配置已经被废弃...
• isOpacityModifyRGB 获取更改透明度时是否修改RGB值。
• getParent 获取该节点的父节点。
• setParent 设置该节点的父节点。
• attr 属性配置函数。
• getChildByUuid 通过 uuid 获取节点的子节点。
• getChildByName 通过名称获取节点的子节点。
• insertChild 插入子节点到指定位置
• getSiblingIndex 获取同级索引。
• setSiblingIndex 设置节点同级索引。
• walk 遍历该节点的子树里的所有节点并按规则执行回调函数。
• removeFromParent 从父节点中删除该节点。
• removeChild 移除节点中指定的子节点，是否需要清理所有正在运行的行为取决于 cleanup 参数。
• removeAllChildren 移除节点所有的子节点，是否需要清理所有正在运行的行为取决于 cleanup 参数。
• isChildOf 是否是指定节点的子节点？
• getComponent 获取节点上指定类型的组件，如果节点有附加指定类型的组件，则返回，如果没有则为空。
• getComponents 返回节点上指定类型的所有组件。
• getComponentInChildren 递归查找所有子节点中第一个匹配指定类型的组件。
• getComponentsInChildren 递归查找自身或所有子节点中指定类型的组件
• addComponent 向节点添加一个指定类型的组件类，你还可以通过传入脚本的名称来添加组件。
• _addComponentAt This api should only used by undo system
• removeComponent 删除节点上的指定组件，传入参数可以是一个组件构造函数或组件名，也可以是已经获得的组件引用。
• _getDependComponent
• destroyAllChildren 销毁所有子节点，并释放所有它们对其它对象的引用。
• clear 销毁记录的事件
• destroy 销毁该对象，并释放所有它对其它对象的引用。
• _destruct 清除实例中的所有引用。
• _onPreDestroy 在对象被销毁之前调用。
• _serialize 为此对象定制序列化。
• _deserialize 从自定义序列化数据初始化此对象。

事件

• position-changed 位置变动监听事件, 通过 this.node.on(cc.Node.EventType.POSITION_CHANGED, callback, this); 进行监听。
• size-changed 尺寸变动监听事件，通过 this.node.on(cc.Node.EventType.SIZE_CHANGED, callback, this); 进行监听。
• anchor-changed 锚点变动监听事件，通过 this.node.on(cc.Node.EventType.ANCHOR_CHANGED, callback, this); 进行监听。
• child-added 增加子节点监听事件，通过 this.node.on(cc.Node.EventType.CHILD_ADDED, callback, this); 进行监听。
• child-removed 删除子节点监听事件，通过 this.node.on(cc.Node.EventType.CHILD_REMOVED, callback, this); 进行监听。
• child-reorder 子节点顺序变动监听事件，通过 this.node.on(cc.Node.EventType.CHILD_REORDER, callback, this); 进行监听。
• group-changed 节点分组变动监听事件，通过 this.node.on(cc.Node.EventType.GROUP_CHANGED, callback, this); 进行监听。
• active-in-hierarchy-changed 注意：此节点激活时，此事件仅从最顶部的节点发出。

Details

属性（properties）

groupIndex

节点的分组索引。
节点的分组将关系到节点的碰撞组件可以与哪些碰撞组件相碰撞。

group

节点的分组。
节点的分组将关系到节点的碰撞组件可以与哪些碰撞组件相碰撞。

position

节点在父节点坐标系中的位置（x, y）。

示例

cc.log("Node Position: " + node.position);

x

节点 X 轴坐标。

示例

node.x = 100;
cc.log("Node Position X: " + node.x);

y

节点 Y 轴坐标。

示例

node.y = 100;
cc.log("Node Position Y: " + node.y);

z

节点 Z 轴坐标。

rotation

该节点旋转角度。

示例

node.rotation = 90;
cc.log("Node Rotation: " + node.rotation);

angle

该节点的旋转角度，正值为逆时针方向。

eulerAngles

该节点的欧拉角度，用于 3D 节点。

示例

node.is3DNode = true;
node.eulerAngles = cc.v3(45, 45, 45);
cc.log("Node eulerAngles (X, Y, Z): " + node.eulerAngles.toString());

rotationX

该节点 X 轴旋转角度。

示例

node.is3DNode = true;
node.eulerAngles = cc.v3(45, 0, 0);
cc.log("Node eulerAngles X: " + node.eulerAngles.x);

rotationY

该节点 Y 轴旋转角度。

示例

node.is3DNode = true;
node.eulerAngles = cc.v3(0, 45, 0);
cc.log("Node eulerAngles Y: " + node.eulerAngles.y);

scale

节点相对父节点的缩放。

示例

node.scale = 1;

scaleX

节点 X 轴缩放。

示例

node.scaleX = 0.5;
cc.log("Node Scale X: " + node.scaleX);

scaleY

节点 Y 轴缩放。

示例

node.scaleY = 0.5;
cc.log("Node Scale Y: " + node.scaleY);

scaleZ

节点 Z 轴缩放。

skewX

该节点 X 轴倾斜角度。

示例

node.skewX = 0;
cc.log("Node SkewX: " + node.skewX);

skewY

该节点 Y 轴倾斜角度。

示例

node.skewY = 0;
cc.log("Node SkewY: " + node.skewY);

opacity

节点透明度，默认值为 255。

示例

node.opacity = 255;

color

节点颜色。默认为白色，数值为：（255，255，255）。

示例

node.color = new cc.Color(255, 255, 255);

anchorX

节点 X 轴锚点位置。

示例

node.anchorX = 0;

anchorY

节点 Y 轴锚点位置。

示例

node.anchorY = 0;

width

节点宽度。

示例

node.width = 100;

height

节点高度。

示例

node.height = 100;

zIndex

zIndex 是用来对节点进行排序的关键属性，它决定一个节点在兄弟节点之间的位置。
zIndex 的取值应该介于 cc.macro.MIN_ZINDEX 和 cc.macro.MAX_ZINDEX 之间 父节点主要根据节点的 zIndex 和添加次序来排序，拥有更高 zIndex 的节点将被排在后面，如果两个节点的 zIndex 一致，先添加的节点会稳定排在另一个节点之前。
节点在 children 中的顺序决定了其渲染顺序。父节点永远在所有子节点之前被渲染

示例

node.zIndex = 1;
cc.log("Node zIndex: " + node.zIndex);

is3DNode

切换 2D/3D 节点，2D 节点会有更高的运行效率

up

获取节点正上方（y 轴）面对的方向，返回值为世界坐标系下的归一化向量

right

获取节点正右方（x 轴）面对的方向，返回值为世界坐标系下的归一化向量

forward

获取节点正前方（z 轴）面对的方向，返回值为世界坐标系下的归一化向量

cascadeOpacity

透明度级联功能从 v2.0 开始已移除 节点的不透明度值是否影响其子节点，默认值为 true。

_components

_prefab

The PrefabInfo object

_persistNode

If true, the node is an persist node which won't be destroyed during scene transition. If false, the node will be destroyed automatically when loading a new scene. Default is false.

name

该节点名称。

示例

node.name = "New Node";
cc.log("Node Name: " + node.name);

uuid

主要用于编辑器的 uuid，在编辑器下可用于持久化存储，在项目构建之后将变成自增的 id。

示例

cc.log("Node Uuid: " + node.uuid);

children

节点的所有子节点。

示例

var children = node.children;
for (var i = 0; i < children.length; ++i) {
    cc.log("Node: " + children[i]);
}

childrenCount

节点的子节点数量。

示例

var count = node.childrenCount;
cc.log("Node Children Count: " + count);

active

当前节点的自身激活状态。
值得注意的是，一个节点的父节点如果不被激活，那么即使它自身设为激活，它仍然无法激活。
如果你想检查节点在场景中实际的激活状态可以使用 Node/activeInHierarchy:property。

示例

node.active = false;

activeInHierarchy

表示此节点是否在场景中激活。

示例

cc.log("activeInHierarchy: " + node.activeInHierarchy);

__eventTargets

Register all related EventTargets, all event callbacks will be removed in _onPreDestroy

parent

该节点的父节点。

示例

cc.log("Node Parent: " + node.parent);

_name

_objFlags

isValid

表示该对象是否可用（被 destroy 后将不可用）。
当一个对象的 destroy 调用以后，会在这一帧结束后才真正销毁。因此从下一帧开始 isValid 就会返回 false，而当前帧内 isValid 仍然会是 true。如果希望判断当前帧是否调用过 destroy，请使用 cc.isValid(obj, true)，不过这往往是特殊的业务需求引起的，通常情况下不需要这样。

示例

var node = new cc.Node();
cc.log(node.isValid);    // true
node.destroy();
cc.log(node.isValid);    // true, still valid in this frame
// after a frame...
cc.log(node.isValid);    // false, destroyed in the end of last frame

方法

constructor

参数列表

• name String

on

在节点上注册指定类型的回调函数，也可以设置 target 用于绑定响应函数的 this 对象。
鼠标或触摸事件会被系统调用 dispatchEvent 方法触发，触发的过程包含三个阶段：

1. 捕获阶段：派发事件给捕获目标（通过 _getCapturingTargets 获取），比如，节点树中注册了捕获阶段的父节点，从根节点开始派发直到目标节点。
   
2. 目标阶段：派发给目标节点的监听器。
   
3. 冒泡阶段：派发事件给冒泡目标（通过 _getBubblingTargets 获取），比如，节点树中注册了冒泡阶段的父节点，从目标节点开始派发直到根节点。
   同时您可以将事件派发到父节点或者通过调用 stopPropagation 拦截它。
   推荐使用这种方式来监听节点上的触摸或鼠标事件，请不要在节点上直接使用 cc.eventManager。
   你也可以注册自定义事件到节点上，并通过 emit 方法触发此类事件，对于这类事件，不会发生捕获冒泡阶段，只会直接派发给注册在该节点上的监听器
   你可以通过在 emit 方法调用时在 type 之后传递额外的参数作为事件回调的参数列表

参数列表

• type String | Node.EventType A string representing the event type to listen for.
  See Node/EventTyupe/POSITION_CHANGED for all builtin events.
• callback Function The callback that will be invoked when the event is dispatched. The callback is ignored if it is a duplicate (the callbacks are unique).
  • event Event | Any event or first argument when emit
  • arg2 Any arg2
  • arg3 Any arg3
  • arg4 Any arg4
  • arg5 Any arg5
• target Object The target (this object) to invoke the callback, can be null
• useCapture Boolean When set to true, the listener will be triggered at capturing phase which is ahead of the final target emit, otherwise it will be triggered during bubbling phase.

示例

this.node.on(cc.Node.EventType.TOUCH_START, this.memberFunction, this);  // if "this" is component and the "memberFunction" declared in CCClass.
node.on(cc.Node.EventType.TOUCH_START, callback, this);
node.on(cc.Node.EventType.TOUCH_MOVE, callback, this);
node.on(cc.Node.EventType.TOUCH_END, callback, this);
node.on(cc.Node.EventType.TOUCH_CANCEL, callback, this);
node.on(cc.Node.EventType.ANCHOR_CHANGED, callback);
node.on(cc.Node.EventType.COLOR_CHANGED, callback);

once

注册节点的特定事件类型回调，回调会在第一时间被触发后删除自身。

参数列表

• type String A string representing the event type to listen for.
• callback Function The callback that will be invoked when the event is dispatched.

                         The callback is ignored if it is a duplicate (the callbacks are unique).
  

  • event Event | Any event or first argument when emit
  • arg2 Any arg2
  • arg3 Any arg3
  • arg4 Any arg4
  • arg5 Any arg5
• target Object The target (this object) to invoke the callback, can be null

示例

node.once(cc.Node.EventType.ANCHOR_CHANGED, callback);

off

删除之前与同类型，回调，目标或 useCapture 注册的回调。

参数列表

• type String A string representing the event type being removed.
• callback Function The callback to remove.
• target Object The target (this object) to invoke the callback, if it's not given, only callback without target will be removed
• useCapture Boolean When set to true, the listener will be triggered at capturing phase which is ahead of the final target emit, otherwise it will be triggered during bubbling phase.

示例

this.node.off(cc.Node.EventType.TOUCH_START, this.memberFunction, this);
node.off(cc.Node.EventType.TOUCH_START, callback, this.node);
node.off(cc.Node.EventType.ANCHOR_CHANGED, callback, this);

targetOff

移除目标上的所有注册事件。

参数列表

• target Object The target to be searched for all related callbacks

示例

node.targetOff(target);

hasEventListener

检查事件目标对象是否有为特定类型的事件注册的回调。

参数列表

• type String The type of event.

emit

通过事件名发送自定义事件

参数列表

• type String event type
• arg1 Any First argument in callback
• arg2 Any Second argument in callback
• arg3 Any Third argument in callback
• arg4 Any Fourth argument in callback
• arg5 Any Fifth argument in callback

示例

eventTarget.emit('fire', event);
eventTarget.emit('fire', message, emitter);

dispatchEvent

分发事件到事件流中。

参数列表

• event Event The Event object that is dispatched into the event flow

pauseSystemEvents

暂停当前节点上注册的所有节点系统事件，节点系统事件包含触摸和鼠标事件。 如果传递 recursive 为 true，那么这个 API 将暂停本节点和它的子树上所有节点的节点系统事件。 参考：https://www.cocos.com/docs/creator/scripting/internal-events.html

参数列表

• recursive Boolean Whether to pause node system events on the sub node tree.

示例

node.pauseSystemEvents(true);

resumeSystemEvents

恢复当前节点上注册的所有节点系统事件，节点系统事件包含触摸和鼠标事件。 如果传递 recursive 为 true，那么这个 API 将恢复本节点和它的子树上所有节点的节点系统事件。 参考：https://www.cocos.com/docs/creator/scripting/internal-events.html

参数列表

• recursive Boolean Whether to resume node system events on the sub node tree.

示例

node.resumeSystemEvents(true);

_getCapturingTargets

Get all the targets listening to the supplied type of event in the target's capturing phase. The capturing phase comprises the journey from the root to the last node BEFORE the event target's node. The result should save in the array parameter, and MUST SORT from child nodes to parent nodes.

Subclasses can override this method to make event propagable.

参数列表

• type String the event type
• array Array the array to receive targets

示例

----------
Subclasses can override this method to make event propagable
```js
for (var target = this._parent; target; target = target._parent) {
    if (target._capturingListeners && target._capturingListeners.hasEventListener(type)) {
        array.push(target);
    }
}

_getBubblingTargets

Get all the targets listening to the supplied type of event in the target's bubbling phase. The bubbling phase comprises any SUBSEQUENT nodes encountered on the return trip to the root of the tree. The result should save in the array parameter, and MUST SORT from child nodes to parent nodes.

Subclasses can override this method to make event propagable.

参数列表

• type String the event type
• array Array the array to receive targets

runAction

执行并返回该执行的动作。该节点将会变成动作的目标。
调用 runAction 时，节点自身处于不激活状态将不会有任何效果。
注意：你不应该修改 runAction 后的动作，将无法发挥作用，如果想进行修改，请在定义 action 时加入。

参数列表

• action Action

示例

var action = cc.scaleTo(0.2, 1, 0.6);
node.runAction(action);
node.runAction(action).repeatForever(); // fail
node.runAction(action.repeatForever()); // right

pauseAllActions

暂停本节点上所有正在运行的动作。和 cc.director.getActionManager().pauseTarget(node); 等价。

示例

node.pauseAllActions();

resumeAllActions

恢复运行本节点上所有暂停的动作。和 cc.director.getActionManager().resumeTarget(node); 等价。

示例

node.resumeAllActions();

stopAllActions

停止并且移除所有正在运行的动作列表。

示例

node.stopAllActions();

stopAction

停止并移除指定的动作。

参数列表

• action Action An action object to be removed.

示例

var action = cc.scaleTo(0.2, 1, 0.6);
node.stopAction(action);

stopActionByTag

停止并且移除指定标签的动作。

参数列表

• tag Number A tag that indicates the action to be removed.

示例

node.stopActionByTag(1);

getActionByTag

通过标签获取指定动作。

参数列表

• tag Number

示例

var action = node.getActionByTag(1);

getNumberOfRunningActions

获取运行着的动作加上正在调度运行的动作的总数。
例如：

• 如果你正在运行 7 个动作中的 1 个 Sequence，它将返回 1。
  
• 如果你正在运行 2 个动作中的 7 个 Sequence，它将返回 7。
  

示例

var count = node.getNumberOfRunningActions();
cc.log("Running Action Count: " + count);

getPosition

获取节点在父节点坐标系中的位置（x, y, z）。 你可以传一个 cc.Vec2 或者 cc.Vec3 作为参数来接收返回值。

参数列表

• out Vec2 | Vec3 The return value to receive position

示例

cc.log("Node Position: " + node.getPosition());

setPosition

设置节点在父节点坐标系中的位置。
可以通过下面的方式设置坐标点：

1. 传入 2 个数值 x, y (此时不会改变 position.z 的值)。
   
2. 传入 cc.v2(x, y) 类型为 cc.Vec2 的对象 (此时 position.z 的值将被设置为0)。
3. 对于 3D 节点可以传入 3 个数值 x, y, z。
   
4. 对于 3D 节点可以传入 cc.v3(x, y, z) 类型为 cc.Vec3 的对象。

参数列表

• x Vec2 | Vec3 | Number X coordinate for position or the position object
• y Number Y coordinate for position
• z Number Z coordinate for position

getScale

获取节点的缩放，需要传一个 cc.Vec2 或者 cc.Vec3 作为参数来接收返回值。

参数列表

• out Vec2 | Vec3

示例

cc.log("Node Scale: " + node.getScale(cc.v3()));

setScale

设置节点在本地坐标系中坐标轴上的缩放比例。 2D 节点可以操作两个坐标轴，而 3D 节点可以操作三个坐标轴。 当只传入 (x, y) 时，scale.z 的值不会被改变。 当只传入 Vec2 对象时，scale.z 的值将被设置为0。

参数列表

• x Number | Vec2 | Vec3 scaleX or scale object
• y Number
• z Number

示例

node.setScale(cc.v2(2, 2)); // Notice: scaleZ will be 0
node.setScale(cc.v3(2, 2, 2)); // for 3D node
node.setScale(2);

getRotation

获取该节点的 quaternion 旋转角度，需要传一个 cc.Quat 作为参数来接收返回值。

参数列表

• out Quat

setRotation

设置该节点的 quaternion 旋转角度。

参数列表

• quat cc.Quat | Number Quaternion object represents the rotation or the x value of quaternion
• y Number y value of quternion
• z Number z value of quternion
• w Number w value of quternion

getContentSize

获取节点自身大小，不受该节点是否被缩放或者旋转的影响。

示例

cc.log("Content Size: " + node.getContentSize());

setContentSize

设置节点原始大小，不受该节点是否被缩放或者旋转的影响。

参数列表

• size Size | Number The untransformed size of the node or The untransformed size's width of the node.
• height Number The untransformed size's height of the node.

示例

node.setContentSize(cc.size(100, 100));
node.setContentSize(100, 100);

getAnchorPoint

获取节点锚点，用百分比表示。
锚点应用于所有变换和坐标点的操作，它就像在节点上连接其父节点的大头针。
锚点是标准化的，就像百分比一样。(0，0) 表示左下角，(1，1) 表示右上角。
但是你可以使用比（1，1）更高的值或者比（0，0）更低的值。
默认的锚点是（0.5，0.5），因此它开始于节点的中心位置。
注意：Creator 中的锚点仅用于定位所在的节点，子节点的定位不受影响。

示例

cc.log("Node AnchorPoint: " + node.getAnchorPoint());

setAnchorPoint

设置锚点的百分比。
锚点应用于所有变换和坐标点的操作，它就像在节点上连接其父节点的大头针。
锚点是标准化的，就像百分比一样。(0，0) 表示左下角，(1，1) 表示右上角。
但是你可以使用比（1，1）更高的值或者比（0，0）更低的值。
默认的锚点是（0.5，0.5），因此它开始于节点的中心位置。
注意：Creator 中的锚点仅用于定位所在的节点，子节点的定位不受影响。

参数列表

• point Vec2 | Number The anchor point of node or The x axis anchor of node.
• y Number The y axis anchor of node.

示例

node.setAnchorPoint(cc.v2(1, 1));
node.setAnchorPoint(1, 1);

lookAt

通过观察目标来设置 rotation，一般用于 Camera Node 上

参数列表

• pos Vec3
• up Vec3 default is (0,1,0)

getLocalMatrix

返回局部空间坐标系的矩阵，基于父节点坐标系。

参数列表

• out Mat4 The matrix object to be filled with data

示例

let mat4 = cc.mat4();
node.getLocalMatrix(mat4);

getWorldMatrix

返回世界空间坐标系的矩阵。

参数列表

• out Mat4 The matrix object to be filled with data

示例

let mat4 = cc.mat4();
node.getWorldMatrix(mat4);

convertToNodeSpaceAR

将一个点转换到节点 (局部) 空间坐标系。

参数列表

• worldPoint Vec3 | Vec2
• out Vec3 | Vec2

示例

var newVec2 = node.convertToNodeSpaceAR(cc.v2(100, 100));
var newVec3 = node.convertToNodeSpaceAR(cc.v3(100, 100, 100));

convertToWorldSpaceAR

将节点坐标系下的一个点转换到世界空间坐标系。

参数列表

• nodePoint Vec3 | Vec2
• out Vec3 | Vec2

示例

var newVec2 = node.convertToWorldSpaceAR(cc.v2(100, 100));
var newVec3 = node.convertToWorldSpaceAR(cc.v3(100, 100, 100));

convertToNodeSpace

将一个点转换到节点 (局部) 坐标系，并加上锚点的坐标。
也就是说返回的坐标是相对于节点包围盒左下角的坐标。
这个 API 的设计是为了和 cocos2d-x 中行为一致，更多情况下你可能需要使用 convertToNodeSpaceAR。

参数列表

• worldPoint Vec2

示例

var newVec2 = node.convertToNodeSpace(cc.v2(100, 100));

convertToWorldSpace

将一个相对于节点左下角的坐标位置转换到世界空间坐标系。 这个 API 的设计是为了和 cocos2d-x 中行为一致，更多情况下你可能需要使用 convertToWorldSpaceAR

参数列表

• nodePoint Vec2

示例

var newVec2 = node.convertToWorldSpace(cc.v2(100, 100));

getNodeToParentTransform

返回这个将节点（局部）的空间坐标系转换成父节点的空间坐标系的矩阵。这个矩阵以像素为单位。

参数列表

• out AffineTransform The affine transform object to be filled with data

示例

let affineTransform = cc.AffineTransform.create();
node.getNodeToParentTransform(affineTransform);

getNodeToParentTransformAR

返回这个将节点（局部）的空间坐标系转换成父节点的空间坐标系的矩阵。
这个矩阵以像素为单位。
该方法基于节点坐标。

参数列表

• out AffineTransform The affine transform object to be filled with data

示例

let affineTransform = cc.AffineTransform.create();
node.getNodeToParentTransformAR(affineTransform);

getNodeToWorldTransform

返回节点到世界坐标系的仿射变换矩阵。矩阵单位是像素。

参数列表

• out AffineTransform The affine transform object to be filled with data

示例

let affineTransform = cc.AffineTransform.create();
node.getNodeToWorldTransform(affineTransform);

getNodeToWorldTransformAR

返回节点到世界坐标仿射变换矩阵。矩阵单位是像素。
该方法基于节点坐标。

参数列表

• out AffineTransform The affine transform object to be filled with data

示例

let affineTransform = cc.AffineTransform.create();
node.getNodeToWorldTransformAR(affineTransform);

getParentToNodeTransform

返回将父节点的坐标系转换成节点（局部）的空间坐标系的矩阵。
该矩阵以像素为单位。返回的矩阵是只读的，不能更改。

参数列表

• out AffineTransform The affine transform object to be filled with data

示例

let affineTransform = cc.AffineTransform.create();
node.getParentToNodeTransform(affineTransform);

getWorldToNodeTransform

参数列表

• out AffineTransform The affine transform object to be filled with data

示例

let affineTransform = cc.AffineTransform.create();
node.getWorldToNodeTransform(affineTransform);

convertTouchToNodeSpace

将触摸点转换成本地坐标系中位置。

参数列表

• touch Touch The touch object

示例

var newVec2 = node.convertTouchToNodeSpace(touch);

convertTouchToNodeSpaceAR

转换一个 cc.Touch（世界坐标）到一个局部坐标，该方法基于节点坐标。

参数列表

• touch Touch The touch object

示例

var newVec2 = node.convertTouchToNodeSpaceAR(touch);

getBoundingBox

返回父节坐标系下的轴向对齐的包围盒。

示例

var boundingBox = node.getBoundingBox();

getBoundingBoxToWorld

返回节点在世界坐标系下的对齐轴向的包围盒（AABB）。
该边框包含自身和已激活的子节点的世界边框。

示例

var newRect = node.getBoundingBoxToWorld();

addChild

添加子节点，并且可以修改该节点的 局部 Z 顺序和名字。

参数列表

• child Node A child node
• zIndex Number Z order for drawing priority. Please refer to zIndex property
• name String A name to identify the node easily. Please refer to name property

示例

node.addChild(newNode, 1, "node");

cleanup

停止所有正在播放的动作和计时器。

示例

node.cleanup();

sortAllChildren

根据子节点的 zIndex 和 arrivalOrder 进行排序，正常情况下开发者不需要手动调用这个函数。

getDisplayedOpacity

获取节点显示透明度， 显示透明度和透明度之间的不同之处在于当启用级连透明度时， 显示透明度是基于自身透明度和父节点透明度计算的。

getDisplayedColor

获取节点的显示颜色， 显示颜色和颜色之间的不同之处在于当启用级连颜色时， 显示颜色是基于自身颜色和父节点颜色计算的。

isCascadeOpacityEnabled

透明度级联功能从 v2.0 开始已移除 返回节点的不透明度值是否影响其子节点。

setCascadeOpacityEnabled

透明度级联功能从 v2.0 开始已移除 启用或禁用级连不透明度，如果级连启用，子节点的不透明度将是父不透明度乘上它自己的不透明度。

参数列表

• cascadeOpacityEnabled Boolean

setOpacityModifyRGB

透明度影响颜色配置已经被废弃 设置更改透明度时是否修改RGB值，

参数列表

• opacityValue Boolean

isOpacityModifyRGB

透明度影响颜色配置已经被废弃 获取更改透明度时是否修改RGB值。

getParent

获取该节点的父节点。

示例

var parent = this.node.getParent();

setParent

设置该节点的父节点。

参数列表

• value Node

示例

node.setParent(newNode);

attr

属性配置函数。在 attrs 的所有属性将被设置为节点属性。

参数列表

• attrs Object Properties to be set to node

示例

var attrs = { key: 0, num: 100 };
node.attr(attrs);

getChildByUuid

通过 uuid 获取节点的子节点。

参数列表

• uuid String The uuid to find the child node.

示例

var child = node.getChildByUuid(uuid);

getChildByName

通过名称获取节点的子节点。

参数列表

• name String A name to find the child node.

示例

var child = node.getChildByName("Test Node");

insertChild

插入子节点到指定位置

参数列表

• child Node the child node to be inserted
• siblingIndex Number the sibling index to place the child in

示例

node.insertChild(child, 2);

getSiblingIndex

获取同级索引。

示例

var index = node.getSiblingIndex();

setSiblingIndex

设置节点同级索引。

参数列表

• index Number

示例

node.setSiblingIndex(1);

walk

遍历该节点的子树里的所有节点并按规则执行回调函数。 对子树中的所有节点，包含当前节点，会执行两次回调，prefunc 会在访问它的子节点之前调用，postfunc 会在访问所有子节点之后调用。 这个函数的实现不是基于递归的，而是基于栈展开递归的方式。 请不要在 walk 过程中对任何其他的节点嵌套执行 walk。

参数列表

• prefunc Function The callback to process node when reach the node for the first time
  • target _BaseNode The current visiting node
• postfunc Function The callback to process node when re-visit the node after walked all children in its sub tree
  • target _BaseNode The current visiting node

示例

node.walk(function (target) {
    console.log('Walked through node ' + target.name + ' for the first time');
}, function (target) {
    console.log('Walked through node ' + target.name + ' after walked all children in its sub tree');
});

removeFromParent

从父节点中删除该节点。如果不传入 cleanup 参数或者传入 true，那么这个节点上所有绑定的事件、action 都会被删除。
因此建议调用这个 API 时总是传入 false 参数。
如果这个节点是一个孤节点，那么什么都不会发生。

参数列表

• cleanup Boolean true if all actions and callbacks on this node should be removed, false otherwise.

示例

node.removeFromParent();
node.removeFromParent(false);

removeChild

移除节点中指定的子节点，是否需要清理所有正在运行的行为取决于 cleanup 参数。
如果 cleanup 参数不传入，默认为 true 表示清理。

参数列表

• child Node The child node which will be removed.
• cleanup Boolean true if all running actions and callbacks on the child node will be cleanup, false otherwise.

示例

node.removeChild(newNode);
node.removeChild(newNode, false);

removeAllChildren

移除节点所有的子节点，是否需要清理所有正在运行的行为取决于 cleanup 参数。
如果 cleanup 参数不传入，默认为 true 表示清理。

参数列表

• cleanup Boolean true if all running actions on all children nodes should be cleanup, false otherwise.

示例

node.removeAllChildren();
node.removeAllChildren(false);

isChildOf

是否是指定节点的子节点？

参数列表

• parent Node

示例

node.isChildOf(newNode);

getComponent

获取节点上指定类型的组件，如果节点有附加指定类型的组件，则返回，如果没有则为空。
传入参数也可以是脚本的名称。

参数列表

• typeOrClassName Function | String

示例

// get sprite component
var sprite = node.getComponent(cc.Sprite);
// get custom test class
var test = node.getComponent("Test");

getComponents

返回节点上指定类型的所有组件。

参数列表

• typeOrClassName Function | String

示例

var sprites = node.getComponents(cc.Sprite);
var tests = node.getComponents("Test");

getComponentInChildren

递归查找所有子节点中第一个匹配指定类型的组件。

参数列表

• typeOrClassName Function | String

示例

var sprite = node.getComponentInChildren(cc.Sprite);
var Test = node.getComponentInChildren("Test");

getComponentsInChildren

递归查找自身或所有子节点中指定类型的组件

参数列表

• typeOrClassName Function | String

示例

var sprites = node.getComponentsInChildren(cc.Sprite);
var tests = node.getComponentsInChildren("Test");

addComponent

向节点添加一个指定类型的组件类，你还可以通过传入脚本的名称来添加组件。

参数列表

• typeOrClassName Function | String The constructor or the class name of the component to add

示例

var sprite = node.addComponent(cc.Sprite);
var test = node.addComponent("Test");

_addComponentAt

This api should only used by undo system

参数列表

• comp Component
• index Number

removeComponent

删除节点上的指定组件，传入参数可以是一个组件构造函数或组件名，也可以是已经获得的组件引用。 如果你已经获得组件引用，你也可以直接调用 component.destroy()

参数列表

• component String | Function | Component The need remove component.

示例

node.removeComponent(cc.Sprite);
var Test = require("Test");
node.removeComponent(Test);

_getDependComponent

参数列表

• depended Component

destroyAllChildren

销毁所有子节点，并释放所有它们对其它对象的引用。
实际销毁操作会延迟到当前帧渲染前执行。

示例

node.destroyAllChildren();

clear

销毁记录的事件

destroy

销毁该对象，并释放所有它对其它对象的引用。
实际销毁操作会延迟到当前帧渲染前执行。从下一帧开始，该对象将不再可用。 您可以在访问对象之前使用 cc.isValid(obj) 来检查对象是否已被销毁。

示例

obj.destroy();

_destruct

清除实例中的所有引用。

注意：此方法不会清除在 CCObject 实例中定义的 getter 或 setter。如果需要，你可以重写 _destruct 方法。例如：

_destruct: function () {
    for (var key in this) {
        if (this.hasOwnProperty(key)) {
            switch (typeof this[key]) {
                case 'string':
                    this[key] = '';
                    break;
                case 'object':
                case 'function':
                    this[key] = null;
                    break;
        }
    }
}

_onPreDestroy

在对象被销毁之前调用。

_serialize

为此对象定制序列化。

参数列表

• exporting Boolean

_deserialize

从自定义序列化数据初始化此对象。

参数列表

• data Object the serialized json data
• ctx _Deserializer

事件

position-changed Event

模块: cc

位置变动监听事件, 通过 this.node.on(cc.Node.EventType.POSITION_CHANGED, callback, this); 进行监听。

索引

Details

size-changed Event

模块: cc

尺寸变动监听事件，通过 this.node.on(cc.Node.EventType.SIZE_CHANGED, callback, this); 进行监听。

索引

Details

anchor-changed Event

模块: cc

锚点变动监听事件，通过 this.node.on(cc.Node.EventType.ANCHOR_CHANGED, callback, this); 进行监听。

索引

Details

child-added Event

模块: cc

增加子节点监听事件，通过 this.node.on(cc.Node.EventType.CHILD_ADDED, callback, this); 进行监听。

索引

Details

child-removed Event

模块: cc

删除子节点监听事件，通过 this.node.on(cc.Node.EventType.CHILD_REMOVED, callback, this); 进行监听。

索引

Details

child-reorder Event

模块: cc

子节点顺序变动监听事件，通过 this.node.on(cc.Node.EventType.CHILD_REORDER, callback, this); 进行监听。

索引

Details

group-changed Event

模块: cc

节点分组变动监听事件，通过 this.node.on(cc.Node.EventType.GROUP_CHANGED, callback, this); 进行监听。

索引

Details

active-in-hierarchy-changed Event

模块: cc 父模块: cc

注意：此节点激活时，此事件仅从最顶部的节点发出。

索引

Details