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

script/dom/css/
csskeyframesrule.rs
