Replace PassRef with Ref/Ref&& across the board.
[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, 2005, 2006, 2007, 2009 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 RefPtr<HTMLElement> create(const QualifiedName& tagName, Document&);
44
45     RefPtr<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     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>&&) override;
81
82     HTMLFormElement* form() const { return virtualForm(); }
83
84     bool hasDirectionAuto() const;
85     TextDirection directionalityIfhasDirAutoAttribute(bool& isAuto) const;
86
87     virtual bool isHTMLUnknownElement() const { return false; }
88     virtual bool isTextControlInnerTextElement() const { return false; }
89
90     virtual bool willRespondToMouseMoveEvents() override;
91     virtual bool willRespondToMouseWheelEvents() override;
92     virtual bool willRespondToMouseClickEvents() override;
93
94     virtual bool isLabelable() const { return false; }
95     virtual FormNamedItem* asFormNamedItem() { return 0; }
96
97     static void populateEventNameForAttributeLocalNameMap(HashMap<AtomicStringImpl*, AtomicString>&);
98
99     bool hasTagName(const HTMLQualifiedName& name) const { return hasLocalName(name.localName()); }
100
101 protected:
102     HTMLElement(const QualifiedName& tagName, Document&, ConstructionType);
103
104     void addHTMLLengthToStyle(MutableStyleProperties&, CSSPropertyID, const String& value);
105     void addHTMLColorToStyle(MutableStyleProperties&, CSSPropertyID, const String& color);
106
107     void applyAlignmentAttributeToStyle(const AtomicString&, MutableStyleProperties&);
108     void applyBorderAttributeToStyle(const AtomicString&, MutableStyleProperties&);
109
110     virtual bool matchesReadWritePseudoClass() const override;
111     virtual void parseAttribute(const QualifiedName&, const AtomicString&) override;
112     virtual bool isPresentationAttribute(const QualifiedName&) const override;
113     virtual void collectStyleForPresentationAttribute(const QualifiedName&, const AtomicString&, MutableStyleProperties&) override;
114     unsigned parseBorderWidthAttribute(const AtomicString&) const;
115
116     virtual void childrenChanged(const ChildChange&) override;
117     void calculateAndAdjustDirectionality();
118
119 private:
120     virtual String nodeName() const override final;
121
122     void mapLanguageAttributeToLocale(const AtomicString&, MutableStyleProperties&);
123
124     virtual HTMLFormElement* virtualForm() const;
125
126     Node* insertAdjacent(const String& where, Node* newChild, ExceptionCode&);
127     RefPtr<DocumentFragment> textToFragment(const String&, ExceptionCode&);
128
129     void dirAttributeChanged(const AtomicString&);
130     void adjustDirectionalityIfNeededAfterChildAttributeChanged(Element* child);
131     void adjustDirectionalityIfNeededAfterChildrenChanged(Element* beforeChange, ChildChangeType);
132     TextDirection directionality(Node** strongDirectionalityTextNode= 0) const;
133
134     TranslateAttributeMode translateAttributeMode() const;
135 };
136
137 inline HTMLElement::HTMLElement(const QualifiedName& tagName, Document& document, ConstructionType type = CreateHTMLElement)
138     : StyledElement(tagName, document, type)
139 {
140     ASSERT(tagName.localName().impl());
141 }
142
143 inline bool Node::hasTagName(const HTMLQualifiedName& name) const
144 {
145     return is<HTMLElement>(*this) && downcast<HTMLElement>(*this).hasTagName(name);
146 }
147
148 } // namespace WebCore
149
150 SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::HTMLElement)
151     static bool isType(const WebCore::Node& node) { return node.isHTMLElement(); }
152 SPECIALIZE_TYPE_TRAITS_END()
153
154 #include "HTMLElementTypeHelpers.h"
155
156 #endif // HTMLElement_h