externalresourcesrequired

Documents often reference and use the contents of other files (and other Web resources) as part of their rendering. In some cases, authors want to specify that particular resources are required for a document to be considered correct.

The externalResourcesRequired attribute is available on all container elements and to all elements which potentially can reference external resources. It specifies whether referenced resources that are not part of the current document are required for proper rendering of the given container element or graphics element.

This attribute applies to all types of resource references, including style sheets, color profiles and fonts specified by a reference using a <font-face> element or a CSS @font-face specification. In particular, if an element sets externalResourcesRequired="true", then all style sheets must be available since any style sheet might affect the rendering of that element.

The externalResourcesRequired attribute is not inheritable (from a sense of attribute value inheritance), but if set on a container element, its value will apply to all elements within the container.

Because setting externalResourcesRequired="true" on a container element will have the effect of disabling progressive display of the contents of that container, if that container includes elements that reference external resources, authors should avoid simply setting externalResourcesRequired="true" on the outermost svg element on a universal basis. Instead, it is better to specify externalResourcesRequired="true" on those particular graphics elements or container elements which specifically need the availability of external resources in order to render properly.

Usage context

Categories	None
Value	true | false
Animatable	No
Normative document	SVG 1.1 (2nd Edition)

true

It indicates that resources external to the current document are required. If an external resource is not available, progressive rendering is suspended, the document's SVGLoad event is not fired and the animation timeline does not begin until that resource and all other required resources become available, have been parsed and are ready to be rendered.

false

It indicates that resources external to the current document are optional. Document rendering can proceed even if external resources are unavailable to the current element and its descendants. This is the default value.

Example

Elements

The following elements can use the externalResourcesRequired attribute

• Animation elements »
• Gradient elements »
• Graphics elements »
• Text content elements »
• Structural elements »
• <a>
• <clippath>
• <cursor>
• <feimage>
• <filter>
• <font>
• <foreignobject>
• <marker>
• <mask>
• <mpath>
• <pattern>
• <script>
• <switch>
• <view>