
HTMLCollection is an awkward legacy interface from the DOM spec. It provides a live view of a DOM subtree, with some kind of filtering that determines which elements are part of the collection. We now return HTMLCollection objects from these APIs: - getElementsByClassName() - getElementsByName() - getElementsByTagName() This initial implementation does not do any kind of caching, since that is quite a tricky problem, and there will be plenty of time for tricky problems later on when the engine is more mature.
114 lines
3.9 KiB
C++
114 lines
3.9 KiB
C++
/*
|
|
* Copyright (c) 2018-2021, Andreas Kling <kling@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/FlyString.h>
|
|
#include <AK/String.h>
|
|
#include <LibWeb/DOM/Attribute.h>
|
|
#include <LibWeb/DOM/ExceptionOr.h>
|
|
#include <LibWeb/DOM/NonDocumentTypeChildNode.h>
|
|
#include <LibWeb/DOM/ParentNode.h>
|
|
#include <LibWeb/HTML/AttributeNames.h>
|
|
#include <LibWeb/HTML/TagNames.h>
|
|
#include <LibWeb/Layout/Node.h>
|
|
#include <LibWeb/QualifiedName.h>
|
|
|
|
namespace Web::DOM {
|
|
|
|
class Element
|
|
: public ParentNode
|
|
, public NonDocumentTypeChildNode<Element> {
|
|
|
|
public:
|
|
using WrapperType = Bindings::ElementWrapper;
|
|
|
|
Element(Document&, QualifiedName);
|
|
virtual ~Element() override;
|
|
|
|
virtual FlyString node_name() const final { return m_qualified_name.local_name(); }
|
|
const FlyString& local_name() const { return m_qualified_name.local_name(); }
|
|
|
|
// NOTE: This is for the JS bindings
|
|
const FlyString& tag_name() const { return local_name(); }
|
|
|
|
const FlyString& prefix() const { return m_qualified_name.prefix(); }
|
|
const FlyString& namespace_() const { return m_qualified_name.namespace_(); }
|
|
|
|
// NOTE: This is for the JS bindings
|
|
const FlyString& namespace_uri() const { return namespace_(); }
|
|
|
|
bool has_attribute(const FlyString& name) const { return !attribute(name).is_null(); }
|
|
bool has_attributes() const { return !m_attributes.is_empty(); }
|
|
String attribute(const FlyString& name) const;
|
|
String get_attribute(const FlyString& name) const { return attribute(name); }
|
|
ExceptionOr<void> set_attribute(const FlyString& name, const String& value);
|
|
void remove_attribute(const FlyString& name);
|
|
|
|
template<typename Callback>
|
|
void for_each_attribute(Callback callback) const
|
|
{
|
|
for (auto& attribute : m_attributes)
|
|
callback(attribute.name(), attribute.value());
|
|
}
|
|
|
|
bool has_class(const FlyString&, CaseSensitivity = CaseSensitivity::CaseSensitive) const;
|
|
const Vector<FlyString>& class_names() const { return m_classes; }
|
|
|
|
virtual void apply_presentational_hints(CSS::StyleProperties&) const { }
|
|
virtual void parse_attribute(const FlyString& name, const String& value);
|
|
|
|
void recompute_style();
|
|
|
|
Layout::NodeWithStyle* layout_node() { return static_cast<Layout::NodeWithStyle*>(Node::layout_node()); }
|
|
const Layout::NodeWithStyle* layout_node() const { return static_cast<const Layout::NodeWithStyle*>(Node::layout_node()); }
|
|
|
|
String name() const { return attribute(HTML::AttributeNames::name); }
|
|
|
|
const CSS::StyleProperties* specified_css_values() const { return m_specified_css_values.ptr(); }
|
|
NonnullRefPtr<CSS::StyleProperties> computed_style();
|
|
|
|
const CSS::CSSStyleDeclaration* inline_style() const { return m_inline_style; }
|
|
|
|
NonnullRefPtr<CSS::CSSStyleDeclaration> style_for_bindings();
|
|
|
|
// FIXME: innerHTML also appears on shadow roots. https://w3c.github.io/DOM-Parsing/#dom-innerhtml
|
|
String inner_html() const;
|
|
void set_inner_html(StringView);
|
|
|
|
bool is_focused() const;
|
|
virtual bool is_focusable() const { return false; }
|
|
|
|
NonnullRefPtr<HTMLCollection> get_elements_by_tag_name(FlyString const&);
|
|
NonnullRefPtr<HTMLCollection> get_elements_by_class_name(FlyString const&);
|
|
|
|
ShadowRoot* shadow_root() { return m_shadow_root; }
|
|
const ShadowRoot* shadow_root() const { return m_shadow_root; }
|
|
void set_shadow_root(RefPtr<ShadowRoot>);
|
|
|
|
protected:
|
|
RefPtr<Layout::Node> create_layout_node() override;
|
|
|
|
private:
|
|
Attribute* find_attribute(const FlyString& name);
|
|
const Attribute* find_attribute(const FlyString& name) const;
|
|
|
|
QualifiedName m_qualified_name;
|
|
Vector<Attribute> m_attributes;
|
|
|
|
RefPtr<CSS::CSSStyleDeclaration> m_inline_style;
|
|
|
|
RefPtr<CSS::StyleProperties> m_specified_css_values;
|
|
|
|
Vector<FlyString> m_classes;
|
|
|
|
RefPtr<ShadowRoot> m_shadow_root;
|
|
};
|
|
|
|
template<>
|
|
inline bool Node::fast_is<Element>() const { return is_element(); }
|
|
|
|
}
|