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