/* * Copyright (c) 2018-2022, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web::DOM { Element::Element(Document& document, DOM::QualifiedName qualified_name) : ParentNode(document, NodeType::ELEMENT_NODE) , m_qualified_name(move(qualified_name)) , m_attributes(NamedNodeMap::create(*this)) { make_html_uppercased_qualified_name(); } Element::~Element() = default; // https://dom.spec.whatwg.org/#dom-element-getattribute String Element::get_attribute(FlyString const& name) const { // 1. Let attr be the result of getting an attribute given qualifiedName and this. auto const* attribute = m_attributes->get_attribute(name); // 2. If attr is null, return null. if (!attribute) return {}; // 3. Return attr’s value. return attribute->value(); } // https://dom.spec.whatwg.org/#dom-element-setattribute ExceptionOr Element::set_attribute(FlyString const& name, String const& value) { // 1. If qualifiedName does not match the Name production in XML, then throw an "InvalidCharacterError" DOMException. // FIXME: Proper name validation if (name.is_empty()) return InvalidCharacterError::create("Attribute name must not be empty"); // 2. If this is in the HTML namespace and its node document is an HTML document, then set qualifiedName to qualifiedName in ASCII lowercase. // FIXME: Handle the second condition, assume it is an HTML document for now. bool insert_as_lowercase = namespace_uri() == Namespace::HTML; // 3. Let attribute be the first attribute in this’s attribute list whose qualified name is qualifiedName, and null otherwise. auto* attribute = m_attributes->get_attribute(name); // 4. If attribute is null, create an attribute whose local name is qualifiedName, value is value, and node document is this’s node document, then append this attribute to this, and then return. if (!attribute) { auto new_attribute = Attribute::create(document(), insert_as_lowercase ? name.to_lowercase() : name, value); m_attributes->append_attribute(new_attribute); attribute = new_attribute.ptr(); } // 5. Change attribute to value. else { attribute->set_value(value); } parse_attribute(attribute->local_name(), value); // FIXME: Invalidate less. document().invalidate_style(); return {}; } // https://dom.spec.whatwg.org/#validate-and-extract ExceptionOr validate_and_extract(FlyString namespace_, FlyString qualified_name) { // 1. If namespace is the empty string, then set it to null. if (namespace_.is_empty()) namespace_ = {}; // 2. Validate qualifiedName. TRY(Document::validate_qualified_name(qualified_name)); // 3. Let prefix be null. FlyString prefix = {}; // 4. Let localName be qualifiedName. auto local_name = qualified_name; // 5. If qualifiedName contains a U+003A (:), then strictly split the string on it and set prefix to the part before and localName to the part after. if (qualified_name.view().contains(':')) { auto parts = qualified_name.view().split_view(':'); prefix = parts[0]; local_name = parts[1]; } // 6. If prefix is non-null and namespace is null, then throw a "NamespaceError" DOMException. if (!prefix.is_null() && namespace_.is_null()) return NamespaceError::create("Prefix is non-null and namespace is null."); // 7. If prefix is "xml" and namespace is not the XML namespace, then throw a "NamespaceError" DOMException. if (prefix == "xml"sv && namespace_ != Namespace::XML) return NamespaceError::create("Prefix is 'xml' and namespace is not the XML namespace."); // 8. If either qualifiedName or prefix is "xmlns" and namespace is not the XMLNS namespace, then throw a "NamespaceError" DOMException. if ((qualified_name == "xmlns"sv || prefix == "xmlns"sv) && namespace_ != Namespace::XMLNS) return NamespaceError::create("Either qualifiedName or prefix is 'xmlns' and namespace is not the XMLNS namespace."); // 9. If namespace is the XMLNS namespace and neither qualifiedName nor prefix is "xmlns", then throw a "NamespaceError" DOMException. if (namespace_ == Namespace::XMLNS && !(qualified_name == "xmlns"sv || prefix == "xmlns"sv)) return NamespaceError::create("Namespace is the XMLNS namespace and neither qualifiedName nor prefix is 'xmlns'."); // 10. Return namespace, prefix, and localName. return QualifiedName { local_name, prefix, namespace_ }; } // https://dom.spec.whatwg.org/#dom-element-setattributens ExceptionOr Element::set_attribute_ns(FlyString const& namespace_, FlyString const& qualified_name, String const& value) { // 1. Let namespace, prefix, and localName be the result of passing namespace and qualifiedName to validate and extract. auto extracted_qualified_name = TRY(validate_and_extract(namespace_, qualified_name)); // FIXME: 2. Set an attribute value for this using localName, value, and also prefix and namespace. // FIXME: Don't just call through to setAttribute() here. return set_attribute(extracted_qualified_name.local_name(), value); } // https://dom.spec.whatwg.org/#dom-element-removeattribute void Element::remove_attribute(FlyString const& name) { m_attributes->remove_attribute(name); did_remove_attribute(name); // FIXME: Invalidate less. document().invalidate_style(); } // https://dom.spec.whatwg.org/#dom-element-hasattribute bool Element::has_attribute(FlyString const& name) const { return m_attributes->get_attribute(name) != nullptr; } // https://dom.spec.whatwg.org/#dom-element-toggleattribute DOM::ExceptionOr Element::toggle_attribute(FlyString const& name, Optional force) { // 1. If qualifiedName does not match the Name production in XML, then throw an "InvalidCharacterError" DOMException. // FIXME: Proper name validation if (name.is_empty()) return InvalidCharacterError::create("Attribute name must not be empty"); // 2. If this is in the HTML namespace and its node document is an HTML document, then set qualifiedName to qualifiedName in ASCII lowercase. // FIXME: Handle the second condition, assume it is an HTML document for now. bool insert_as_lowercase = namespace_uri() == Namespace::HTML; // 3. Let attribute be the first attribute in this’s attribute list whose qualified name is qualifiedName, and null otherwise. auto* attribute = m_attributes->get_attribute(name); // 4. If attribute is null, then: if (!attribute) { // 1. If force is not given or is true, create an attribute whose local name is qualifiedName, value is the empty string, and node document is this’s node document, then append this attribute to this, and then return true. if (!force.has_value() || force.value()) { auto new_attribute = Attribute::create(document(), insert_as_lowercase ? name.to_lowercase() : name, ""); m_attributes->append_attribute(new_attribute); parse_attribute(new_attribute->local_name(), ""); // FIXME: Invalidate less. document().invalidate_style(); return true; } // 2. Return false. return false; } // 5. Otherwise, if force is not given or is false, remove an attribute given qualifiedName and this, and then return false. if (!force.has_value() || !force.value()) { m_attributes->remove_attribute(name); did_remove_attribute(name); // FIXME: Invalidate less. document().invalidate_style(); } // 6. Return true. return true; } // https://dom.spec.whatwg.org/#dom-element-getattributenames Vector Element::get_attribute_names() const { // The getAttributeNames() method steps are to return the qualified names of the attributes in this’s attribute list, in order; otherwise a new list. Vector names; for (size_t i = 0; i < m_attributes->length(); ++i) { auto const* attribute = m_attributes->item(i); names.append(attribute->name()); } return names; } bool Element::has_class(FlyString const& class_name, CaseSensitivity case_sensitivity) const { return any_of(m_classes, [&](auto& it) { return case_sensitivity == CaseSensitivity::CaseSensitive ? it == class_name : it.equals_ignoring_case(class_name); }); } RefPtr Element::create_layout_node(NonnullRefPtr style) { if (local_name() == "noscript" && document().is_scripting_enabled()) return nullptr; auto display = style->display(); return create_layout_node_for_display_type(document(), display, move(style), this); } RefPtr Element::create_layout_node_for_display_type(DOM::Document& document, CSS::Display const& display, NonnullRefPtr style, Element* element) { if (display.is_table_inside()) return adopt_ref(*new Layout::TableBox(document, element, move(style))); if (display.is_list_item()) return adopt_ref(*new Layout::ListItemBox(document, element, move(style))); if (display.is_table_row()) return adopt_ref(*new Layout::TableRowBox(document, element, move(style))); if (display.is_table_cell()) return adopt_ref(*new Layout::TableCellBox(document, element, move(style))); if (display.is_table_row_group() || display.is_table_header_group() || display.is_table_footer_group()) return adopt_ref(*new Layout::TableRowGroupBox(document, element, move(style))); if (display.is_table_column() || display.is_table_column_group() || display.is_table_caption()) { // FIXME: This is just an incorrect placeholder until we improve table layout support. return adopt_ref(*new Layout::BlockContainer(document, element, move(style))); } if (display.is_inline_outside()) { if (display.is_flow_root_inside()) { auto block = adopt_ref(*new Layout::BlockContainer(document, element, move(style))); block->set_inline(true); return block; } if (display.is_flow_inside()) return adopt_ref(*new Layout::InlineNode(document, element, move(style))); dbgln_if(LIBWEB_CSS_DEBUG, "FIXME: Support display: {}", display.to_string()); return adopt_ref(*new Layout::InlineNode(document, element, move(style))); } if (display.is_flow_inside() || display.is_flow_root_inside() || display.is_flex_inside()) return adopt_ref(*new Layout::BlockContainer(document, element, move(style))); TODO(); } CSS::CSSStyleDeclaration const* Element::inline_style() const { return m_inline_style; } void Element::parse_attribute(FlyString const& name, String const& value) { if (name == HTML::AttributeNames::class_) { auto new_classes = value.split_view(is_ascii_space); m_classes.clear(); m_classes.ensure_capacity(new_classes.size()); for (auto& new_class : new_classes) { m_classes.unchecked_append(new_class); } if (m_class_list) m_class_list->associated_attribute_changed(value); } else if (name == HTML::AttributeNames::style) { // https://drafts.csswg.org/cssom/#ref-for-cssstyledeclaration-updating-flag if (m_inline_style && m_inline_style->is_updating()) return; m_inline_style = parse_css_style_attribute(CSS::Parser::ParsingContext(document()), value, *this); set_needs_style_update(true); } } void Element::did_remove_attribute(FlyString const& name) { if (name == HTML::AttributeNames::style) { if (m_inline_style) { m_inline_style = nullptr; set_needs_style_update(true); } } } enum class RequiredInvalidation { None, RepaintOnly, RebuildStackingContextTree, Relayout, }; static RequiredInvalidation compute_required_invalidation(CSS::StyleProperties const& old_style, CSS::StyleProperties const& new_style) { if (&old_style.computed_font() != &new_style.computed_font()) return RequiredInvalidation::Relayout; bool requires_repaint = false; bool requires_stacking_context_tree_rebuild = false; for (auto i = to_underlying(CSS::first_property_id); i <= to_underlying(CSS::last_property_id); ++i) { auto property_id = static_cast(i); auto const& old_value = old_style.properties()[i]; auto const& new_value = new_style.properties()[i]; if (!old_value && !new_value) continue; if (!old_value || !new_value) return RequiredInvalidation::Relayout; if (*old_value == *new_value) continue; if (CSS::property_affects_layout(property_id)) return RequiredInvalidation::Relayout; if (CSS::property_affects_stacking_context(property_id)) requires_stacking_context_tree_rebuild = true; requires_repaint = true; } if (requires_stacking_context_tree_rebuild) return RequiredInvalidation::RebuildStackingContextTree; if (requires_repaint) return RequiredInvalidation::RepaintOnly; return RequiredInvalidation::None; } Element::NeedsRelayout Element::recompute_style() { set_needs_style_update(false); VERIFY(parent()); auto new_computed_css_values = document().style_computer().compute_style(*this); auto required_invalidation = RequiredInvalidation::Relayout; if (m_computed_css_values) required_invalidation = compute_required_invalidation(*m_computed_css_values, *new_computed_css_values); if (required_invalidation == RequiredInvalidation::None) return NeedsRelayout::No; m_computed_css_values = move(new_computed_css_values); if (required_invalidation == RequiredInvalidation::RepaintOnly && layout_node()) { layout_node()->apply_style(*m_computed_css_values); layout_node()->set_needs_display(); return NeedsRelayout::No; } if (required_invalidation == RequiredInvalidation::RebuildStackingContextTree && layout_node()) { layout_node()->apply_style(*m_computed_css_values); document().invalidate_stacking_context_tree(); layout_node()->set_needs_display(); return NeedsRelayout::No; } return NeedsRelayout::Yes; } NonnullRefPtr Element::resolved_css_values() { auto element_computed_style = CSS::ResolvedCSSStyleDeclaration::create(*this); auto properties = CSS::StyleProperties::create(); for (auto i = to_underlying(CSS::first_property_id); i <= to_underlying(CSS::last_property_id); ++i) { auto property_id = (CSS::PropertyID)i; auto maybe_value = element_computed_style->property(property_id); if (!maybe_value.has_value()) continue; properties->set_property(property_id, maybe_value.release_value().value); } return properties; } RefPtr const& Element::class_list() { if (!m_class_list) m_class_list = DOMTokenList::create(*this, HTML::AttributeNames::class_); return m_class_list; } // https://dom.spec.whatwg.org/#dom-element-matches DOM::ExceptionOr Element::matches(StringView selectors) const { auto maybe_selectors = parse_selector(CSS::Parser::ParsingContext(static_cast(const_cast(*this))), selectors); if (!maybe_selectors.has_value()) return DOM::SyntaxError::create("Failed to parse selector"); auto sel = maybe_selectors.value(); for (auto& s : sel) { if (SelectorEngine::matches(s, *this)) return true; } return false; } // https://dom.spec.whatwg.org/#dom-element-closest DOM::ExceptionOr Element::closest(StringView selectors) const { auto maybe_selectors = parse_selector(CSS::Parser::ParsingContext(static_cast(const_cast(*this))), selectors); if (!maybe_selectors.has_value()) return DOM::SyntaxError::create("Failed to parse selector"); auto matches_selectors = [](CSS::SelectorList const& selector_list, Element const* element) { for (auto& selector : selector_list) { if (!SelectorEngine::matches(selector, *element)) return false; } return true; }; auto const selector_list = maybe_selectors.release_value(); for (auto* element = this; element; element = element->parent_element()) { if (!matches_selectors(selector_list, element)) continue; return element; } return nullptr; } ExceptionOr Element::set_inner_html(String const& markup) { TRY(DOMParsing::inner_html_setter(*this, markup)); set_needs_style_update(true); // NOTE: Since the DOM has changed, we have to rebuild the layout tree. document().invalidate_layout(); document().set_needs_layout(); return {}; } // https://w3c.github.io/DOM-Parsing/#dom-innerhtml-innerhtml String Element::inner_html() const { return serialize_fragment(/* FIXME: Providing true for the require well-formed flag (which may throw) */); } bool Element::is_focused() const { return document().focused_element() == this; } bool Element::is_active() const { return document().active_element() == this; } NonnullRefPtr Element::get_elements_by_class_name(FlyString const& class_name) { return HTMLCollection::create(*this, [class_name, quirks_mode = document().in_quirks_mode()](Element const& element) { return element.has_class(class_name, quirks_mode ? CaseSensitivity::CaseInsensitive : CaseSensitivity::CaseSensitive); }); } void Element::set_shadow_root(RefPtr shadow_root) { if (m_shadow_root == shadow_root) return; if (m_shadow_root) m_shadow_root->set_host(nullptr); m_shadow_root = move(shadow_root); if (m_shadow_root) m_shadow_root->set_host(this); invalidate_style(); } NonnullRefPtr Element::style_for_bindings() { if (!m_inline_style) m_inline_style = CSS::ElementInlineCSSStyleDeclaration::create(*this, {}, {}); return *m_inline_style; } // https://dom.spec.whatwg.org/#element-html-uppercased-qualified-name void Element::make_html_uppercased_qualified_name() { // This is allowed by the spec: "User agents could optimize qualified name and HTML-uppercased qualified name by storing them in internal slots." if (namespace_() == Namespace::HTML /* FIXME: and its node document is an HTML document */) m_html_uppercased_qualified_name = qualified_name().to_uppercase(); else m_html_uppercased_qualified_name = qualified_name(); } // https://html.spec.whatwg.org/multipage/webappapis.html#queue-an-element-task void Element::queue_an_element_task(HTML::Task::Source source, Function steps) { auto task = HTML::Task::create(source, &document(), [strong_this = NonnullRefPtr(*this), steps = move(steps)] { steps(); }); HTML::main_thread_event_loop().task_queue().add(move(task)); } // https://html.spec.whatwg.org/multipage/syntax.html#void-elements bool Element::is_void_element() const { return local_name().is_one_of(HTML::TagNames::area, HTML::TagNames::base, HTML::TagNames::br, HTML::TagNames::col, HTML::TagNames::embed, HTML::TagNames::hr, HTML::TagNames::img, HTML::TagNames::input, HTML::TagNames::link, HTML::TagNames::meta, HTML::TagNames::param, HTML::TagNames::source, HTML::TagNames::track, HTML::TagNames::wbr); } // https://html.spec.whatwg.org/multipage/parsing.html#serializes-as-void bool Element::serializes_as_void() const { return is_void_element() || local_name().is_one_of(HTML::TagNames::basefont, HTML::TagNames::bgsound, HTML::TagNames::frame, HTML::TagNames::keygen); } // https://drafts.csswg.org/cssom-view/#dom-element-getboundingclientrect NonnullRefPtr Element::get_bounding_client_rect() const { // // NOTE: Ensure that layout is up-to-date before looking at metrics. const_cast(document()).update_layout(); // FIXME: Support inline layout nodes as well. auto* paint_box = this->paint_box(); if (!paint_box) return Geometry::DOMRect::create(0, 0, 0, 0); VERIFY(document().browsing_context()); auto viewport_offset = document().browsing_context()->viewport_scroll_offset(); return Geometry::DOMRect::create(paint_box->absolute_rect().translated(-viewport_offset.x(), -viewport_offset.y())); } // https://drafts.csswg.org/cssom-view/#dom-element-getclientrects NonnullRefPtr Element::get_client_rects() const { NonnullRefPtrVector rects; // 1. If the element on which it was invoked does not have an associated layout box return an empty DOMRectList object and stop this algorithm. if (!layout_node() || !layout_node()->is_box()) return Geometry::DOMRectList::create(move(rects)); // FIXME: 2. If the element has an associated SVG layout box return a DOMRectList object containing a single DOMRect object that describes // the bounding box of the element as defined by the SVG specification, applying the transforms that apply to the element and its ancestors. // FIXME: 3. Return a DOMRectList object containing DOMRect objects in content order, one for each box fragment, // describing its border area (including those with a height or width of zero) with the following constraints: // - Apply the transforms that apply to the element and its ancestors. // - If the element on which the method was invoked has a computed value for the display property of table // or inline-table include both the table box and the caption box, if any, but not the anonymous container box. // - Replace each anonymous block box with its child box(es) and repeat this until no anonymous block boxes are left in the final list. auto bounding_rect = get_bounding_client_rect(); rects.append(bounding_rect); return Geometry::DOMRectList::create(move(rects)); } int Element::client_top() const { // 1. If the element has no associated CSS layout box or if the CSS layout box is inline, return zero. if (!layout_node() || !layout_node()->is_box()) return 0; // 2. Return the computed value of the border-top-width property // plus the height of any scrollbar rendered between the top padding edge and the top border edge, // ignoring any transforms that apply to the element and its ancestors. return static_cast(*layout_node()).computed_values().border_top().width; } // https://drafts.csswg.org/cssom-view/#dom-element-clientleft int Element::client_left() const { // 1. If the element has no associated CSS layout box or if the CSS layout box is inline, return zero. if (!layout_node() || !layout_node()->is_box()) return 0; // 2. Return the computed value of the border-left-width property // plus the width of any scrollbar rendered between the left padding edge and the left border edge, // ignoring any transforms that apply to the element and its ancestors. return static_cast(*layout_node()).computed_values().border_left().width; } // https://drafts.csswg.org/cssom-view/#dom-element-clientwidth int Element::client_width() const { // NOTE: Ensure that layout is up-to-date before looking at metrics. const_cast(document()).update_layout(); // 1. If the element has no associated CSS layout box or if the CSS layout box is inline, return zero. if (!paint_box()) return 0; // 2. If the element is the root element and the element’s node document is not in quirks mode, // or if the element is the HTML body element and the element’s node document is in quirks mode, // return the viewport width excluding the size of a rendered scroll bar (if any). if ((is(*this) && !document().in_quirks_mode()) || (is(*this) && document().in_quirks_mode())) { return document().browsing_context()->viewport_rect().width(); } // 3. Return the width of the padding edge excluding the width of any rendered scrollbar between the padding edge and the border edge, // ignoring any transforms that apply to the element and its ancestors. return paint_box()->absolute_padding_box_rect().width(); } // https://drafts.csswg.org/cssom-view/#dom-element-clientheight int Element::client_height() const { // NOTE: Ensure that layout is up-to-date before looking at metrics. const_cast(document()).update_layout(); // 1. If the element has no associated CSS layout box or if the CSS layout box is inline, return zero. if (!paint_box()) return 0; // 2. If the element is the root element and the element’s node document is not in quirks mode, // or if the element is the HTML body element and the element’s node document is in quirks mode, // return the viewport height excluding the size of a rendered scroll bar (if any). if ((is(*this) && !document().in_quirks_mode()) || (is(*this) && document().in_quirks_mode())) { return document().browsing_context()->viewport_rect().height(); } // 3. Return the height of the padding edge excluding the height of any rendered scrollbar between the padding edge and the border edge, // ignoring any transforms that apply to the element and its ancestors. return paint_box()->absolute_padding_box_rect().height(); } void Element::children_changed() { Node::children_changed(); set_needs_style_update(true); } void Element::set_pseudo_element_node(Badge, CSS::Selector::PseudoElement pseudo_element, RefPtr pseudo_element_node) { m_pseudo_element_nodes[to_underlying(pseudo_element)] = move(pseudo_element_node); } RefPtr Element::get_pseudo_element_node(CSS::Selector::PseudoElement pseudo_element) const { return m_pseudo_element_nodes[to_underlying(pseudo_element)]; } void Element::clear_pseudo_element_nodes(Badge) { m_pseudo_element_nodes.fill(nullptr); } void Element::serialize_pseudo_elements_as_json(JsonArraySerializer& children_array) const { for (size_t i = 0; i < m_pseudo_element_nodes.size(); ++i) { auto& pseudo_element_node = m_pseudo_element_nodes[i]; if (!pseudo_element_node) continue; auto object = MUST(children_array.add_object()); MUST(object.add("name"sv, String::formatted("::{}", CSS::pseudo_element_name(static_cast(i))))); MUST(object.add("type"sv, "pseudo-element")); MUST(object.add("parent-id"sv, id())); MUST(object.add("pseudo-element"sv, i)); MUST(object.finish()); } } }