Sets the value of an object's attribute for a specified duration.
Members Table
The following table lists the members exposed by the
set
object. Click a tab on the left to choose the type of member you want to view.
Attributes/Properties
Attribute | Property | Description |
---|
ATTRIBUTENAME | attributeName |
Sets or retrieves the name of the element's attribute to be animated. |
AUTOREVERSE | autoReverse |
Sets or retrieves whether the timeline on an element begins playing in reverse immediately after completing in the forward direction. |
BEGIN | begin |
Sets or retrieves the delay time before the timeline begins playing on the element. |
DUR | dur |
Sets or retrieves a value indicating the amount of time the element remains active or displayed. |
END | end |
Sets or retrieves a value indicating the end time for the element, or the end of the simple duration when the element is set to repeat. |
FILL | fill |
Sets or retrieves the action an element takes if its timeline ends before the timeline on its parent element ends. |
| hasMedia |
Retrieves a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element. |
REPEATDUR | repeatDur |
Sets or retrieves the number of seconds that an element's timeline repeats. |
RESTART | restart |
Sets or retrieves the conditions under which an element can be restarted on a timeline. |
systemBitrate | |
Retrieves the approximate bandwidth available to the system in bits-per-second. |
systemCaptions | |
Indicates whether or not to display a text equivalent of the audio portion of the presentation. |
systemLanguage | |
Indicates whether a given language is selected in a user's system preferences. |
systemOverdubOrSubtitle | |
Specifies whether overdubs or subtitles render during a presentation. |
TARGETELEMENT | targetElement |
Sets or retrieves the target element to be animated. |
TIMECONTAINER | timeContainer |
Sets or retrieves the type of timeline associated with an element. |
| timeParent |
Retrieves the parent time container element of the current element. |
TO | to |
Sets or retrieves the ending value of an animation. |
Events
Event | Description |
---|
onbegin |
Fires when the timeline starts on an element. |
onend |
Fires when the timeline stops on an element. |
onpause |
Fires when the timeline on an element pauses. |
onrepeat |
Fires when the timeline repeats on an element, beginning with the second iteration. |
onreset |
Fires when the timeline reaches the value of the BEGIN attribute or when the resetElement method is called on the element. |
onresume |
Fires when an element's timeline resumes from a paused state. |
onreverse |
Fires when the timeline on an element begins to play backward. |
Methods
Method | Description |
---|
activeTimeToParentTime |
Converts a value in the element's active timeline to the corresponding point in the parent timeline. |
activeTimeToSegmentTime |
Converts a value in the element's active timeline to the corresponding point in the segment timeline. |
beginElement |
Starts the element on the timeline. |
beginElementAt |
Starts an element's timeline at the specified time. |
documentTimeToParentTime |
Converts a value in the document timeline to the corresponding point in the element's parent timeline. |
endElement |
Stops the element on the timeline. |
endElementAt |
Ends an element's timeline at the specified time. |
parentTimeToActiveTime |
Converts a value in the parent timeline to the corresponding point in the element's active timeline. |
parentTimeToDocumentTime |
Converts a value in the element's parent timeline to the corresponding point in the document timeline. |
pauseElement |
Stops playing an element's timeline at the current point. |
resetElement |
Removes any changes made to the element and returns the element to its original state. |
resumeElement |
Restarts the element's timeline from a paused state. |
seekActiveTime |
Locates a specified point on the element's active timeline and begins playing from that point. |
seekSegmentTime |
Locates the specified point on the element's segment timeline, and begins playing from that point. |
seekTo |
Locates a specified point on the element's segment timeline, including repetitions, and begins playing from that point. |
seekToFrame |
Locates a specified frame in the object. |
segmentTimeToActiveTime |
Converts a value in the element's segment timeline to the corresponding point in the element's active timeline. |
segmentTimeToSimpleTime |
Converts a value in the element's segment timeline to the corresponding point in the element's simple timeline. |
simpleTimeToSegmentTime |
Converts a value in the element's simple timeline to the corresponding point in the element's segment timeline. |
Objects
Object | Description |
---|
currTimeState |
Contains information about an HTML+TIME timeline. |
Remarks
This element only manipulates the presentation value for the duration of the animation. When the animation completes, the effect is no longer applied.
When setting style properties on an object, the property must be initialized in the object's style. The following example demonstrates how to use the t:SET element to change the width of a div.
<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
<HEAD>
<TITLE>t:SET Demo</TITLE>
<?IMPORT namespace="t" implementation="#default#time2">
</HEAD>
<BODY>
<DIV ID="oDIV" STYLE="width:100px; height:50px; border:solid black 1px;
text-align:center;">Resizing DIV!</DIV>
<t:SET attributeName="width" begin="2" to="300" dur="5" targetElement="oDIV" />
</BODY>
</HTML>
The prefix t: is used to associate this element with an Extensible Markup Language (XML) namespace. You must declare the XML namespace in the html tag of your document when using this element.
<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
You must then import the tag definitions from the time2 behavior by using the IMPORT processing instruction.
<?IMPORT namespace="t" implementation="#default#time2">
The members listed in the following table might not be accessible through scripting until the window.onload event fires. Waiting for this event to fire ensures that the page is completely loaded, that all behaviors have been applied to corresponding elements on the page, and that all the behavior's properties, methods, and events are available for scripting. Using any of the behavior-defined members before the window.onload event fires could result in a scripting error, indicating that the object does not support that particular member.
This element is not rendered.
This element requires a closing tag.
Standards Information
This object is defined in
Synchronized Multimedia Integration Language (SMIL) 2.0
.
See Also
animate, animateColor, animateMotion, Introduction to HTML+TIME, time2