Node.appendChild(null) / replaceChild(null, null) / removeChild(null) / insertBefore...
[WebKit-https.git] / Source / WebCore / svg / SVGUseElement.cpp
1 /*
2  * Copyright (C) 2004, 2005, 2006, 2007, 2008 Nikolas Zimmermann <zimmermann@kde.org>
3  * Copyright (C) 2004, 2005, 2006, 2007 Rob Buis <buis@kde.org>
4  * Copyright (C) Research In Motion Limited 2009-2010. All rights reserved.
5  * Copyright (C) 2011 Torch Mobile (Beijing) Co. Ltd. All rights reserved.
6  * Copyright (C) 2012 University of Szeged
7  * Copyright (C) 2012 Renata Hodovan <reni@webkit.org>
8  * Copyright (C) 2015 Apple Inc. All rights reserved.
9  *
10  * This library is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Library General Public
12  * License as published by the Free Software Foundation; either
13  * version 2 of the License, or (at your option) any later version.
14  *
15  * This library is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18  * Library General Public License for more details.
19  *
20  * You should have received a copy of the GNU Library General Public License
21  * along with this library; see the file COPYING.LIB.  If not, write to
22  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23  * Boston, MA 02110-1301, USA.
24  */
25
26 #include "config.h"
27 #include "SVGUseElement.h"
28
29 #include "CachedResourceLoader.h"
30 #include "CachedSVGDocument.h"
31 #include "ElementIterator.h"
32 #include "Event.h"
33 #include "RenderSVGResource.h"
34 #include "RenderSVGTransformableContainer.h"
35 #include "ShadowRoot.h"
36 #include "SVGGElement.h"
37 #include "SVGSVGElement.h"
38 #include "SVGSymbolElement.h"
39 #include "XLinkNames.h"
40
41 namespace WebCore {
42
43 DEFINE_ANIMATED_LENGTH(SVGUseElement, SVGNames::xAttr, X, x)
44 DEFINE_ANIMATED_LENGTH(SVGUseElement, SVGNames::yAttr, Y, y)
45 DEFINE_ANIMATED_LENGTH(SVGUseElement, SVGNames::widthAttr, Width, width)
46 DEFINE_ANIMATED_LENGTH(SVGUseElement, SVGNames::heightAttr, Height, height)
47 DEFINE_ANIMATED_STRING(SVGUseElement, XLinkNames::hrefAttr, Href, href)
48 DEFINE_ANIMATED_BOOLEAN(SVGUseElement, SVGNames::externalResourcesRequiredAttr, ExternalResourcesRequired, externalResourcesRequired)
49
50 BEGIN_REGISTER_ANIMATED_PROPERTIES(SVGUseElement)
51     REGISTER_LOCAL_ANIMATED_PROPERTY(x)
52     REGISTER_LOCAL_ANIMATED_PROPERTY(y)
53     REGISTER_LOCAL_ANIMATED_PROPERTY(width)
54     REGISTER_LOCAL_ANIMATED_PROPERTY(height)
55     REGISTER_LOCAL_ANIMATED_PROPERTY(href)
56     REGISTER_LOCAL_ANIMATED_PROPERTY(externalResourcesRequired)
57     REGISTER_PARENT_ANIMATED_PROPERTIES(SVGGraphicsElement)
58 END_REGISTER_ANIMATED_PROPERTIES
59
60 inline SVGUseElement::SVGUseElement(const QualifiedName& tagName, Document& document)
61     : SVGGraphicsElement(tagName, document)
62     , m_x(LengthModeWidth)
63     , m_y(LengthModeHeight)
64     , m_width(LengthModeWidth)
65     , m_height(LengthModeHeight)
66     , m_svgLoadEventTimer(*this, &SVGElement::svgLoadEventTimerFired)
67 {
68     ASSERT(hasCustomStyleResolveCallbacks());
69     ASSERT(hasTagName(SVGNames::useTag));
70     registerAnimatedPropertiesForSVGUseElement();
71 }
72
73 Ref<SVGUseElement> SVGUseElement::create(const QualifiedName& tagName, Document& document)
74 {
75     return adoptRef(*new SVGUseElement(tagName, document));
76 }
77
78 SVGUseElement::~SVGUseElement()
79 {
80     if (m_externalDocument)
81         m_externalDocument->removeClient(this);
82 }
83
84 void SVGUseElement::parseAttribute(const QualifiedName& name, const AtomicString& value)
85 {
86     SVGParsingError parseError = NoError;
87
88     if (name == SVGNames::xAttr)
89         setXBaseValue(SVGLength::construct(LengthModeWidth, value, parseError));
90     else if (name == SVGNames::yAttr)
91         setYBaseValue(SVGLength::construct(LengthModeHeight, value, parseError));
92     else if (name == SVGNames::widthAttr)
93         setWidthBaseValue(SVGLength::construct(LengthModeWidth, value, parseError, ForbidNegativeLengths));
94     else if (name == SVGNames::heightAttr)
95         setHeightBaseValue(SVGLength::construct(LengthModeHeight, value, parseError, ForbidNegativeLengths));
96
97     reportAttributeParsingError(parseError, name, value);
98
99     SVGExternalResourcesRequired::parseAttribute(name, value);
100     SVGGraphicsElement::parseAttribute(name, value);
101     SVGURIReference::parseAttribute(name, value);
102 }
103
104 Node::InsertionNotificationRequest SVGUseElement::insertedInto(ContainerNode& rootParent)
105 {
106     SVGGraphicsElement::insertedInto(rootParent);
107     if (inDocument()) {
108         SVGExternalResourcesRequired::insertedIntoDocument(this);
109         invalidateShadowTree();
110         updateExternalDocument();
111     }
112     return InsertionDone;
113 }
114
115 void SVGUseElement::removedFrom(ContainerNode& rootParent)
116 {
117     SVGGraphicsElement::removedFrom(rootParent);
118     clearShadowTree();
119     updateExternalDocument();
120 }
121
122 inline Document* SVGUseElement::externalDocument() const
123 {
124     return m_externalDocument ? m_externalDocument->document() : nullptr;
125 }
126
127 void SVGUseElement::transferSizeAttributesToTargetClone(SVGElement& shadowElement) const
128 {
129     // FIXME: The check for valueInSpecifiedUnits being non-zero below is a workaround for the fact
130     // that we currently have no good way to tell whether a particular animatable attribute is a value
131     // indicating it was unspecified, or specified but could not be parsed. Would be nice to fix that some day.
132     if (is<SVGSymbolElement>(shadowElement)) {
133         // Spec (<use> on <symbol>): This generated 'svg' will always have explicit values for attributes width and height.
134         // If attributes width and/or height are provided on the 'use' element, then these attributes
135         // will be transferred to the generated 'svg'. If attributes width and/or height are not specified,
136         // the generated 'svg' element will use values of 100% for these attributes.
137         shadowElement.setAttribute(SVGNames::widthAttr, (widthIsValid() && width().valueInSpecifiedUnits()) ? AtomicString(width().valueAsString()) : "100%");
138         shadowElement.setAttribute(SVGNames::heightAttr, (heightIsValid() && height().valueInSpecifiedUnits()) ? AtomicString(height().valueAsString()) : "100%");
139     } else if (is<SVGSVGElement>(shadowElement)) {
140         // Spec (<use> on <svg>): If attributes width and/or height are provided on the 'use' element, then these
141         // values will override the corresponding attributes on the 'svg' in the generated tree.
142         shadowElement.setAttribute(SVGNames::widthAttr, (widthIsValid() && width().valueInSpecifiedUnits()) ? AtomicString(width().valueAsString()) : shadowElement.correspondingElement()->getAttribute(SVGNames::widthAttr));
143         shadowElement.setAttribute(SVGNames::heightAttr, (heightIsValid() && height().valueInSpecifiedUnits()) ? AtomicString(height().valueAsString()) : shadowElement.correspondingElement()->getAttribute(SVGNames::heightAttr));
144     }
145 }
146
147 void SVGUseElement::svgAttributeChanged(const QualifiedName& attrName)
148 {
149     InstanceInvalidationGuard guard(*this);
150
151     if (attrName == SVGNames::xAttr || attrName == SVGNames::yAttr || attrName == SVGNames::widthAttr || attrName == SVGNames::heightAttr) {
152         updateRelativeLengthsInformation();
153         if (attrName == SVGNames::widthAttr || attrName == SVGNames::heightAttr) {
154             // FIXME: It's unnecessarily inefficient to update both width and height each time either is changed.
155             if (auto* targetClone = this->targetClone())
156                 transferSizeAttributesToTargetClone(*targetClone);
157         }
158         if (auto* renderer = this->renderer())
159             RenderSVGResource::markForLayoutAndParentResourceInvalidation(*renderer);
160         return;
161     }
162
163     if (SVGExternalResourcesRequired::handleAttributeChange(this, attrName))
164         return;
165
166     if (SVGURIReference::isKnownAttribute(attrName)) {
167         updateExternalDocument();
168         invalidateShadowTree();
169         return;
170     }
171
172     if (SVGLangSpace::isKnownAttribute(attrName) || SVGExternalResourcesRequired::isKnownAttribute(attrName)) {
173         invalidateShadowTree();
174         return;
175     }
176
177     SVGGraphicsElement::svgAttributeChanged(attrName);
178 }
179
180 void SVGUseElement::willAttachRenderers()
181 {
182     if (m_shadowTreeNeedsUpdate)
183         updateShadowTree();
184     SVGGraphicsElement::willAttachRenderers();
185 }
186
187 static HashSet<AtomicString> createAllowedElementSet()
188 {
189     // Spec: "Any 'svg', 'symbol', 'g', graphics element or other 'use' is potentially a template object that can be re-used
190     // (i.e., "instanced") in the SVG document via a 'use' element."
191     // "Graphics Element" is defined as 'circle', 'ellipse', 'image', 'line', 'path', 'polygon', 'polyline', 'rect', 'text'
192     // Excluded are anything that is used by reference or that only make sense to appear once in a document.
193     using namespace SVGNames;
194     HashSet<AtomicString> set;
195     for (auto& tag : { aTag, circleTag, descTag, ellipseTag, gTag, imageTag, lineTag, metadataTag, pathTag, polygonTag, polylineTag, rectTag, svgTag, switchTag, symbolTag, textTag, textPathTag, titleTag, trefTag, tspanTag, useTag })
196         set.add(tag.localName());
197     return set;
198 }
199
200 static inline bool isDisallowedElement(const SVGElement& element)
201 {
202     static NeverDestroyed<HashSet<AtomicString>> set = createAllowedElementSet();
203     return !set.get().contains(element.localName());
204 }
205
206 static inline bool isDisallowedElement(const Element& element)
207 {
208     return !element.isSVGElement() || isDisallowedElement(downcast<SVGElement>(element));
209 }
210
211 void SVGUseElement::clearShadowTree()
212 {
213     if (auto* root = userAgentShadowRoot())
214         root->removeChildren();
215 }
216
217 void SVGUseElement::buildPendingResource()
218 {
219     invalidateShadowTree();
220 }
221
222 void SVGUseElement::updateShadowTree()
223 {
224     m_shadowTreeNeedsUpdate = false;
225
226     // FIXME: It's expensive to re-clone the entire tree every time. We should find a more efficient way to handle this.
227     clearShadowTree();
228
229     if (isInShadowTree() || !inDocument())
230         return;
231
232     String targetID;
233     auto* target = findTarget(&targetID);
234     if (!target) {
235         document().accessSVGExtensions().addPendingResource(targetID, this);
236         return;
237     }
238
239     cloneTarget(ensureUserAgentShadowRoot(), *target);
240     expandUseElementsInShadowTree();
241     expandSymbolElementsInShadowTree();
242     transferEventListenersToShadowTree();
243
244     updateRelativeLengthsInformation();
245
246     // When we invalidate the other shadow trees, it's important that we don't
247     // follow any cycles and invalidate ourselves. To avoid that, we temporarily
248     // set m_shadowTreeNeedsUpdate to true so invalidateShadowTree will
249     // quickly return and do nothing.
250     ASSERT(!m_shadowTreeNeedsUpdate);
251     m_shadowTreeNeedsUpdate = true;
252     invalidateDependentShadowTrees();
253     m_shadowTreeNeedsUpdate = false;
254 }
255
256 SVGElement* SVGUseElement::targetClone() const
257 {
258     auto* root = userAgentShadowRoot();
259     if (!root)
260         return nullptr;
261     return downcast<SVGElement>(root->firstChild());
262 }
263
264 RenderPtr<RenderElement> SVGUseElement::createElementRenderer(Ref<RenderStyle>&& style, const RenderTreePosition&)
265 {
266     return createRenderer<RenderSVGTransformableContainer>(*this, WTF::move(style));
267 }
268
269 static bool isDirectReference(const SVGElement& element)
270 {
271     using namespace SVGNames;
272     return element.hasTagName(circleTag)
273         || element.hasTagName(ellipseTag)
274         || element.hasTagName(pathTag)
275         || element.hasTagName(polygonTag)
276         || element.hasTagName(polylineTag)
277         || element.hasTagName(rectTag)
278         || element.hasTagName(textTag);
279 }
280
281 void SVGUseElement::toClipPath(Path& path)
282 {
283     ASSERT(path.isEmpty());
284
285     auto* targetClone = this->targetClone();
286     if (!is<SVGGraphicsElement>(targetClone))
287         return;
288
289     if (!isDirectReference(*targetClone)) {
290         // Spec: Indirect references are an error (14.3.5)
291         document().accessSVGExtensions().reportError(ASCIILiteral("Not allowed to use indirect reference in <clip-path>"));
292         return;
293     }
294
295     downcast<SVGGraphicsElement>(*targetClone).toClipPath(path);
296     SVGLengthContext lengthContext(this);
297     // FIXME: Find a way to do this without manual resolution of x/y here. It's potentially incorrect.
298     path.translate(FloatSize(x().value(lengthContext), y().value(lengthContext)));
299     path.transform(animatedLocalTransform());
300 }
301
302 RenderElement* SVGUseElement::rendererClipChild() const
303 {
304     auto* targetClone = this->targetClone();
305     if (!targetClone)
306         return nullptr;
307     if (!isDirectReference(*targetClone))
308         return nullptr;
309     return targetClone->renderer();
310 }
311
312 static void removeDisallowedElementsFromSubtree(SVGElement& subtree)
313 {
314     // Remove disallowed elements after the fact rather than not cloning them in the first place.
315     // This optimizes for the normal case where none of those elements are present.
316
317     // This function is used only on elements in subtrees that are not yet in documents, so
318     // mutation events are not a factor; there are no event listeners to handle those events.
319     // Assert that it's not in a document to make sure callers are still using it this way.
320     ASSERT(!subtree.inDocument());
321
322     Vector<Element*> disallowedElements;
323     auto descendants = descendantsOfType<Element>(subtree);
324     for (auto it = descendants.begin(), end = descendants.end(); it != end; ) {
325         if (isDisallowedElement(*it)) {
326             disallowedElements.append(&*it);
327             it.traverseNextSkippingChildren();
328             continue;
329         }
330         ++it;
331     }
332     for (auto* element : disallowedElements) {
333         for (auto& descendant : descendantsOfType<SVGElement>(*element))
334             descendant.setCorrespondingElement(nullptr);
335         element->parentNode()->removeChild(*element);
336     }
337 }
338
339 static void associateClonesWithOriginals(SVGElement& clone, SVGElement& original)
340 {
341     // This assertion checks that we don't call this with the arguments backwards.
342     // The clone is new and so it's not installed in a parent yet.
343     ASSERT(!clone.parentNode());
344
345     // The loop below works because we are associating these clones immediately, before
346     // doing transformations like removing disallowed elements or expanding elements.
347     clone.setCorrespondingElement(&original);
348     for (auto pair : descendantsOfType<SVGElement>(clone, original))
349         pair.first.setCorrespondingElement(&pair.second);
350 }
351
352 static void associateReplacementCloneWithOriginal(SVGElement& replacementClone, SVGElement& originalClone)
353 {
354     auto* correspondingElement = originalClone.correspondingElement();
355     ASSERT(correspondingElement);
356     originalClone.setCorrespondingElement(nullptr);
357     replacementClone.setCorrespondingElement(correspondingElement);
358 }
359
360 static void associateReplacementClonesWithOriginals(SVGElement& replacementClone, SVGElement& originalClone)
361 {
362     // This assertion checks that we don't call this with the arguments backwards.
363     // The replacement clone is new and so it's not installed in a parent yet.
364     ASSERT(!replacementClone.parentNode());
365
366     // The loop below works because we are associating these clones immediately, before
367     // doing transformations like removing disallowed elements or expanding elements.
368     associateReplacementCloneWithOriginal(replacementClone, originalClone);
369     for (auto pair : descendantsOfType<SVGElement>(replacementClone, originalClone))
370         associateReplacementCloneWithOriginal(pair.first, pair.second);
371 }
372
373 SVGElement* SVGUseElement::findTarget(String* targetID) const
374 {
375     auto* correspondingElement = this->correspondingElement();
376     auto& original = correspondingElement ? downcast<SVGUseElement>(*correspondingElement) : *this;
377
378     auto* targetCandidate = targetElementFromIRIString(original.href(), original.document(), targetID, original.externalDocument());
379     if (targetID && !targetID->isNull()) {
380         // If the reference is external, don't return the target ID to the caller.
381         // The caller would use the target ID to wait for a pending resource on the wrong document.
382         // If we ever want the change that and let the caller to wait on the external document,
383         // we should change this function so it returns the appropriate document to go with the ID.
384         if (isExternalURIReference(original.href(), original.document()))
385             *targetID = String();
386     }
387     if (!is<SVGElement>(targetCandidate))
388         return nullptr;
389     auto& target = downcast<SVGElement>(*targetCandidate);
390
391     if (!target.inDocument() || isDisallowedElement(target))
392         return nullptr;
393
394     // Reject any target that has already been cloned to create one of the ancestors of this element,
395     // already in the shadow tree. This is sufficient to prevent cycles.
396     if (correspondingElement) {
397         for (auto& ancestor : lineageOfType<SVGElement>(*this)) {
398             if (ancestor.correspondingElement() == &target)
399                 return nullptr;
400         }
401     }
402
403     return &target;
404 }
405
406 void SVGUseElement::cloneTarget(ContainerNode& container, SVGElement& target) const
407 {
408     Ref<SVGElement> targetClone = static_cast<SVGElement&>(target.cloneElementWithChildren(document()).get());
409     associateClonesWithOriginals(targetClone.get(), target);
410     removeDisallowedElementsFromSubtree(targetClone.get());
411     transferSizeAttributesToTargetClone(targetClone.get());
412     container.appendChild(WTF::move(targetClone));
413 }
414
415 static void cloneDataAndChildren(SVGElement& replacementClone, SVGElement& originalClone)
416 {
417     // This assertion checks that we don't call this with the arguments backwards.
418     // The replacement clone is new and so it's not installed in a parent yet.
419     ASSERT(!replacementClone.parentNode());
420
421     replacementClone.cloneDataFromElement(originalClone);
422     originalClone.cloneChildNodes(replacementClone);
423     associateReplacementClonesWithOriginals(replacementClone, originalClone);
424     removeDisallowedElementsFromSubtree(replacementClone);
425 }
426
427 void SVGUseElement::expandUseElementsInShadowTree() const
428 {
429     auto descendants = descendantsOfType<SVGUseElement>(*userAgentShadowRoot());
430     for (auto it = descendants.begin(), end = descendants.end(); it != end; ) {
431         SVGUseElement& originalClone = *it;
432         it = end; // Efficiently quiets assertions due to the outstanding iterator.
433
434         auto* target = originalClone.findTarget();
435
436         // Spec: In the generated content, the 'use' will be replaced by 'g', where all attributes from the
437         // 'use' element except for x, y, width, height and xlink:href are transferred to the generated 'g' element.
438
439         auto replacementClone = SVGGElement::create(document());
440         cloneDataAndChildren(replacementClone.get(), originalClone);
441
442         replacementClone->removeAttribute(SVGNames::xAttr);
443         replacementClone->removeAttribute(SVGNames::yAttr);
444         replacementClone->removeAttribute(SVGNames::widthAttr);
445         replacementClone->removeAttribute(SVGNames::heightAttr);
446         replacementClone->removeAttribute(XLinkNames::hrefAttr);
447
448         if (target)
449             originalClone.cloneTarget(replacementClone.get(), *target);
450
451         originalClone.parentNode()->replaceChild(replacementClone.copyRef(), originalClone);
452
453         // Resume iterating, starting just inside the replacement clone.
454         it = descendants.from(replacementClone.get());
455     }
456 }
457
458 void SVGUseElement::expandSymbolElementsInShadowTree() const
459 {
460     auto descendants = descendantsOfType<SVGSymbolElement>(*userAgentShadowRoot());
461     for (auto it = descendants.begin(), end = descendants.end(); it != end; ) {
462         SVGSymbolElement& originalClone = *it;
463         it = end; // Efficiently quiets assertions due to the outstanding iterator.
464
465         // Spec: The referenced 'symbol' and its contents are deep-cloned into the generated tree,
466         // with the exception that the 'symbol' is replaced by an 'svg'. This generated 'svg' will
467         // always have explicit values for attributes width and height. If attributes width and/or
468         // height are provided on the 'use' element, then these attributes will be transferred to
469         // the generated 'svg'. If attributes width and/or height are not specified, the generated
470         // 'svg' element will use values of 100% for these attributes.
471
472         auto replacementClone = SVGSVGElement::create(document());
473         cloneDataAndChildren(replacementClone.get(), originalClone);
474
475         originalClone.parentNode()->replaceChild(replacementClone.copyRef(), originalClone);
476
477         // Resume iterating, starting just inside the replacement clone.
478         it = descendants.from(replacementClone.get());
479     }
480 }
481
482 void SVGUseElement::transferEventListenersToShadowTree() const
483 {
484     for (auto& descendant : descendantsOfType<SVGElement>(*userAgentShadowRoot())) {
485         if (EventTargetData* data = descendant.correspondingElement()->eventTargetData())
486             data->eventListenerMap.copyEventListenersNotCreatedFromMarkupToTarget(&descendant);
487     }
488 }
489
490 void SVGUseElement::invalidateShadowTree()
491 {
492     if (m_shadowTreeNeedsUpdate)
493         return;
494     m_shadowTreeNeedsUpdate = true;
495     setNeedsStyleRecalc(ReconstructRenderTree);
496     invalidateDependentShadowTrees();
497 }
498
499 void SVGUseElement::invalidateDependentShadowTrees()
500 {
501     for (auto* instance : instances()) {
502         if (auto* element = instance->correspondingUseElement())
503             element->invalidateShadowTree();
504     }
505 }
506
507 bool SVGUseElement::selfHasRelativeLengths() const
508 {
509     if (x().isRelative() || y().isRelative() || width().isRelative() || height().isRelative())
510         return true;
511
512     auto* targetClone = this->targetClone();
513     return targetClone && targetClone->hasRelativeLengths();
514 }
515
516 void SVGUseElement::notifyFinished(CachedResource* resource)
517 {
518     invalidateShadowTree();
519     if (resource->errorOccurred())
520         dispatchEvent(Event::create(eventNames().errorEvent, false, false));
521     else if (!resource->wasCanceled())
522         SVGExternalResourcesRequired::dispatchLoadEvent(this);
523 }
524
525 void SVGUseElement::finishParsingChildren()
526 {
527     SVGGraphicsElement::finishParsingChildren();
528     SVGExternalResourcesRequired::finishParsingChildren();
529 }
530
531 void SVGUseElement::updateExternalDocument()
532 {
533     URL externalDocumentURL;
534     if (inDocument() && isExternalURIReference(href(), document())) {
535         externalDocumentURL = document().completeURL(href());
536         if (!externalDocumentURL.hasFragmentIdentifier())
537             externalDocumentURL = URL();
538     }
539
540     if (externalDocumentURL == (m_externalDocument ? m_externalDocument->url() : URL()))
541         return;
542
543     if (m_externalDocument)
544         m_externalDocument->removeClient(this);
545
546     if (externalDocumentURL.isNull())
547         m_externalDocument = nullptr;
548     else {
549         ResourceLoaderOptions options = CachedResourceLoader::defaultCachedResourceOptions();
550         options.setContentSecurityPolicyImposition(isInUserAgentShadowTree() ? ContentSecurityPolicyImposition::SkipPolicyCheck : ContentSecurityPolicyImposition::DoPolicyCheck);
551
552         CachedResourceRequest request { ResourceRequest { externalDocumentURL }, options };
553         request.setInitiator(this);
554         m_externalDocument = document().cachedResourceLoader().requestSVGDocument(request);
555         if (m_externalDocument)
556             m_externalDocument->addClient(this);
557     }
558
559     invalidateShadowTree();
560 }
561
562 bool SVGUseElement::isValid() const
563 {
564     return SVGTests::isValid();
565 }
566
567 bool SVGUseElement::haveLoadedRequiredResources()
568 {
569     return SVGExternalResourcesRequired::haveLoadedRequiredResources();
570 }
571
572 void SVGUseElement::setHaveFiredLoadEvent(bool haveFiredLoadEvent)
573 {
574     m_haveFiredLoadEvent = haveFiredLoadEvent;
575 }
576
577 bool SVGUseElement::haveFiredLoadEvent() const
578 {
579     return m_haveFiredLoadEvent;
580 }
581
582 Timer* SVGUseElement::svgLoadEventTimer()
583 {
584     return &m_svgLoadEventTimer;
585 }
586
587 }