script/dom/html/
htmloptionscollection.rs

1/* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
4
5use std::cmp::Ordering;
6
7use dom_struct::dom_struct;
8use html5ever::{QualName, local_name, ns};
9use js::context::{JSContext, NoGC};
10use script_bindings::reflector::reflect_dom_object_with_cx;
11
12use crate::dom::bindings::codegen::Bindings::ElementBinding::ElementMethods;
13use crate::dom::bindings::codegen::Bindings::HTMLCollectionBinding::HTMLCollectionMethods;
14use crate::dom::bindings::codegen::Bindings::HTMLOptionsCollectionBinding::HTMLOptionsCollectionMethods;
15use crate::dom::bindings::codegen::Bindings::HTMLSelectElementBinding::HTMLSelectElementMethods;
16use crate::dom::bindings::codegen::Bindings::NodeBinding::Node_Binding::NodeMethods;
17use crate::dom::bindings::codegen::UnionTypes::{
18    HTMLElementOrLong, HTMLOptionElementOrHTMLOptGroupElement,
19};
20use crate::dom::bindings::error::{Error, ErrorResult};
21use crate::dom::bindings::inheritance::Castable;
22use crate::dom::bindings::root::DomRoot;
23use crate::dom::bindings::str::DOMString;
24use crate::dom::element::{CustomElementCreationMode, Element, ElementCreator};
25use crate::dom::html::htmlcollection::{CollectionFilter, HTMLCollection};
26use crate::dom::html::htmloptionelement::HTMLOptionElement;
27use crate::dom::html::htmlselectelement::HTMLSelectElement;
28use crate::dom::node::{Node, NodeTraits};
29use crate::dom::window::Window;
30
31#[dom_struct]
32pub(crate) struct HTMLOptionsCollection {
33    collection: HTMLCollection,
34}
35
36impl HTMLOptionsCollection {
37    fn new_inherited(
38        select: &HTMLSelectElement,
39        filter: Box<dyn CollectionFilter + 'static>,
40    ) -> HTMLOptionsCollection {
41        HTMLOptionsCollection {
42            collection: HTMLCollection::new_inherited(select.upcast(), filter),
43        }
44    }
45
46    pub(crate) fn new(
47        cx: &mut JSContext,
48        window: &Window,
49        select: &HTMLSelectElement,
50        filter: Box<dyn CollectionFilter + 'static>,
51    ) -> DomRoot<HTMLOptionsCollection> {
52        reflect_dom_object_with_cx(
53            Box::new(HTMLOptionsCollection::new_inherited(select, filter)),
54            window,
55            cx,
56        )
57    }
58
59    fn add_new_elements(&self, cx: &mut JSContext, count: u32) -> ErrorResult {
60        let root = self.upcast().root_node();
61        let document = root.owner_document();
62
63        for _ in 0..count {
64            let element = Element::create(
65                cx,
66                QualName::new(None, ns!(html), local_name!("option")),
67                None,
68                &document,
69                ElementCreator::ScriptCreated,
70                CustomElementCreationMode::Asynchronous,
71                None,
72            );
73            let node = element.upcast::<Node>();
74            root.AppendChild(cx, node)?;
75        }
76        Ok(())
77    }
78}
79
80impl HTMLOptionsCollectionMethods<crate::DomTypeHolder> for HTMLOptionsCollection {
81    // FIXME: This shouldn't need to be implemented here since HTMLCollection (the parent of
82    // HTMLOptionsCollection) implements NamedGetter.
83    // https://github.com/servo/servo/issues/5875
84    //
85    /// <https://dom.spec.whatwg.org/#dom-htmlcollection-nameditem>
86    fn NamedGetter(&self, cx: &JSContext, name: DOMString) -> Option<DomRoot<Element>> {
87        self.upcast().NamedItem(cx, name)
88    }
89
90    /// <https://heycam.github.io/webidl/#dfn-supported-property-names>
91    fn SupportedPropertyNames(&self, no_gc: &NoGC) -> Vec<DOMString> {
92        self.upcast().SupportedPropertyNames(no_gc)
93    }
94
95    // FIXME: This shouldn't need to be implemented here since HTMLCollection (the parent of
96    // HTMLOptionsCollection) implements IndexedGetter.
97    // https://github.com/servo/servo/issues/5875
98    //
99    /// <https://dom.spec.whatwg.org/#dom-htmlcollection-item>
100    fn IndexedGetter(&self, cx: &JSContext, index: u32) -> Option<DomRoot<Element>> {
101        self.upcast().IndexedGetter(cx, index)
102    }
103
104    /// <https://html.spec.whatwg.org/multipage/#dom-htmloptionscollection-setter>
105    fn IndexedSetter(
106        &self,
107        cx: &mut JSContext,
108        index: u32,
109        value: Option<&HTMLOptionElement>,
110    ) -> ErrorResult {
111        if let Some(value) = value {
112            // Step 2
113            let length = self.upcast().Length(cx);
114
115            // Step 3
116            let n = index as i32 - length as i32;
117
118            // Step 4
119            if n > 0 {
120                self.add_new_elements(cx, n as u32)?;
121            }
122
123            // Step 5
124            let node = value.upcast::<Node>();
125            let root = self.upcast().root_node();
126            if n >= 0 {
127                Node::pre_insert(cx, node, &root, None).map(|_| ())
128            } else {
129                let child = self.upcast().IndexedGetter(cx, index).unwrap();
130                let child_node = child.upcast::<Node>();
131
132                root.ReplaceChild(cx, node, child_node).map(|_| ())
133            }
134        } else {
135            // Step 1
136            self.Remove(cx, index as i32);
137            Ok(())
138        }
139    }
140
141    /// <https://html.spec.whatwg.org/multipage/#dom-htmloptionscollection-length>
142    fn Length(&self, cx: &JSContext) -> u32 {
143        self.upcast().Length(cx)
144    }
145
146    /// <https://html.spec.whatwg.org/multipage/#dom-htmloptionscollection-length>
147    fn SetLength(&self, cx: &mut JSContext, length: u32) {
148        // Step 1. Let current be the number of nodes represented by the collection.
149        let current = self.upcast().Length(cx);
150
151        match length.cmp(&current) {
152            // Step 2. If the given value is greater than current, then:
153            Ordering::Greater => {
154                // Step 2.1 If the given value is greater than 100,000, then return.
155                if length > 100_000 {
156                    return;
157                }
158
159                // Step 2.2 Let n be value − current.
160                let n = length - current;
161
162                // Step 2.3 Append n new option elements with no attributes and no child
163                // nodes to the select element on which this is rooted.
164                self.add_new_elements(cx, n).unwrap();
165            },
166            // Step 3. If the given value is less than current, then:
167            Ordering::Less => {
168                // Step 3.1. Let n be current − value.
169                // Step 3.2 Remove the last n nodes in the collection from their parent nodes.
170                for index in (length..current).rev() {
171                    self.Remove(cx, index as i32)
172                }
173            },
174            _ => {},
175        }
176    }
177
178    /// <https://html.spec.whatwg.org/multipage/#dom-htmloptionscollection-add>
179    fn Add(
180        &self,
181        cx: &mut JSContext,
182        element: HTMLOptionElementOrHTMLOptGroupElement,
183        before: Option<HTMLElementOrLong>,
184    ) -> ErrorResult {
185        let root = self.upcast().root_node();
186
187        let node: &Node = match element {
188            HTMLOptionElementOrHTMLOptGroupElement::HTMLOptionElement(ref element) => {
189                element.upcast()
190            },
191            HTMLOptionElementOrHTMLOptGroupElement::HTMLOptGroupElement(ref element) => {
192                element.upcast()
193            },
194        };
195
196        // Step 1: If element is an ancestor of the select element on which the
197        // HTMLOptionsCollection is rooted, then throw a "HierarchyRequestError"
198        // DOMException.
199        if node.is_ancestor_of(&root) {
200            return Err(Error::HierarchyRequest(None));
201        }
202
203        if let Some(HTMLElementOrLong::HTMLElement(ref before_element)) = before {
204            // Step 2: If before is an element, but that element isn't a descendant
205            // of the select element on which the HTMLOptionsCollection is rooted,
206            // then throw a "NotFoundError" DOMException.
207            let before_node = before_element.upcast::<Node>();
208            if !root.is_ancestor_of(before_node) {
209                return Err(Error::NotFound(None));
210            }
211
212            // Step 3: If element and before are the same element, then return.
213            if node == before_node {
214                return Ok(());
215            }
216        }
217
218        // Step 4: If before is a node, then let reference be that node. Otherwise,
219        // if before is an integer, and there is a beforeth node in the collection,
220        // let reference be that node. Otherwise, let reference be null.
221        let reference_node = before.and_then(|before| match before {
222            HTMLElementOrLong::HTMLElement(element) => Some(DomRoot::upcast::<Node>(element)),
223            HTMLElementOrLong::Long(index) => self
224                .upcast()
225                .IndexedGetter(cx, index as u32)
226                .map(DomRoot::upcast::<Node>),
227        });
228
229        // Step 5: If reference is not null, let parent be the parent node of
230        // reference. Otherwise, let parent be the select element on which the
231        // HTMLOptionsCollection is rooted.
232        let parent = if let Some(ref reference_node) = reference_node {
233            reference_node.GetParentNode().unwrap()
234        } else {
235            root
236        };
237
238        // Step 6: Pre-insert element into parent node before reference.
239        Node::pre_insert(cx, node, &parent, reference_node.as_deref()).map(|_| ())
240    }
241
242    /// <https://html.spec.whatwg.org/multipage/#dom-htmloptionscollection-remove>
243    fn Remove(&self, cx: &mut JSContext, index: i32) {
244        if let Some(element) = self.upcast().IndexedGetter(cx, index as u32) {
245            element.Remove(cx);
246        }
247    }
248
249    /// <https://html.spec.whatwg.org/multipage/#dom-htmloptionscollection-selectedindex>
250    fn SelectedIndex(&self, cx: &JSContext) -> i32 {
251        self.upcast()
252            .root_node()
253            .downcast::<HTMLSelectElement>()
254            .expect("HTMLOptionsCollection not rooted on a HTMLSelectElement")
255            .SelectedIndex(cx)
256    }
257
258    /// <https://html.spec.whatwg.org/multipage/#dom-htmloptionscollection-selectedindex>
259    fn SetSelectedIndex(&self, cx: &mut JSContext, index: i32) {
260        self.upcast()
261            .root_node()
262            .downcast::<HTMLSelectElement>()
263            .expect("HTMLOptionsCollection not rooted on a HTMLSelectElement")
264            .SetSelectedIndex(cx, index)
265    }
266}
script/dom/html/htmloptionscollection.rs

script/dom/html/
htmloptionscollection.rs
