cryptic points in the API

diving edge , jquery flash , as3 background, give feedback difficulties encounter studying edge api, believing answers benefit others.

 

1) edge animate triggers, events , actions

 

• few properties of event object mentionned : e.target, e.originalevent, e.compid. why not listing them exhaustively (or least giving link api of such event object) ?

 

it took me time find on web how express in as3 comes down <eventobject>.target.name to

 

var elem, evt = e ? e : event;

if (evt.srcelement)  elem = evt.srcelement;

else if (evt.target) elem = evt.target;

return elem.getattribute("id").substr(18,4);

 

(not being sure there nothing simpler)

 

• different categories of events mentionned, among composition-level dom events , page-level dom events. helpful if 2 levels clarified, relations between 2 (or again link page clarifying this).

 

• timeline events : update, play, complete, stop. single list rather lean ! started thread (http://forums.adobe.com/message/5246740#5246740) more information, in vain. if play, complete , stop may considered self-explanatory, update not clear : rate fired ?

 

• “compositionready fires after composition ready play, before autoplay occurs.“

this place event (it event ?) mentionned.

 

• few sentences cryptic me (surely being not enough jquery/javascript savvy) :

 

- “he sym variable more durable when use things settimeout.“

 

- “you can compare the  comid  passed actions function closure.“

 

- “other mouse events simulated if click event bound.“

 

2) work symbols

 

• “the child elements of symbol instance owned symbol , referred actors.“

this place term “actor“ mentionned.

 

• emphasized there <compositionobject>createsymbolchild() method, not confused <symbolobject>.createchildsymbol (!!!), latter having additional z_index parameter.

 

• // hide element "paw" within nested symbol

sym.getcomposition().getstage().sym.getsymbol("kitten_1").getsymbol("kitten_paw").$("paw") .hide();

 

it looks second occurrence of sym 1 many !?

 

• finally, make matters worse, french translation of page rough, broken.

 

“a child symbol instance of "kittenpaw_sym" inside element "kitten""

 

should translated : instance du symbole “kittenpaw_sym“, enfant de l’élément "kitten".

 

and not : instance de symbole enfant de "kittenpaw_sym" dans l’élément "kitten".

 

that has different meaning , confusing. on several occasions, tried in touch adobe ––even macromedia— french team poor translations of docs, in vain ; there way improving, benefit french-speaking community ?

 

gil

hi, gil-

 

okay, there's lot in post.  let's start last 1 first: open suggestions translations of documentation.  if have laundry list of these things, can file them our linguists , have them fix it.  being said, please remember 1 human lot of animate work on, speed on these things might kind of slow.

 

otherwise, we're refining , rewriting our documentation.  please point these things out us, because we write our documentation (and blog posts, , give talks how use animate, , answer user requests).  i'll @ these issues pointed out , see if can them fixed soon.

 

i'll answer frequency problem in other post.

 

other miscellaneous points brought up:

• compositionready available clicking on {} button next stage in elements panel (or clicking on + next stage in code panel)
• "durable" not right word, gist of phrase when use javascript functions settimeout, "sym" point correct object, while "this" not guaranteed point right object, scope changes within function.
• actions closure - event handler called "action" (hence "actions pop up"), closure has lies within function() call of event handler
• mouse events - basically, since there isn't mouse on touch-based device, event guaranteed work "click."  device fake other mouse events (like touch mouseover), , won't.

 

-elaine

More discussions in Edge Animate CC

adobe