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