blob: 333cd66b1808d4416ff7701a2e3a81c858236f4d [file] [log] [blame]
/*
* Copyright (C) 1999 Lars Knoll (knoll@kde.org)
* (C) 1999 Antti Koivisto (koivisto@kde.org)
* Copyright (C) 2004-2007, 2009, 2014 Apple Inc. All rights reserved.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*
*/
#ifndef HTMLElement_h
#define HTMLElement_h
#include "core/CoreExport.h"
#include "core/dom/Element.h"
namespace blink {
class DocumentFragment;
class HTMLFormElement;
class HTMLMenuElement;
class ExceptionState;
enum TranslateAttributeMode {
TranslateAttributeYes,
TranslateAttributeNo,
TranslateAttributeInherit
};
class CORE_EXPORT HTMLElement : public Element {
DEFINE_WRAPPERTYPEINFO();
public:
DECLARE_ELEMENT_FACTORY_WITH_TAGNAME(HTMLElement);
bool hasTagName(const HTMLQualifiedName& name) const { return hasLocalName(name.localName()); }
String title() const final;
short tabIndex() const override;
void setInnerText(const String&, ExceptionState&);
void setOuterText(const String&, ExceptionState&);
virtual bool hasCustomFocusLogic() const;
String contentEditable() const;
void setContentEditable(const String&, ExceptionState&);
virtual bool draggable() const;
void setDraggable(bool);
bool spellcheck() const;
void setSpellcheck(bool);
bool translate() const;
void setTranslate(bool);
const AtomicString& dir();
void setDir(const AtomicString&);
void clickForBindings();
void accessKeyAction(bool sendMouseEvents) override;
bool ieForbidsInsertHTML() const;
virtual HTMLFormElement* formOwner() const { return nullptr; }
HTMLFormElement* findFormAncestor() const;
bool hasDirectionAuto() const;
TextDirection directionalityIfhasDirAutoAttribute(bool& isAuto) const;
virtual bool isHTMLUnknownElement() const { return false; }
virtual bool isPluginElement() const { return false; }
virtual bool isLabelable() const { return false; }
// http://www.whatwg.org/specs/web-apps/current-work/multipage/elements.html#interactive-content
virtual bool isInteractiveContent() const;
void defaultEventHandler(Event*) override;
static const AtomicString& eventNameForAttributeName(const QualifiedName& attrName);
bool matchesReadOnlyPseudoClass() const override;
bool matchesReadWritePseudoClass() const override;
static const AtomicString& eventParameterName();
HTMLMenuElement* assignedContextMenu() const;
HTMLMenuElement* contextMenu() const;
void setContextMenu(HTMLMenuElement*);
virtual String altText() const { return String(); }
protected:
HTMLElement(const QualifiedName& tagName, Document&, ConstructionType);
void addHTMLLengthToStyle(MutableStylePropertySet*, CSSPropertyID, const String& value);
void addHTMLColorToStyle(MutableStylePropertySet*, CSSPropertyID, const String& color);
void applyAlignmentAttributeToStyle(const AtomicString&, MutableStylePropertySet*);
void applyBorderAttributeToStyle(const AtomicString&, MutableStylePropertySet*);
void parseAttribute(const QualifiedName&, const AtomicString&) override;
bool isPresentationAttribute(const QualifiedName&) const override;
void collectStyleForPresentationAttribute(const QualifiedName&, const AtomicString&, MutableStylePropertySet*) override;
unsigned parseBorderWidthAttribute(const AtomicString&) const;
void childrenChanged(const ChildrenChange&) override;
void calculateAndAdjustDirectionality();
private:
String nodeName() const final;
bool isHTMLElement() const = delete; // This will catch anyone doing an unnecessary check.
bool isStyledElement() const = delete; // This will catch anyone doing an unnecessary check.
void mapLanguageAttributeToLocale(const AtomicString&, MutableStylePropertySet*);
PassRefPtrWillBeRawPtr<DocumentFragment> textToFragment(const String&, ExceptionState&);
bool selfOrAncestorHasDirAutoAttribute() const;
void dirAttributeChanged(const AtomicString&);
void adjustDirectionalityIfNeededAfterChildAttributeChanged(Element* child);
void adjustDirectionalityIfNeededAfterChildrenChanged(const ChildrenChange&);
TextDirection directionality(Node** strongDirectionalityTextNode= 0) const;
TranslateAttributeMode translateAttributeMode() const;
void handleKeypressEvent(KeyboardEvent*);
};
DEFINE_ELEMENT_TYPE_CASTS(HTMLElement, isHTMLElement());
template <typename T> bool isElementOfType(const HTMLElement&);
template <> inline bool isElementOfType<const HTMLElement>(const HTMLElement&) { return true; }
inline HTMLElement::HTMLElement(const QualifiedName& tagName, Document& document, ConstructionType type = CreateHTMLElement)
: Element(tagName, &document, type)
{
ASSERT(!tagName.localName().isNull());
}
inline bool Node::hasTagName(const HTMLQualifiedName& name) const
{
return isHTMLElement() && toHTMLElement(*this).hasTagName(name);
}
// Functor used to match HTMLElements with a specific HTML tag when using the ElementTraversal API.
class HasHTMLTagName {
STACK_ALLOCATED();
public:
explicit HasHTMLTagName(const HTMLQualifiedName& tagName): m_tagName(tagName) { }
bool operator() (const HTMLElement& element) const { return element.hasTagName(m_tagName); }
private:
const HTMLQualifiedName& m_tagName;
};
// This requires isHTML*Element(const Element&) and isHTML*Element(const HTMLElement&).
// When the input element is an HTMLElement, we don't need to check the namespace URI, just the local name.
#define DEFINE_HTMLELEMENT_TYPE_CASTS_WITH_FUNCTION(thisType) \
inline bool is##thisType(const thisType* element); \
inline bool is##thisType(const thisType& element); \
inline bool is##thisType(const HTMLElement* element) { return element && is##thisType(*element); } \
inline bool is##thisType(const Node& node) { return node.isHTMLElement() ? is##thisType(toHTMLElement(node)) : false; } \
inline bool is##thisType(const Node* node) { return node && is##thisType(*node); } \
inline bool is##thisType(const Element* element) { return element && is##thisType(*element); } \
template<typename T> inline bool is##thisType(const PassRefPtr<T>& node) { return is##thisType(node.get()); } \
template<typename T> inline bool is##thisType(const RefPtr<T>& node) { return is##thisType(node.get()); } \
template <> inline bool isElementOfType<const thisType>(const HTMLElement& element) { return is##thisType(element); } \
DEFINE_ELEMENT_TYPE_CASTS_WITH_FUNCTION(thisType)
} // namespace blink
#include "core/HTMLElementTypeHelpers.h"
#endif // HTMLElement_h