2020-01-18 11:38:21 +03:00
|
|
|
/*
|
2021-02-07 13:20:15 +03:00
|
|
|
* Copyright (c) 2018-2021, Andreas Kling <kling@serenityos.org>
|
2020-01-18 11:38:21 +03:00
|
|
|
*
|
2021-04-22 11:24:48 +03:00
|
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
2020-01-18 11:38:21 +03:00
|
|
|
*/
|
|
|
|
|
2019-06-15 19:55:47 +03:00
|
|
|
#pragma once
|
|
|
|
|
2020-03-22 15:10:04 +03:00
|
|
|
#include <AK/FlyString.h>
|
2019-09-06 16:34:26 +03:00
|
|
|
#include <AK/String.h>
|
2021-05-28 22:21:44 +03:00
|
|
|
#include <LibWeb/CSS/CSSStyleDeclaration.h>
|
2021-09-24 14:49:57 +03:00
|
|
|
#include <LibWeb/CSS/StyleComputer.h>
|
2020-05-22 22:45:00 +03:00
|
|
|
#include <LibWeb/DOM/Attribute.h>
|
2021-09-29 18:25:48 +03:00
|
|
|
#include <LibWeb/DOM/ChildNode.h>
|
2021-02-19 21:13:08 +03:00
|
|
|
#include <LibWeb/DOM/ExceptionOr.h>
|
2021-10-16 23:16:57 +03:00
|
|
|
#include <LibWeb/DOM/NamedNodeMap.h>
|
2020-08-03 21:30:02 +03:00
|
|
|
#include <LibWeb/DOM/NonDocumentTypeChildNode.h>
|
2020-03-07 12:32:51 +03:00
|
|
|
#include <LibWeb/DOM/ParentNode.h>
|
2022-02-18 22:52:47 +03:00
|
|
|
#include <LibWeb/DOM/QualifiedName.h>
|
2020-08-12 15:46:53 +03:00
|
|
|
#include <LibWeb/HTML/AttributeNames.h>
|
2021-09-09 01:59:09 +03:00
|
|
|
#include <LibWeb/HTML/EventLoop/Task.h>
|
2020-12-13 19:54:40 +03:00
|
|
|
#include <LibWeb/HTML/TagNames.h>
|
2020-11-22 17:53:01 +03:00
|
|
|
#include <LibWeb/Layout/Node.h>
|
2019-10-14 19:32:02 +03:00
|
|
|
|
2020-07-26 20:37:56 +03:00
|
|
|
namespace Web::DOM {
|
2019-06-15 19:55:47 +03:00
|
|
|
|
2020-08-03 21:30:02 +03:00
|
|
|
class Element
|
|
|
|
: public ParentNode
|
2021-09-29 18:25:48 +03:00
|
|
|
, public ChildNode<Element>
|
2020-08-03 21:30:02 +03:00
|
|
|
, public NonDocumentTypeChildNode<Element> {
|
|
|
|
|
2019-06-15 19:55:47 +03:00
|
|
|
public:
|
2020-03-25 20:53:20 +03:00
|
|
|
using WrapperType = Bindings::ElementWrapper;
|
|
|
|
|
2021-02-07 13:20:15 +03:00
|
|
|
Element(Document&, QualifiedName);
|
2019-06-15 19:55:47 +03:00
|
|
|
virtual ~Element() override;
|
|
|
|
|
2021-05-05 00:25:43 +03:00
|
|
|
const String& qualified_name() const { return m_qualified_name.as_string(); }
|
2021-05-11 17:17:11 +03:00
|
|
|
const String& html_uppercased_qualified_name() const { return m_html_uppercased_qualified_name; }
|
2021-05-05 00:25:43 +03:00
|
|
|
virtual FlyString node_name() const final { return html_uppercased_qualified_name(); }
|
2020-10-10 04:48:05 +03:00
|
|
|
const FlyString& local_name() const { return m_qualified_name.local_name(); }
|
2020-07-23 19:18:13 +03:00
|
|
|
|
|
|
|
// NOTE: This is for the JS bindings
|
2021-05-11 17:17:11 +03:00
|
|
|
const String& tag_name() const { return html_uppercased_qualified_name(); }
|
2019-06-15 19:55:47 +03:00
|
|
|
|
2021-04-14 02:23:39 +03:00
|
|
|
const FlyString& prefix() const { return m_qualified_name.prefix(); }
|
2020-10-10 04:48:05 +03:00
|
|
|
const FlyString& namespace_() const { return m_qualified_name.namespace_(); }
|
|
|
|
|
|
|
|
// NOTE: This is for the JS bindings
|
|
|
|
const FlyString& namespace_uri() const { return namespace_(); }
|
|
|
|
|
2021-10-16 23:16:57 +03:00
|
|
|
bool has_attribute(const FlyString& name) const;
|
|
|
|
bool has_attributes() const { return !m_attributes->is_empty(); }
|
|
|
|
String attribute(const FlyString& name) const { return get_attribute(name); }
|
|
|
|
String get_attribute(const FlyString& name) const;
|
2021-02-19 21:13:08 +03:00
|
|
|
ExceptionOr<void> set_attribute(const FlyString& name, const String& value);
|
2022-02-05 20:21:49 +03:00
|
|
|
ExceptionOr<void> set_attribute_ns(FlyString const& namespace_, FlyString const& qualified_name, String const& value);
|
2020-08-02 17:15:15 +03:00
|
|
|
void remove_attribute(const FlyString& name);
|
2021-10-16 23:16:57 +03:00
|
|
|
size_t attribute_list_size() const { return m_attributes->length(); }
|
2021-10-17 00:00:49 +03:00
|
|
|
NonnullRefPtr<NamedNodeMap> const& attributes() const { return m_attributes; }
|
2021-12-29 16:02:21 +03:00
|
|
|
Vector<String> get_attribute_names() const;
|
2019-06-15 22:08:36 +03:00
|
|
|
|
2021-10-18 20:21:23 +03:00
|
|
|
RefPtr<DOMTokenList> const& class_list();
|
|
|
|
|
2021-09-30 03:16:36 +03:00
|
|
|
DOM::ExceptionOr<bool> matches(StringView selectors) const;
|
2022-02-15 22:41:51 +03:00
|
|
|
DOM::ExceptionOr<DOM::Element const*> closest(StringView selectors) const;
|
2021-09-30 03:16:36 +03:00
|
|
|
|
2021-09-30 03:17:23 +03:00
|
|
|
int client_top() const;
|
|
|
|
int client_left() const;
|
|
|
|
int client_width() const;
|
|
|
|
int client_height() const;
|
|
|
|
|
2019-06-15 22:08:36 +03:00
|
|
|
template<typename Callback>
|
2019-06-15 23:49:44 +03:00
|
|
|
void for_each_attribute(Callback callback) const
|
2019-06-15 22:08:36 +03:00
|
|
|
{
|
2021-10-16 23:16:57 +03:00
|
|
|
for (size_t i = 0; i < m_attributes->length(); ++i) {
|
|
|
|
auto const* attribute = m_attributes->item(i);
|
2021-10-15 16:57:07 +03:00
|
|
|
callback(attribute->name(), attribute->value());
|
2021-10-16 23:16:57 +03:00
|
|
|
}
|
2019-06-15 22:08:36 +03:00
|
|
|
}
|
|
|
|
|
2021-02-08 03:06:20 +03:00
|
|
|
bool has_class(const FlyString&, CaseSensitivity = CaseSensitivity::CaseSensitive) const;
|
2020-06-12 14:23:07 +03:00
|
|
|
const Vector<FlyString>& class_names() const { return m_classes; }
|
2019-06-27 21:40:21 +03:00
|
|
|
|
2020-07-26 21:01:35 +03:00
|
|
|
virtual void apply_presentational_hints(CSS::StyleProperties&) const { }
|
2020-03-22 15:10:04 +03:00
|
|
|
virtual void parse_attribute(const FlyString& name, const String& value);
|
2022-02-15 21:15:11 +03:00
|
|
|
virtual void did_remove_attribute(FlyString const&) { }
|
2019-10-04 22:05:52 +03:00
|
|
|
|
2019-10-14 19:32:02 +03:00
|
|
|
void recompute_style();
|
|
|
|
|
2020-11-22 17:53:01 +03:00
|
|
|
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()); }
|
2019-10-14 19:32:02 +03:00
|
|
|
|
2020-06-03 21:51:28 +03:00
|
|
|
String name() const { return attribute(HTML::AttributeNames::name); }
|
2019-10-20 10:09:15 +03:00
|
|
|
|
2022-02-05 15:17:01 +03:00
|
|
|
CSS::StyleProperties const* specified_css_values() const { return m_specified_css_values.ptr(); }
|
|
|
|
void set_specified_css_values(RefPtr<CSS::StyleProperties> style) { m_specified_css_values = move(style); }
|
2020-07-26 21:01:35 +03:00
|
|
|
NonnullRefPtr<CSS::StyleProperties> computed_style();
|
2020-01-02 16:52:34 +03:00
|
|
|
|
2021-03-13 22:11:33 +03:00
|
|
|
const CSS::CSSStyleDeclaration* inline_style() const { return m_inline_style; }
|
2020-12-07 21:56:53 +03:00
|
|
|
|
2021-03-14 00:39:55 +03:00
|
|
|
NonnullRefPtr<CSS::CSSStyleDeclaration> style_for_bindings();
|
|
|
|
|
2020-03-25 20:53:20 +03:00
|
|
|
String inner_html() const;
|
2021-09-14 00:42:57 +03:00
|
|
|
ExceptionOr<void> set_inner_html(String const&);
|
2020-03-25 20:53:20 +03:00
|
|
|
|
2020-08-14 20:40:37 +03:00
|
|
|
bool is_focused() const;
|
2021-06-19 01:42:34 +03:00
|
|
|
bool is_active() const;
|
|
|
|
|
2021-04-22 22:11:20 +03:00
|
|
|
NonnullRefPtr<HTMLCollection> get_elements_by_class_name(FlyString const&);
|
2021-02-08 01:44:01 +03:00
|
|
|
|
2021-02-10 20:21:35 +03:00
|
|
|
ShadowRoot* shadow_root() { return m_shadow_root; }
|
|
|
|
const ShadowRoot* shadow_root() const { return m_shadow_root; }
|
|
|
|
void set_shadow_root(RefPtr<ShadowRoot>);
|
|
|
|
|
2022-02-10 19:04:31 +03:00
|
|
|
void add_custom_property(String custom_property_name, CSS::StyleProperty style_property)
|
2021-05-28 22:21:44 +03:00
|
|
|
{
|
2022-02-10 19:04:31 +03:00
|
|
|
m_custom_properties.set(move(custom_property_name), move(style_property));
|
2021-05-28 22:21:44 +03:00
|
|
|
}
|
2022-02-10 19:04:31 +03:00
|
|
|
|
|
|
|
HashMap<String, CSS::StyleProperty> const& custom_properties() const { return m_custom_properties; }
|
|
|
|
HashMap<String, CSS::StyleProperty>& custom_properties() { return m_custom_properties; }
|
2021-05-28 22:21:44 +03:00
|
|
|
|
2021-09-09 01:59:09 +03:00
|
|
|
void queue_an_element_task(HTML::Task::Source, Function<void()>);
|
|
|
|
|
2021-09-14 00:42:15 +03:00
|
|
|
bool is_void_element() const;
|
|
|
|
bool serializes_as_void() const;
|
|
|
|
|
2021-09-27 01:55:13 +03:00
|
|
|
NonnullRefPtr<Geometry::DOMRect> get_bounding_client_rect() const;
|
2022-02-12 16:48:00 +03:00
|
|
|
NonnullRefPtr<Geometry::DOMRectList> get_client_rects() const;
|
2021-09-27 01:55:13 +03:00
|
|
|
|
2022-02-05 15:17:01 +03:00
|
|
|
virtual RefPtr<Layout::Node> create_layout_node(NonnullRefPtr<CSS::StyleProperties>);
|
|
|
|
|
2022-02-06 21:27:10 +03:00
|
|
|
virtual void did_receive_focus() { }
|
|
|
|
virtual void did_lose_focus() { }
|
|
|
|
|
2020-06-13 23:24:49 +03:00
|
|
|
protected:
|
2021-10-12 18:53:52 +03:00
|
|
|
virtual void children_changed() override;
|
2019-10-05 23:27:52 +03:00
|
|
|
|
2020-06-13 23:24:49 +03:00
|
|
|
private:
|
2021-05-05 00:25:43 +03:00
|
|
|
void make_html_uppercased_qualified_name();
|
|
|
|
|
2020-10-10 04:48:05 +03:00
|
|
|
QualifiedName m_qualified_name;
|
2021-05-05 00:25:43 +03:00
|
|
|
String m_html_uppercased_qualified_name;
|
2021-10-16 23:16:57 +03:00
|
|
|
NonnullRefPtr<NamedNodeMap> m_attributes;
|
2020-01-02 16:52:34 +03:00
|
|
|
|
2021-03-13 22:11:33 +03:00
|
|
|
RefPtr<CSS::CSSStyleDeclaration> m_inline_style;
|
2020-12-07 21:56:53 +03:00
|
|
|
|
2021-01-06 13:42:01 +03:00
|
|
|
RefPtr<CSS::StyleProperties> m_specified_css_values;
|
2022-02-10 19:04:31 +03:00
|
|
|
HashMap<String, CSS::StyleProperty> m_custom_properties;
|
2020-05-27 00:07:19 +03:00
|
|
|
|
2021-10-18 20:21:23 +03:00
|
|
|
RefPtr<DOMTokenList> m_class_list;
|
2020-05-27 00:07:19 +03:00
|
|
|
Vector<FlyString> m_classes;
|
2021-02-10 20:21:35 +03:00
|
|
|
|
|
|
|
RefPtr<ShadowRoot> m_shadow_root;
|
2019-06-15 19:55:47 +03:00
|
|
|
};
|
2019-10-06 21:37:39 +03:00
|
|
|
|
2021-01-07 19:31:26 +03:00
|
|
|
template<>
|
2021-01-17 11:34:01 +03:00
|
|
|
inline bool Node::fast_is<Element>() const { return is_element(); }
|
2021-01-07 19:31:26 +03:00
|
|
|
|
|
|
|
}
|