script/dom/
csskeyframesrule.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::cell::RefCell;
6
7use cssparser::{Parser, ParserInput};
8use dom_struct::dom_struct;
9use servo_arc::Arc;
10use style::shared_lock::{Locked, SharedRwLockReadGuard, ToCssWithGuard};
11use style::stylesheets::CssRuleType;
12use style::stylesheets::keyframes_rule::{Keyframe, KeyframeSelector, KeyframesRule};
13use style::values::KeyframesName;
14
15use crate::dom::bindings::codegen::Bindings::CSSKeyframesRuleBinding::CSSKeyframesRuleMethods;
16use crate::dom::bindings::error::ErrorResult;
17use crate::dom::bindings::inheritance::Castable;
18use crate::dom::bindings::reflector::{DomGlobal, reflect_dom_object};
19use crate::dom::bindings::root::{DomRoot, MutNullableDom};
20use crate::dom::bindings::str::DOMString;
21use crate::dom::csskeyframerule::CSSKeyframeRule;
22use crate::dom::cssrule::{CSSRule, SpecificCSSRule};
23use crate::dom::cssrulelist::{CSSRuleList, RulesSource};
24use crate::dom::cssstylesheet::CSSStyleSheet;
25use crate::dom::window::Window;
26use crate::script_runtime::CanGc;
27
28#[dom_struct]
29pub(crate) struct CSSKeyframesRule {
30    cssrule: CSSRule,
31    #[ignore_malloc_size_of = "Stylo"]
32    #[no_trace]
33    keyframesrule: RefCell<Arc<Locked<KeyframesRule>>>,
34    rulelist: MutNullableDom<CSSRuleList>,
35}
36
37impl CSSKeyframesRule {
38    fn new_inherited(
39        parent_stylesheet: &CSSStyleSheet,
40        keyframesrule: Arc<Locked<KeyframesRule>>,
41    ) -> CSSKeyframesRule {
42        CSSKeyframesRule {
43            cssrule: CSSRule::new_inherited(parent_stylesheet),
44            keyframesrule: RefCell::new(keyframesrule),
45            rulelist: MutNullableDom::new(None),
46        }
47    }
48
49    #[cfg_attr(crown, allow(crown::unrooted_must_root))]
50    pub(crate) fn new(
51        window: &Window,
52        parent_stylesheet: &CSSStyleSheet,
53        keyframesrule: Arc<Locked<KeyframesRule>>,
54        can_gc: CanGc,
55    ) -> DomRoot<CSSKeyframesRule> {
56        reflect_dom_object(
57            Box::new(CSSKeyframesRule::new_inherited(
58                parent_stylesheet,
59                keyframesrule,
60            )),
61            window,
62            can_gc,
63        )
64    }
65
66    fn rulelist(&self, can_gc: CanGc) -> DomRoot<CSSRuleList> {
67        self.rulelist.or_init(|| {
68            let parent_stylesheet = &self.upcast::<CSSRule>().parent_stylesheet();
69            CSSRuleList::new(
70                self.global().as_window(),
71                parent_stylesheet,
72                RulesSource::Keyframes(self.keyframesrule.borrow().clone()),
73                can_gc,
74            )
75        })
76    }
77
78    /// Given a keyframe selector, finds the index of the first corresponding rule if any
79    fn find_rule(&self, selector: &DOMString) -> Option<usize> {
80        let selector = selector.str();
81        let mut input = ParserInput::new(&selector);
82        let mut input = Parser::new(&mut input);
83        if let Ok(sel) = KeyframeSelector::parse(&mut input) {
84            let guard = self.cssrule.shared_lock().read();
85            // This finds the *last* element matching a selector
86            // because that's the rule that applies. Thus, rposition
87            self.keyframesrule
88                .borrow()
89                .read_with(&guard)
90                .keyframes
91                .iter()
92                .rposition(|frame| frame.read_with(&guard).selector == sel)
93        } else {
94            None
95        }
96    }
97
98    pub(crate) fn update_rule(
99        &self,
100        keyframesrule: Arc<Locked<KeyframesRule>>,
101        guard: &SharedRwLockReadGuard,
102    ) {
103        if let Some(rulelist) = self.rulelist.get() {
104            rulelist.update_rules(RulesSource::Keyframes(keyframesrule.clone()), guard);
105        }
106
107        *self.keyframesrule.borrow_mut() = keyframesrule;
108    }
109}
110
111impl CSSKeyframesRuleMethods<crate::DomTypeHolder> for CSSKeyframesRule {
112    // https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-cssrules
113    fn CssRules(&self, can_gc: CanGc) -> DomRoot<CSSRuleList> {
114        self.rulelist(can_gc)
115    }
116
117    // https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-appendrule
118    fn AppendRule(&self, rule: DOMString, can_gc: CanGc) {
119        let style_stylesheet = self.cssrule.parent_stylesheet().style_stylesheet();
120        let rule = rule.str();
121        let rule = Keyframe::parse(
122            &rule,
123            &style_stylesheet.contents,
124            &style_stylesheet.shared_lock,
125        );
126
127        if let Ok(rule) = rule {
128            self.cssrule.parent_stylesheet().will_modify();
129            let mut guard = self.cssrule.shared_lock().write();
130            self.keyframesrule
131                .borrow()
132                .write_with(&mut guard)
133                .keyframes
134                .push(rule);
135            self.rulelist(can_gc).append_lazy_dom_rule();
136            self.cssrule.parent_stylesheet().notify_invalidations();
137        }
138    }
139
140    // https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-deleterule
141    fn DeleteRule(&self, selector: DOMString, can_gc: CanGc) {
142        if let Some(idx) = self.find_rule(&selector) {
143            let _ = self.rulelist(can_gc).remove_rule(idx as u32);
144        }
145    }
146
147    // https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-findrule
148    fn FindRule(&self, selector: DOMString, can_gc: CanGc) -> Option<DomRoot<CSSKeyframeRule>> {
149        self.find_rule(&selector)
150            .and_then(|idx| self.rulelist(can_gc).item(idx as u32, can_gc))
151            .and_then(DomRoot::downcast)
152    }
153
154    // https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-name
155    fn Name(&self) -> DOMString {
156        let guard = self.cssrule.shared_lock().read();
157        DOMString::from(&**self.keyframesrule.borrow().read_with(&guard).name.as_atom())
158    }
159
160    // https://drafts.csswg.org/css-animations/#dom-csskeyframesrule-name
161    fn SetName(&self, value: DOMString) -> ErrorResult {
162        // Spec deviation: https://github.com/w3c/csswg-drafts/issues/801
163        // Setting this property to a CSS-wide keyword or `none` does not throw,
164        // it stores a value that serializes as a quoted string.
165        self.cssrule.parent_stylesheet().will_modify();
166        let name = KeyframesName::from_ident(&value.str());
167        let mut guard = self.cssrule.shared_lock().write();
168        self.keyframesrule.borrow().write_with(&mut guard).name = name;
169        self.cssrule.parent_stylesheet().notify_invalidations();
170        Ok(())
171    }
172}
173
174impl SpecificCSSRule for CSSKeyframesRule {
175    fn ty(&self) -> CssRuleType {
176        CssRuleType::Keyframes
177    }
178
179    fn get_css(&self) -> DOMString {
180        let guard = self.cssrule.shared_lock().read();
181        self.keyframesrule
182            .borrow()
183            .read_with(&guard)
184            .to_css_string(&guard)
185            .into()
186    }
187
188    fn deparent_children(&self) {
189        if let Some(list) = self.rulelist.get() {
190            list.deparent_all()
191        }
192    }
193}
script/dom/csskeyframesrule.rs

script/dom/
csskeyframesrule.rs
