components/script/dom/execcommand/commands/inserttext.rs - main - githubmirror/servo

components/script/dom/execcommand/commands/inserttext.rs
186 строк7 KB
Psychpsyo (Cameron)
script: Implement inserttext command (#46838)
28 июл 2026, 23:05
28 июл 2026, 23:05a80b5ee
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */

use js::context::JSContext;
use script_bindings::codegen::GenericBindings::CharacterDataBinding::CharacterDataMethods;
use script_bindings::codegen::GenericBindings::DocumentBinding::DocumentMethods;
use script_bindings::codegen::GenericBindings::SelectionBinding::SelectionMethods;
use script_bindings::inheritance::Castable;

use crate::dom::Node;
use crate::dom::bindings::codegen::Bindings::RangeBinding::RangeMethods;
use crate::dom::bindings::str::DOMString;
use crate::dom::characterdata::CharacterData;
use crate::dom::document::Document;
use crate::dom::execcommand::basecommand::CommandName;
use crate::dom::execcommand::commands::insertparagraph::execute_insert_paragraph_command;
use crate::dom::execcommand::contenteditable::selection::SelectionDeletionStripWrappers;
use crate::dom::selection::Selection;
use crate::dom::text::Text;

/// <https://w3c.github.io/editing/docs/execCommand/#the-inserttext-command>
pub(crate) fn execute_insert_text_command(
    cx: &mut JSContext,
    document: &Document,
    selection: &Selection,
    value: DOMString,
) -> bool {
    // Step 1. Delete the selection, with strip wrappers false.
    selection.delete_the_selection(
        cx,
        document,
        Default::default(),
        SelectionDeletionStripWrappers::NoStrip,
        Default::default(),
    );

    // Step 2. If the active range's start node is neither editable nor an editing host, return true.
    let mut active_range = selection
        .active_range()
        .expect("Must always have an active range.");
    if !active_range.start_container().is_editable_or_editing_host() {
        return true;
    }

    // Step 3. If value's length is greater than one:
    if value.len() > 1 {
        // Step 3.1. For each code unit el in value, take the action for the insertText command, with value equal to el.
        for el in value.str().chars() {
            execute_insert_text_command(cx, document, selection, DOMString::from(el.to_string()));
        }

        // Step 3.2. Return true.
        return true;
    }

    // Step 4. If value is the empty string, return true.
    if value.is_empty() {
        return true;
    }

    // Step 5. If value is a newline (U+000A), take the action for the insertParagraph command and return true.
    if value == "\n" {
        execute_insert_paragraph_command(cx, document, selection);
        return true;
    }

    // Step 6. Let node and offset be the active range's start node and offset.
    let mut node = active_range.start_container();
    let mut offset = active_range.start_offset();

    // Step 7. If node has a child whose index is offset − 1, and that child is a Text node, set node to that child, then set offset to node's length.
    if offset > 0 &&
        let Some(child) = node.children().nth((offset - 1) as usize) &&
        child.is::<Text>()
    {
        node = child;
        offset = node.len();
    }

    // Step 8. If node has a child whose index is offset, and that child is a Text node, set node to that child, then set offset to zero.
    if let Some(child) = node.children().nth((offset) as usize) &&
        child.is::<Text>()
    {
        node = child;
        offset = 0;
    }

    // Step 9. Record current overrides, and let overrides be the result.
    let overrides = CommandName::record_current_overrides(document);

    // Step 10. Call collapse(node, offset) on the context object's selection.
    if selection.Collapse(cx, Some(&node), offset).is_err() {
        unreachable!("Must always be able to collapse the selection");
    }

    // Step 11. Canonicalize whitespace at (node, offset).
    node.canonicalize_whitespace(cx, offset, Default::default());

    // Step 12. Let (node, offset) be the active range's start.
    active_range = selection
        .active_range()
        .expect("Must always have an active range.");
    node = active_range.start_container();
    offset = active_range.start_offset();

    // Step 13. If node is a Text node:
    if let Some(node_as_text) = node.downcast::<Text>() {
        // Step 13.1. Call insertData(offset, value) on node.
        if node_as_text
            .upcast::<CharacterData>()
            .InsertData(cx, offset, value.clone())
            .is_err()
        {
            unreachable!("Must always be able to insert");
        }

        // Step 13.2. Call collapse(node, offset) on the context object's selection.
        if selection.Collapse(cx, Some(&node), offset).is_err() {
            unreachable!("Must always be able to collapse the selection.");
        }

        // Step 13.3. Call extend(node, offset + 1) on the context object's selection.
        if selection.Extend(cx, &node, offset + 1).is_err() {
            unreachable!("Must always be able to extend the selection");
        }

        active_range = selection
            .active_range()
            .expect("Must always have an active range.");
    }
    // Step 14. Otherwise:
    else {
        // Step 14.1. If node has only one child, which is a collapsed line break, remove its child from it.
        // TODO: Implement this.

        // Step 14.2. Let text be the result of calling createTextNode(value) on the context object.
        let text = document.CreateTextNode(cx, value.clone());
        let text = text.upcast::<Node>();

        // Step 14.3. Call insertNode(text) on the active range.
        if active_range.InsertNode(cx, text).is_err() {
            unreachable!("Must always be able to insert");
        }

        // Step 14.4. Call collapse(text, 0) on the context object's selection.
        if selection.Collapse(cx, Some(text), 0).is_err() {
            unreachable!("Must always be able to collapse the selection");
        }

        // Step 14.5. Call extend(text, 1) on the context object's selection.
        if selection.Extend(cx, text, 1).is_err() {
            unreachable!("Must always be able to extend the selection");
        }

        active_range = selection
            .active_range()
            .expect("Must always have an active range.");
    }

    // Step 15. Restore states and values from overrides.
    active_range.restore_states_and_values(cx, selection, document, overrides);

    // Step 16. Canonicalize whitespace at the active range's start, with fix collapsed space false.
    active_range
        .start_container()
        .canonicalize_whitespace(cx, active_range.start_offset(), false);

    // Step 17. Canonicalize whitespace at the active range's end, with fix collapsed space false.
    active_range
        .end_container()
        .canonicalize_whitespace(cx, active_range.end_offset(), false);

    // Step 18. If value is a space character, autolink the active range's start.
    if value == " " {
        // TODO: Implement autolink.
    }

    // Step 19. Call collapseToEnd() on the context object's selection.
    if selection.CollapseToEnd(cx).is_err() {
        unreachable!("Must always be able to CollapseToEnd here.");
    }

    // Step 20. Return true.
    true
}