Rename StylePropertySet to StyleProperties
[WebKit-https.git] / Source / WebCore / html / HTMLElement.cpp
1 /*
2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
3  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
4  * Copyright (C) 2004, 2005, 2006, 2007, 2008 Apple Inc. All rights reserved.
5  * Copyright (C) 2009 Torch Mobile Inc. All rights reserved. (http://www.torchmobile.com/)
6  * Copyright (C) 2011 Motorola Mobility. All rights reserved.
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Library General Public
10  * License as published by the Free Software Foundation; either
11  * version 2 of the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Library General Public License for more details.
17  *
18  * You should have received a copy of the GNU Library General Public License
19  * along with this library; see the file COPYING.LIB.  If not, write to
20  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21  * Boston, MA 02110-1301, USA.
22  *
23  */
24
25 #include "config.h"
26 #include "HTMLElement.h"
27
28 #include "Attribute.h"
29 #include "CSSParser.h"
30 #include "CSSPropertyNames.h"
31 #include "CSSValueKeywords.h"
32 #include "CSSValuePool.h"
33 #include "DOMSettableTokenList.h"
34 #include "DocumentFragment.h"
35 #include "ElementAncestorIterator.h"
36 #include "Event.h"
37 #include "EventListener.h"
38 #include "EventNames.h"
39 #include "ExceptionCode.h"
40 #include "Frame.h"
41 #include "FrameLoader.h"
42 #include "HTMLBRElement.h"
43 #include "HTMLCollection.h"
44 #include "HTMLDocument.h"
45 #include "HTMLElementFactory.h"
46 #include "HTMLFormElement.h"
47 #include "HTMLNames.h"
48 #include "HTMLParserIdioms.h"
49 #include "HTMLTemplateElement.h"
50 #include "HTMLTextFormControlElement.h"
51 #include "NodeTraversal.h"
52 #include "RenderLineBreak.h"
53 #include "ScriptController.h"
54 #include "Settings.h"
55 #include "StyleProperties.h"
56 #include "SubframeLoader.h"
57 #include "Text.h"
58 #include "TextIterator.h"
59 #include "XMLNames.h"
60 #include "markup.h"
61 #include <wtf/NeverDestroyed.h>
62 #include <wtf/StdLibExtras.h>
63 #include <wtf/text/CString.h>
64
65 namespace WebCore {
66
67 using namespace HTMLNames;
68 using namespace WTF;
69
70 PassRefPtr<HTMLElement> HTMLElement::create(const QualifiedName& tagName, Document& document)
71 {
72     return adoptRef(new HTMLElement(tagName, document));
73 }
74
75 String HTMLElement::nodeName() const
76 {
77     // FIXME: Would be nice to have an atomicstring lookup based off uppercase
78     // chars that does not have to copy the string on a hit in the hash.
79     // FIXME: We should have a way to detect XHTML elements and replace the hasPrefix() check with it.
80     if (document().isHTMLDocument() && !tagQName().hasPrefix())
81         return tagQName().localNameUpper();
82     return Element::nodeName();
83 }
84
85 bool HTMLElement::ieForbidsInsertHTML() const
86 {
87     // FIXME: Supposedly IE disallows settting innerHTML, outerHTML
88     // and createContextualFragment on these tags.  We have no tests to
89     // verify this however, so this list could be totally wrong.
90     // This list was moved from the previous endTagRequirement() implementation.
91     // This is also called from editing and assumed to be the list of tags
92     // for which no end tag should be serialized. It's unclear if the list for
93     // IE compat and the list for serialization sanity are the same.
94     if (hasLocalName(areaTag)
95         || hasLocalName(baseTag)
96         || hasLocalName(basefontTag)
97         || hasLocalName(brTag)
98         || hasLocalName(colTag)
99         || hasLocalName(embedTag)
100         || hasLocalName(frameTag)
101         || hasLocalName(hrTag)
102         || hasLocalName(imageTag)
103         || hasLocalName(imgTag)
104         || hasLocalName(inputTag)
105         || hasLocalName(isindexTag)
106         || hasLocalName(linkTag)
107         || hasLocalName(metaTag)
108         || hasLocalName(paramTag)
109         || hasLocalName(sourceTag)
110         || hasLocalName(wbrTag))
111         return true;
112     // FIXME: I'm not sure why dashboard mode would want to change the
113     // serialization of <canvas>, that seems like a bad idea.
114 #if ENABLE(DASHBOARD_SUPPORT)
115     if (hasLocalName(canvasTag)) {
116         Settings* settings = document().settings();
117         if (settings && settings->usesDashboardBackwardCompatibilityMode())
118             return true;
119     }
120 #endif
121     return false;
122 }
123
124 static inline CSSValueID unicodeBidiAttributeForDirAuto(HTMLElement& element)
125 {
126     if (element.hasLocalName(preTag) || element.hasLocalName(textareaTag))
127         return CSSValueWebkitPlaintext;
128     // FIXME: For bdo element, dir="auto" should result in "bidi-override isolate" but we don't support having multiple values in unicode-bidi yet.
129     // See https://bugs.webkit.org/show_bug.cgi?id=73164.
130     return CSSValueWebkitIsolate;
131 }
132
133 unsigned HTMLElement::parseBorderWidthAttribute(const AtomicString& value) const
134 {
135     unsigned borderWidth = 0;
136     if (value.isEmpty() || !parseHTMLNonNegativeInteger(value, borderWidth))
137         return hasLocalName(tableTag) ? 1 : borderWidth;
138     return borderWidth;
139 }
140
141 void HTMLElement::applyBorderAttributeToStyle(const AtomicString& value, MutableStyleProperties& style)
142 {
143     addPropertyToPresentationAttributeStyle(style, CSSPropertyBorderWidth, parseBorderWidthAttribute(value), CSSPrimitiveValue::CSS_PX);
144     addPropertyToPresentationAttributeStyle(style, CSSPropertyBorderStyle, CSSValueSolid);
145 }
146
147 void HTMLElement::mapLanguageAttributeToLocale(const AtomicString& value, MutableStyleProperties& style)
148 {
149     if (!value.isEmpty()) {
150         // Have to quote so the locale id is treated as a string instead of as a CSS keyword.
151         addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitLocale, quoteCSSString(value));
152     } else {
153         // The empty string means the language is explicitly unknown.
154         addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitLocale, CSSValueAuto);
155     }
156 }
157
158 bool HTMLElement::isPresentationAttribute(const QualifiedName& name) const
159 {
160     if (name == alignAttr || name == contenteditableAttr || name == hiddenAttr || name == langAttr || name.matches(XMLNames::langAttr) || name == draggableAttr || name == dirAttr)
161         return true;
162     return StyledElement::isPresentationAttribute(name);
163 }
164
165 void HTMLElement::collectStyleForPresentationAttribute(const QualifiedName& name, const AtomicString& value, MutableStyleProperties& style)
166 {
167     if (name == alignAttr) {
168         if (equalIgnoringCase(value, "middle"))
169             addPropertyToPresentationAttributeStyle(style, CSSPropertyTextAlign, CSSValueCenter);
170         else
171             addPropertyToPresentationAttributeStyle(style, CSSPropertyTextAlign, value);
172     } else if (name == contenteditableAttr) {
173         if (value.isEmpty() || equalIgnoringCase(value, "true")) {
174             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitUserModify, CSSValueReadWrite);
175             addPropertyToPresentationAttributeStyle(style, CSSPropertyWordWrap, CSSValueBreakWord);
176             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitNbspMode, CSSValueSpace);
177             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitLineBreak, CSSValueAfterWhiteSpace);
178         } else if (equalIgnoringCase(value, "plaintext-only")) {
179             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitUserModify, CSSValueReadWritePlaintextOnly);
180             addPropertyToPresentationAttributeStyle(style, CSSPropertyWordWrap, CSSValueBreakWord);
181             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitNbspMode, CSSValueSpace);
182             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitLineBreak, CSSValueAfterWhiteSpace);
183         } else if (equalIgnoringCase(value, "false"))
184             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitUserModify, CSSValueReadOnly);
185     } else if (name == hiddenAttr) {
186         addPropertyToPresentationAttributeStyle(style, CSSPropertyDisplay, CSSValueNone);
187     } else if (name == draggableAttr) {
188         if (equalIgnoringCase(value, "true")) {
189             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitUserDrag, CSSValueElement);
190             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitUserSelect, CSSValueNone);
191         } else if (equalIgnoringCase(value, "false"))
192             addPropertyToPresentationAttributeStyle(style, CSSPropertyWebkitUserDrag, CSSValueNone);
193     } else if (name == dirAttr) {
194         if (equalIgnoringCase(value, "auto"))
195             addPropertyToPresentationAttributeStyle(style, CSSPropertyUnicodeBidi, unicodeBidiAttributeForDirAuto(*this));
196         else {
197             addPropertyToPresentationAttributeStyle(style, CSSPropertyDirection, value);
198             if (!hasTagName(bdiTag) && !hasTagName(bdoTag) && !hasTagName(outputTag))
199                 addPropertyToPresentationAttributeStyle(style, CSSPropertyUnicodeBidi, CSSValueEmbed);
200         }
201     } else if (name.matches(XMLNames::langAttr))
202         mapLanguageAttributeToLocale(value, style);
203     else if (name == langAttr) {
204         // xml:lang has a higher priority than lang.
205         if (!fastHasAttribute(XMLNames::langAttr))
206             mapLanguageAttributeToLocale(value, style);
207     } else
208         StyledElement::collectStyleForPresentationAttribute(name, value, style);
209 }
210
211 static NEVER_INLINE void populateEventNameForAttributeLocalNameMap(HashMap<AtomicStringImpl*, AtomicString>& map)
212 {
213     static const QualifiedName* const simpleTable[] = {
214         &onabortAttr,
215         &onbeforecopyAttr,
216         &onbeforecutAttr,
217         &onbeforepasteAttr,
218         &onblurAttr,
219         &oncanplayAttr,
220         &oncanplaythroughAttr,
221         &onchangeAttr,
222         &onclickAttr,
223         &oncontextmenuAttr,
224         &oncopyAttr,
225         &oncutAttr,
226         &ondblclickAttr,
227         &ondragAttr,
228         &ondragendAttr,
229         &ondragenterAttr,
230         &ondragleaveAttr,
231         &ondragoverAttr,
232         &ondragstartAttr,
233         &ondropAttr,
234         &ondurationchangeAttr,
235         &onemptiedAttr,
236         &onendedAttr,
237         &onerrorAttr,
238         &onfocusAttr,
239         &onfocusinAttr,
240         &onfocusoutAttr,
241         &oninputAttr,
242         &oninvalidAttr,
243         &onkeydownAttr,
244         &onkeypressAttr,
245         &onkeyupAttr,
246         &onloadAttr,
247         &onloadeddataAttr,
248         &onloadedmetadataAttr,
249         &onloadstartAttr,
250         &onmousedownAttr,
251         &onmouseenterAttr,
252         &onmouseleaveAttr,
253         &onmousemoveAttr,
254         &onmouseoutAttr,
255         &onmouseoverAttr,
256         &onmouseupAttr,
257         &onmousewheelAttr,
258         &onpasteAttr,
259         &onpauseAttr,
260         &onplayAttr,
261         &onplayingAttr,
262         &onprogressAttr,
263         &onratechangeAttr,
264         &onresetAttr,
265         &onscrollAttr,
266         &onseekedAttr,
267         &onseekingAttr,
268         &onselectAttr,
269         &onselectstartAttr,
270         &onstalledAttr,
271         &onsubmitAttr,
272         &onsuspendAttr,
273         &ontimeupdateAttr,
274         &ontouchcancelAttr,
275         &ontouchendAttr,
276         &ontouchmoveAttr,
277         &ontouchstartAttr,
278         &onvolumechangeAttr,
279         &onwaitingAttr,
280         &onwheelAttr,
281 #if ENABLE(FULLSCREEN_API)
282         &onwebkitfullscreenchangeAttr,
283         &onwebkitfullscreenerrorAttr,
284 #endif
285     };
286
287     for (unsigned i = 0, size = WTF_ARRAY_LENGTH(simpleTable); i < size; ++i) {
288         // FIXME: Would be nice to check these against the actual event names in eventNames().
289         // Not obvious how to do that simply, though.
290         const AtomicString& attributeName = simpleTable[i]->localName();
291
292         // Remove the "on" prefix. Requires some memory allocation and computing a hash, but
293         // by not using pointers from eventNames(), simpleTable can be initialized at compile time.
294         AtomicString eventName = attributeName.string().substring(2);
295
296         map.add(attributeName.impl(), eventName);
297     }
298
299     struct CustomMapping {
300         const QualifiedName& attributeName;
301         const AtomicString& eventName;
302     };
303
304     const CustomMapping customTable[] = {
305         { ontransitionendAttr, eventNames().webkitTransitionEndEvent },
306         { onwebkitanimationendAttr, eventNames().webkitAnimationEndEvent },
307         { onwebkitanimationiterationAttr, eventNames().webkitAnimationIterationEvent },
308         { onwebkitanimationstartAttr, eventNames().webkitAnimationStartEvent },
309         { onwebkittransitionendAttr, eventNames().webkitTransitionEndEvent },
310     };
311
312     for (unsigned i = 0, size = WTF_ARRAY_LENGTH(customTable); i < size; ++i)
313         map.add(customTable[i].attributeName.localName().impl(), customTable[i].eventName);
314 }
315
316 void HTMLElement::parseAttribute(const QualifiedName& name, const AtomicString& value)
317 {
318     if (isIdAttributeName(name) || name == classAttr || name == styleAttr)
319         return StyledElement::parseAttribute(name, value);
320
321     if (name == dirAttr)
322         dirAttributeChanged(value);
323     else if (name == tabindexAttr) {
324         int tabindex = 0;
325         if (value.isEmpty())
326             clearTabIndexExplicitlyIfNeeded();
327         else if (parseHTMLInteger(value, tabindex)) {
328             // Clamp tabindex to the range of 'short' to match Firefox's behavior.
329             setTabIndexExplicitly(std::max(static_cast<int>(std::numeric_limits<short>::min()), std::min(tabindex, static_cast<int>(std::numeric_limits<short>::max()))));
330         }
331     } else if (name.namespaceURI().isNull()) {
332         // FIXME: Can we do this even faster by checking the local name "on" prefix before we do anything with the map?
333         static NeverDestroyed<HashMap<AtomicStringImpl*, AtomicString>> eventNamesGlobal;
334         auto& eventNames = eventNamesGlobal.get();
335         if (eventNames.isEmpty())
336             populateEventNameForAttributeLocalNameMap(eventNames);
337         const AtomicString& eventName = eventNames.get(name.localName().impl());
338         if (!eventName.isNull())
339             setAttributeEventListener(eventName, name, value);
340     }
341 }
342
343 String HTMLElement::innerHTML() const
344 {
345     return createMarkup(*this, ChildrenOnly);
346 }
347
348 String HTMLElement::outerHTML() const
349 {
350     return createMarkup(*this);
351 }
352
353 void HTMLElement::setInnerHTML(const String& html, ExceptionCode& ec)
354 {
355     if (RefPtr<DocumentFragment> fragment = createFragmentForInnerOuterHTML(html, this, AllowScriptingContent, ec)) {
356         ContainerNode* container = this;
357 #if ENABLE(TEMPLATE_ELEMENT)
358         if (hasLocalName(templateTag))
359             container = toHTMLTemplateElement(this)->content();
360 #endif
361         replaceChildrenWithFragment(*container, fragment.release(), ec);
362     }
363 }
364
365 static void mergeWithNextTextNode(Text& node, ExceptionCode& ec)
366 {
367     Node* next = node.nextSibling();
368     if (!next || !next->isTextNode())
369         return;
370
371     Ref<Text> textNode(node);
372     Ref<Text> textNext(toText(*next));
373     textNode->appendData(textNext->data(), ec);
374     if (ec)
375         return;
376     textNext->remove(ec);
377 }
378
379 void HTMLElement::setOuterHTML(const String& html, ExceptionCode& ec)
380 {
381     Element* p = parentElement();
382     if (!p || !p->isHTMLElement()) {
383         ec = NO_MODIFICATION_ALLOWED_ERR;
384         return;
385     }
386     RefPtr<HTMLElement> parent = toHTMLElement(p);
387     RefPtr<Node> prev = previousSibling();
388     RefPtr<Node> next = nextSibling();
389
390     RefPtr<DocumentFragment> fragment = createFragmentForInnerOuterHTML(html, parent.get(), AllowScriptingContent, ec);
391     if (ec)
392         return;
393       
394     parent->replaceChild(fragment.release(), this, ec);
395     RefPtr<Node> node = next ? next->previousSibling() : nullptr;
396     if (!ec && node && node->isTextNode())
397         mergeWithNextTextNode(toText(*node), ec);
398     if (!ec && prev && prev->isTextNode())
399         mergeWithNextTextNode(toText(*prev), ec);
400 }
401
402 PassRefPtr<DocumentFragment> HTMLElement::textToFragment(const String& text, ExceptionCode& ec)
403 {
404     RefPtr<DocumentFragment> fragment = DocumentFragment::create(document());
405     unsigned int i, length = text.length();
406     UChar c = 0;
407     for (unsigned int start = 0; start < length; ) {
408
409         // Find next line break.
410         for (i = start; i < length; i++) {
411             c = text[i];
412             if (c == '\r' || c == '\n')
413                 break;
414         }
415
416         fragment->appendChild(Text::create(document(), text.substring(start, i - start)), ec);
417         if (ec)
418             return nullptr;
419
420         if (c == '\r' || c == '\n') {
421             fragment->appendChild(HTMLBRElement::create(document()), ec);
422             if (ec)
423                 return nullptr;
424             // Make sure \r\n doesn't result in two line breaks.
425             if (c == '\r' && i + 1 < length && text[i + 1] == '\n')
426                 i++;
427         }
428
429         start = i + 1; // Character after line break.
430     }
431
432     return fragment;
433 }
434
435 void HTMLElement::setInnerText(const String& text, ExceptionCode& ec)
436 {
437     if (ieForbidsInsertHTML()) {
438         ec = NO_MODIFICATION_ALLOWED_ERR;
439         return;
440     }
441     if (hasLocalName(colTag) || hasLocalName(colgroupTag) || hasLocalName(framesetTag) ||
442         hasLocalName(headTag) || hasLocalName(htmlTag) || hasLocalName(tableTag) || 
443         hasLocalName(tbodyTag) || hasLocalName(tfootTag) || hasLocalName(theadTag) ||
444         hasLocalName(trTag)) {
445         ec = NO_MODIFICATION_ALLOWED_ERR;
446         return;
447     }
448
449     // FIXME: This doesn't take whitespace collapsing into account at all.
450
451     if (!text.contains('\n') && !text.contains('\r')) {
452         if (text.isEmpty()) {
453             removeChildren();
454             return;
455         }
456         replaceChildrenWithText(*this, text, ec);
457         return;
458     }
459
460     // FIXME: Do we need to be able to detect preserveNewline style even when there's no renderer?
461     // FIXME: Can the renderer be out of date here? Do we need to call updateStyleIfNeeded?
462     // For example, for the contents of textarea elements that are display:none?
463     auto r = renderer();
464     if (r && r->style().preserveNewline()) {
465         if (!text.contains('\r')) {
466             replaceChildrenWithText(*this, text, ec);
467             return;
468         }
469         String textWithConsistentLineBreaks = text;
470         textWithConsistentLineBreaks.replace("\r\n", "\n");
471         textWithConsistentLineBreaks.replace('\r', '\n');
472         replaceChildrenWithText(*this, textWithConsistentLineBreaks, ec);
473         return;
474     }
475
476     // Add text nodes and <br> elements.
477     ec = 0;
478     RefPtr<DocumentFragment> fragment = textToFragment(text, ec);
479     if (!ec)
480         replaceChildrenWithFragment(*this, fragment.release(), ec);
481 }
482
483 void HTMLElement::setOuterText(const String& text, ExceptionCode& ec)
484 {
485     if (ieForbidsInsertHTML()) {
486         ec = NO_MODIFICATION_ALLOWED_ERR;
487         return;
488     }
489     if (hasLocalName(colTag) || hasLocalName(colgroupTag) || hasLocalName(framesetTag) ||
490         hasLocalName(headTag) || hasLocalName(htmlTag) || hasLocalName(tableTag) || 
491         hasLocalName(tbodyTag) || hasLocalName(tfootTag) || hasLocalName(theadTag) ||
492         hasLocalName(trTag)) {
493         ec = NO_MODIFICATION_ALLOWED_ERR;
494         return;
495     }
496
497     RefPtr<ContainerNode> parent = parentNode();
498     if (!parent) {
499         ec = NO_MODIFICATION_ALLOWED_ERR;
500         return;
501     }
502
503     RefPtr<Node> prev = previousSibling();
504     RefPtr<Node> next = nextSibling();
505     RefPtr<Node> newChild;
506     ec = 0;
507     
508     // Convert text to fragment with <br> tags instead of linebreaks if needed.
509     if (text.contains('\r') || text.contains('\n'))
510         newChild = textToFragment(text, ec);
511     else
512         newChild = Text::create(document(), text);
513
514     if (!this || !parentNode())
515         ec = HIERARCHY_REQUEST_ERR;
516     if (ec)
517         return;
518     parent->replaceChild(newChild.release(), this, ec);
519
520     RefPtr<Node> node = next ? next->previousSibling() : nullptr;
521     if (!ec && node && node->isTextNode())
522         mergeWithNextTextNode(toText(*node), ec);
523     if (!ec && prev && prev->isTextNode())
524         mergeWithNextTextNode(toText(*prev), ec);
525 }
526
527 Node* HTMLElement::insertAdjacent(const String& where, Node* newChild, ExceptionCode& ec)
528 {
529     // In Internet Explorer if the element has no parent and where is "beforeBegin" or "afterEnd",
530     // a document fragment is created and the elements appended in the correct order. This document
531     // fragment isn't returned anywhere.
532     //
533     // This is impossible for us to implement as the DOM tree does not allow for such structures,
534     // Opera also appears to disallow such usage.
535
536     if (equalIgnoringCase(where, "beforeBegin")) {
537         ContainerNode* parent = this->parentNode();
538         return (parent && parent->insertBefore(newChild, this, ec)) ? newChild : nullptr;
539     }
540
541     if (equalIgnoringCase(where, "afterBegin"))
542         return insertBefore(newChild, firstChild(), ec) ? newChild : nullptr;
543
544     if (equalIgnoringCase(where, "beforeEnd"))
545         return appendChild(newChild, ec) ? newChild : nullptr;
546
547     if (equalIgnoringCase(where, "afterEnd")) {
548         ContainerNode* parent = this->parentNode();
549         return (parent && parent->insertBefore(newChild, nextSibling(), ec)) ? newChild : nullptr;
550     }
551     
552     // IE throws COM Exception E_INVALIDARG; this is the best DOM exception alternative.
553     ec = NOT_SUPPORTED_ERR;
554     return nullptr;
555 }
556
557 Element* HTMLElement::insertAdjacentElement(const String& where, Element* newChild, ExceptionCode& ec)
558 {
559     if (!newChild) {
560         // IE throws COM Exception E_INVALIDARG; this is the best DOM exception alternative.
561         ec = TYPE_MISMATCH_ERR;
562         return nullptr;
563     }
564
565     Node* returnValue = insertAdjacent(where, newChild, ec);
566     ASSERT_WITH_SECURITY_IMPLICATION(!returnValue || returnValue->isElementNode());
567     return toElement(returnValue); 
568 }
569
570 // Step 3 of http://www.whatwg.org/specs/web-apps/current-work/multipage/apis-in-html-documents.html#insertadjacenthtml()
571 static Element* contextElementForInsertion(const String& where, Element* element, ExceptionCode& ec)
572 {
573     if (equalIgnoringCase(where, "beforeBegin") || equalIgnoringCase(where, "afterEnd")) {
574         ContainerNode* parent = element->parentNode();
575         if (parent && !parent->isElementNode()) {
576             ec = NO_MODIFICATION_ALLOWED_ERR;
577             return nullptr;
578         }
579         ASSERT_WITH_SECURITY_IMPLICATION(!parent || parent->isElementNode());
580         return toElement(parent);
581     }
582     if (equalIgnoringCase(where, "afterBegin") || equalIgnoringCase(where, "beforeEnd"))
583         return element;
584     ec =  SYNTAX_ERR;
585     return nullptr;
586 }
587
588 void HTMLElement::insertAdjacentHTML(const String& where, const String& markup, ExceptionCode& ec)
589 {
590     Element* contextElement = contextElementForInsertion(where, this, ec);
591     if (!contextElement)
592         return;
593     RefPtr<DocumentFragment> fragment = createFragmentForInnerOuterHTML(markup, contextElement, AllowScriptingContent, ec);
594     if (!fragment)
595         return;
596     insertAdjacent(where, fragment.get(), ec);
597 }
598
599 void HTMLElement::insertAdjacentText(const String& where, const String& text, ExceptionCode& ec)
600 {
601     RefPtr<Text> textNode = document().createTextNode(text);
602     insertAdjacent(where, textNode.get(), ec);
603 }
604
605 void HTMLElement::applyAlignmentAttributeToStyle(const AtomicString& alignment, MutableStyleProperties& style)
606 {
607     // Vertical alignment with respect to the current baseline of the text
608     // right or left means floating images.
609     CSSValueID floatValue = CSSValueInvalid;
610     CSSValueID verticalAlignValue = CSSValueInvalid;
611
612     if (equalIgnoringCase(alignment, "absmiddle"))
613         verticalAlignValue = CSSValueMiddle;
614     else if (equalIgnoringCase(alignment, "absbottom"))
615         verticalAlignValue = CSSValueBottom;
616     else if (equalIgnoringCase(alignment, "left")) {
617         floatValue = CSSValueLeft;
618         verticalAlignValue = CSSValueTop;
619     } else if (equalIgnoringCase(alignment, "right")) {
620         floatValue = CSSValueRight;
621         verticalAlignValue = CSSValueTop;
622     } else if (equalIgnoringCase(alignment, "top"))
623         verticalAlignValue = CSSValueTop;
624     else if (equalIgnoringCase(alignment, "middle"))
625         verticalAlignValue = CSSValueWebkitBaselineMiddle;
626     else if (equalIgnoringCase(alignment, "center"))
627         verticalAlignValue = CSSValueMiddle;
628     else if (equalIgnoringCase(alignment, "bottom"))
629         verticalAlignValue = CSSValueBaseline;
630     else if (equalIgnoringCase(alignment, "texttop"))
631         verticalAlignValue = CSSValueTextTop;
632
633     if (floatValue != CSSValueInvalid)
634         addPropertyToPresentationAttributeStyle(style, CSSPropertyFloat, floatValue);
635
636     if (verticalAlignValue != CSSValueInvalid)
637         addPropertyToPresentationAttributeStyle(style, CSSPropertyVerticalAlign, verticalAlignValue);
638 }
639
640 bool HTMLElement::hasCustomFocusLogic() const
641 {
642     return false;
643 }
644
645 bool HTMLElement::supportsFocus() const
646 {
647     return Element::supportsFocus() || (rendererIsEditable() && parentNode() && !parentNode()->rendererIsEditable());
648 }
649
650 String HTMLElement::contentEditable() const
651 {
652     const AtomicString& value = fastGetAttribute(contenteditableAttr);
653
654     if (value.isNull())
655         return ASCIILiteral("inherit");
656     if (value.isEmpty() || equalIgnoringCase(value, "true"))
657         return ASCIILiteral("true");
658     if (equalIgnoringCase(value, "false"))
659         return ASCIILiteral("false");
660     if (equalIgnoringCase(value, "plaintext-only"))
661         return ASCIILiteral("plaintext-only");
662
663     return ASCIILiteral("inherit");
664 }
665
666 void HTMLElement::setContentEditable(const String& enabled, ExceptionCode& ec)
667 {
668     if (equalIgnoringCase(enabled, "true"))
669         setAttribute(contenteditableAttr, AtomicString("true", AtomicString::ConstructFromLiteral));
670     else if (equalIgnoringCase(enabled, "false"))
671         setAttribute(contenteditableAttr, AtomicString("false", AtomicString::ConstructFromLiteral));
672     else if (equalIgnoringCase(enabled, "plaintext-only"))
673         setAttribute(contenteditableAttr, AtomicString("plaintext-only", AtomicString::ConstructFromLiteral));
674     else if (equalIgnoringCase(enabled, "inherit"))
675         removeAttribute(contenteditableAttr);
676     else
677         ec = SYNTAX_ERR;
678 }
679
680 bool HTMLElement::draggable() const
681 {
682     return equalIgnoringCase(fastGetAttribute(draggableAttr), "true");
683 }
684
685 void HTMLElement::setDraggable(bool value)
686 {
687     setAttribute(draggableAttr, value
688         ? AtomicString("true", AtomicString::ConstructFromLiteral)
689         : AtomicString("false", AtomicString::ConstructFromLiteral));
690 }
691
692 bool HTMLElement::spellcheck() const
693 {
694     return isSpellCheckingEnabled();
695 }
696
697 void HTMLElement::setSpellcheck(bool enable)
698 {
699     setAttribute(spellcheckAttr, enable
700         ? AtomicString("true", AtomicString::ConstructFromLiteral)
701         : AtomicString("false", AtomicString::ConstructFromLiteral));
702 }
703
704 void HTMLElement::click()
705 {
706     dispatchSimulatedClick(nullptr, SendNoEvents, DoNotShowPressedLook);
707 }
708
709 void HTMLElement::accessKeyAction(bool sendMouseEvents)
710 {
711     dispatchSimulatedClick(nullptr, sendMouseEvents ? SendMouseUpDownEvents : SendNoEvents);
712 }
713
714 String HTMLElement::title() const
715 {
716     return fastGetAttribute(titleAttr);
717 }
718
719 short HTMLElement::tabIndex() const
720 {
721     if (supportsFocus())
722         return Element::tabIndex();
723     return -1;
724 }
725
726 void HTMLElement::setTabIndex(int value)
727 {
728     setIntegralAttribute(tabindexAttr, value);
729 }
730
731 TranslateAttributeMode HTMLElement::translateAttributeMode() const
732 {
733     const AtomicString& value = fastGetAttribute(translateAttr);
734
735     if (value.isNull())
736         return TranslateAttributeInherit;
737     if (equalIgnoringCase(value, "yes") || value.isEmpty())
738         return TranslateAttributeYes;
739     if (equalIgnoringCase(value, "no"))
740         return TranslateAttributeNo;
741
742     return TranslateAttributeInherit;
743 }
744
745 bool HTMLElement::translate() const
746 {
747     auto lineage = lineageOfType<HTMLElement>(*this);
748     for (auto element = lineage.begin(), end = lineage.end(); element != end; ++element) {
749         TranslateAttributeMode mode = element->translateAttributeMode();
750         if (mode == TranslateAttributeInherit)
751             continue;
752         ASSERT(mode == TranslateAttributeYes || mode == TranslateAttributeNo);
753         return mode == TranslateAttributeYes;
754     }
755
756     // Default on the root element is translate=yes.
757     return true;
758 }
759
760 void HTMLElement::setTranslate(bool enable)
761 {
762     setAttribute(translateAttr, enable ? "yes" : "no");
763 }
764
765 PassRefPtr<HTMLCollection> HTMLElement::children()
766 {
767     return ensureCachedHTMLCollection(NodeChildren);
768 }
769
770 bool HTMLElement::rendererIsNeeded(const RenderStyle& style)
771 {
772     if (hasLocalName(noscriptTag)) {
773         Frame* frame = document().frame();
774         if (frame && frame->script().canExecuteScripts(NotAboutToExecuteScript))
775             return false;
776     } else if (hasLocalName(noembedTag)) {
777         Frame* frame = document().frame();
778         if (frame && frame->loader().subframeLoader().allowPlugins(NotAboutToInstantiatePlugin))
779             return false;
780     }
781     return StyledElement::rendererIsNeeded(style);
782 }
783
784 RenderElement* HTMLElement::createRenderer(PassRef<RenderStyle> style)
785 {
786     if (hasLocalName(wbrTag))
787         return new RenderLineBreak(*this, std::move(style));
788     return RenderElement::createFor(*this, std::move(style));
789 }
790
791 HTMLFormElement* HTMLElement::virtualForm() const
792 {
793     return HTMLFormElement::findClosestFormAncestor(*this);
794 }
795
796 static inline bool elementAffectsDirectionality(const Node* node)
797 {
798     return node->isHTMLElement() && (node->hasTagName(bdiTag) || toHTMLElement(node)->hasAttribute(dirAttr));
799 }
800
801 static void setHasDirAutoFlagRecursively(Node* firstNode, bool flag, Node* lastNode = nullptr)
802 {
803     firstNode->setSelfOrAncestorHasDirAutoAttribute(flag);
804
805     Node* node = firstNode->firstChild();
806
807     while (node) {
808         if (node->selfOrAncestorHasDirAutoAttribute() == flag)
809             return;
810
811         if (elementAffectsDirectionality(node)) {
812             if (node == lastNode)
813                 return;
814             node = NodeTraversal::nextSkippingChildren(node, firstNode);
815             continue;
816         }
817         node->setSelfOrAncestorHasDirAutoAttribute(flag);
818         if (node == lastNode)
819             return;
820         node = NodeTraversal::next(node, firstNode);
821     }
822 }
823
824 void HTMLElement::childrenChanged(const ChildChange& change)
825 {
826     StyledElement::childrenChanged(change);
827     adjustDirectionalityIfNeededAfterChildrenChanged(change.previousSiblingElement, change.type);
828 }
829
830 bool HTMLElement::hasDirectionAuto() const
831 {
832     const AtomicString& direction = fastGetAttribute(dirAttr);
833     return (hasTagName(bdiTag) && direction.isNull()) || equalIgnoringCase(direction, "auto");
834 }
835
836 TextDirection HTMLElement::directionalityIfhasDirAutoAttribute(bool& isAuto) const
837 {
838     if (!(selfOrAncestorHasDirAutoAttribute() && hasDirectionAuto())) {
839         isAuto = false;
840         return LTR;
841     }
842
843     isAuto = true;
844     return directionality();
845 }
846
847 TextDirection HTMLElement::directionality(Node** strongDirectionalityTextNode) const
848 {
849     if (isHTMLTextFormControlElement(*this)) {
850         HTMLTextFormControlElement* textElement = toHTMLTextFormControlElement(const_cast<HTMLElement*>(this));
851         bool hasStrongDirectionality;
852         UCharDirection textDirection = textElement->value().defaultWritingDirection(&hasStrongDirectionality);
853         if (strongDirectionalityTextNode)
854             *strongDirectionalityTextNode = hasStrongDirectionality ? textElement : nullptr;
855         return (textDirection == U_LEFT_TO_RIGHT) ? LTR : RTL;
856     }
857
858     Node* node = firstChild();
859     while (node) {
860         // Skip bdi, script, style and text form controls.
861         if (equalIgnoringCase(node->nodeName(), "bdi") || node->hasTagName(scriptTag) || node->hasTagName(styleTag) 
862             || (node->isElementNode() && toElement(node)->isTextFormControl())) {
863             node = NodeTraversal::nextSkippingChildren(node, this);
864             continue;
865         }
866
867         // Skip elements with valid dir attribute
868         if (node->isElementNode()) {
869             AtomicString dirAttributeValue = toElement(node)->fastGetAttribute(dirAttr);
870             if (equalIgnoringCase(dirAttributeValue, "rtl") || equalIgnoringCase(dirAttributeValue, "ltr") || equalIgnoringCase(dirAttributeValue, "auto")) {
871                 node = NodeTraversal::nextSkippingChildren(node, this);
872                 continue;
873             }
874         }
875
876         if (node->isTextNode()) {
877             bool hasStrongDirectionality;
878             UCharDirection textDirection = node->textContent(true).defaultWritingDirection(&hasStrongDirectionality);
879             if (hasStrongDirectionality) {
880                 if (strongDirectionalityTextNode)
881                     *strongDirectionalityTextNode = node;
882                 return (textDirection == U_LEFT_TO_RIGHT) ? LTR : RTL;
883             }
884         }
885         node = NodeTraversal::next(node, this);
886     }
887     if (strongDirectionalityTextNode)
888         *strongDirectionalityTextNode = nullptr;
889     return LTR;
890 }
891
892 void HTMLElement::dirAttributeChanged(const AtomicString& value)
893 {
894     Element* parent = parentElement();
895
896     if (parent && parent->isHTMLElement() && parent->selfOrAncestorHasDirAutoAttribute())
897         toHTMLElement(parent)->adjustDirectionalityIfNeededAfterChildAttributeChanged(this);
898
899     if (equalIgnoringCase(value, "auto"))
900         calculateAndAdjustDirectionality();
901 }
902
903 void HTMLElement::adjustDirectionalityIfNeededAfterChildAttributeChanged(Element* child)
904 {
905     ASSERT(selfOrAncestorHasDirAutoAttribute());
906     Node* strongDirectionalityTextNode;
907     TextDirection textDirection = directionality(&strongDirectionalityTextNode);
908     setHasDirAutoFlagRecursively(child, false);
909     if (!renderer() || renderer()->style().direction() == textDirection)
910         return;
911     auto lineage = elementLineage(this);
912     for (auto elementToAdjust = lineage.begin(), end = lineage.end(); elementToAdjust != end; ++elementToAdjust) {
913         if (elementAffectsDirectionality(&*elementToAdjust)) {
914             elementToAdjust->setNeedsStyleRecalc();
915             return;
916         }
917     }
918 }
919
920 void HTMLElement::calculateAndAdjustDirectionality()
921 {
922     Node* strongDirectionalityTextNode;
923     TextDirection textDirection = directionality(&strongDirectionalityTextNode);
924     setHasDirAutoFlagRecursively(this, true, strongDirectionalityTextNode);
925     if (renderer() && renderer()->style().direction() != textDirection)
926         setNeedsStyleRecalc();
927 }
928
929 void HTMLElement::adjustDirectionalityIfNeededAfterChildrenChanged(Element* beforeChange, ChildChangeType changeType)
930 {
931     // FIXME: This function looks suspicious.
932     if (document().renderView() && (changeType == ElementRemoved || changeType == TextRemoved)) {
933         Node* node = beforeChange ? beforeChange->nextSibling() : nullptr;
934         for (; node; node = node->nextSibling()) {
935             if (elementAffectsDirectionality(node))
936                 continue;
937
938             setHasDirAutoFlagRecursively(node, false);
939         }
940     }
941
942     if (!selfOrAncestorHasDirAutoAttribute())
943         return;
944
945     Node* oldMarkedNode = nullptr;
946     if (beforeChange)
947         oldMarkedNode = changeType == ElementInserted ? ElementTraversal::nextSibling(beforeChange) : beforeChange->nextSibling();
948
949     while (oldMarkedNode && elementAffectsDirectionality(oldMarkedNode))
950         oldMarkedNode = oldMarkedNode->nextSibling();
951     if (oldMarkedNode)
952         setHasDirAutoFlagRecursively(oldMarkedNode, false);
953
954     auto lineage = lineageOfType<HTMLElement>(*this);
955     for (auto elementToAdjust = lineage.begin(), end = lineage.end(); elementToAdjust != end; ++elementToAdjust) {
956         if (elementAffectsDirectionality(&*elementToAdjust)) {
957             elementToAdjust->calculateAndAdjustDirectionality();
958             return;
959         }
960     }
961 }
962
963 bool HTMLElement::isURLAttribute(const Attribute& attribute) const
964 {
965     return StyledElement::isURLAttribute(attribute);
966 }
967
968 void HTMLElement::addHTMLLengthToStyle(MutableStyleProperties& style, CSSPropertyID propertyID, const String& value)
969 {
970     // FIXME: This function should not spin up the CSS parser, but should instead just figure out the correct
971     // length unit and make the appropriate parsed value.
972
973     if (StringImpl* string = value.impl()) {
974         unsigned parsedLength = 0;
975
976         while (parsedLength < string->length() && (*string)[parsedLength] <= ' ')
977             ++parsedLength;
978
979         for (; parsedLength < string->length(); ++parsedLength) {
980             UChar cc = (*string)[parsedLength];
981             if (cc > '9')
982                 break;
983             if (cc < '0') {
984                 if (cc == '%' || cc == '*')
985                     ++parsedLength;
986                 if (cc != '.')
987                     break;
988             }
989         }
990
991         if (parsedLength != string->length()) {
992             addPropertyToPresentationAttributeStyle(style, propertyID, string->substring(0, parsedLength));
993             return;
994         }
995     }
996
997     addPropertyToPresentationAttributeStyle(style, propertyID, value);
998 }
999
1000 static RGBA32 parseColorStringWithCrazyLegacyRules(const String& colorString)
1001 {
1002     // Per spec, only look at the first 128 digits of the string.
1003     const size_t maxColorLength = 128;
1004     // We'll pad the buffer with two extra 0s later, so reserve two more than the max.
1005     Vector<char, maxColorLength+2> digitBuffer;
1006
1007     size_t i = 0;
1008     // Skip a leading #.
1009     if (colorString[0] == '#')
1010         i = 1;
1011
1012     // Grab the first 128 characters, replacing non-hex characters with 0.
1013     // Non-BMP characters are replaced with "00" due to them appearing as two "characters" in the String.
1014     for (; i < colorString.length() && digitBuffer.size() < maxColorLength; i++) {
1015         if (!isASCIIHexDigit(colorString[i]))
1016             digitBuffer.append('0');
1017         else
1018             digitBuffer.append(colorString[i]);
1019     }
1020
1021     if (!digitBuffer.size())
1022         return Color::black;
1023
1024     // Pad the buffer out to at least the next multiple of three in size.
1025     digitBuffer.append('0');
1026     digitBuffer.append('0');
1027
1028     if (digitBuffer.size() < 6)
1029         return makeRGB(toASCIIHexValue(digitBuffer[0]), toASCIIHexValue(digitBuffer[1]), toASCIIHexValue(digitBuffer[2]));
1030
1031     // Split the digits into three components, then search the last 8 digits of each component.
1032     ASSERT(digitBuffer.size() >= 6);
1033     size_t componentLength = digitBuffer.size() / 3;
1034     size_t componentSearchWindowLength = std::min<size_t>(componentLength, 8);
1035     size_t redIndex = componentLength - componentSearchWindowLength;
1036     size_t greenIndex = componentLength * 2 - componentSearchWindowLength;
1037     size_t blueIndex = componentLength * 3 - componentSearchWindowLength;
1038     // Skip digits until one of them is non-zero, or we've only got two digits left in the component.
1039     while (digitBuffer[redIndex] == '0' && digitBuffer[greenIndex] == '0' && digitBuffer[blueIndex] == '0' && (componentLength - redIndex) > 2) {
1040         redIndex++;
1041         greenIndex++;
1042         blueIndex++;
1043     }
1044     ASSERT(redIndex + 1 < componentLength);
1045     ASSERT(greenIndex >= componentLength);
1046     ASSERT(greenIndex + 1 < componentLength * 2);
1047     ASSERT(blueIndex >= componentLength * 2);
1048     ASSERT_WITH_SECURITY_IMPLICATION(blueIndex + 1 < digitBuffer.size());
1049
1050     int redValue = toASCIIHexValue(digitBuffer[redIndex], digitBuffer[redIndex + 1]);
1051     int greenValue = toASCIIHexValue(digitBuffer[greenIndex], digitBuffer[greenIndex + 1]);
1052     int blueValue = toASCIIHexValue(digitBuffer[blueIndex], digitBuffer[blueIndex + 1]);
1053     return makeRGB(redValue, greenValue, blueValue);
1054 }
1055
1056 // Color parsing that matches HTML's "rules for parsing a legacy color value"
1057 void HTMLElement::addHTMLColorToStyle(MutableStyleProperties& style, CSSPropertyID propertyID, const String& attributeValue)
1058 {
1059     // An empty string doesn't apply a color. (One containing only whitespace does, which is why this check occurs before stripping.)
1060     if (attributeValue.isEmpty())
1061         return;
1062
1063     String colorString = attributeValue.stripWhiteSpace();
1064
1065     // "transparent" doesn't apply a color either.
1066     if (equalIgnoringCase(colorString, "transparent"))
1067         return;
1068
1069     // If the string is a named CSS color or a 3/6-digit hex color, use that.
1070     Color parsedColor(colorString);
1071     if (!parsedColor.isValid())
1072         parsedColor.setRGB(parseColorStringWithCrazyLegacyRules(colorString));
1073
1074     style.setProperty(propertyID, cssValuePool().createColorValue(parsedColor.rgb()));
1075 }
1076
1077 } // namespace WebCore
1078
1079 #ifndef NDEBUG
1080
1081 // For use in the debugger
1082 void dumpInnerHTML(WebCore::HTMLElement*);
1083
1084 void dumpInnerHTML(WebCore::HTMLElement* element)
1085 {
1086     printf("%s\n", element->innerHTML().ascii().data());
1087 }
1088
1089 #endif