【easeljs】事件匯總

文章說明:為了方便我自己查找easeljs的所有事件,所以我從easeljs的文檔里抄過來加上自己的翻譯,會慢慢補全,漏了的,錯了的,評論一下我會補上去哦。(不確定翻譯對不對的地方我會留著原文。)

1. 繼承自,表示所有繼承自那個對象的對象都有這個事件。
2. 定義于,表示只有這個對象才有這個事件。
3. 加入版本,表示從這個版本起才加入這個事件,老版本沒有這個事件。
4. “此對象”表示被添加了這個事件的對象
5. 與jquery和js一致,事件的回調函數第一個參數會帶上事件對象,在easeljs文檔event類中可以看到各個事件屬性的說明。
6. stage的事件全加進來了

easeljs事件默認是不支持touch設備的,需要這樣才可以 var stage = new createjs.Stage("canvasId"); createjs.Touch.enable(stage);

添加事件的方法

on ( type listener [scope] [once=false] [data] [useCapture=false] ) Function

繼承自 EventDispatcherA shortcut method for using addEventListener that makes it easier to specify an execution scope, have a listener only run once, associate arbitrary data with the listener, and remove the listener.This method works by creating an anonymous wrapper function and subscribing it with addEventListener. The wrapper function is returned for use with removeEventListener (or off).IMPORTANT: To remove a listener added with on, you must pass in the returned wrapper function as the listener, or use remove. Likewise, each time you call on a NEW wrapper function is subscribed, so multiple calls to on with the same params will create multiple listeners.Example

