This section is informative.
The following SMIL 3.0 DOM Module defined in this Chapter is a new module which was not part of SMIL 2.1.
This section is informative.
This chapter describes the SMIL 3.0 DOM support. SMIL is an XML-based language and conforms to the (XML) DOM Core [DOM1], [DOM2]. A language profile may include DOM support. The granularity of DOM being supported corresponds to the modules being selected in that language profile. As with all modules, required support for the DOM is an option of the language profile. DOM support consists of two independently usable parts, a module which contains methods to start and stop parts of a presentation during playback, and a description of the effects of changing attributes during playback.
No SMIL-specific interfaces are defined to change elements and attributes. The only SMIL-specific interfaces that are defined are an interface to start and stop parts of the running presentation, and an interface to handle events.
The section The animation sandwich model in the SMIL 3.0 Animation chapter describes the presentation effects of changing attributes that can be animated, whether or not any animations on the attribute are active.
This section is normative.
Using DOM level 2 methods [DOM2] an application may change the values of attributes and add and delete elements in a running SMIL presentation. Whether such editing is allowed is implementation dependent, although a profile may require support. In terms from the SMIL 3.0 Animation chapter, changing the value of an attribute through a DOM method changes the base value of the attribute. If animations are included in the profile, any animations on the same attribute build upon this changed base value. The presentation value which results from applying an animation is not visible through the DOM. The presentation effect of other changes through the DOM to a document while it is being played back is implementation-dependent.
In the chapter SMIL 3.0 Timing and Synchronization, the module DOMTimingMethods is defined which contains DOM methods to start and stop parts of a presentation during playback, and also DOM events that may be used to influence a presentation. The complete definition of these methods and events and their effects on a presentation is given in the section Document object model support of the Timing and Synchronization Module chapter.
This section is informative.
The functions supported in this version of the SMIL 3.0 DOM Modules draft are restricted to providing external access to attributes that profiles implementing this module also are able to change dynamically using SMIL animation primitives. A future version of this module description will likely contain a broader scope for DOM support.