Quelle  ratio.rs

/* 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/. */

//! Generic types for CSS values related to <ratio>.
//! https://drafts.csswg.org/css-values/#ratios

use std::fmt::{self, Write};
use style_traits::{CssWriter, ToCss};
use crate::{One, Zero};

/// A generic value for the `<ratio>` value.
#[derive(
    Clone,
    Copy,
    Debug,
    MallocSizeOf,
    PartialEq,
    SpecifiedValueInfo,
    ToAnimatedValue,
    ToComputedValue,
    ToResolvedValue,
    ToShmem,
)]
#[repr(C)]
pub struct Ratio<N>(pub N, pub N);

impl<N> ToCss for Ratio<N>
where
    N: ToCss,
{
    fn to_css<W>(&self, dest: &mut CssWriter<W>) -> fmt::Result
    where
        W: Write,
    {
        self.0.to_css(dest)?;
        // Even though 1 could be omitted, we don't per
        // https://drafts.csswg.org/css-values-4/#ratio-value:
        //
        //     The second <number> is optional, defaulting to 1. However,
        //     <ratio> is always serialized with both components.
        //
        // And for compat reasons, see bug 1669742.
        //
        // We serialize with spaces for consistency with all other
        // slash-delimited things, see
        // https://github.com/w3c/csswg-drafts/issues/4282
        dest.write_str(" / ")?;
        self.1.to_css(dest)?;
        Ok(())
    }
}

impl<N> Ratio<N>
where
    N: Zero + One,
{
    /// Returns true if this is a degenerate ratio.
    /// https://drafts.csswg.org/css-values/#degenerate-ratio
    #[inline]
    pub fn is_degenerate(&self) -> bool {
        self.0.is_zero() || self.1.is_zero()
    }

    /// Returns the used value. A ratio of 0/0 behaves as the ratio 1/0.
    /// https://drafts.csswg.org/css-values-4/#ratios
    pub fn used_value(self) -> Self {
        if self.0.is_zero() && self.1.is_zero() {
            Self(One::one(), Zero::zero())
        } else {
            self
        }
    }
}

impl<N> Zero for Ratio<N>
where
    N: Zero + One,
{
    fn zero() -> Self {
        Self(Zero::zero(), One::one())
    }

    fn is_zero(&self) -> bool {
        self.0.is_zero()
    }
}