externalresourcesrequired

externalresourcesrequired

文档经常引用和使用其他文件（和其他Web资源）的内容作为其渲染的一部分。在某些情况下，作者想要指定文档被认为是正确的需要特定的资源。

该externalResourcesRequired属性在所有容器元素和所有可能可以引用外部资源的元素上都可用。它指定是否需要引用的资源不是当前文档的一部分，才能正确呈现给定的容器元素或图形元素。

此属性适用于所有类型的资源引用，包括使用<font-face>元素或CSS @ font-face规范的引用指定的样式表，颜色配置文件和字体。特别是，如果一个元素设置了externalResourcesRequired="true"，那么所有样式表必须是可用的，因为任何样式表都可能影响该元素的呈现。

externalResourcesRequired属性不是可继承的（从属性值继承的意义上说），但是如果在容器元素上设置，则其值将应用于容器内的所有元素。

因为externalResourcesRequired="true"在容器元素上设置会禁用渐进显示该容器的内容，如果该容器包含引用外部资源的元素，作者应该避免简单地在通用的基础上对最外层的svg元素设置externalResourcesRequired="true"。相反，最好在那些特别需要外部资源可用性的特定图形元素或容器元素上指定externalResourcesRequired="true"，以便正确渲染。

用法上下文

true——表示需要当前文档外部的资源。如果外部资源不可用，渐进式渲染暂停，文档的SVGLoad事件不会被触发，动画时间轴直到该资源和所有其他所需资源变为可用时才会开始，已经被解析并准备好进行渲染。

实例

适用元素

以下元素可以使用该externalResourcesRequired属性

• 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>