var listener = myBtn.on("click", handleClick, null, false, {count:3});function handleClick(evt, data) {    data.count -= 1;    console.log(this == myBtn); // true - scope defaults to the dispatcher    if (data.count == 0) {        alert("clicked 3 times!");        myBtn.off("click", listener);        // alternately: evt.remove();    }}

Parameters:

type StringThe string type of the event.listener Function | ObjectAn object with a handleEvent method, or a function that will be called when the event is dispatched.[scope] Object optionalThe scope to execute the listener in. Defaults to the dispatcher/currentTarget for function listeners, and to the listener itself for object listeners (ie. using handleEvent).[once=false] Boolean optionalIf true, the listener will remove itself after the first time it is triggered.[data] optionalArbitrary data that will be included as the second parameter when the listener is called.[useCapture=false] Boolean optionalFor events that bubble, indicates whether to listen for the event in the capture or bubbling/target phase.Returns:

Function: Returns the anonymous function that was created and assigned as the listener. This is needed to remove the listener later using .removeEventListener.

added

繼承自 DisplayObject當此對象被add到其它容器對象時觸發

click

繼承自 DisplayObject加入版本 0.6.0在用戶按下左鍵并在此對象上松開左鍵后觸發。

dblclick

繼承自 DisplayObject加入版本 0.6.0當用戶在此對象上雙擊左鍵后觸發。

drawend

定義于 stage加入版本 0.7.0每次顯示列表被繪制到canvas后并且restore過canvas context后觸發。Dispatched each update immediately after the display list is drawn to the canvas and the canvas context is restored.

drawstart

定義于 stage加入版本 0.7.0在清除畫布和繪制顯示列表之前觸發?？梢栽谡{用event對象上使用preventDefault取消這次繪制。Dispatched each update immediately before the canvas is cleared and the display list is drawn to it. You can call preventDefault on the event object to cancel the draw.

mousedown

繼承自 DisplayObject加入版本 0.6.0用戶在此對象上按下左鍵后觸發。

mouseenter

定義于 stage加入版本 0.7.0當鼠標指針從canvas區域外(mouseInBounds == true)移進canvas區域(mouseInBounds == false)后觸發。這是目前唯一非點擊的鼠標輸入事件。

mouseleave

定義于 stage加入版本 0.7.0當鼠標從canvas區域內(mouseInBounds == true)移出(mouseInBounds == false)后觸發。這是目前唯一非點擊的鼠標輸入事件。(我也不知道為何這里的mouseInBounds和上面的相反,看原文吧)

mouseout

繼承自 DisplayObject加入版本 0.6.0當用戶鼠標從該對象的任意一個子項離開后觸發。這個事件一定要啟用enableMouseOver。另請參閱rollout。(寫好rollout后如果我還記得這里,會把這個鏈接弄好)

mouseover

繼承自 DisplayObject加入版本 0.6.0當用戶鼠標進入該對象的任意一個子項后觸發。這個事件一定要啟用enableMouseOver。另請參閱rollout。(寫好rollout后如果我還記得這里,會把這個鏈接弄好)

pressmove

繼承自 DisplayObject加入版本 0.7.0在此對象上發生了mousedown事件后,無論鼠標是否移動,pressmove事件都會持續發生在此對象上,直到松開鼠標按鈕。這事件在拖拽和類似的需求里很有用。(如果stage上加了這個事件偵聽,當stage上什么元素都沒有時,這個是無效的,需要用stagemousemove)

pressup

繼承自 DisplayObject加入版本 0.7.0在此對象上發生了mousedown事件后,松開鼠標會觸發。這事件在拖拽和類似的需求里很有用。

removed

繼承自 DisplayObject當此對象從它的父對象上移除后會觸發。

rollout

繼承自 DisplayObject加入版本 0.7.0這個事件和mouseout很像,但有這些不同:它不冒泡,而且它把該對象的內容認為是一個整體。例如,myContainer包含著兩個有重疊部分的子項:shapeA和shapeB。用戶移動他的鼠標到shapeA上,然后直接移到shapeB上,然后離開他們倆。如果myContainer有Mouseout:event,會收到兩個事件,每個事件指向一個子元素:

• 當鼠標離開shapeA時target=shapeA
• 當鼠標離開shapeB時target=shapeB

然而當事件換成rollout,只會在離開myContainer時才會觸發事件(不僅僅是離開shapeB),target=myContainer。這個事件一定要啟用enableMouseOver。(jquery也有這樣的,但是我忘記jquery中哪個是只離開父對象才觸發了。)

rollover

繼承自 DisplayObject加入版本 0.7.0這個事件和mouseover很像,不同之處跟rollout和mouseout的不同之處是一樣的。這個事件一定要啟用enableMouseOver。

stagemousedown

定義于 stage加入版本 0.6.0用戶在canvas上按下左鍵后觸發。

stagemousemove

定義于 stage加入版本 0.6.0當用戶在canvas上移動鼠標時持續觸發。

stagemouseup

定義于 stage加入版本 0.6.0當用戶在stage的某處按下左鍵,然后在頁面中能接收事件的任意一處(不同瀏覽器有些不同)松開左鍵?？梢允褂?code>mouseInBounds檢查鼠標是否在stage范圍內。

tick

繼承自 DisplayObject: tick:642加入版本 0.6.0Dispatched on each display object on a stage whenever the stage updates. This occurs immediately before the rendering (draw) pass. When update is called, first all display objects on the stage dispatch the tick event, then all of the display objects are drawn to stage. Children will have their Tick:event event dispatched in order of their depth prior to the event being dispatched on their parent.Event Payload:

• target ObjectThe object that dispatched the event.
• type StringThe event type.
• params ArrayAn array containing any arguments that were passed to the Stage.update() method. For example if you called stage.update("hello"), then the params would be ["hello"].
• paused Boolean 指出ticker當前是否暫停
• delta Number從上次觸發事件以來,經過了多少毫秒。
• time NumberTicker實例化之后經過了多少毫秒
• runTime NumberTicker實例化之后未被暫停的狀態下經過了多少毫秒。例如,你可以決定用time-runTime初始化后被暫停的總時間(The total time in ms that Ticker was not paused since it was initialized. For example, you could determine the amount of time that the Ticker has been paused since initialization with time-runTime.)

tickend

Defined in tickend:294Available since 0.7.0Dispatched each update immediately after the tick event is propagated through the display list. Does not fire if tickOnUpdate is false. Precedes the "drawstart" event.

tickstart

Defined in tickstart:287Available since 0.7.0Dispatched each update immediately before the tick event is propagated through the display list. You can call preventDefault on the event object to cancel propagating the tick event.