components/script/dom/html/tabular_data/htmltableelement.rs - main - githubmirror/servo

components/script/dom/html/tabular_data/htmltableelement.rs
586 строк21 KB
Oisín Ó Maolchathail
html: Add error messages (#47124)
10 авг 2026, 17:37
10 авг 2026, 17:3774a7f95
/* 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 std::cell::Cell;

use dom_struct::dom_struct;
use html5ever::{LocalName, Prefix, QualName, local_name, ns};
use js::context::JSContext;
use js::rust::HandleObject;
use style::attr::{AttrValue, LengthOrPercentageOrAuto, parse_unsigned_integer};
use style::color::AbsoluteColor;

use crate::dom::bindings::codegen::Bindings::HTMLCollectionBinding::HTMLCollectionMethods;
use crate::dom::bindings::codegen::Bindings::HTMLTableElementBinding::HTMLTableElementMethods;
use crate::dom::bindings::codegen::Bindings::NodeBinding::NodeMethods;
use crate::dom::bindings::error::{Error, ErrorResult, Fallible};
use crate::dom::bindings::inheritance::Castable;
use crate::dom::bindings::root::{Dom, DomRoot, LayoutDom, MutNullableDom};
use crate::dom::bindings::str::DOMString;
use crate::dom::document::Document;
use crate::dom::element::attributes::storage::AttrRef;
use crate::dom::element::{AttributeMutation, CustomElementCreationMode, Element, ElementCreator};
use crate::dom::html::htmlcollection::{CollectionFilter, HTMLCollection};
use crate::dom::html::htmlelement::HTMLElement;
use crate::dom::html::htmltablecaptionelement::HTMLTableCaptionElement;
use crate::dom::html::htmltablecolelement::HTMLTableColElement;
use crate::dom::html::htmltablerowelement::HTMLTableRowElement;
use crate::dom::html::htmltablesectionelement::HTMLTableSectionElement;
use crate::dom::node::virtualmethods::VirtualMethods;
use crate::dom::node::{Node, NodeTraits};

#[dom_struct]
pub(crate) struct HTMLTableElement {
    htmlelement: HTMLElement,
    border: Cell<Option<u32>>,
    cellpadding: Cell<Option<u32>>,
    cellspacing: Cell<Option<u32>>,
    tbodies: MutNullableDom<HTMLCollection>,
}

#[cfg_attr(crown, expect(crown::unrooted_must_root))]
#[derive(JSTraceable, MallocSizeOf)]
struct TableRowFilter {
    sections: Vec<Dom<Node>>,
}

impl CollectionFilter for TableRowFilter {
    fn filter(&self, elem: &Element, root: &Node) -> bool {
        elem.is::<HTMLTableRowElement>() &&
            (root.is_parent_of(elem.upcast()) ||
                self.sections
                    .iter()
                    .any(|section| section.is_parent_of(elem.upcast())))
    }
}

impl HTMLTableElement {
    fn new_inherited(
        local_name: LocalName,
        prefix: Option<Prefix>,
        document: &Document,
    ) -> HTMLTableElement {
        HTMLTableElement {
            htmlelement: HTMLElement::new_inherited(local_name, prefix, document),
            border: Cell::new(None),
            cellpadding: Cell::new(None),
            cellspacing: Cell::new(None),
            tbodies: Default::default(),
        }
    }

    pub(crate) fn new(
        cx: &mut js::context::JSContext,
        local_name: LocalName,
        prefix: Option<Prefix>,
        document: &Document,
        proto: Option<HandleObject>,
    ) -> DomRoot<HTMLTableElement> {
        let n = Node::reflect_node_with_proto(
            cx,
            Box::new(HTMLTableElement::new_inherited(
                local_name, prefix, document,
            )),
            document,
            proto,
        );

        n.upcast::<Node>().set_weird_parser_insertion_mode();
        n
    }

    // https://html.spec.whatwg.org/multipage/#dom-table-thead
    /// <https://html.spec.whatwg.org/multipage/#dom-table-tfoot>
    fn get_first_section_of_type(
        &self,
        atom: &LocalName,
    ) -> Option<DomRoot<HTMLTableSectionElement>> {
        self.upcast::<Node>()
            .child_elements()
            .find(|n| n.is::<HTMLTableSectionElement>() && n.local_name() == atom)
            .and_then(|n| n.downcast().map(DomRoot::from_ref))
    }

    // https://html.spec.whatwg.org/multipage/#dom-table-thead
    /// <https://html.spec.whatwg.org/multipage/#dom-table-tfoot>
    fn set_first_section_of_type<P>(
        &self,
        cx: &mut JSContext,
        atom: &LocalName,
        section: Option<&HTMLTableSectionElement>,
        reference_predicate: P,
    ) -> ErrorResult
    where
        P: FnMut(&DomRoot<Element>) -> bool,
    {
        if let Some(e) = section &&
            e.upcast::<Element>().local_name() != atom
        {
            return Err(Error::HierarchyRequest(Some(
                "Section element must be null or is not a thead nor a tfoot element".into(),
            )));
        }

        self.delete_first_section_of_type(cx, atom);

        let node = self.upcast::<Node>();

        if let Some(section) = section {
            let reference_element = node.child_elements().find(reference_predicate);
            let reference_node = reference_element.as_ref().map(|e| e.upcast());

            node.InsertBefore(cx, section.upcast(), reference_node)?;
        }

        Ok(())
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-createthead>
    /// <https://html.spec.whatwg.org/multipage/#dom-table-createtfoot>
    fn create_section_of_type(
        &self,
        cx: &mut JSContext,
        atom: &LocalName,
    ) -> DomRoot<HTMLTableSectionElement> {
        if let Some(section) = self.get_first_section_of_type(atom) {
            return section;
        }

        let section = Element::create(
            cx,
            QualName::new(None, ns!(html), atom.clone()),
            None,
            &self.owner_document(),
            ElementCreator::ScriptCreated,
            CustomElementCreationMode::Asynchronous,
            None,
        );

        let section = DomRoot::downcast::<HTMLTableSectionElement>(section).unwrap();

        match *atom {
            local_name!("thead") => self.SetTHead(cx, Some(&section)),
            local_name!("tfoot") => self.SetTFoot(cx, Some(&section)),
            _ => unreachable!("unexpected section type"),
        }
        .expect("unexpected section type");

        section
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-deletethead>
    /// <https://html.spec.whatwg.org/multipage/#dom-table-deletetfoot>
    fn delete_first_section_of_type(&self, cx: &mut JSContext, atom: &LocalName) {
        if let Some(thead) = self.get_first_section_of_type(atom) {
            thead.upcast::<Node>().remove_self(cx);
        }
    }

    fn get_rows(&self) -> TableRowFilter {
        TableRowFilter {
            sections: self
                .upcast::<Node>()
                .children()
                .filter_map(|ref node| {
                    node.downcast::<HTMLTableSectionElement>()
                        .map(|_| Dom::from_ref(&**node))
                })
                .collect(),
        }
    }
}

impl HTMLTableElementMethods<crate::DomTypeHolder> for HTMLTableElement {
    /// <https://html.spec.whatwg.org/multipage/#dom-table-rows>
    fn Rows(&self, cx: &mut JSContext) -> DomRoot<HTMLCollection> {
        let filter = self.get_rows();
        HTMLCollection::new(cx, &self.owner_window(), self.upcast(), Box::new(filter))
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-caption>
    fn GetCaption(&self) -> Option<DomRoot<HTMLTableCaptionElement>> {
        self.upcast::<Node>().children().find_map(DomRoot::downcast)
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-caption>
    fn SetCaption(
        &self,
        cx: &mut JSContext,
        new_caption: Option<&HTMLTableCaptionElement>,
    ) -> Fallible<()> {
        if let Some(ref caption) = self.GetCaption() {
            caption.upcast::<Node>().remove_self(cx);
        }

        if let Some(caption) = new_caption {
            let node = self.upcast::<Node>();
            node.InsertBefore(cx, caption.upcast(), node.GetFirstChild().as_deref())?;
        }

        Ok(())
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-createcaption>
    fn CreateCaption(&self, cx: &mut JSContext) -> DomRoot<HTMLTableCaptionElement> {
        match self.GetCaption() {
            Some(caption) => caption,
            None => {
                let caption = Element::create(
                    cx,
                    QualName::new(None, ns!(html), local_name!("caption")),
                    None,
                    &self.owner_document(),
                    ElementCreator::ScriptCreated,
                    CustomElementCreationMode::Asynchronous,
                    None,
                );
                let caption = DomRoot::downcast::<HTMLTableCaptionElement>(caption).unwrap();

                self.SetCaption(cx, Some(&caption))
                    .expect("Generated caption is invalid");
                caption
            },
        }
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-deletecaption>
    fn DeleteCaption(&self, cx: &mut JSContext) {
        if let Some(caption) = self.GetCaption() {
            caption.upcast::<Node>().remove_self(cx);
        }
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-thead>
    fn GetTHead(&self) -> Option<DomRoot<HTMLTableSectionElement>> {
        self.get_first_section_of_type(&local_name!("thead"))
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-thead>
    fn SetTHead(&self, cx: &mut JSContext, thead: Option<&HTMLTableSectionElement>) -> ErrorResult {
        self.set_first_section_of_type(cx, &local_name!("thead"), thead, |n| {
            !n.is::<HTMLTableCaptionElement>() && !n.is::<HTMLTableColElement>()
        })
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-createthead>
    fn CreateTHead(&self, cx: &mut JSContext) -> DomRoot<HTMLTableSectionElement> {
        self.create_section_of_type(cx, &local_name!("thead"))
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-deletethead>
    fn DeleteTHead(&self, cx: &mut JSContext) {
        self.delete_first_section_of_type(cx, &local_name!("thead"))
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-tfoot>
    fn GetTFoot(&self) -> Option<DomRoot<HTMLTableSectionElement>> {
        self.get_first_section_of_type(&local_name!("tfoot"))
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-tfoot>
    fn SetTFoot(&self, cx: &mut JSContext, tfoot: Option<&HTMLTableSectionElement>) -> ErrorResult {
        self.set_first_section_of_type(cx, &local_name!("tfoot"), tfoot, |n| {
            if n.is::<HTMLTableCaptionElement>() || n.is::<HTMLTableColElement>() {
                return false;
            }

            if n.is::<HTMLTableSectionElement>() {
                let name = n.local_name();
                if name == &local_name!("thead") || name == &local_name!("tbody") {
                    return false;
                }
            }

            true
        })
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-createtfoot>
    fn CreateTFoot(&self, cx: &mut JSContext) -> DomRoot<HTMLTableSectionElement> {
        self.create_section_of_type(cx, &local_name!("tfoot"))
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-deletetfoot>
    fn DeleteTFoot(&self, cx: &mut JSContext) {
        self.delete_first_section_of_type(cx, &local_name!("tfoot"))
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-tbodies>
    fn TBodies(&self, cx: &mut JSContext) -> DomRoot<HTMLCollection> {
        self.tbodies.or_init(|| {
            HTMLCollection::new_with_filter_fn(
                cx,
                &self.owner_window(),
                self.upcast(),
                |element, root| {
                    element.is::<HTMLTableSectionElement>() &&
                        element.local_name() == &local_name!("tbody") &&
                        element.upcast::<Node>().GetParentNode().as_deref() == Some(root)
                },
            )
        })
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-createtbody>
    fn CreateTBody(&self, cx: &mut JSContext) -> DomRoot<HTMLTableSectionElement> {
        let tbody = Element::create(
            cx,
            QualName::new(None, ns!(html), local_name!("tbody")),
            None,
            &self.owner_document(),
            ElementCreator::ScriptCreated,
            CustomElementCreationMode::Asynchronous,
            None,
        );
        let tbody = DomRoot::downcast::<HTMLTableSectionElement>(tbody).unwrap();
        let node = self.upcast::<Node>();
        let last_tbody = node
            .rev_children()
            .filter_map(DomRoot::downcast::<Element>)
            .find(|n| n.is::<HTMLTableSectionElement>() && n.local_name() == &local_name!("tbody"));
        let reference_element = last_tbody.and_then(|t| t.upcast::<Node>().GetNextSibling());

        node.InsertBefore(cx, tbody.upcast(), reference_element.as_deref())
            .expect("Insertion failed");
        tbody
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-insertrow>
    fn InsertRow(&self, cx: &mut JSContext, index: i32) -> Fallible<DomRoot<HTMLTableRowElement>> {
        let rows = self.Rows(cx);
        let number_of_row_elements = rows.Length(cx);

        if index < -1 || index > number_of_row_elements as i32 {
            return Err(Error::IndexSize(Some(
                "Index value must be equal to or greater than -1 and less than the number of row elements".into(),
            )));
        }

        let new_row = Element::create(
            cx,
            QualName::new(None, ns!(html), local_name!("tr")),
            None,
            &self.owner_document(),
            ElementCreator::ScriptCreated,
            CustomElementCreationMode::Asynchronous,
            None,
        );
        let new_row = DomRoot::downcast::<HTMLTableRowElement>(new_row).unwrap();
        let node = self.upcast::<Node>();

        if number_of_row_elements == 0 {
            // append new row to last or new tbody in table
            if let Some(last_tbody) = node
                .rev_children()
                .filter_map(DomRoot::downcast::<Element>)
                .find(|n| {
                    n.is::<HTMLTableSectionElement>() && n.local_name() == &local_name!("tbody")
                })
            {
                last_tbody
                    .upcast::<Node>()
                    .AppendChild(cx, new_row.upcast::<Node>())
                    .expect("InsertRow failed to append first row.");
            } else {
                let tbody = self.CreateTBody(cx);
                node.AppendChild(cx, tbody.upcast())
                    .expect("InsertRow failed to append new tbody.");

                tbody
                    .upcast::<Node>()
                    .AppendChild(cx, new_row.upcast::<Node>())
                    .expect("InsertRow failed to append first row.");
            }
        } else if index == number_of_row_elements as i32 || index == -1 {
            // append new row to parent of last row in table
            let last_row = rows
                .Item(cx, number_of_row_elements - 1)
                .expect("InsertRow failed to find last row in table.");

            let last_row_parent = last_row
                .upcast::<Node>()
                .GetParentNode()
                .expect("InsertRow failed to find parent of last row in table.");

            last_row_parent
                .upcast::<Node>()
                .AppendChild(cx, new_row.upcast::<Node>())
                .expect("InsertRow failed to append last row.");
        } else {
            // insert new row before the index-th row in rows using the same parent
            let ith_row = rows
                .Item(cx, index as u32)
                .expect("InsertRow failed to find a row in table.");

            let ith_row_parent = ith_row
                .upcast::<Node>()
                .GetParentNode()
                .expect("InsertRow failed to find parent of a row in table.");

            ith_row_parent
                .upcast::<Node>()
                .InsertBefore(cx, new_row.upcast::<Node>(), Some(ith_row.upcast::<Node>()))
                .expect("InsertRow failed to append row");
        }

        Ok(new_row)
    }

    /// <https://html.spec.whatwg.org/multipage/#dom-table-deleterow>
    fn DeleteRow(&self, cx: &mut JSContext, mut index: i32) -> Fallible<()> {
        let rows = self.Rows(cx);
        let num_rows = rows.Length(cx) as i32;

        // Step 1: If index is less than −1 or greater than or equal to the number of elements
        // in the rows collection, then throw an "IndexSizeError".
        if !(-1..num_rows).contains(&index) {
            return Err(Error::IndexSize(Some(
                "Index value must be equal to or greater than -1 and less than the number of row elements".into(),
            )));
        }

        let num_rows = rows.Length(cx) as i32;

        // Step 2: If index is −1, then remove the last element in the rows collection from its
        // parent, or do nothing if the rows collection is empty.
        if index == -1 {
            index = num_rows - 1;
        }

        if num_rows == 0 {
            return Ok(());
        }

        // Step 3: Otherwise, remove the indexth element in the rows collection from its parent.
        DomRoot::upcast::<Node>(rows.Item(cx, index as u32).unwrap()).remove_self(cx);

        Ok(())
    }

    // https://html.spec.whatwg.org/multipage/#dom-table-bgcolor
    make_getter!(BgColor, "bgcolor");

    // https://html.spec.whatwg.org/multipage/#dom-table-bgcolor
    make_legacy_color_setter!(SetBgColor, "bgcolor");

    // <https://html.spec.whatwg.org/multipage/#dom-table-width>
    make_getter!(Width, "width");

    // <https://html.spec.whatwg.org/multipage/#dom-table-width>
    make_nonzero_dimension_setter!(SetWidth, "width");

    // <https://html.spec.whatwg.org/multipage/#dom-table-align>
    make_setter!(SetAlign, "align");
    make_getter!(Align, "align");

    // <https://html.spec.whatwg.org/multipage/#dom-table-cellpadding>
    make_setter!(SetCellPadding, "cellpadding");
    make_getter!(CellPadding, "cellpadding");

    // <https://html.spec.whatwg.org/multipage/#dom-table-cellspacing>
    make_setter!(SetCellSpacing, "cellspacing");
    make_getter!(CellSpacing, "cellspacing");
}

impl LayoutDom<'_, HTMLTableElement> {
    pub(crate) fn get_background_color(self) -> Option<AbsoluteColor> {
        self.upcast::<Element>()
            .get_attr_for_layout(&ns!(), &local_name!("bgcolor"))
            .and_then(AttrValue::as_color)
            .cloned()
    }

    pub(crate) fn get_border(self) -> Option<u32> {
        (self.unsafe_get()).border.get()
    }

    pub(crate) fn get_cellpadding(self) -> Option<u32> {
        (self.unsafe_get()).cellpadding.get()
    }

    pub(crate) fn get_cellspacing(self) -> Option<u32> {
        (self.unsafe_get()).cellspacing.get()
    }

    pub(crate) fn get_width(self) -> LengthOrPercentageOrAuto {
        self.upcast::<Element>()
            .get_attr_for_layout(&ns!(), &local_name!("width"))
            .map(AttrValue::as_dimension)
            .cloned()
            .unwrap_or(LengthOrPercentageOrAuto::Auto)
    }

    pub(crate) fn get_height(self) -> LengthOrPercentageOrAuto {
        self.upcast::<Element>()
            .get_attr_for_layout(&ns!(), &local_name!("height"))
            .map(AttrValue::as_dimension)
            .cloned()
            .unwrap_or(LengthOrPercentageOrAuto::Auto)
    }
}

impl VirtualMethods for HTMLTableElement {
    fn super_type(&self) -> Option<&dyn VirtualMethods> {
        Some(self.upcast::<HTMLElement>() as &dyn VirtualMethods)
    }

    fn attribute_mutated(
        &self,
        cx: &mut js::context::JSContext,
        attr: AttrRef<'_>,
        mutation: AttributeMutation,
    ) {
        self.super_type()
            .unwrap()
            .attribute_mutated(cx, attr, mutation);
        match *attr.local_name() {
            local_name!("border") => {
                // According to HTML5 § 14.3.9, invalid values map to 1px.
                self.border.set(
                    mutation
                        .new_value(attr)
                        .map(|value| parse_unsigned_integer(value.chars()).unwrap_or(1)),
                );
            },
            local_name!("cellpadding") => {
                self.cellpadding.set(
                    mutation
                        .new_value(attr)
                        .and_then(|value| parse_unsigned_integer(value.chars()).ok()),
                );
            },
            local_name!("cellspacing") => {
                self.cellspacing.set(
                    mutation
                        .new_value(attr)
                        .and_then(|value| parse_unsigned_integer(value.chars()).ok()),
                );
            },
            _ => {},
        }
    }

    fn attribute_affects_presentational_hints(&self, attr: AttrRef<'_>) -> bool {
        match attr.local_name() {
            &local_name!("width") | &local_name!("height") => true,
            _ => self
                .super_type()
                .unwrap()
                .attribute_affects_presentational_hints(attr),
        }
    }

    fn parse_plain_attribute(&self, local_name: &LocalName, value: DOMString) -> AttrValue {
        match *local_name {
            local_name!("border") => AttrValue::from_u32(value.into(), 1),
            local_name!("width") => AttrValue::from_nonzero_dimension(value.into()),
            local_name!("height") => AttrValue::from_dimension(value.into()),
            local_name!("bgcolor") => AttrValue::from_legacy_color(value.into()),
            _ => self
                .super_type()
                .unwrap()
                .parse_plain_attribute(local_name, value),
        }
    }
}