style/stylesheets/
media_rule.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
5//! An [`@media`][media] rule.
6//!
7//! [media]: https://drafts.csswg.org/css-conditional/#at-ruledef-media
8
9use crate::media_queries::MediaList;
10use crate::shared_lock::{DeepCloneWithLock, Locked};
11use crate::shared_lock::{SharedRwLock, SharedRwLockReadGuard, ToCssWithGuard};
12use crate::str::CssStringWriter;
13use crate::stylesheets::CssRules;
14use cssparser::SourceLocation;
15#[cfg(feature = "gecko")]
16use malloc_size_of::{MallocSizeOfOps, MallocUnconditionalShallowSizeOf};
17use servo_arc::Arc;
18use std::fmt::{self, Write};
19use style_traits::{CssWriter, ToCss};
20
21/// An [`@media`][media] rule.
22///
23/// [media]: https://drafts.csswg.org/css-conditional/#at-ruledef-media
24#[derive(Debug, ToShmem)]
25pub struct MediaRule {
26    /// The list of media queries used by this media rule.
27    pub media_queries: Arc<Locked<MediaList>>,
28    /// The nested rules to this media rule.
29    pub rules: Arc<Locked<CssRules>>,
30    /// The source position where this media rule was found.
31    pub source_location: SourceLocation,
32}
33
34impl MediaRule {
35    /// Measure heap usage.
36    #[cfg(feature = "gecko")]
37    pub fn size_of(&self, guard: &SharedRwLockReadGuard, ops: &mut MallocSizeOfOps) -> usize {
38        // Measurement of other fields may be added later.
39        self.rules.unconditional_shallow_size_of(ops)
40            + self.rules.read_with(guard).size_of(guard, ops)
41    }
42}
43
44impl ToCssWithGuard for MediaRule {
45    // Serialization of MediaRule is not specced.
46    // https://drafts.csswg.org/cssom/#serialize-a-css-rule CSSMediaRule
47    fn to_css(&self, guard: &SharedRwLockReadGuard, dest: &mut CssStringWriter) -> fmt::Result {
48        dest.write_str("@media ")?;
49        self.media_queries
50            .read_with(guard)
51            .to_css(&mut CssWriter::new(dest))?;
52        self.rules.read_with(guard).to_css_block(guard, dest)
53    }
54}
55
56impl DeepCloneWithLock for MediaRule {
57    fn deep_clone_with_lock(&self, lock: &SharedRwLock, guard: &SharedRwLockReadGuard) -> Self {
58        let media_queries = self.media_queries.read_with(guard);
59        let rules = self.rules.read_with(guard);
60        MediaRule {
61            media_queries: Arc::new(lock.wrap(media_queries.clone())),
62            rules: Arc::new(lock.wrap(rules.deep_clone_with_lock(lock, guard))),
63            source_location: self.source_location.clone(),
64        }
65    }
66}
style/stylesheets/media_rule.rs

style/stylesheets/
media_rule.rs
