script/dom/css/
css.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 cssparser::{Parser, ParserInput, serialize_identifier};
6use dom_struct::dom_struct;
7use js::context::JSContext;
8use script_bindings::codegen::GenericBindings::CSSBinding::PropertyDefinition;
9use style::stylesheets::supports_rule::{Declaration, parse_condition_or_declaration};
10use style::stylesheets::{CssRuleType, UrlExtraData};
11use style::stylist::RegisterCustomPropertyResult;
12use style_traits::ParsingMode;
13
14use crate::css::parser_context_for_anonymous_content;
15use crate::dom::bindings::codegen::Bindings::CSSBinding::CSSMethods;
16use crate::dom::bindings::codegen::Bindings::WindowBinding::Window_Binding::WindowMethods;
17use crate::dom::bindings::error::{Error, Fallible};
18use crate::dom::bindings::reflector::Reflector;
19use crate::dom::bindings::root::DomRoot;
20use crate::dom::bindings::str::DOMString;
21use crate::dom::window::Window;
22use crate::dom::worklet::Worklet;
23
24#[dom_struct]
25#[expect(clippy::upper_case_acronyms)]
26pub(crate) struct CSS {
27    reflector_: Reflector,
28}
29
30impl CSSMethods<crate::DomTypeHolder> for CSS {
31    /// <https://drafts.csswg.org/cssom/#the-css.escape()-method>
32    fn Escape(_: &Window, ident: DOMString) -> Fallible<DOMString> {
33        let mut escaped = String::new();
34        serialize_identifier(&ident.str(), &mut escaped).unwrap();
35        Ok(DOMString::from(escaped))
36    }
37
38    /// <https://drafts.csswg.org/css-conditional/#dom-css-supports>
39    fn Supports(win: &Window, property: DOMString, value: DOMString) -> bool {
40        let mut decl = String::new();
41        serialize_identifier(&property.str(), &mut decl).unwrap();
42        decl.push_str(": ");
43        decl.push_str(&value.str());
44        let decl = Declaration(decl);
45        let url_data = UrlExtraData(win.Document().url().get_arc());
46        let context = parser_context_for_anonymous_content(
47            CssRuleType::Style,
48            ParsingMode::DEFAULT,
49            &url_data,
50        );
51        decl.eval(&context)
52    }
53
54    /// <https://drafts.csswg.org/css-conditional/#dom-css-supports>
55    fn Supports_(win: &Window, condition: DOMString) -> bool {
56        let condition = condition.str();
57        let mut input = ParserInput::new(&condition);
58        let mut input = Parser::new(&mut input);
59        let cond = match parse_condition_or_declaration(&mut input) {
60            Ok(c) => c,
61            Err(..) => return false,
62        };
63
64        let url_data = UrlExtraData(win.Document().url().get_arc());
65        let context = parser_context_for_anonymous_content(
66            CssRuleType::Style,
67            ParsingMode::DEFAULT,
68            &url_data,
69        );
70        cond.eval(&context)
71    }
72
73    /// <https://drafts.css-houdini.org/css-paint-api-1/#paint-worklet>
74    fn PaintWorklet(cx: &mut JSContext, win: &Window) -> DomRoot<Worklet> {
75        win.paint_worklet(cx)
76    }
77
78    /// <https://drafts.css-houdini.org/css-properties-values-api/#the-registerproperty-function>
79    fn RegisterProperty(window: &Window, property_definition: &PropertyDefinition) -> Fallible<()> {
80        use RegisterCustomPropertyResult::*;
81        let result = window.layout_mut().stylist_mut().register_custom_property(
82            &UrlExtraData(window.get_url().get_arc()),
83            &property_definition.name.str(),
84            &property_definition.syntax.str(),
85            property_definition.inherits,
86            property_definition
87                .initialValue
88                .as_ref()
89                .map(|value| value.str())
90                .as_deref(),
91        );
92        Err(match result {
93            SuccessfullyRegistered => return Ok(()),
94            InvalidName |
95            InvalidSyntax |
96            InvalidInitialValue |
97            NoInitialValue |
98            InitialValueNotComputationallyIndependent => Error::Syntax(None),
99            AlreadyRegistered => Error::InvalidModification(None),
100        })
101    }
102}