servo-script 0.2.0

A component of the servo web-engine.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

/* 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 cssparser::{Parser, ParserInput, serialize_identifier};
use dom_struct::dom_struct;
use js::context::JSContext;
use script_bindings::codegen::GenericBindings::CSSBinding::PropertyDefinition;
use style::stylesheets::supports_rule::{Declaration, parse_condition_or_declaration};
use style::stylesheets::{CssRuleType, UrlExtraData};
use style::stylist::RegisterCustomPropertyResult;
use style_traits::ParsingMode;

use crate::css::parser_context_for_anonymous_content;
use crate::dom::bindings::codegen::Bindings::CSSBinding::CSSMethods;
use crate::dom::bindings::codegen::Bindings::WindowBinding::Window_Binding::WindowMethods;
use crate::dom::bindings::error::{Error, Fallible};
use crate::dom::bindings::reflector::Reflector;
use crate::dom::bindings::root::DomRoot;
use crate::dom::bindings::str::DOMString;
use crate::dom::window::Window;
use crate::dom::worklet::Worklet;

#[dom_struct]
#[expect(clippy::upper_case_acronyms)]
pub(crate) struct CSS {
    reflector_: Reflector,
}

impl CSSMethods<crate::DomTypeHolder> for CSS {
    /// <https://drafts.csswg.org/cssom/#the-css.escape()-method>
    fn Escape(_: &Window, ident: DOMString) -> Fallible<DOMString> {
        let mut escaped = String::new();
        serialize_identifier(&ident.str(), &mut escaped).unwrap();
        Ok(DOMString::from(escaped))
    }

    /// <https://drafts.csswg.org/css-conditional/#dom-css-supports>
    fn Supports(win: &Window, property: DOMString, value: DOMString) -> bool {
        let mut decl = String::new();
        serialize_identifier(&property.str(), &mut decl).unwrap();
        decl.push_str(": ");
        decl.push_str(&value.str());
        let decl = Declaration(decl);
        let url_data = UrlExtraData(win.Document().url().get_arc());
        let context = parser_context_for_anonymous_content(
            CssRuleType::Style,
            ParsingMode::DEFAULT,
            &url_data,
        );
        decl.eval(&context)
    }

    /// <https://drafts.csswg.org/css-conditional/#dom-css-supports>
    fn Supports_(win: &Window, condition: DOMString) -> bool {
        let condition = condition.str();
        let mut input = ParserInput::new(&condition);
        let mut input = Parser::new(&mut input);
        let cond = match parse_condition_or_declaration(&mut input) {
            Ok(c) => c,
            Err(..) => return false,
        };

        let url_data = UrlExtraData(win.Document().url().get_arc());
        let context = parser_context_for_anonymous_content(
            CssRuleType::Style,
            ParsingMode::DEFAULT,
            &url_data,
        );
        cond.eval(&context)
    }

    /// <https://drafts.css-houdini.org/css-paint-api-1/#paint-worklet>
    fn PaintWorklet(cx: &mut JSContext, win: &Window) -> DomRoot<Worklet> {
        win.paint_worklet(cx)
    }

    /// <https://drafts.css-houdini.org/css-properties-values-api/#the-registerproperty-function>
    fn RegisterProperty(window: &Window, property_definition: &PropertyDefinition) -> Fallible<()> {
        use RegisterCustomPropertyResult::*;
        let result = window.layout_mut().stylist_mut().register_custom_property(
            &UrlExtraData(window.get_url().get_arc()),
            &property_definition.name.str(),
            &property_definition.syntax.str(),
            property_definition.inherits,
            property_definition
                .initialValue
                .as_ref()
                .map(|value| value.str())
                .as_deref(),
        );
        Err(match result {
            SuccessfullyRegistered => return Ok(()),
            InvalidName |
            InvalidSyntax |
            InvalidInitialValue |
            NoInitialValue |
            InitialValueNotComputationallyIndependent => Error::Syntax(None),
            AlreadyRegistered => Error::InvalidModification(None),
        })
    }
}