Deprecated since SVG 2
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
The externalResourcesRequired
attribute specifies whether referenced resources that are not part of the current document are required for proper rendering of the given container 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 notes
Value | false | true |
---|---|
Default value | false |
Animatable | No |
true
- This value 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
- This value 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.
Specifications
Specification | Status | Comment |
---|---|---|
Scalable Vector Graphics (SVG) 1.1 (Second Edition) The definition of 'externalResourcesRequired' in that specification. |
Recommendation | Initial definition |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
externalResourcesRequired | Chrome ? | Edge ? | Firefox ? | IE ? | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
Legend
- Compatibility unknown
- Compatibility unknown
- Deprecated. Not for use in new websites.
- Deprecated. Not for use in new websites.