30e3775a004e31beae835cf690cb409b1dfeb77a
[WebKit-https.git] / Source / WebCore / html / HTMLElement.h
1 /*
2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
3  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
4  * Copyright (C) 2004-2009, 2015 Apple Inc. All rights reserved.
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Library General Public
8  * License as published by the Free Software Foundation; either
9  * version 2 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Library General Public License for more details.
15  *
16  * You should have received a copy of the GNU Library General Public License
17  * along with this library; see the file COPYING.LIB.  If not, write to
18  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
19  * Boston, MA 02110-1301, USA.
20  *
21  */
22
23 #ifndef HTMLElement_h
24 #define HTMLElement_h
25
26 #include "StyledElement.h"
27
28 namespace WebCore {
29
30 class DocumentFragment;
31 class FormNamedItem;
32 class HTMLCollection;
33 class HTMLFormElement;
34
35 enum TranslateAttributeMode {
36     TranslateAttributeYes,
37     TranslateAttributeNo,
38     TranslateAttributeInherit
39 };
40
41 class HTMLElement : public StyledElement {
42 public:
43     static Ref<HTMLElement> create(const QualifiedName& tagName, Document&);
44
45     WEBCORE_EXPORT virtual String title() const override final;
46
47     virtual short tabIndex() const override;
48
49     void setInnerText(const String&, ExceptionCode&);
50     void setOuterText(const String&, ExceptionCode&);
51
52     Element* insertAdjacentElement(const String& where, Element* newChild, ExceptionCode&);
53     void insertAdjacentHTML(const String& where, const String& html, ExceptionCode&);
54     void insertAdjacentText(const String& where, const String& text, ExceptionCode&);
55
56     virtual bool hasCustomFocusLogic() const;
57     virtual bool supportsFocus() const override;
58
59     String contentEditable() const;
60     void setContentEditable(const String&, ExceptionCode&);
61
62     static Editability editabilityFromContentEditableAttr(const Node&);
63
64     virtual bool draggable() const;
65     void setDraggable(bool);
66
67     bool spellcheck() const;
68     void setSpellcheck(bool);
69
70     bool translate() const;
71     void setTranslate(bool);
72
73     void click();
74
75     virtual void accessKeyAction(bool sendMouseEvents) override;
76
77     bool ieForbidsInsertHTML() const;
78
79     virtual bool rendererIsNeeded(const RenderStyle&) override;
80     virtual RenderPtr<RenderElement> createElementRenderer(Ref<RenderStyle>&&, const RenderTreePosition&) override;
81
82     HTMLFormElement* form() const { return virtualForm(); }
83
84     const AtomicString& dir() const;
85     void setDir(const AtomicString&);
86
87     bool hasDirectionAuto() const;
88     TextDirection directionalityIfhasDirAutoAttribute(bool& isAuto) const;
89
90     virtual bool isHTMLUnknownElement() const { return false; }
91     virtual bool isTextControlInnerTextElement() const { return false; }
92
93     virtual bool willRespondToMouseMoveEvents() override;
94     virtual bool willRespondToMouseWheelEvents() override;
95     virtual bool willRespondToMouseClickEvents() override;
96
97     virtual bool isLabelable() const { return false; }
98     virtual FormNamedItem* asFormNamedItem() { return 0; }
99
100     bool hasTagName(const HTMLQualifiedName& name) const { return hasLocalName(name.localName()); }
101
102     static const AtomicString& eventNameForEventHandlerAttribute(const QualifiedName& attributeName);
103
104 protected:
105     HTMLElement(const QualifiedName& tagName, Document&, ConstructionType);
106
107     void addHTMLLengthToStyle(MutableStyleProperties&, CSSPropertyID, const String& value);
108     void addHTMLColorToStyle(MutableStyleProperties&, CSSPropertyID, const String& color);
109
110     void applyAlignmentAttributeToStyle(const AtomicString&, MutableStyleProperties&);
111     void applyBorderAttributeToStyle(const AtomicString&, MutableStyleProperties&);
112
113     virtual bool matchesReadWritePseudoClass() const override;
114     virtual void parseAttribute(const QualifiedName&, const AtomicString&) override;
115     virtual bool isPresentationAttribute(const QualifiedName&) const override;
116     virtual void collectStyleForPresentationAttribute(const QualifiedName&, const AtomicString&, MutableStyleProperties&) override;
117     unsigned parseBorderWidthAttribute(const AtomicString&) const;
118
119     virtual void childrenChanged(const ChildChange&) override;
120     void calculateAndAdjustDirectionality();
121
122     typedef HashMap<AtomicStringImpl*, AtomicString> EventHandlerNameMap;
123     template<size_t tableSize> static void populateEventHandlerNameMap(EventHandlerNameMap&, const QualifiedName* const (&table)[tableSize]);
124     static const AtomicString& eventNameForEventHandlerAttribute(const QualifiedName& attributeName, const EventHandlerNameMap&);
125
126 private:
127     virtual String nodeName() const override final;
128
129     void mapLanguageAttributeToLocale(const AtomicString&, MutableStyleProperties&);
130
131     virtual HTMLFormElement* virtualForm() const;
132
133     Node* insertAdjacent(const String& where, Node* newChild, ExceptionCode&);
134     Ref<DocumentFragment> textToFragment(const String&, ExceptionCode&);
135
136     void dirAttributeChanged(const AtomicString&);
137     void adjustDirectionalityIfNeededAfterChildAttributeChanged(Element* child);
138     void adjustDirectionalityIfNeededAfterChildrenChanged(Element* beforeChange, ChildChangeType);
139     TextDirection directionality(Node** strongDirectionalityTextNode= 0) const;
140
141     TranslateAttributeMode translateAttributeMode() const;
142
143     static void populateEventHandlerNameMap(EventHandlerNameMap&, const QualifiedName* const table[], size_t tableSize);
144     static EventHandlerNameMap createEventHandlerNameMap();
145 };
146
147 inline HTMLElement::HTMLElement(const QualifiedName& tagName, Document& document, ConstructionType type = CreateHTMLElement)
148     : StyledElement(tagName, document, type)
149 {
150     ASSERT(tagName.localName().impl());
151 }
152
153 template<size_t tableSize> inline void HTMLElement::populateEventHandlerNameMap(EventHandlerNameMap& map, const QualifiedName* const (&table)[tableSize])
154 {
155     populateEventHandlerNameMap(map, table, tableSize);
156 }
157
158 inline bool Node::hasTagName(const HTMLQualifiedName& name) const
159 {
160     return is<HTMLElement>(*this) && downcast<HTMLElement>(*this).hasTagName(name);
161 }
162
163 } // namespace WebCore
164
165 SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::HTMLElement)
166     static bool isType(const WebCore::Node& node) { return node.isHTMLElement(); }
167 SPECIALIZE_TYPE_TRAITS_END()
168
169 #include "HTMLElementTypeHelpers.h"
170
171 #endif // HTMLElement_h