Provide additional information on the grammar and semantics for cmd element’s cmd attribute
Provide this information.
Part 4, 4.6.28
te
Proposed Disposition of DIS 29500 Comment ECMA-0066 (Modified: 2008-01-08) Agreed; the cmd element’s cmd attribute should be more thoroughly documented. The following changes will be made to Part 4, §4.6.28, page 3,101, line 13: Attributes Description cmd (Command) This is a string used to define the actual command. When an event is specified, in IE, the runtime will register the specific event and make sure that time conditions (begin/end/etc.) elsewhere on the page which listen for the event get hooked up correctly. This attribute defines the actual command to be issued. Depending on the type of command specified, the actual command can be made to invoke a wide range of actions on the linked or embedded object. Reserved Values (when type = “ call “): Value Description play play corresponding media playFrom(s) play corresponding media starting from s , where s is the number of seconds from the beginning of the clip pause pause corresponding media resume resume play of corresponding media stop stop play of corresponding media togglePause play corresponding media if media is already paused, pause corresponding media if media is already playing. If the corresponding media is not active, this command will restart the media and play from its beginning. Reserved Values (when type = “ evt “): Value Description onstopaudio stop play of all audio Reserved Values (when type = “ verb “): Value Description Attributes Description 0 Open the object for editing 1 Open the object for viewing The value of the cmd attribute shall be the string representation of an integer that represents the embedded object verb number. This verb number will determine the action that the rendering application should take corresponding to this object when this point in the animation is reached. [Example: Consider the following command <p:cmd type="evt" cmd="onstopaudio"> <p:cBhvr> <p:cTn display="0" masterRel="sameClick"> <p:stCondLst> <p:cond evt="begin" delay="0"> <p:tn val="5"/> </p:cond> </p:stCondLst> </p:cTn> <p:tgtEl> <p:sldTgt/> </p:tgtEl> </p:cBhvr> </p:cmd> end example] In the above example, the event of onstopaudio will stop all audio from playing once this particular animation is reached in the timeline. The possible values for this attribute are defined by the XML Schema string datatype. type (Command Type) This attribute is required and defines the type of command. When the value is set to "event", the "cmd" attribute string is used to send out an event to the target element. When the value is set to "call", the "cmd" string is used to call a method or function on the target element. When the value is set to "verb", the "cmd" string is treated as an verb on the element. When the value is set to "script", the cmd will be interpreted in the IE runtime as a string containing javascript statements. Note that this may cause a runtime script error if the script is invalid at the time it’s called. Attributes Description If the targetElement is not found, the command will not execute. This attribute specifies the type of command that will be issued by the rendering application to the appropriate target application or object. There are three possible values, call , evt , and verb . A call type is used to specify the class of commands that can then be issued. Call commands (type=” call “): This command type is used to call methods on the object specified ( play (), pause (), etc.) Event Commands (type=” evt “): This command type is used to set an event for the object at this point in the timeline ( onstopaudio , etc.) Verb Commands (type=” verb “): This command type is used to set verbs for the object to occur at this point in the timeline (0, 1, etc.) The possible values for this attribute are defined by the ST_TLCommandType simple type (§4.8.36).
