More event handler improvements
[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     Ref<HTMLCollection> children();
46
47     WEBCORE_EXPORT virtual String title() const override final;
48
49     virtual short tabIndex() const override;
50
51     void setInnerText(const String&, ExceptionCode&);
52     void setOuterText(const String&, ExceptionCode&);
53
54     Element* insertAdjacentElement(const String& where, Element* newChild, ExceptionCode&);
55     void insertAdjacentHTML(const String& where, const String& html, ExceptionCode&);
56     void insertAdjacentText(const String& where, const String& text, ExceptionCode&);
57
58     virtual bool hasCustomFocusLogic() const;
59     virtual bool supportsFocus() const override;
60
61     String contentEditable() const;
62     void setContentEditable(const String&, ExceptionCode&);
63
64     static Editability editabilityFromContentEditableAttr(const Node&);
65
66     virtual bool draggable() const;
67     void setDraggable(bool);
68
69     bool spellcheck() const;
70     void setSpellcheck(bool);
71
72     bool translate() const;
73     void setTranslate(bool);
74
75     void click();
76
77     virtual void accessKeyAction(bool sendMouseEvents) override;
78
79     bool ieForbidsInsertHTML() const;
80
81     virtual bool rendererIsNeeded(const RenderStyle&) override;
82     virtual RenderPtr<RenderElement> createElementRenderer(Ref<RenderStyle>&&) override;
83
84     HTMLFormElement* form() const { return virtualForm(); }
85
86     const AtomicString& dir() const;
87     void setDir(const AtomicString&);
88
89     bool hasDirectionAuto() const;
90     TextDirection directionalityIfhasDirAutoAttribute(bool& isAuto) const;
91
92     virtual bool isHTMLUnknownElement() const { return false; }
93     virtual bool isTextControlInnerTextElement() const { return false; }
94
95     virtual bool willRespondToMouseMoveEvents() override;
96     virtual bool willRespondToMouseWheelEvents() override;
97     virtual bool willRespondToMouseClickEvents() override;
98
99     virtual bool isLabelable() const { return false; }
100     virtual FormNamedItem* asFormNamedItem() { return 0; }
101
102     bool hasTagName(const HTMLQualifiedName& name) const { return hasLocalName(name.localName()); }
103
104     static const AtomicString& eventNameForEventHandlerAttribute(const QualifiedName& attributeName);
105
106 protected:
107     HTMLElement(const QualifiedName& tagName, Document&, ConstructionType);
108
109     void addHTMLLengthToStyle(MutableStyleProperties&, CSSPropertyID, const String& value);
110     void addHTMLColorToStyle(MutableStyleProperties&, CSSPropertyID, const String& color);
111
112     void applyAlignmentAttributeToStyle(const AtomicString&, MutableStyleProperties&);
113     void applyBorderAttributeToStyle(const AtomicString&, MutableStyleProperties&);
114
115     virtual bool matchesReadWritePseudoClass() const override;
116     virtual void parseAttribute(const QualifiedName&, const AtomicString&) override;
117     virtual bool isPresentationAttribute(const QualifiedName&) const override;
118     virtual void collectStyleForPresentationAttribute(const QualifiedName&, const AtomicString&, MutableStyleProperties&) override;
119     unsigned parseBorderWidthAttribute(const AtomicString&) const;
120
121     virtual void childrenChanged(const ChildChange&) override;
122     void calculateAndAdjustDirectionality();
123
124     typedef HashMap<AtomicStringImpl*, AtomicString> EventHandlerNameMap;
125     template<size_t tableSize> static void populateEventHandlerNameMap(EventHandlerNameMap&, const QualifiedName* const (&table)[tableSize]);
126     static const AtomicString& eventNameForEventHandlerAttribute(const QualifiedName& attributeName, const EventHandlerNameMap&);
127
128 private:
129     virtual String nodeName() const override final;
130
131     void mapLanguageAttributeToLocale(const AtomicString&, MutableStyleProperties&);
132
133     virtual HTMLFormElement* virtualForm() const;
134
135     Node* insertAdjacent(const String& where, Node* newChild, ExceptionCode&);
136     Ref<DocumentFragment> textToFragment(const String&, ExceptionCode&);
137
138     void dirAttributeChanged(const AtomicString&);
139     void adjustDirectionalityIfNeededAfterChildAttributeChanged(Element* child);
140     void adjustDirectionalityIfNeededAfterChildrenChanged(Element* beforeChange, ChildChangeType);
141     TextDirection directionality(Node** strongDirectionalityTextNode= 0) const;
142
143     TranslateAttributeMode translateAttributeMode() const;
144
145     static void populateEventHandlerNameMap(EventHandlerNameMap&, const QualifiedName* const table[], size_t tableSize);
146     static EventHandlerNameMap createEventHandlerNameMap();
147 };
148
149 inline HTMLElement::HTMLElement(const QualifiedName& tagName, Document& document, ConstructionType type = CreateHTMLElement)
150     : StyledElement(tagName, document, type)
151 {
152     ASSERT(tagName.localName().impl());
153 }
154
155 template<size_t tableSize> inline void HTMLElement::populateEventHandlerNameMap(EventHandlerNameMap& map, const QualifiedName* const (&table)[tableSize])
156 {
157     populateEventHandlerNameMap(map, table, tableSize);
158 }
159
160 inline bool Node::hasTagName(const HTMLQualifiedName& name) const
161 {
162     return is<HTMLElement>(*this) && downcast<HTMLElement>(*this).hasTagName(name);
163 }
164
165 } // namespace WebCore
166
167 SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::HTMLElement)
168     static bool isType(const WebCore::Node& node) { return node.isHTMLElement(); }
169 SPECIALIZE_TYPE_TRAITS_END()
170
171 #include "HTMLElementTypeHelpers.h"
172
173 #endif // HTMLElement_h