Scripting

Attribute definitions:

Name	Value	Lacuna value	Animatable
type	content-type	application/ecmascript	no

Identifies the scripting language for the given 'script' element. The value content-type specifies a media type, per Multipurpose Internet Mail Extensions (MIME) Part Two [RFC2046]. If a 'script/type' is not provided, then the default scripting language assumed is ECMAScript, as if processed with the 'application/ecmascript' media type.

Name	Value	Lacuna value	Animatable
href	<url>	(none)	no

An URL reference to an external resource containing the script code.

Event handling

Events can cause scripts to execute when either of the following has occurred:

• Event attributes such as 'onclick' or 'svg/onload' are assigned to particular elements, where the values of the event attributes are script which is executed when the given event occurs.
• Event listeners as described in DOM4 [DOM4] are defined which are invoked when a given event happens on a given object.

Related sections of the spec:

• User interface events describes how an SVG user agent handles events such as pointer movements events (e.g., mouse movement) and activation events (e.g., mouse click).
• Relationship with DOM3 events describes what parts of DOM are supported by SVG and how to register event listeners.

Event attributes

The following event attributes are available on many SVG elements.

The complete list of events that are part of the SVG language and SVG DOM and descriptions of those events is provided in Complete list of supported events.

The contents of event attributes are always interpreted as ECMAScript, as if processed with the media type 'application/ecmascript'. [RFC2046][RFC4329]

Event attribute for the load event

Attribute definitions:

Name	Value	Lacuna value	Animatable
onload	<anything>	(none)	no

Specifies some script to execute when "bubbling" or "at target" phase listeners for the load event are fired on the element the attribute is specified on.

Event attributes on graphics and container elements

Below are the definitions for the graphical event attributes. These can be specified on most graphics elements and container elements. (See the definition for each element to determine whether it can have a graphical event attribute specified on it.)

Note that 'svg/onload', defined above, is also classified as a graphical event attribute.

Attribute definitions:

Name	Value	Lacuna value	Animatable
onfocusin, onfocusout, onfocus, onblur, onclick, onkeydown, onkeyup, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout	<anything>	(none)	no

Specifies some script to execute when "bubbling" or "at target" phase listeners for the corresponding event are fired on the element the attribute is specified on. See the Complete list of supported events to determine which event each of these event attributes corresponds to.

Document-level event attributes

Below are the definitions for the document event attributes. These can be specified only on 'svg' elements.

The conformance class for the 'only-on-<svg> elements' criteria needs to be clarified here (this is for document validation presumably, so perhaps Conforming SVG Document Fragments would be appropriate to mention), the document event attributes should be fine to specify on any element, they just don't do much in all such cases, and it makes sense to not encourage uses where it doesn't have any real meaning. For Conforming Dynamic SVG Viewers: what the document event attributes should do is register an event listener for the event in question.

'onerror' should be available on image, script and elements that load external resources. This is related to issue 2254.

Attribute definitions:

Name	Value	Lacuna value	Animatable
onunload, onabort, onerror, onresize, onscroll, onzoom	<anything>	(none)	no

Specifies some script to execute when "bubbling" or "at target" phase listeners for the corresponding event are fired on the element the attribute is specified on. See the Complete list of supported events to determine which event each of these event attributes corresponds to.

Animation event attributes

Below are the definitions for the animation event attributes. These can be specified on the animation elements.

Attribute definitions:

Name	Value	Lacuna value	Animatable
onbegin, onend, onrepeat	<anything>	(none)	no

Specifies some script to execute when "bubbling" or "at target" phase listeners for the corresponding event are fired on the element the attribute is specified on. See the Complete list of supported events to determine which event each of these event attributes corresponds to.

DOM interfaces

Interface SVGScriptElement

interface SVGScriptElement : SVGElement {
  attribute DOMString type;
};

SVGScriptElement implements SVGURIReference;

Interface SVGZoomEvent

A DOM consumer can use the hasFeature of the DOMImplementation interface to determine whether the SVG zoom event set has been implemented by a DOM implementation. The feature string for this event set is "SVGZoomEvents". This string is also used with the createEvent method.

The zoom event handler occurs before the zoom event is processed. The remainder of the DOM represents the previous state of the document. The document will be updated upon normal return from the event handler.

The UI event type for a zoom event is:

SVGZoom

The zoom event occurs when the user initiates an action which causes the current view of the SVG document fragment to be rescaled. Event handlers are only recognized on 'svg' elements. See SVGZoom event.

• Bubbles: Yes
• Cancelable: No
• Context Info: zoomRectScreen, previousScale, previousTranslate, newScale, newTranslate, screenX, screenY, clientX, clientY, altKey, ctrlKey, shiftKey, metaKey, relatedNode.
  (screenX, screenY, clientX and clientY indicate the center of the zoom area, with clientX and clientY in viewport coordinates for the corresponding 'svg' element. relatedNode is the corresponding 'svg' element.)

interface SVGZoomEvent : UIEvent {
  readonly attribute DOMRectReadOnly zoomRectScreen;
  readonly attribute float previousScale;
  readonly attribute DOMPointReadOnly previousTranslate;
  readonly attribute float newScale;
  readonly attribute DOMPointReadOnly newTranslate;
};

Attributes:

zoomRectScreen (readonly DOMRectReadOnly)

The specified zoom rectangle in screen units.

The DOMRectReadOnly object is read only.

previousScale (readonly float)

The scale factor from previous zoom operations that was in place before the zoom operation occurred.

previousTranslate (readonly DOMPointReadOnly)

The translation values from previous zoom operations that were in place before the zoom operation occurred.

The DOMPointReadOnly object is read only.

newScale (readonly float)

The scale factor that will be in place after the zoom operation has been processed.

newTranslate (readonly DOMPointReadOnly)

The translation values that will be in place after the zoom operation has been processed.

The DOMPointReadOnly object is read only.