/* * Copyright (c) 2024-2025, Jelle Raaijmakers * * 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 namespace Web::Editing { // https://w3c.github.io/editing/docs/execCommand/#the-backcolor-command bool command_back_color_action(DOM::Document& document, String const& value) { // 1. If value is not a valid CSS color, prepend "#" to it. auto resulting_value = value; if (!Color::from_string(resulting_value).has_value()) { resulting_value = MUST(String::formatted("#{}", resulting_value)); // 2. If value is still not a valid CSS color, or if it is currentColor, return false. if (!Color::from_string(resulting_value).has_value()) { // FIXME: Also return false in case of currentColor. return false; } } // 3. Set the selection's value to value. set_the_selections_value(document, CommandNames::backColor, resulting_value); // 4. Return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-bold-command bool command_bold_action(DOM::Document& document, String const&) { // If queryCommandState("bold") returns true, set the selection's value to "normal". if (document.query_command_state(CommandNames::bold)) { set_the_selections_value(document, CommandNames::bold, "normal"_string); } // Otherwise set the selection's value to "bold". else { set_the_selections_value(document, CommandNames::bold, "bold"_string); } // Either way, return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-createlink-command bool command_create_link_action(DOM::Document& document, String const& value) { // 1. If value is the empty string, return false. if (value.is_empty()) return false; // 2. For each editable a element that has an href attribute and is an ancestor of some node effectively contained // in the active range, set that a element's href attribute to value. HashTable visited_ancestors; auto set_value_for_ancestor_anchors = [&](GC::Ref node) { node->for_each_ancestor([&](GC::Ref ancestor) { if (visited_ancestors.contains(ancestor.ptr())) return IterationDecision::Break; if (is(*ancestor) && ancestor->is_editable() && static_cast(*ancestor).has_attribute(HTML::AttributeNames::href)) MUST(static_cast(*ancestor).set_href(value)); visited_ancestors.set(ancestor.ptr()); return IterationDecision::Continue; }); }; for_each_node_effectively_contained_in_range(active_range(document), [&](GC::Ref descendant) { set_value_for_ancestor_anchors(descendant); return TraversalDecision::Continue; }); // 3. Set the selection's value to value. set_the_selections_value(document, CommandNames::createLink, value); // 4. Return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-defaultparagraphseparator-command bool command_default_paragraph_separator_action(DOM::Document& document, String const& input_value) { // Let value be converted to ASCII lowercase. auto value = input_value.to_ascii_lowercase(); // If value is then equal to "p" or "div", set the context object's default single-line // container name to value, then return true. if (value == HTML::TagNames::p) { document.set_default_single_line_container_name(HTML::TagNames::p); return true; } if (value == HTML::TagNames::div) { document.set_default_single_line_container_name(HTML::TagNames::div); return true; } // Otherwise, return false. return false; } // https://w3c.github.io/editing/docs/execCommand/#the-defaultparagraphseparator-command String command_default_paragraph_separator_value(DOM::Document const& document) { // Return the context object's default single-line container name. return document.default_single_line_container_name().to_string(); } // https://w3c.github.io/editing/docs/execCommand/#the-delete-command bool command_delete_action(DOM::Document& document, String const&) { // 1. If the active range is not collapsed, delete the selection and return true. auto& selection = *document.get_selection(); auto& active_range = *selection.range(); if (!active_range.collapsed()) { delete_the_selection(selection); return true; } // 2. Canonicalize whitespace at the active range's start. canonicalize_whitespace(active_range.start()); // 3. Let node and offset be the active range's start node and offset. GC::Ptr node = active_range.start_container(); int offset = active_range.start_offset(); // 4. Repeat the following steps: GC::Ptr offset_minus_one_child; while (true) { offset_minus_one_child = node->child_at_index(offset - 1); // 1. If offset is zero and node's previousSibling is an editable invisible node, remove // node's previousSibling from its parent. if (auto* previous_sibling = node->previous_sibling()) { if (offset == 0 && previous_sibling->is_editable() && is_invisible_node(*previous_sibling)) { previous_sibling->remove(); continue; } } // 2. Otherwise, if node has a child with index offset − 1 and that child is an editable // invisible node, remove that child from node, then subtract one from offset. if (offset_minus_one_child && offset_minus_one_child->is_editable() && is_invisible_node(*offset_minus_one_child)) { offset_minus_one_child->remove(); --offset; continue; } // 3. Otherwise, if offset is zero and node is an inline node, or if node is an invisible // node, set offset to the index of node, then set node to its parent. if ((offset == 0 && is_inline_node(*node)) || is_invisible_node(*node)) { offset = node->index(); node = *node->parent(); continue; } // 4. Otherwise, if node has a child with index offset − 1 and that child is an editable a, // remove that child from node, preserving its descendants. Then return true. if (is(offset_minus_one_child.ptr()) && offset_minus_one_child->is_editable()) { remove_node_preserving_its_descendants(*offset_minus_one_child); return true; } // 5. Otherwise, if node has a child with index offset − 1 and that child is not a block // node or a br or an img, set node to that child, then set offset to the length of node. if (offset_minus_one_child && !is_block_node(*offset_minus_one_child) && !is(*offset_minus_one_child) && !is(*offset_minus_one_child)) { node = *offset_minus_one_child; offset = node->length(); continue; } // 6. Otherwise, break from this loop. break; } // 5. If node is a Text node and offset is not zero, or if node is a block node that has a child // with index offset − 1 and that child is a br or hr or img: bool block_node_child_is_relevant_type = false; if (is_block_node(*node)) { if (auto* child_node = node->child_at_index(offset - 1)) { auto& child_element = static_cast(*child_node); block_node_child_is_relevant_type = child_element.local_name().is_one_of(HTML::TagNames::br, HTML::TagNames::hr, HTML::TagNames::img); } } if ((is(*node) && offset != 0) || block_node_child_is_relevant_type) { // 1. Call collapse(node, offset) on the context object's selection. MUST(selection.collapse(node, offset)); // 2. Call extend(node, offset − 1) on the context object's selection. MUST(selection.extend(*node, offset - 1)); // 3. Delete the selection. delete_the_selection(selection); // 4. Return true. return true; } // 6. If node is an inline node, return true. if (is_inline_node(*node)) return true; // 7. If node is an li or dt or dd and is the first child of its parent, and offset is zero: auto& node_element = static_cast(*node); if (offset == 0 && node->index() == 0 && node_element.local_name().is_one_of(HTML::TagNames::li, HTML::TagNames::dt, HTML::TagNames::dd)) { // 1. Let items be a list of all lis that are ancestors of node. Vector> items; node->for_each_ancestor([&items](GC::Ref ancestor) { if (is(*ancestor)) items.append(ancestor); return IterationDecision::Continue; }); // 2. Normalize sublists of each item in items. for (auto item : items) normalize_sublists_in_node(item); // 3. Record the values of the one-node list consisting of node, and let values be the // result. auto values = record_the_values_of_nodes({ *node }); // 4. Split the parent of the one-node list consisting of node. split_the_parent_of_nodes({ *node }); // 5. Restore the values from values. restore_the_values_of_nodes(values); // 6. If node is a dd or dt, and it is not an allowed child of any of its ancestors in the // same editing host, set the tag name of node to the default single-line container name // and let node be the result. if (node_element.local_name().is_one_of(HTML::TagNames::dd, HTML::TagNames::dt)) { bool allowed_child_of_any_ancestor = false; node->for_each_ancestor([&](GC::Ref ancestor) { if (is_in_same_editing_host(*node, ancestor) && is_allowed_child_of_node(GC::Ref { *node }, ancestor)) { allowed_child_of_any_ancestor = true; return IterationDecision::Break; } return IterationDecision::Continue; }); if (!allowed_child_of_any_ancestor) node = set_the_tag_name(node_element, document.default_single_line_container_name()); } // 7. Fix disallowed ancestors of node. fix_disallowed_ancestors_of_node(*node); // 8. Return true. return true; } // 8. Let start node equal node and let start offset equal offset. auto start_node = node; auto start_offset = offset; // 9. Repeat the following steps: while (true) { // AD-HOC: If start node is not a Node, return false. This prevents a crash by dereferencing a null pointer in // step 1 below. Edits outside of might be prohibited: https://github.com/w3c/editing/issues/405 if (!start_node) return false; // 1. If start offset is zero, set start offset to the index of start node and then set // start node to its parent. if (start_offset == 0) { start_offset = start_node->index(); start_node = start_node->parent(); continue; } // 2. Otherwise, if start node has an editable invisible child with index start offset minus // one, remove it from start node and subtract one from start offset. offset_minus_one_child = start_node->child_at_index(start_offset - 1); if (offset_minus_one_child && offset_minus_one_child->is_editable() && is_invisible_node(*offset_minus_one_child)) { offset_minus_one_child->remove(); --start_offset; continue; } // 3. Otherwise, break from this loop. break; } // 10. If offset is zero, and node has an editable inclusive ancestor in the same editing host // that's an indentation element: if (offset == 0) { bool has_matching_inclusive_ancestor = false; node->for_each_inclusive_ancestor([&](GC::Ref ancestor) { if (ancestor->is_editable() && is_in_same_editing_host(ancestor, *node) && is_indentation_element(ancestor)) { has_matching_inclusive_ancestor = true; return IterationDecision::Break; } return IterationDecision::Continue; }); if (has_matching_inclusive_ancestor) { // 1. Block-extend the range whose start and end are both (node, 0), and let new range be // the result. auto new_range = block_extend_a_range(DOM::Range::create(*node, 0, *node, 0)); // 2. Let node list be a list of nodes, initially empty. Vector> node_list; // 3. For each node current node contained in new range, append current node to node list if // the last member of node list (if any) is not an ancestor of current node, and current // node is editable but has no editable descendants. new_range->for_each_contained([&node_list](GC::Ref current_node) { if (!node_list.is_empty() && node_list.last()->is_ancestor_of(current_node)) return IterationDecision::Continue; if (!current_node->is_editable()) return IterationDecision::Continue; bool has_editable_descendant = false; current_node->for_each_in_subtree([&](DOM::Node const& descendant) { if (descendant.is_editable()) { has_editable_descendant = true; return TraversalDecision::Break; } return TraversalDecision::Continue; }); if (!has_editable_descendant) node_list.append(current_node); return IterationDecision::Continue; }); // 4. Outdent each node in node list. for (auto current_node : node_list) outdent(current_node); // 5. Return true. return true; } } // 11. If the child of start node with index start offset is a table, return true. if (is(start_node->child_at_index(start_offset))) return true; // 12. If start node has a child with index start offset − 1, and that child is a table: offset_minus_one_child = start_node->child_at_index(start_offset - 1); if (is(offset_minus_one_child.ptr())) { // 1. Call collapse(start node, start offset − 1) on the context object's selection. MUST(selection.collapse(start_node, start_offset - 1)); // 2. Call extend(start node, start offset) on the context object's selection. MUST(selection.extend(*start_node, start_offset)); // 3. Return true. return true; } // 13. If offset is zero; and either the child of start node with index start offset minus one // is an hr, or the child is a br whose previousSibling is either a br or not an inline // node: if (offset == 0 && is(offset_minus_one_child.ptr())) { auto& child_element = static_cast(*offset_minus_one_child); auto* previous_sibling = child_element.previous_sibling(); if (is(child_element) || (is(child_element) && previous_sibling && (is(*previous_sibling) || !is_inline_node(*previous_sibling)))) { // 1. Call collapse(start node, start offset − 1) on the context object's selection. MUST(selection.collapse(start_node, start_offset - 1)); // 2. Call extend(start node, start offset) on the context object's selection. MUST(selection.extend(*start_node, start_offset)); // 3. Delete the selection. delete_the_selection(selection); // 4. Call collapse(node, offset) on the selection. MUST(selection.collapse(node, offset)); // 5. Return true. return true; } } // 14. If the child of start node with index start offset is an li or dt or dd, and that child's // firstChild is an inline node, and start offset is not zero: // NOTE: step 9 above guarantees start_offset cannot be 0 here. auto is_li_dt_or_dd = [](DOM::Element const& node) { return node.local_name().is_one_of(HTML::TagNames::li, HTML::TagNames::dt, HTML::TagNames::dd); }; auto* start_offset_child = start_node->child_at_index(start_offset); if (is(start_offset_child) && is_li_dt_or_dd(static_cast(*start_offset_child)) && start_offset_child->has_children() && is_inline_node(*start_offset_child->first_child())) { // 1. Let previous item be the child of start node with index start offset minus one. GC::Ref previous_item = *start_node->child_at_index(start_offset - 1); // 2. If previous item's lastChild is an inline node other than a br, call // createElement("br") on the context object and append the result as the last child of // previous item. GC::Ptr previous_item_last_child = previous_item->last_child(); if (previous_item_last_child && is_inline_node(*previous_item_last_child) && !is(*previous_item_last_child)) { auto br_element = MUST(DOM::create_element(previous_item->document(), HTML::TagNames::br, Namespace::HTML)); MUST(previous_item->append_child(br_element)); } // 3. If previous item's lastChild is an inline node, call createElement("br") on the // context object and append the result as the last child of previous item. if (previous_item_last_child && is_inline_node(*previous_item_last_child)) { auto br_element = MUST(DOM::create_element(previous_item->document(), HTML::TagNames::br, Namespace::HTML)); MUST(previous_item->append_child(br_element)); } } // 15. If start node's child with index start offset is an li or dt or dd, and that child's // previousSibling is also an li or dt or dd: if (is(start_offset_child) && is_li_dt_or_dd(static_cast(*start_offset_child)) && is(start_offset_child->previous_sibling()) && is_li_dt_or_dd(static_cast(*start_offset_child->previous_sibling()))) { // 1. Call cloneRange() on the active range, and let original range be the result. auto original_range = active_range.clone_range(); // 2. Set start node to its child with index start offset − 1. start_node = start_node->child_at_index(start_offset - 1); // 3. Set start offset to start node's length. start_offset = start_node->length(); // 4. Set node to start node's nextSibling. node = start_node->next_sibling(); // 5. Call collapse(start node, start offset) on the context object's selection. MUST(selection.collapse(start_node, start_offset)); // 6. Call extend(node, 0) on the context object's selection. MUST(selection.extend(*node, 0)); // 7. Delete the selection. delete_the_selection(selection); // 8. Call removeAllRanges() on the context object's selection. selection.remove_all_ranges(); // 9. Call addRange(original range) on the context object's selection. selection.add_range(original_range); // 10. Return true. return true; } // 16. While start node has a child with index start offset minus one: while (start_node->child_at_index(start_offset - 1) != nullptr) { // 1. If start node's child with index start offset minus one is editable and invisible, // remove it from start node, then subtract one from start offset. offset_minus_one_child = start_node->child_at_index(start_offset - 1); if (offset_minus_one_child->is_editable() && is_invisible_node(*offset_minus_one_child)) { offset_minus_one_child->remove(); --start_offset; } // 2. Otherwise, set start node to its child with index start offset minus one, then set // start offset to the length of start node. else { start_node = *offset_minus_one_child; start_offset = start_node->length(); } } // 17. Call collapse(start node, start offset) on the context object's selection. MUST(selection.collapse(start_node, start_offset)); // 18. Call extend(node, offset) on the context object's selection. MUST(selection.extend(*node, offset)); // 19. Delete the selection, with direction "backward". delete_the_selection(selection, true, true, Selection::Direction::Backwards); // 20. Return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-fontname-command bool command_font_name_action(DOM::Document& document, String const& value) { // Set the selection's value to value, then return true. set_the_selections_value(document, CommandNames::fontName, value); return true; } enum class FontSizeMode : u8 { Absolute, RelativePlus, RelativeMinus, }; // https://w3c.github.io/editing/docs/execCommand/#the-fontsize-command bool command_font_size_action(DOM::Document& document, String const& value) { // 1. Strip leading and trailing whitespace from value. auto resulting_value = MUST(value.trim_ascii_whitespace()); // 2. If value is not a valid floating point number, and would not be a valid floating point number if a single // leading "+" character were stripped, return false. if (!HTML::is_valid_floating_point_number(resulting_value)) { if (!resulting_value.starts_with_bytes("+"sv) || !HTML::is_valid_floating_point_number(MUST(resulting_value.substring_from_byte_offset(1)))) return false; } // 3. If the first character of value is "+", delete the character and let mode be "relative-plus". auto mode = FontSizeMode::Absolute; if (resulting_value.starts_with_bytes("+"sv)) { resulting_value = MUST(resulting_value.substring_from_byte_offset(1)); mode = FontSizeMode::RelativePlus; } // 4. Otherwise, if the first character of value is "-", delete the character and let mode be "relative-minus". else if (resulting_value.starts_with_bytes("-"sv)) { resulting_value = MUST(resulting_value.substring_from_byte_offset(1)); mode = FontSizeMode::RelativeMinus; } // 5. Otherwise, let mode be "absolute". // NOTE: This is the default set in step 3. // 6. Apply the rules for parsing non-negative integers to value, and let number be the result. i64 number = HTML::parse_non_negative_integer(resulting_value).release_value(); // 7. If mode is "relative-plus", add three to number. if (mode == FontSizeMode::RelativePlus) number += 3; // 8. If mode is "relative-minus", negate number, then add three to it. if (mode == FontSizeMode::RelativeMinus) number = -number + 3; // 9. If number is less than one, let number equal 1. number = AK::max(number, 1); // 10. If number is greater than seven, let number equal 7. number = AK::min(number, 7); // 11. Set value to the string here corresponding to number: // 1: x-small // 2: small // 3: medium // 4: large // 5: x-large // 6: xx-large // 7: xxx-large auto const& font_sizes = named_font_sizes(); resulting_value = MUST(String::from_utf8(font_sizes[number - 1])); // 12. Set the selection's value to value. set_the_selections_value(document, CommandNames::fontSize, resulting_value); // 13. Return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-fontsize-command String command_font_size_value(DOM::Document const& document) { // 1. If the active range is null, return the empty string. auto range = active_range(document); if (!range) return {}; // 2. Let pixel size be the effective command value of the first formattable node that is effectively contained in // the active range, or if there is no such node, the effective command value of the active range's start node, // in either case interpreted as a number of pixels. auto first_formattable_node = first_formattable_node_effectively_contained(range); auto value = effective_command_value( first_formattable_node ? first_formattable_node : *range->start_container(), CommandNames::fontSize); auto pixel_size = font_size_to_pixel_size(value.value_or({})); // 3. Return the legacy font size for pixel size. return legacy_font_size(pixel_size.to_int()); } // https://w3c.github.io/editing/docs/execCommand/#the-forwarddelete-command bool command_forward_delete_action(DOM::Document& document, String const&) { // 1. If the active range is not collapsed, delete the selection and return true. auto& selection = *document.get_selection(); auto& active_range = *selection.range(); if (!active_range.collapsed()) { delete_the_selection(selection); return true; } // 2. Canonicalize whitespace at the active range's start. canonicalize_whitespace(active_range.start()); // 3. Let node and offset be the active range's start node and offset. auto node = active_range.start().node; auto offset = active_range.start().offset; // 4. Repeat the following steps: while (true) { // 1. If offset is the length of node and node's nextSibling is an editable invisible node, remove node's // nextSibling from its parent. if (offset == node->length() && node->next_sibling() && node->next_sibling()->is_editable() && is_invisible_node(*node->next_sibling())) { node->next_sibling()->remove(); continue; } // 2. Otherwise, if node has a child with index offset and that child is an editable invisible node, remove that // child from node. auto* child_at_offset = node->child_at_index(offset); if (child_at_offset && child_at_offset->is_editable() && is_invisible_node(*child_at_offset)) { child_at_offset->remove(); continue; } // 3. Otherwise, if offset is the length of node and node is an inline node, or if node is invisible, set offset // to one plus the index of node, then set node to its parent. if (node->parent() && ((offset == node->length() && is_inline_node(node)) || is_invisible_node(node))) { offset = node->index() + 1; node = *node->parent(); continue; } // 4. Otherwise, if node has a child with index offset and that child is neither a block node nor a br nor an // img nor a collapsed block prop, set node to that child, then set offset to zero. if (child_at_offset && !is_block_node(*child_at_offset) && !is(*child_at_offset) && !is(*child_at_offset) && !is_collapsed_block_prop(*child_at_offset)) { node = *child_at_offset; offset = 0; continue; } // 5. Otherwise, break from this loop. break; } // 5. If node is a Text node and offset is not node's length: if (is(*node) && offset != node->length()) { // 1. Let end offset be offset plus one. auto end_offset = offset + 1; // FIXME: 2. While end offset is not node's length and the end offsetth code unit of node's data has general category M // when interpreted as a Unicode code point, add one to end offset. // 3. Call collapse(node, offset) on the context object's selection. MUST(selection.collapse(node, offset)); // 4. Call extend(node, end offset) on the context object's selection. MUST(selection.extend(node, end_offset)); // 5. Delete the selection. delete_the_selection(selection); // 6. Return true. return true; } // 6. If node is an inline node, return true. if (is_inline_node(node)) return true; // 7. If node has a child with index offset and that child is a br or hr or img, but is not a collapsed block prop: if (auto child_at_offset = node->child_at_index(offset); (is(child_at_offset) || is(child_at_offset) || is(child_at_offset)) && !is_collapsed_block_prop(*child_at_offset)) { // 1. Call collapse(node, offset) on the context object's selection. MUST(selection.collapse(node, offset)); // 2. Call extend(node, offset + 1) on the context object's selection. MUST(selection.extend(node, offset + 1)); // 3. Delete the selection. delete_the_selection(selection); // 4. Return true. return true; } // 8. Let end node equal node and let end offset equal offset. auto end_node = node; auto end_offset = offset; // 9. If end node has a child with index end offset, and that child is a collapsed block prop, add one to end // offset. if (auto child_at_offset = end_node->child_at_index(end_offset); child_at_offset && is_collapsed_block_prop(*child_at_offset)) ++end_offset; // 10. Repeat the following steps: while (true) { // 1. If end offset is the length of end node, set end offset to one plus the index of end node and then set end // node to its parent. if (end_node->parent() && end_offset == end_node->length()) { end_offset = end_node->index() + 1; end_node = *end_node->parent(); continue; } // 2. Otherwise, if end node has an editable invisible child with index end offset, remove it from end node. if (auto child_at_offset = end_node->child_at_index(end_offset); child_at_offset && child_at_offset->is_editable() && is_invisible_node(*child_at_offset)) { child_at_offset->remove(); continue; } // 3. Otherwise, break from this loop. break; } // 11. If the child of end node with index end offset minus one is a table, return true. if (is(end_node->child_at_index(end_offset - 1))) return true; // 12. If the child of end node with index end offset is a table: if (is(end_node->child_at_index(end_offset))) { // 1. Call collapse(end node, end offset) on the context object's selection. MUST(selection.collapse(end_node, end_offset)); // 2. Call extend(end node, end offset + 1) on the context object's selection. MUST(selection.extend(end_node, end_offset + 1)); // 3. Return true. return true; } // 13. If offset is the length of node, and the child of end node with index end offset is an hr or br: if (auto child_at_offset = end_node->child_at_index(end_offset); offset == node->length() && (is(child_at_offset) || is(child_at_offset))) { // 1. Call collapse(end node, end offset) on the context object's selection. MUST(selection.collapse(end_node, end_offset)); // 2. Call extend(end node, end offset + 1) on the context object's selection. MUST(selection.extend(end_node, end_offset + 1)); // 3. Delete the selection. delete_the_selection(selection); // 4. Call collapse(node, offset) on the selection. MUST(selection.collapse(node, offset)); // 5. Return true. return true; } // 14. While end node has a child with index end offset: while (auto child_at_offset = end_node->child_at_index(end_offset)) { // 1. If end node's child with index end offset is editable and invisible, remove it from end node. if (child_at_offset->is_editable() && is_invisible_node(*child_at_offset)) { child_at_offset->remove(); } // 2. Otherwise, set end node to its child with index end offset and set end offset to zero. else { end_node = *child_at_offset; end_offset = 0; } } // 15. Call collapse(node, offset) on the context object's selection. MUST(selection.collapse(node, offset)); // 16. Call extend(end node, end offset) on the context object's selection. MUST(selection.extend(end_node, end_offset)); // 17. Delete the selection. delete_the_selection(selection); // AD-HOC: Return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-insertlinebreak-command bool command_insert_linebreak_action(DOM::Document& document, String const&) { // 1. Delete the selection, with strip wrappers false. auto& selection = *document.get_selection(); delete_the_selection(selection, true, false); // 2. If the active range's start node is neither editable nor an editing host, return true. auto& active_range = *selection.range(); auto start_node = active_range.start_container(); if (!start_node->is_editable_or_editing_host()) return true; // 3. If the active range's start node is an Element, and "br" is not an allowed child of it, return true. if (is(*start_node) && !is_allowed_child_of_node(HTML::TagNames::br, start_node)) return true; // 4. If the active range's start node is not an Element, and "br" is not an allowed child of the active range's // start node's parent, return true. if (!is(*start_node) && start_node->parent() && !is_allowed_child_of_node(HTML::TagNames::br, GC::Ref { *start_node->parent() })) return true; // 5. If the active range's start node is a Text node and its start offset is zero, call collapse() on the context // object's selection, with first argument equal to the active range's start node's parent and second argument // equal to the active range's start node's index. if (is(*start_node) && active_range.start_offset() == 0) MUST(selection.collapse(start_node->parent(), start_node->index())); // 6. If the active range's start node is a Text node and its start offset is the length of its start node, call // collapse() on the context object's selection, with first argument equal to the active range's start node's // parent and second argument equal to one plus the active range's start node's index. if (is(*start_node) && active_range.start_offset() == start_node->length()) MUST(selection.collapse(start_node->parent(), start_node->index() + 1)); // AD-HOC: If the active range's start node is a Text node and its resolved value for "white-space" is one of "pre", // "pre-line" or "pre-wrap": // * Insert a newline (\n) character at the active range's start offset; // * Collapse the selection with active range's start node as the first argument and one plus active range's // start offset as the second argument // * Insert another newline (\n) character if the active range's start offset is equal to the length of the // active range's start node. // * Return true. if (is(*start_node)) { auto& text_node = static_cast(*start_node); auto resolved_white_space = resolved_keyword(*start_node, CSS::PropertyID::WhiteSpace); if (resolved_white_space.has_value() && first_is_one_of(resolved_white_space.value(), CSS::Keyword::Pre, CSS::Keyword::PreLine, CSS::Keyword::PreWrap)) { MUST(text_node.insert_data(active_range.start_offset(), "\n"_string)); MUST(selection.collapse(start_node, active_range.start_offset() + 1)); if (selection.range()->start_offset() == start_node->length()) MUST(text_node.insert_data(active_range.start_offset(), "\n"_string)); return true; } } // 7. Let br be the result of calling createElement("br") on the context object. auto br = MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)); // 8. Call insertNode(br) on the active range. MUST(active_range.insert_node(br)); // 9. Call collapse() on the context object's selection, with br's parent as the first argument and one plus br's // index as the second argument. MUST(selection.collapse(br->parent(), br->index() + 1)); // 10. If br is a collapsed line break, call createElement("br") on the context object and let extra br be the // result, then call insertNode(extra br) on the active range. if (is_collapsed_line_break(br)) { auto extra_br = MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)); MUST(active_range.insert_node(extra_br)); } // 11. Return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-insertparagraph-command bool command_insert_paragraph_action(DOM::Document& document, String const&) { // 1. Delete the selection. auto& selection = *document.get_selection(); delete_the_selection(selection); // 2. If the active range's start node is neither editable nor an editing host, return true. GC::Ref active_range = *selection.range(); GC::Ptr node = active_range->start_container(); if (!node->is_editable_or_editing_host()) return true; // 3. Let node and offset be the active range's start node and offset. // NOTE: node is set in step 2 auto offset = active_range->start_offset(); // 4. If node is a Text node, and offset is neither 0 nor the length of node, call splitText(offset) on node. if (is(*node) && offset != 0 && offset != node->length()) MUST(static_cast(*node).split_text(offset)); // 5. If node is a Text node and offset is its length, set offset to one plus the index of node, then set node to // its parent. if (is(*node) && offset == node->length()) { offset = node->index() + 1; node = node->parent(); } // 6. If node is a Text or Comment node, set offset to the index of node, then set node to its parent. if (is(*node) || is(*node)) { offset = node->index(); node = node->parent(); } // 7. Call collapse(node, offset) on the context object's selection. MUST(selection.collapse(node, offset)); active_range = *selection.range(); // 8. Let container equal node. auto container = node; // 9. While container is not a single-line container, and container's parent is editable and in the same editing // host as node, set container to its parent. while (!is_single_line_container(*container)) { auto container_parent = container->parent(); if (!container_parent->is_editable() || !is_in_same_editing_host(*node, *container_parent)) break; container = container_parent; } // 10. If container is an editable single-line container in the same editing host as node, and its local name is "p" // or "div": if (container->is_editable() && is_single_line_container(*container) && is_in_same_editing_host(*container, *node) && is(*container) && static_cast(*container).local_name().is_one_of(HTML::TagNames::p, HTML::TagNames::div)) { // 1. Let outer container equal container. auto outer_container = container; // 2. While outer container is not a dd or dt or li, and outer container's parent is editable, set outer // container to its parent. auto is_li_dt_or_dd = [](DOM::Element const& node) { return node.local_name().is_one_of(HTML::TagNames::li, HTML::TagNames::dt, HTML::TagNames::dd); }; while (!is(*outer_container) || !is_li_dt_or_dd(static_cast(*outer_container))) { auto outer_container_parent = outer_container->parent(); if (!outer_container_parent->is_editable()) break; outer_container = outer_container_parent; } // 3. If outer container is a dd or dt or li, set container to outer container. if (is(*outer_container) && is_li_dt_or_dd(static_cast(*outer_container))) container = outer_container; } // 11. If container is not editable or not in the same editing host as node or is not a single-line container: if (!container->is_editable() || !is_in_same_editing_host(*container, *node) || !is_single_line_container(*container)) { // 1. Let tag be the default single-line container name. auto tag = document.default_single_line_container_name(); // 2. Block-extend the active range, and let new range be the result. auto new_range = block_extend_a_range(active_range); // 3. Let node list be a list of nodes, initially empty. Vector> node_list; // 4. Append to node list the first node in tree order that is contained in new range and is an allowed child of // "p", if any. new_range->for_each_contained([&node_list](GC::Ref node) { if (is_allowed_child_of_node(node, HTML::TagNames::p)) { node_list.append(node); return IterationDecision::Break; } return IterationDecision::Continue; }); // 5. If node list is empty: if (node_list.is_empty()) { // 1. If tag is not an allowed child of the active range's start node, return true. if (!is_allowed_child_of_node(tag, active_range->start_container())) return true; // 2. Set container to the result of calling createElement(tag) on the context object. container = MUST(DOM::create_element(document, tag, Namespace::HTML)); // 3. Call insertNode(container) on the active range. MUST(active_range->insert_node(*container)); // 4. Call createElement("br") on the context object, and append the result as the last child of container. MUST(container->append_child(MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)))); // 5. Call collapse(container, 0) on the context object's selection. MUST(selection.collapse(container, 0)); // 6. Return true. return true; } // 6. While the nextSibling of the last member of node list is not null and is an allowed child of "p", append // it to node list. auto next_sibling = node_list.last()->next_sibling(); while (next_sibling && is_allowed_child_of_node(GC::Ref { *next_sibling }, HTML::TagNames::p)) { node_list.append(*next_sibling); next_sibling = next_sibling->next_sibling(); } // 7. Wrap node list, with sibling criteria returning false and new parent instructions returning the result of // calling createElement(tag) on the context object. Set container to the result. wrap( node_list, [](auto) { return false; }, [&] { return MUST(DOM::create_element(document, tag, Namespace::HTML)); }); } // 12. If container's local name is "address", "listing", or "pre": if (is(*container) && static_cast(*container) .local_name() .is_one_of(HTML::TagNames::address, HTML::TagNames::listing, HTML::TagNames::pre)) { // 1. Let br be the result of calling createElement("br") on the context object. auto br = MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)); // 2. Call insertNode(br) on the active range. MUST(active_range->insert_node(br)); // 3. Call collapse(node, offset + 1) on the context object's selection. MUST(selection.collapse(node, offset + 1)); active_range = *selection.range(); // 4. If br is the last descendant of container, let br be the result of calling createElement("br") on the // context object, then call insertNode(br) on the active range. GC::Ptr last_descendant = container->last_child(); while (last_descendant->has_children()) last_descendant = last_descendant->last_child(); if (br == last_descendant) { br = MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)); MUST(active_range->insert_node(br)); } // 5. Return true. return true; } // 13. If container's local name is "li", "dt", or "dd"; and either it has no children or it has a single child and // that child is a br: if (is(*container) && static_cast(*container).local_name().is_one_of(HTML::TagNames::li, HTML::TagNames::dt, HTML::TagNames::dd) && (!container->has_children() || (container->child_count() == 1 && is(container->first_child())))) { // 1. Split the parent of the one-node list consisting of container. split_the_parent_of_nodes({ *container }); // 2. If container has no children, call createElement("br") on the context object and append the result as the // last child of container. if (!container->has_children()) MUST(container->append_child(MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)))); // 3. If container is a dd or dt, and it is not an allowed child of any of its ancestors in the same editing // host, set the tag name of container to the default single-line container name and let container be the // result. if (static_cast(*container).local_name().is_one_of(HTML::TagNames::dd, HTML::TagNames::dt)) { bool allowed_child_of_any_ancestor = false; container->for_each_ancestor([&](GC::Ref ancestor) { if (is_allowed_child_of_node(GC::Ref { *container }, ancestor) && is_in_same_editing_host(*container, ancestor)) { allowed_child_of_any_ancestor = true; return IterationDecision::Break; } return IterationDecision::Continue; }); if (!allowed_child_of_any_ancestor) container = set_the_tag_name(static_cast(*container), document.default_single_line_container_name()); } // 4. Fix disallowed ancestors of container. fix_disallowed_ancestors_of_node(*container); // 5. Return true. return true; } // 14. Let new line range be a new range whose start is the same as the active range's, and whose end is (container, // length of container). auto new_line_range = DOM::Range::create(active_range->start_container(), active_range->start_offset(), *container, container->length()); // 15. While new line range's start offset is zero and its start node is not a prohibited paragraph child, set its // start to (parent of start node, index of start node). GC::Ptr start_container = new_line_range->start_container(); while (start_container->parent() && new_line_range->start_offset() == 0 && !is_prohibited_paragraph_child(*start_container)) { MUST(new_line_range->set_start(*start_container->parent(), start_container->index())); start_container = start_container->parent(); } // 16. While new line range's start offset is the length of its start node and its start node is not a prohibited // paragraph child, set its start to (parent of start node, 1 + index of start node). start_container = new_line_range->start_container(); while (start_container->parent() && new_line_range->start_offset() == start_container->length() && !is_prohibited_paragraph_child(*start_container)) { MUST(new_line_range->set_start(*start_container->parent(), start_container->index() + 1)); start_container = start_container->parent(); } // 17. Let end of line be true if new line range contains either nothing or a single br, and false otherwise. auto end_of_line = new_line_range->collapsed() || ((new_line_range->start_container() == new_line_range->end_container() && new_line_range->start_offset() == new_line_range->end_offset() - 1) && is(*new_line_range->start_container())); auto& container_element = verify_cast(*container); auto new_container_name = [&] -> FlyString { // 18. If the local name of container is "h1", "h2", "h3", "h4", "h5", or "h6", and end of line is true, let new // container name be the default single-line container name. if (end_of_line && is_heading(container_element.local_name())) return document.default_single_line_container_name(); // 19. Otherwise, if the local name of container is "dt" and end of line is true, let new container name be "dd". if (container_element.local_name() == HTML::TagNames::dt && end_of_line) return HTML::TagNames::dd; // 20. Otherwise, if the local name of container is "dd" and end of line is true, let new container name be "dt". if (container_element.local_name() == HTML::TagNames::dd && end_of_line) return HTML::TagNames::dt; // 21. Otherwise, let new container name be the local name of container. return container_element.local_name(); }(); // 22. Let new container be the result of calling createElement(new container name) on the context object. auto new_container = MUST(DOM::create_element(document, new_container_name, Namespace::HTML)); // 23. Copy all attributes of container to new container. container_element.for_each_attribute([&new_container](FlyString const& name, String const& value) { MUST(new_container->set_attribute(name, value)); }); // 24. If new container has an id attribute, unset it. if (new_container->has_attribute(HTML::AttributeNames::id)) new_container->remove_attribute(HTML::AttributeNames::id); // 25. Insert new container into the parent of container immediately after container. container->parent()->insert_before(*new_container, container->next_sibling()); // 26. Let contained nodes be all nodes contained in new line range. Vector> contained_nodes; new_line_range->for_each_contained([&contained_nodes](GC::Ref node) { contained_nodes.append(node); return IterationDecision::Continue; }); // 27. Let frag be the result of calling extractContents() on new line range. auto frag = MUST(new_line_range->extract_contents()); // 28. Unset the id attribute (if any) of each Element descendant of frag that is not in contained nodes. frag->for_each_in_subtree_of_type([&contained_nodes](GC::Ref descendant) { if (!contained_nodes.contains_slow(descendant)) descendant->remove_attribute(HTML::AttributeNames::id); return TraversalDecision::Continue; }); // 29. Call appendChild(frag) on new container. MUST(new_container->append_child(frag)); // 30. While container's lastChild is a prohibited paragraph child, set container to its lastChild. while (container->last_child() && is_prohibited_paragraph_child(*container->last_child())) container = container->last_child(); // 31. While new container's lastChild is a prohibited paragraph child, set new container to its lastChild. while (new_container->last_child() && is_prohibited_paragraph_child(*new_container->last_child())) { // NOTE: is_prohibited_paragraph_child() ensures that last_child() is an HTML::HTMLElement new_container = static_cast(*new_container->last_child()); } // 32. If container has no visible children, call createElement("br") on the context object, and append the result // as the last child of container. if (!has_visible_children(*container)) MUST(container->append_child(MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)))); // 33. If new container has no visible children, call createElement("br") on the context object, and append the // result as the last child of new container. if (!has_visible_children(*new_container)) MUST(new_container->append_child(MUST(DOM::create_element(document, HTML::TagNames::br, Namespace::HTML)))); // 34. Call collapse(new container, 0) on the context object's selection. MUST(document.get_selection()->collapse(new_container, 0)); // 35. Return true return true; } // https://w3c.github.io/editing/docs/execCommand/#the-stylewithcss-command bool command_style_with_css_action(DOM::Document& document, String const& value) { // If value is an ASCII case-insensitive match for the string "false", set the CSS styling flag to false. // Otherwise, set the CSS styling flag to true. document.set_css_styling_flag(!value.equals_ignoring_ascii_case("false"sv)); // Either way, return true. return true; } // https://w3c.github.io/editing/docs/execCommand/#the-stylewithcss-command bool command_style_with_css_state(DOM::Document const& document) { // True if the CSS styling flag is true, otherwise false. return document.css_styling_flag(); } static Array const commands { // https://w3c.github.io/editing/docs/execCommand/#the-backcolor-command CommandDefinition { .command = CommandNames::backColor, .action = command_back_color_action, .relevant_css_property = CSS::PropertyID::BackgroundColor, }, // https://w3c.github.io/editing/docs/execCommand/#the-bold-command CommandDefinition { .command = CommandNames::bold, .action = command_bold_action, .relevant_css_property = CSS::PropertyID::FontWeight, .inline_activated_values = { "bold"sv, "600"sv, "700"sv, "800"sv, "900"sv }, }, // https://w3c.github.io/editing/docs/execCommand/#the-createlink-command CommandDefinition { .command = CommandNames::createLink, .action = command_create_link_action, }, // https://w3c.github.io/editing/docs/execCommand/#the-delete-command CommandDefinition { .command = CommandNames::delete_, .action = command_delete_action, .preserves_overrides = true, }, // https://w3c.github.io/editing/docs/execCommand/#the-defaultparagraphseparator-command CommandDefinition { .command = CommandNames::defaultParagraphSeparator, .action = command_default_paragraph_separator_action, .value = command_default_paragraph_separator_value, }, // https://w3c.github.io/editing/docs/execCommand/#the-fontname-command CommandDefinition { .command = CommandNames::fontName, .action = command_font_name_action, .relevant_css_property = CSS::PropertyID::FontFamily, }, // https://w3c.github.io/editing/docs/execCommand/#the-fontsize-command CommandDefinition { .command = CommandNames::fontSize, .action = command_font_size_action, .value = command_font_size_value, .relevant_css_property = CSS::PropertyID::FontSize, }, // https://w3c.github.io/editing/docs/execCommand/#the-forwarddelete-command CommandDefinition { .command = CommandNames::forwardDelete, .action = command_forward_delete_action, .preserves_overrides = true, }, // https://w3c.github.io/editing/docs/execCommand/#the-hilitecolor-command CommandDefinition { .command = CommandNames::hiliteColor, .action = command_back_color_action, // For historical reasons, backColor and hiliteColor behave identically. .relevant_css_property = CSS::PropertyID::BackgroundColor, }, // https://w3c.github.io/editing/docs/execCommand/#the-insertlinebreak-command CommandDefinition { .command = CommandNames::insertLineBreak, .action = command_insert_linebreak_action, .preserves_overrides = true, }, // https://w3c.github.io/editing/docs/execCommand/#the-insertparagraph-command CommandDefinition { .command = CommandNames::insertParagraph, .action = command_insert_paragraph_action, .preserves_overrides = true, }, // https://w3c.github.io/editing/docs/execCommand/#the-stylewithcss-command CommandDefinition { .command = CommandNames::styleWithCSS, .action = command_style_with_css_action, .state = command_style_with_css_state, }, }; Optional find_command_definition(FlyString const& command) { for (auto& definition : commands) { if (command.equals_ignoring_ascii_case(definition.command)) return definition; } return {}; } }