components/script/dom/css/csskeyframesrule.rs - main - githubmirror/servo

components/script/dom/css/csskeyframesrule.rs
222 строки8 KB
Narfinger
script: Cleanup custom node dirty inclusive ancestor walk (#46981)
04 авг 2026, 20:35
04 авг 2026, 20:3521faece
/* 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::RefCell;

use cssparser::{Parser, ParserInput};
use dom_struct::dom_struct;
use js::context::{JSContext, NoGC};
use script_bindings::reflector::reflect_dom_object_with_cx;
use servo_arc::Arc;
use style::shared_lock::{Locked, SharedRwLockReadGuard, ToCssWithGuard};
use style::stylesheets::keyframes_rule::{Keyframe, KeyframeSelectors, KeyframesRule};
use style::stylesheets::{CssRuleType, StylesheetInDocument};
use style::values::KeyframesName;

use super::csskeyframerule::CSSKeyframeRule;
use super::cssrule::{CSSRule, SpecificCSSRule};
use super::cssrulelist::{CSSRuleList, RulesSource};
use super::cssstylesheet::CSSStyleSheet;
use crate::dom::bindings::codegen::Bindings::CSSKeyframesRuleBinding::CSSKeyframesRuleMethods;
use crate::dom::bindings::error::ErrorResult;
use crate::dom::bindings::inheritance::Castable;
use crate::dom::bindings::reflector::DomGlobal;
use crate::dom::bindings::root::{DomRoot, MutNullableDom};
use crate::dom::bindings::str::DOMString;
use crate::dom::cssgroupingrule::CSSGroupingRule;
use crate::dom::window::Window;

#[dom_struct]
pub(crate) struct CSSKeyframesRule {
    css_rule: CSSRule,
    #[ignore_malloc_size_of = "Stylo"]
    #[no_trace]
    keyframes_rule: RefCell<Arc<Locked<KeyframesRule>>>,
    rule_list: MutNullableDom<CSSRuleList>,
}

impl CSSKeyframesRule {
    fn new_inherited(
        parent_rule: Option<&CSSGroupingRule>,
        parent_stylesheet: &CSSStyleSheet,
        keyframesrule: Arc<Locked<KeyframesRule>>,
    ) -> CSSKeyframesRule {
        CSSKeyframesRule {
            css_rule: CSSRule::new_inherited(parent_rule, parent_stylesheet),
            keyframes_rule: RefCell::new(keyframesrule),
            rule_list: MutNullableDom::new(None),
        }
    }

    pub(crate) fn new(
        cx: &mut JSContext,
        window: &Window,
        parent_rule: Option<&CSSGroupingRule>,
        parent_stylesheet: &CSSStyleSheet,
        keyframesrule: Arc<Locked<KeyframesRule>>,
    ) -> DomRoot<CSSKeyframesRule> {
        reflect_dom_object_with_cx(
            Box::new(CSSKeyframesRule::new_inherited(
                parent_rule,
                parent_stylesheet,
                keyframesrule,
            )),
            window,
            cx,
        )
    }

    fn rulelist(&self, cx: &mut JSContext) -> DomRoot<CSSRuleList> {
        self.rule_list.or_init(|| {
            let parent_stylesheet = &self.upcast::<CSSRule>().parent_stylesheet();
            CSSRuleList::new(
                cx,
                self.global().as_window(),
                None,
                parent_stylesheet,
                RulesSource::Keyframes(self.keyframes_rule.borrow().clone()),
            )
        })
    }

    /// Given a keyframe selector, finds the index of the first corresponding rule if any
    fn find_rule(&self, selector: &DOMString) -> Option<usize> {
        let selector = selector.str();
        let mut input = ParserInput::new(&selector);
        let mut input = Parser::new(&mut input);
        if let Ok(sel) = KeyframeSelectors::parse(&mut input) {
            let guard = self.css_rule.shared_lock().read();
            // This finds the *last* element matching a selector
            // because that's the rule that applies. Thus, rposition
            self.keyframes_rule
                .borrow()
                .read_with(&guard)
                .keyframes
                .iter()
                .rposition(|frame| frame.read_with(&guard).selector == sel)
        } else {
            None
        }
    }

    pub(crate) fn update_rule(
        &self,
        keyframesrule: Arc<Locked<KeyframesRule>>,
        guard: &SharedRwLockReadGuard,
    ) {
        if let Some(rulelist) = self.rule_list.get() {
            rulelist.update_rules(RulesSource::Keyframes(keyframesrule.clone()), guard);
        }

        *self.keyframes_rule.borrow_mut() = keyframesrule;
    }
}

impl CSSKeyframesRuleMethods<crate::DomTypeHolder> for CSSKeyframesRule {
    /// <https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-cssrules>
    fn CssRules(&self, cx: &mut JSContext) -> DomRoot<CSSRuleList> {
        self.rulelist(cx)
    }

    /// <https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-appendrule>
    fn AppendRule(&self, no_gc: &NoGC, rule: DOMString) {
        let style_stylesheet = self.css_rule.parent_stylesheet().style_stylesheet();
        let rule = rule.str();
        let rule = {
            let guard = style_stylesheet.shared_lock.read();
            Keyframe::parse(
                &rule,
                style_stylesheet.contents(&guard),
                &style_stylesheet.shared_lock,
            )
        };

        if let Ok(rule) = rule {
            self.css_rule.parent_stylesheet().will_modify();
            {
                let mut guard = self.css_rule.shared_lock().write();
                self.keyframes_rule
                    .borrow()
                    .write_with(&mut guard)
                    .keyframes
                    .push(rule);
            }

            if let Some(rulelist) = self.rule_list.get() {
                rulelist.append_lazy_dom_rule();
            }

            self.css_rule
                .parent_stylesheet()
                .notify_invalidations(no_gc);
        }
    }

    /// <https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-deleterule>
    fn DeleteRule(&self, cx: &mut JSContext, selector: DOMString) {
        if let Some(idx) = self.find_rule(&selector) {
            let _ = self.rulelist(cx).remove_rule(cx, idx as u32);
        }
    }

    /// <https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-findrule>
    fn FindRule(
        &self,
        cx: &mut JSContext,
        selector: DOMString,
    ) -> Option<DomRoot<CSSKeyframeRule>> {
        self.find_rule(&selector)
            .and_then(|idx| self.rulelist(cx).item(cx, idx as u32))
            .and_then(DomRoot::downcast)
    }

    /// <https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-name>
    fn Name(&self) -> DOMString {
        let guard = self.css_rule.shared_lock().read();
        DOMString::from(
            &**self
                .keyframes_rule
                .borrow()
                .read_with(&guard)
                .name
                .as_atom(),
        )
    }

    /// <https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-name>
    fn SetName(&self, no_gc: &NoGC, value: DOMString) -> ErrorResult {
        // Spec deviation: https://github.com/w3c/csswg-drafts/issues/801
        // Setting this property to a CSS-wide keyword or `none` does not throw,
        // it stores a value that serializes as a quoted string.
        self.css_rule.parent_stylesheet().will_modify();
        let name = KeyframesName::from_ident(&value.str());
        let mut guard = self.css_rule.shared_lock().write();
        self.keyframes_rule.borrow().write_with(&mut guard).name = name;
        self.css_rule
            .parent_stylesheet()
            .notify_invalidations(no_gc);
        Ok(())
    }
}

impl SpecificCSSRule for CSSKeyframesRule {
    fn ty(&self) -> CssRuleType {
        CssRuleType::Keyframes
    }

    fn get_css(&self) -> DOMString {
        let guard = self.css_rule.shared_lock().read();
        self.keyframes_rule
            .borrow()
            .read_with(&guard)
            .to_css_string(&guard)
            .into()
    }

    fn deparent_children(&self) {
        if let Some(list) = self.rule_list.get() {
            list.deparent_all()
        }
    }
}