mirror of
https://github.com/servo/servo.git
synced 2025-06-06 16:45:39 +00:00
c2819365f0
MozLength is not a very descriptive name. If we're going to use it in both Gecko and Servo we may as well name it something more accurate. I would've chosen `ContentSize` per CSS2[1][2] if it wasn't a lie in presence of box-sizing. I don't have better ideas than `Size`, given that. [1]: https://drafts.csswg.org/css2/visudet.html#propdef-width [2]: https://drafts.csswg.org/css2/box.html#content-width Differential Revision: https://phabricator.services.mozilla.com/D19280
1125 lines
38 KiB
Rust
1125 lines
38 KiB
Rust
/* 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/. */
|
|
|
|
//! [Length values][length].
|
|
//!
|
|
//! [length]: https://drafts.csswg.org/css-values/#lengths
|
|
|
|
use super::{AllowQuirks, Number, Percentage, ToComputedValue};
|
|
use crate::font_metrics::FontMetricsQueryResult;
|
|
use crate::parser::{Parse, ParserContext};
|
|
use crate::values::computed::{self, CSSPixelLength, Context};
|
|
use crate::values::generics::length as generics;
|
|
use crate::values::generics::length::{MaxSize as GenericMaxSize, Size as GenericSize};
|
|
use crate::values::generics::transform::IsZeroLength;
|
|
use crate::values::generics::NonNegative;
|
|
use crate::values::specified::calc::CalcNode;
|
|
use crate::values::{Auto, CSSFloat, Either, Normal};
|
|
use app_units::Au;
|
|
use cssparser::{Parser, Token};
|
|
use euclid::Size2D;
|
|
use std::cmp;
|
|
use std::ops::{Add, Mul};
|
|
use style_traits::values::specified::AllowedNumericType;
|
|
use style_traits::{ParseError, SpecifiedValueInfo, StyleParseErrorKind};
|
|
|
|
pub use super::image::{ColorStop, EndingShape as GradientEndingShape, Gradient};
|
|
pub use super::image::{GradientKind, Image};
|
|
pub use crate::values::specified::calc::CalcLengthPercentage;
|
|
|
|
/// Number of app units per pixel
|
|
pub const AU_PER_PX: CSSFloat = 60.;
|
|
/// Number of app units per inch
|
|
pub const AU_PER_IN: CSSFloat = AU_PER_PX * 96.;
|
|
/// Number of app units per centimeter
|
|
pub const AU_PER_CM: CSSFloat = AU_PER_IN / 2.54;
|
|
/// Number of app units per millimeter
|
|
pub const AU_PER_MM: CSSFloat = AU_PER_IN / 25.4;
|
|
/// Number of app units per quarter
|
|
pub const AU_PER_Q: CSSFloat = AU_PER_MM / 4.;
|
|
/// Number of app units per point
|
|
pub const AU_PER_PT: CSSFloat = AU_PER_IN / 72.;
|
|
/// Number of app units per pica
|
|
pub const AU_PER_PC: CSSFloat = AU_PER_PT * 12.;
|
|
|
|
/// Same as Gecko's AppUnitsToIntCSSPixels
|
|
///
|
|
/// Converts app units to integer pixel values,
|
|
/// rounding during the conversion
|
|
pub fn au_to_int_px(au: f32) -> i32 {
|
|
(au / AU_PER_PX).round() as i32
|
|
}
|
|
|
|
/// A font relative length.
|
|
#[derive(Clone, Copy, Debug, MallocSizeOf, PartialEq, ToCss)]
|
|
pub enum FontRelativeLength {
|
|
/// A "em" value: https://drafts.csswg.org/css-values/#em
|
|
#[css(dimension)]
|
|
Em(CSSFloat),
|
|
/// A "ex" value: https://drafts.csswg.org/css-values/#ex
|
|
#[css(dimension)]
|
|
Ex(CSSFloat),
|
|
/// A "ch" value: https://drafts.csswg.org/css-values/#ch
|
|
#[css(dimension)]
|
|
Ch(CSSFloat),
|
|
/// A "rem" value: https://drafts.csswg.org/css-values/#rem
|
|
#[css(dimension)]
|
|
Rem(CSSFloat),
|
|
}
|
|
|
|
/// A source to resolve font-relative units against
|
|
#[derive(Clone, Copy, Debug, PartialEq)]
|
|
pub enum FontBaseSize {
|
|
/// Use the font-size of the current element.
|
|
CurrentStyle,
|
|
/// Use the inherited font-size.
|
|
InheritedStyle,
|
|
/// Use the inherited font-size, but strip em units.
|
|
///
|
|
/// FIXME(emilio): This is very complex, and should go away.
|
|
InheritedStyleButStripEmUnits,
|
|
/// Use a custom base size.
|
|
///
|
|
/// FIXME(emilio): This is very dubious, and only used for MathML.
|
|
Custom(Au),
|
|
}
|
|
|
|
impl FontBaseSize {
|
|
/// Calculate the actual size for a given context
|
|
pub fn resolve(&self, context: &Context) -> Au {
|
|
match *self {
|
|
FontBaseSize::Custom(size) => size,
|
|
FontBaseSize::CurrentStyle => context.style().get_font().clone_font_size().size(),
|
|
FontBaseSize::InheritedStyleButStripEmUnits | FontBaseSize::InheritedStyle => {
|
|
context.style().get_parent_font().clone_font_size().size()
|
|
},
|
|
}
|
|
}
|
|
}
|
|
|
|
impl FontRelativeLength {
|
|
/// Return true if this is a zero value.
|
|
fn is_zero(&self) -> bool {
|
|
match *self {
|
|
FontRelativeLength::Em(v) |
|
|
FontRelativeLength::Ex(v) |
|
|
FontRelativeLength::Ch(v) |
|
|
FontRelativeLength::Rem(v) => v == 0.0,
|
|
}
|
|
}
|
|
|
|
/// Computes the font-relative length.
|
|
pub fn to_computed_value(&self, context: &Context, base_size: FontBaseSize) -> CSSPixelLength {
|
|
use std::f32;
|
|
let (reference_size, length) = self.reference_font_size_and_length(context, base_size);
|
|
let pixel = (length * reference_size.to_f32_px())
|
|
.min(f32::MAX)
|
|
.max(f32::MIN);
|
|
CSSPixelLength::new(pixel)
|
|
}
|
|
|
|
/// Return reference font size.
|
|
///
|
|
/// We use the base_size flag to pass a different size for computing
|
|
/// font-size and unconstrained font-size.
|
|
///
|
|
/// This returns a pair, the first one is the reference font size, and the
|
|
/// second one is the unpacked relative length.
|
|
fn reference_font_size_and_length(
|
|
&self,
|
|
context: &Context,
|
|
base_size: FontBaseSize,
|
|
) -> (Au, CSSFloat) {
|
|
fn query_font_metrics(
|
|
context: &Context,
|
|
reference_font_size: Au,
|
|
) -> FontMetricsQueryResult {
|
|
context.font_metrics_provider.query(
|
|
context.style().get_font(),
|
|
reference_font_size,
|
|
context.style().writing_mode,
|
|
context.in_media_query,
|
|
context.device(),
|
|
)
|
|
}
|
|
|
|
let reference_font_size = base_size.resolve(context);
|
|
match *self {
|
|
FontRelativeLength::Em(length) => {
|
|
if context.for_non_inherited_property.is_some() {
|
|
if base_size == FontBaseSize::CurrentStyle {
|
|
context
|
|
.rule_cache_conditions
|
|
.borrow_mut()
|
|
.set_font_size_dependency(reference_font_size.into());
|
|
}
|
|
}
|
|
|
|
if base_size == FontBaseSize::InheritedStyleButStripEmUnits {
|
|
(Au(0), length)
|
|
} else {
|
|
(reference_font_size, length)
|
|
}
|
|
},
|
|
FontRelativeLength::Ex(length) => {
|
|
if context.for_non_inherited_property.is_some() {
|
|
context.rule_cache_conditions.borrow_mut().set_uncacheable();
|
|
}
|
|
let reference_size = match query_font_metrics(context, reference_font_size) {
|
|
FontMetricsQueryResult::Available(metrics) => metrics.x_height,
|
|
// https://drafts.csswg.org/css-values/#ex
|
|
//
|
|
// In the cases where it is impossible or impractical to
|
|
// determine the x-height, a value of 0.5em must be
|
|
// assumed.
|
|
//
|
|
FontMetricsQueryResult::NotAvailable => reference_font_size.scale_by(0.5),
|
|
};
|
|
(reference_size, length)
|
|
},
|
|
FontRelativeLength::Ch(length) => {
|
|
if context.for_non_inherited_property.is_some() {
|
|
context.rule_cache_conditions.borrow_mut().set_uncacheable();
|
|
}
|
|
let reference_size = match query_font_metrics(context, reference_font_size) {
|
|
FontMetricsQueryResult::Available(metrics) => metrics.zero_advance_measure,
|
|
// https://drafts.csswg.org/css-values/#ch
|
|
//
|
|
// In the cases where it is impossible or impractical to
|
|
// determine the measure of the “0” glyph, it must be
|
|
// assumed to be 0.5em wide by 1em tall. Thus, the ch
|
|
// unit falls back to 0.5em in the general case, and to
|
|
// 1em when it would be typeset upright (i.e.
|
|
// writing-mode is vertical-rl or vertical-lr and
|
|
// text-orientation is upright).
|
|
//
|
|
FontMetricsQueryResult::NotAvailable => {
|
|
if context.style().writing_mode.is_vertical() {
|
|
reference_font_size
|
|
} else {
|
|
reference_font_size.scale_by(0.5)
|
|
}
|
|
},
|
|
};
|
|
(reference_size, length)
|
|
},
|
|
FontRelativeLength::Rem(length) => {
|
|
// https://drafts.csswg.org/css-values/#rem:
|
|
//
|
|
// When specified on the font-size property of the root
|
|
// element, the rem units refer to the property's initial
|
|
// value.
|
|
//
|
|
let reference_size = if context.is_root_element || context.in_media_query {
|
|
reference_font_size
|
|
} else {
|
|
context.device().root_font_size()
|
|
};
|
|
(reference_size, length)
|
|
},
|
|
}
|
|
}
|
|
}
|
|
|
|
/// A viewport-relative length.
|
|
///
|
|
/// <https://drafts.csswg.org/css-values/#viewport-relative-lengths>
|
|
#[derive(Clone, Copy, Debug, MallocSizeOf, PartialEq, ToCss)]
|
|
pub enum ViewportPercentageLength {
|
|
/// A vw unit: https://drafts.csswg.org/css-values/#vw
|
|
#[css(dimension)]
|
|
Vw(CSSFloat),
|
|
/// A vh unit: https://drafts.csswg.org/css-values/#vh
|
|
#[css(dimension)]
|
|
Vh(CSSFloat),
|
|
/// <https://drafts.csswg.org/css-values/#vmin>
|
|
#[css(dimension)]
|
|
Vmin(CSSFloat),
|
|
/// <https://drafts.csswg.org/css-values/#vmax>
|
|
#[css(dimension)]
|
|
Vmax(CSSFloat),
|
|
}
|
|
|
|
impl ViewportPercentageLength {
|
|
/// Return true if this is a zero value.
|
|
fn is_zero(&self) -> bool {
|
|
match *self {
|
|
ViewportPercentageLength::Vw(v) |
|
|
ViewportPercentageLength::Vh(v) |
|
|
ViewportPercentageLength::Vmin(v) |
|
|
ViewportPercentageLength::Vmax(v) => v == 0.0,
|
|
}
|
|
}
|
|
|
|
/// Computes the given viewport-relative length for the given viewport size.
|
|
pub fn to_computed_value(&self, viewport_size: Size2D<Au>) -> CSSPixelLength {
|
|
let (factor, length) = match *self {
|
|
ViewportPercentageLength::Vw(length) => (length, viewport_size.width),
|
|
ViewportPercentageLength::Vh(length) => (length, viewport_size.height),
|
|
ViewportPercentageLength::Vmin(length) => {
|
|
(length, cmp::min(viewport_size.width, viewport_size.height))
|
|
},
|
|
ViewportPercentageLength::Vmax(length) => {
|
|
(length, cmp::max(viewport_size.width, viewport_size.height))
|
|
},
|
|
};
|
|
|
|
// FIXME: Bug 1396535, we need to fix the extremely small viewport length for transform.
|
|
// See bug 989802. We truncate so that adding multiple viewport units
|
|
// that add up to 100 does not overflow due to rounding differences
|
|
let trunc_scaled = ((length.0 as f64) * factor as f64 / 100.).trunc();
|
|
Au::from_f64_au(trunc_scaled).into()
|
|
}
|
|
}
|
|
|
|
/// HTML5 "character width", as defined in HTML5 § 14.5.4.
|
|
#[derive(Clone, Copy, Debug, MallocSizeOf, PartialEq, ToCss)]
|
|
pub struct CharacterWidth(pub i32);
|
|
|
|
impl CharacterWidth {
|
|
/// Computes the given character width.
|
|
pub fn to_computed_value(&self, reference_font_size: Au) -> CSSPixelLength {
|
|
// This applies the *converting a character width to pixels* algorithm as specified
|
|
// in HTML5 § 14.5.4.
|
|
//
|
|
// TODO(pcwalton): Find these from the font.
|
|
let average_advance = reference_font_size.scale_by(0.5);
|
|
let max_advance = reference_font_size;
|
|
let au = average_advance.scale_by(self.0 as CSSFloat - 1.0) + max_advance;
|
|
au.into()
|
|
}
|
|
}
|
|
|
|
/// Represents an absolute length with its unit
|
|
#[derive(Clone, Copy, Debug, MallocSizeOf, PartialEq, ToCss)]
|
|
pub enum AbsoluteLength {
|
|
/// An absolute length in pixels (px)
|
|
#[css(dimension)]
|
|
Px(CSSFloat),
|
|
/// An absolute length in inches (in)
|
|
#[css(dimension)]
|
|
In(CSSFloat),
|
|
/// An absolute length in centimeters (cm)
|
|
#[css(dimension)]
|
|
Cm(CSSFloat),
|
|
/// An absolute length in millimeters (mm)
|
|
#[css(dimension)]
|
|
Mm(CSSFloat),
|
|
/// An absolute length in quarter-millimeters (q)
|
|
#[css(dimension)]
|
|
Q(CSSFloat),
|
|
/// An absolute length in points (pt)
|
|
#[css(dimension)]
|
|
Pt(CSSFloat),
|
|
/// An absolute length in pica (pc)
|
|
#[css(dimension)]
|
|
Pc(CSSFloat),
|
|
}
|
|
|
|
impl AbsoluteLength {
|
|
fn is_zero(&self) -> bool {
|
|
match *self {
|
|
AbsoluteLength::Px(v) |
|
|
AbsoluteLength::In(v) |
|
|
AbsoluteLength::Cm(v) |
|
|
AbsoluteLength::Mm(v) |
|
|
AbsoluteLength::Q(v) |
|
|
AbsoluteLength::Pt(v) |
|
|
AbsoluteLength::Pc(v) => v == 0.,
|
|
}
|
|
}
|
|
|
|
/// Convert this into a pixel value.
|
|
#[inline]
|
|
pub fn to_px(&self) -> CSSFloat {
|
|
use std::f32;
|
|
|
|
let pixel = match *self {
|
|
AbsoluteLength::Px(value) => value,
|
|
AbsoluteLength::In(value) => value * (AU_PER_IN / AU_PER_PX),
|
|
AbsoluteLength::Cm(value) => value * (AU_PER_CM / AU_PER_PX),
|
|
AbsoluteLength::Mm(value) => value * (AU_PER_MM / AU_PER_PX),
|
|
AbsoluteLength::Q(value) => value * (AU_PER_Q / AU_PER_PX),
|
|
AbsoluteLength::Pt(value) => value * (AU_PER_PT / AU_PER_PX),
|
|
AbsoluteLength::Pc(value) => value * (AU_PER_PC / AU_PER_PX),
|
|
};
|
|
pixel.min(f32::MAX).max(f32::MIN)
|
|
}
|
|
}
|
|
|
|
impl ToComputedValue for AbsoluteLength {
|
|
type ComputedValue = CSSPixelLength;
|
|
|
|
fn to_computed_value(&self, _: &Context) -> Self::ComputedValue {
|
|
CSSPixelLength::new(self.to_px())
|
|
}
|
|
|
|
fn from_computed_value(computed: &Self::ComputedValue) -> Self {
|
|
AbsoluteLength::Px(computed.px())
|
|
}
|
|
}
|
|
|
|
impl Mul<CSSFloat> for AbsoluteLength {
|
|
type Output = AbsoluteLength;
|
|
|
|
#[inline]
|
|
fn mul(self, scalar: CSSFloat) -> AbsoluteLength {
|
|
match self {
|
|
AbsoluteLength::Px(v) => AbsoluteLength::Px(v * scalar),
|
|
AbsoluteLength::In(v) => AbsoluteLength::In(v * scalar),
|
|
AbsoluteLength::Cm(v) => AbsoluteLength::Cm(v * scalar),
|
|
AbsoluteLength::Mm(v) => AbsoluteLength::Mm(v * scalar),
|
|
AbsoluteLength::Q(v) => AbsoluteLength::Q(v * scalar),
|
|
AbsoluteLength::Pt(v) => AbsoluteLength::Pt(v * scalar),
|
|
AbsoluteLength::Pc(v) => AbsoluteLength::Pc(v * scalar),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl Add<AbsoluteLength> for AbsoluteLength {
|
|
type Output = Self;
|
|
|
|
#[inline]
|
|
fn add(self, rhs: Self) -> Self {
|
|
match (self, rhs) {
|
|
(AbsoluteLength::Px(x), AbsoluteLength::Px(y)) => AbsoluteLength::Px(x + y),
|
|
(AbsoluteLength::In(x), AbsoluteLength::In(y)) => AbsoluteLength::In(x + y),
|
|
(AbsoluteLength::Cm(x), AbsoluteLength::Cm(y)) => AbsoluteLength::Cm(x + y),
|
|
(AbsoluteLength::Mm(x), AbsoluteLength::Mm(y)) => AbsoluteLength::Mm(x + y),
|
|
(AbsoluteLength::Q(x), AbsoluteLength::Q(y)) => AbsoluteLength::Q(x + y),
|
|
(AbsoluteLength::Pt(x), AbsoluteLength::Pt(y)) => AbsoluteLength::Pt(x + y),
|
|
(AbsoluteLength::Pc(x), AbsoluteLength::Pc(y)) => AbsoluteLength::Pc(x + y),
|
|
_ => AbsoluteLength::Px(self.to_px() + rhs.to_px()),
|
|
}
|
|
}
|
|
}
|
|
|
|
/// A `<length>` without taking `calc` expressions into account
|
|
///
|
|
/// <https://drafts.csswg.org/css-values/#lengths>
|
|
#[derive(Clone, Copy, Debug, MallocSizeOf, PartialEq, ToCss)]
|
|
pub enum NoCalcLength {
|
|
/// An absolute length
|
|
///
|
|
/// <https://drafts.csswg.org/css-values/#absolute-length>
|
|
Absolute(AbsoluteLength),
|
|
|
|
/// A font-relative length:
|
|
///
|
|
/// <https://drafts.csswg.org/css-values/#font-relative-lengths>
|
|
FontRelative(FontRelativeLength),
|
|
|
|
/// A viewport-relative length.
|
|
///
|
|
/// <https://drafts.csswg.org/css-values/#viewport-relative-lengths>
|
|
ViewportPercentage(ViewportPercentageLength),
|
|
|
|
/// HTML5 "character width", as defined in HTML5 § 14.5.4.
|
|
///
|
|
/// This cannot be specified by the user directly and is only generated by
|
|
/// `Stylist::synthesize_rules_for_legacy_attributes()`.
|
|
#[css(function)]
|
|
ServoCharacterWidth(CharacterWidth),
|
|
}
|
|
|
|
impl Mul<CSSFloat> for NoCalcLength {
|
|
type Output = NoCalcLength;
|
|
|
|
#[inline]
|
|
fn mul(self, scalar: CSSFloat) -> NoCalcLength {
|
|
match self {
|
|
NoCalcLength::Absolute(v) => NoCalcLength::Absolute(v * scalar),
|
|
NoCalcLength::FontRelative(v) => NoCalcLength::FontRelative(v * scalar),
|
|
NoCalcLength::ViewportPercentage(v) => NoCalcLength::ViewportPercentage(v * scalar),
|
|
NoCalcLength::ServoCharacterWidth(_) => panic!("Can't multiply ServoCharacterWidth!"),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl NoCalcLength {
|
|
/// Parse a given absolute or relative dimension.
|
|
pub fn parse_dimension(
|
|
context: &ParserContext,
|
|
value: CSSFloat,
|
|
unit: &str,
|
|
) -> Result<Self, ()> {
|
|
Ok(match_ignore_ascii_case! { unit,
|
|
"px" => NoCalcLength::Absolute(AbsoluteLength::Px(value)),
|
|
"in" => NoCalcLength::Absolute(AbsoluteLength::In(value)),
|
|
"cm" => NoCalcLength::Absolute(AbsoluteLength::Cm(value)),
|
|
"mm" => NoCalcLength::Absolute(AbsoluteLength::Mm(value)),
|
|
"q" => NoCalcLength::Absolute(AbsoluteLength::Q(value)),
|
|
"pt" => NoCalcLength::Absolute(AbsoluteLength::Pt(value)),
|
|
"pc" => NoCalcLength::Absolute(AbsoluteLength::Pc(value)),
|
|
// font-relative
|
|
"em" => NoCalcLength::FontRelative(FontRelativeLength::Em(value)),
|
|
"ex" => NoCalcLength::FontRelative(FontRelativeLength::Ex(value)),
|
|
"ch" => NoCalcLength::FontRelative(FontRelativeLength::Ch(value)),
|
|
"rem" => NoCalcLength::FontRelative(FontRelativeLength::Rem(value)),
|
|
// viewport percentages
|
|
"vw" if !context.in_page_rule() => {
|
|
NoCalcLength::ViewportPercentage(ViewportPercentageLength::Vw(value))
|
|
}
|
|
"vh" if !context.in_page_rule() => {
|
|
NoCalcLength::ViewportPercentage(ViewportPercentageLength::Vh(value))
|
|
}
|
|
"vmin" if !context.in_page_rule() => {
|
|
NoCalcLength::ViewportPercentage(ViewportPercentageLength::Vmin(value))
|
|
}
|
|
"vmax" if !context.in_page_rule() => {
|
|
NoCalcLength::ViewportPercentage(ViewportPercentageLength::Vmax(value))
|
|
}
|
|
_ => return Err(())
|
|
})
|
|
}
|
|
|
|
#[inline]
|
|
/// Returns a `zero` length.
|
|
pub fn zero() -> NoCalcLength {
|
|
NoCalcLength::Absolute(AbsoluteLength::Px(0.))
|
|
}
|
|
|
|
#[inline]
|
|
/// Checks whether the length value is zero.
|
|
pub fn is_zero(&self) -> bool {
|
|
match *self {
|
|
NoCalcLength::Absolute(length) => length.is_zero(),
|
|
_ => false,
|
|
}
|
|
}
|
|
|
|
/// Get a px value without context.
|
|
#[inline]
|
|
pub fn to_computed_pixel_length_without_context(&self) -> Result<CSSFloat, ()> {
|
|
match *self {
|
|
NoCalcLength::Absolute(len) => Ok(len.to_px()),
|
|
_ => Err(()),
|
|
}
|
|
}
|
|
|
|
/// Get an absolute length from a px value.
|
|
#[inline]
|
|
pub fn from_px(px_value: CSSFloat) -> NoCalcLength {
|
|
NoCalcLength::Absolute(AbsoluteLength::Px(px_value))
|
|
}
|
|
}
|
|
|
|
impl SpecifiedValueInfo for NoCalcLength {}
|
|
|
|
impl IsZeroLength for NoCalcLength {
|
|
#[inline]
|
|
fn is_zero_length(&self) -> bool {
|
|
match *self {
|
|
NoCalcLength::Absolute(v) => v.is_zero(),
|
|
NoCalcLength::FontRelative(v) => v.is_zero(),
|
|
NoCalcLength::ViewportPercentage(v) => v.is_zero(),
|
|
NoCalcLength::ServoCharacterWidth(v) => v.0 == 0,
|
|
}
|
|
}
|
|
}
|
|
|
|
/// An extension to `NoCalcLength` to parse `calc` expressions.
|
|
/// This is commonly used for the `<length>` values.
|
|
///
|
|
/// <https://drafts.csswg.org/css-values/#lengths>
|
|
#[derive(Clone, Debug, MallocSizeOf, PartialEq, SpecifiedValueInfo, ToCss)]
|
|
pub enum Length {
|
|
/// The internal length type that cannot parse `calc`
|
|
NoCalc(NoCalcLength),
|
|
/// A calc expression.
|
|
///
|
|
/// <https://drafts.csswg.org/css-values/#calc-notation>
|
|
Calc(Box<CalcLengthPercentage>),
|
|
}
|
|
|
|
impl From<NoCalcLength> for Length {
|
|
#[inline]
|
|
fn from(len: NoCalcLength) -> Self {
|
|
Length::NoCalc(len)
|
|
}
|
|
}
|
|
|
|
impl Mul<CSSFloat> for Length {
|
|
type Output = Length;
|
|
|
|
#[inline]
|
|
fn mul(self, scalar: CSSFloat) -> Length {
|
|
match self {
|
|
Length::NoCalc(inner) => Length::NoCalc(inner * scalar),
|
|
Length::Calc(..) => panic!("Can't multiply Calc!"),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl Mul<CSSFloat> for FontRelativeLength {
|
|
type Output = FontRelativeLength;
|
|
|
|
#[inline]
|
|
fn mul(self, scalar: CSSFloat) -> FontRelativeLength {
|
|
match self {
|
|
FontRelativeLength::Em(v) => FontRelativeLength::Em(v * scalar),
|
|
FontRelativeLength::Ex(v) => FontRelativeLength::Ex(v * scalar),
|
|
FontRelativeLength::Ch(v) => FontRelativeLength::Ch(v * scalar),
|
|
FontRelativeLength::Rem(v) => FontRelativeLength::Rem(v * scalar),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl Mul<CSSFloat> for ViewportPercentageLength {
|
|
type Output = ViewportPercentageLength;
|
|
|
|
#[inline]
|
|
fn mul(self, scalar: CSSFloat) -> ViewportPercentageLength {
|
|
match self {
|
|
ViewportPercentageLength::Vw(v) => ViewportPercentageLength::Vw(v * scalar),
|
|
ViewportPercentageLength::Vh(v) => ViewportPercentageLength::Vh(v * scalar),
|
|
ViewportPercentageLength::Vmin(v) => ViewportPercentageLength::Vmin(v * scalar),
|
|
ViewportPercentageLength::Vmax(v) => ViewportPercentageLength::Vmax(v * scalar),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl Length {
|
|
#[inline]
|
|
/// Returns a `zero` length.
|
|
pub fn zero() -> Length {
|
|
Length::NoCalc(NoCalcLength::zero())
|
|
}
|
|
|
|
#[inline]
|
|
fn parse_internal<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
num_context: AllowedNumericType,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
// FIXME: remove early returns when lifetimes are non-lexical
|
|
{
|
|
let location = input.current_source_location();
|
|
let token = input.next()?;
|
|
match *token {
|
|
Token::Dimension {
|
|
value, ref unit, ..
|
|
} if num_context.is_ok(context.parsing_mode, value) => {
|
|
return NoCalcLength::parse_dimension(context, value, unit)
|
|
.map(Length::NoCalc)
|
|
.map_err(|()| location.new_unexpected_token_error(token.clone()));
|
|
},
|
|
Token::Number { value, .. } if num_context.is_ok(context.parsing_mode, value) => {
|
|
if value != 0. &&
|
|
!context.parsing_mode.allows_unitless_lengths() &&
|
|
!allow_quirks.allowed(context.quirks_mode)
|
|
{
|
|
return Err(location.new_custom_error(StyleParseErrorKind::UnspecifiedError));
|
|
}
|
|
return Ok(Length::NoCalc(NoCalcLength::Absolute(AbsoluteLength::Px(
|
|
value,
|
|
))));
|
|
},
|
|
Token::Function(ref name) if name.eq_ignore_ascii_case("calc") => {},
|
|
ref token => return Err(location.new_unexpected_token_error(token.clone())),
|
|
}
|
|
}
|
|
input.parse_nested_block(|input| {
|
|
CalcNode::parse_length(context, input, num_context)
|
|
.map(|calc| Length::Calc(Box::new(calc)))
|
|
})
|
|
}
|
|
|
|
/// Parse a non-negative length
|
|
#[inline]
|
|
pub fn parse_non_negative<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_non_negative_quirky(context, input, AllowQuirks::No)
|
|
}
|
|
|
|
/// Parse a non-negative length, allowing quirks.
|
|
#[inline]
|
|
pub fn parse_non_negative_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_internal(
|
|
context,
|
|
input,
|
|
AllowedNumericType::NonNegative,
|
|
allow_quirks,
|
|
)
|
|
}
|
|
|
|
/// Get an absolute length from a px value.
|
|
#[inline]
|
|
pub fn from_px(px_value: CSSFloat) -> Length {
|
|
Length::NoCalc(NoCalcLength::from_px(px_value))
|
|
}
|
|
}
|
|
|
|
impl Parse for Length {
|
|
fn parse<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_quirky(context, input, AllowQuirks::No)
|
|
}
|
|
}
|
|
|
|
impl Length {
|
|
/// Parses a length, with quirks.
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_internal(context, input, AllowedNumericType::All, allow_quirks)
|
|
}
|
|
}
|
|
|
|
/// A wrapper of Length, whose value must be >= 0.
|
|
pub type NonNegativeLength = NonNegative<Length>;
|
|
|
|
impl Parse for NonNegativeLength {
|
|
#[inline]
|
|
fn parse<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Ok(NonNegative(Length::parse_non_negative(context, input)?))
|
|
}
|
|
}
|
|
|
|
impl From<NoCalcLength> for NonNegativeLength {
|
|
#[inline]
|
|
fn from(len: NoCalcLength) -> Self {
|
|
NonNegative::<Length>(Length::NoCalc(len))
|
|
}
|
|
}
|
|
|
|
impl From<Length> for NonNegativeLength {
|
|
#[inline]
|
|
fn from(len: Length) -> Self {
|
|
NonNegative::<Length>(len)
|
|
}
|
|
}
|
|
|
|
impl NonNegativeLength {
|
|
/// Returns a `zero` length.
|
|
#[inline]
|
|
pub fn zero() -> Self {
|
|
Length::zero().into()
|
|
}
|
|
|
|
/// Get an absolute length from a px value.
|
|
#[inline]
|
|
pub fn from_px(px_value: CSSFloat) -> Self {
|
|
Length::from_px(px_value.max(0.)).into()
|
|
}
|
|
|
|
/// Parses a non-negative length, optionally with quirks.
|
|
#[inline]
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Ok(NonNegative(Length::parse_non_negative_quirky(
|
|
context,
|
|
input,
|
|
allow_quirks,
|
|
)?))
|
|
}
|
|
}
|
|
|
|
/// Either a NonNegativeLength or the `auto` keyword.
|
|
pub type NonNegativeLengthOrAuto = Either<NonNegativeLength, Auto>;
|
|
|
|
/// A `<length-percentage>` value. This can be either a `<length>`, a
|
|
/// `<percentage>`, or a combination of both via `calc()`.
|
|
///
|
|
/// https://drafts.csswg.org/css-values-4/#typedef-length-percentage
|
|
#[allow(missing_docs)]
|
|
#[derive(Clone, Debug, MallocSizeOf, PartialEq, SpecifiedValueInfo, ToCss)]
|
|
pub enum LengthPercentage {
|
|
Length(NoCalcLength),
|
|
Percentage(computed::Percentage),
|
|
Calc(Box<CalcLengthPercentage>),
|
|
}
|
|
|
|
impl From<Length> for LengthPercentage {
|
|
fn from(len: Length) -> LengthPercentage {
|
|
match len {
|
|
Length::NoCalc(l) => LengthPercentage::Length(l),
|
|
Length::Calc(l) => LengthPercentage::Calc(l),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl From<NoCalcLength> for LengthPercentage {
|
|
#[inline]
|
|
fn from(len: NoCalcLength) -> Self {
|
|
LengthPercentage::Length(len)
|
|
}
|
|
}
|
|
|
|
impl From<Percentage> for LengthPercentage {
|
|
#[inline]
|
|
fn from(pc: Percentage) -> Self {
|
|
if pc.is_calc() {
|
|
LengthPercentage::Calc(Box::new(CalcLengthPercentage {
|
|
percentage: Some(computed::Percentage(pc.get())),
|
|
..Default::default()
|
|
}))
|
|
} else {
|
|
LengthPercentage::Percentage(computed::Percentage(pc.get()))
|
|
}
|
|
}
|
|
}
|
|
|
|
impl From<computed::Percentage> for LengthPercentage {
|
|
#[inline]
|
|
fn from(pc: computed::Percentage) -> Self {
|
|
LengthPercentage::Percentage(pc)
|
|
}
|
|
}
|
|
|
|
impl Parse for LengthPercentage {
|
|
#[inline]
|
|
fn parse<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_quirky(context, input, AllowQuirks::No)
|
|
}
|
|
}
|
|
|
|
impl LengthPercentage {
|
|
#[inline]
|
|
/// Returns a `zero` length.
|
|
pub fn zero() -> LengthPercentage {
|
|
LengthPercentage::Length(NoCalcLength::zero())
|
|
}
|
|
|
|
#[inline]
|
|
/// Returns a `0%` value.
|
|
pub fn zero_percent() -> LengthPercentage {
|
|
LengthPercentage::Percentage(computed::Percentage::zero())
|
|
}
|
|
|
|
fn parse_internal<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
num_context: AllowedNumericType,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
// FIXME: remove early returns when lifetimes are non-lexical
|
|
{
|
|
let location = input.current_source_location();
|
|
let token = input.next()?;
|
|
match *token {
|
|
Token::Dimension {
|
|
value, ref unit, ..
|
|
} if num_context.is_ok(context.parsing_mode, value) => {
|
|
return NoCalcLength::parse_dimension(context, value, unit)
|
|
.map(LengthPercentage::Length)
|
|
.map_err(|()| location.new_unexpected_token_error(token.clone()));
|
|
},
|
|
Token::Percentage { unit_value, .. }
|
|
if num_context.is_ok(context.parsing_mode, unit_value) =>
|
|
{
|
|
return Ok(LengthPercentage::Percentage(computed::Percentage(
|
|
unit_value,
|
|
)));
|
|
}
|
|
Token::Number { value, .. } if num_context.is_ok(context.parsing_mode, value) => {
|
|
if value != 0. &&
|
|
!context.parsing_mode.allows_unitless_lengths() &&
|
|
!allow_quirks.allowed(context.quirks_mode)
|
|
{
|
|
return Err(location.new_unexpected_token_error(token.clone()));
|
|
} else {
|
|
return Ok(LengthPercentage::Length(NoCalcLength::from_px(value)));
|
|
}
|
|
},
|
|
Token::Function(ref name) if name.eq_ignore_ascii_case("calc") => {},
|
|
_ => return Err(location.new_unexpected_token_error(token.clone())),
|
|
}
|
|
}
|
|
|
|
let calc = input.parse_nested_block(|i| {
|
|
CalcNode::parse_length_or_percentage(context, i, num_context)
|
|
})?;
|
|
Ok(LengthPercentage::Calc(Box::new(calc)))
|
|
}
|
|
|
|
/// Parses allowing the unitless length quirk.
|
|
/// <https://quirks.spec.whatwg.org/#the-unitless-length-quirk>
|
|
#[inline]
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_internal(context, input, AllowedNumericType::All, allow_quirks)
|
|
}
|
|
|
|
/// Parse a non-negative length.
|
|
///
|
|
/// FIXME(emilio): This should be not public and we should use
|
|
/// NonNegativeLengthPercentage instead.
|
|
#[inline]
|
|
pub fn parse_non_negative<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_non_negative_quirky(context, input, AllowQuirks::No)
|
|
}
|
|
|
|
/// Parse a non-negative length, with quirks.
|
|
#[inline]
|
|
pub fn parse_non_negative_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_internal(
|
|
context,
|
|
input,
|
|
AllowedNumericType::NonNegative,
|
|
allow_quirks,
|
|
)
|
|
}
|
|
}
|
|
|
|
impl IsZeroLength for LengthPercentage {
|
|
#[inline]
|
|
fn is_zero_length(&self) -> bool {
|
|
match *self {
|
|
LengthPercentage::Length(l) => l.is_zero_length(),
|
|
LengthPercentage::Percentage(p) => p.0 == 0.0,
|
|
LengthPercentage::Calc(_) => false,
|
|
}
|
|
}
|
|
}
|
|
|
|
/// A specified type for `<length-percentage> | auto`.
|
|
pub type LengthPercentageOrAuto = generics::LengthPercentageOrAuto<LengthPercentage>;
|
|
|
|
impl LengthPercentageOrAuto {
|
|
/// Returns a value representing a `0` length.
|
|
pub fn zero() -> Self {
|
|
generics::LengthPercentageOrAuto::LengthPercentage(LengthPercentage::zero())
|
|
}
|
|
|
|
/// Returns a value representing `0%`.
|
|
#[inline]
|
|
pub fn zero_percent() -> Self {
|
|
generics::LengthPercentageOrAuto::LengthPercentage(LengthPercentage::zero_percent())
|
|
}
|
|
|
|
/// Parses a length or a percentage, allowing the unitless length quirk.
|
|
/// <https://quirks.spec.whatwg.org/#the-unitless-length-quirk>
|
|
#[inline]
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_with(context, input, |context, input| {
|
|
LengthPercentage::parse_quirky(context, input, allow_quirks)
|
|
})
|
|
}
|
|
}
|
|
|
|
/// A wrapper of LengthPercentageOrAuto, whose value must be >= 0.
|
|
pub type NonNegativeLengthPercentageOrAuto =
|
|
generics::LengthPercentageOrAuto<NonNegativeLengthPercentage>;
|
|
|
|
impl NonNegativeLengthPercentageOrAuto {
|
|
/// Returns a value representing a `0` length.
|
|
pub fn zero() -> Self {
|
|
generics::LengthPercentageOrAuto::LengthPercentage(NonNegativeLengthPercentage::zero())
|
|
}
|
|
|
|
/// Returns a value representing `0%`.
|
|
#[inline]
|
|
pub fn zero_percent() -> Self {
|
|
generics::LengthPercentageOrAuto::LengthPercentage(
|
|
NonNegativeLengthPercentage::zero_percent(),
|
|
)
|
|
}
|
|
|
|
/// Parses a non-negative length-percentage, allowing the unitless length
|
|
/// quirk.
|
|
#[inline]
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_with(context, input, |context, input| {
|
|
NonNegativeLengthPercentage::parse_quirky(context, input, allow_quirks)
|
|
})
|
|
}
|
|
}
|
|
|
|
/// A wrapper of LengthPercentage, whose value must be >= 0.
|
|
pub type NonNegativeLengthPercentage = NonNegative<LengthPercentage>;
|
|
|
|
/// Either a computed NonNegativeLength or the `normal` keyword.
|
|
pub type NonNegativeLengthOrNormal = Either<NonNegativeLength, Normal>;
|
|
|
|
/// Either a NonNegativeLengthPercentage or the `normal` keyword.
|
|
pub type NonNegativeLengthPercentageOrNormal = Either<NonNegativeLengthPercentage, Normal>;
|
|
|
|
impl From<NoCalcLength> for NonNegativeLengthPercentage {
|
|
#[inline]
|
|
fn from(len: NoCalcLength) -> Self {
|
|
NonNegative(LengthPercentage::from(len))
|
|
}
|
|
}
|
|
|
|
impl Parse for NonNegativeLengthPercentage {
|
|
#[inline]
|
|
fn parse<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Self::parse_quirky(context, input, AllowQuirks::No)
|
|
}
|
|
}
|
|
|
|
impl NonNegativeLengthPercentage {
|
|
#[inline]
|
|
/// Returns a `zero` length.
|
|
pub fn zero() -> Self {
|
|
NonNegative(LengthPercentage::zero())
|
|
}
|
|
|
|
#[inline]
|
|
/// Returns a `0%` value.
|
|
pub fn zero_percent() -> Self {
|
|
NonNegative(LengthPercentage::zero_percent())
|
|
}
|
|
|
|
/// Parses a length or a percentage, allowing the unitless length quirk.
|
|
/// <https://quirks.spec.whatwg.org/#the-unitless-length-quirk>
|
|
#[inline]
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
LengthPercentage::parse_non_negative_quirky(context, input, allow_quirks).map(NonNegative)
|
|
}
|
|
}
|
|
|
|
/// Either a `<length>` or the `normal` keyword.
|
|
pub type LengthOrNormal = Either<Length, Normal>;
|
|
|
|
/// Either a `<length>` or the `auto` keyword.
|
|
pub type LengthOrAuto = Either<Length, Auto>;
|
|
|
|
/// Either a `<length>` or a `<number>`.
|
|
pub type LengthOrNumber = Either<Length, Number>;
|
|
|
|
impl LengthOrNumber {
|
|
/// Parse a non-negative LengthOrNumber.
|
|
pub fn parse_non_negative<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
// We try to parse as a Number first because, for cases like
|
|
// LengthOrNumber, we want "0" to be parsed as a plain Number rather
|
|
// than a Length (0px); this matches the behaviour of all major browsers
|
|
if let Ok(v) = input.try(|i| Number::parse_non_negative(context, i)) {
|
|
return Ok(Either::Second(v));
|
|
}
|
|
|
|
Length::parse_non_negative(context, input).map(Either::First)
|
|
}
|
|
|
|
/// Returns `0`.
|
|
#[inline]
|
|
pub fn zero() -> Self {
|
|
Either::Second(Number::new(0.))
|
|
}
|
|
}
|
|
|
|
/// A specified value for `min-width`, `min-height`, `width` or `height` property.
|
|
pub type Size = GenericSize<NonNegativeLengthPercentage>;
|
|
|
|
impl Parse for Size {
|
|
fn parse<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
Size::parse_quirky(context, input, AllowQuirks::No)
|
|
}
|
|
}
|
|
|
|
impl Size {
|
|
/// Parses, with quirks.
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
#[cfg(feature = "gecko")]
|
|
{
|
|
if let Ok(l) = input.try(computed::ExtremumLength::parse) {
|
|
return Ok(GenericSize::ExtremumLength(l));
|
|
}
|
|
}
|
|
|
|
if input.try(|i| i.expect_ident_matching("auto")).is_ok() {
|
|
return Ok(GenericSize::Auto);
|
|
}
|
|
|
|
let length = NonNegativeLengthPercentage::parse_quirky(context, input, allow_quirks)?;
|
|
Ok(GenericSize::LengthPercentage(length))
|
|
}
|
|
|
|
/// Returns `0%`.
|
|
#[inline]
|
|
pub fn zero_percent() -> Self {
|
|
GenericSize::LengthPercentage(NonNegativeLengthPercentage::zero_percent())
|
|
}
|
|
}
|
|
|
|
/// A specified value for `max-width` or `max-height` property.
|
|
pub type MaxSize = GenericMaxSize<NonNegativeLengthPercentage>;
|
|
|
|
impl Parse for MaxSize {
|
|
fn parse<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
MaxSize::parse_quirky(context, input, AllowQuirks::No)
|
|
}
|
|
}
|
|
|
|
impl MaxSize {
|
|
/// Parses, with quirks.
|
|
pub fn parse_quirky<'i, 't>(
|
|
context: &ParserContext,
|
|
input: &mut Parser<'i, 't>,
|
|
allow_quirks: AllowQuirks,
|
|
) -> Result<Self, ParseError<'i>> {
|
|
#[cfg(feature = "gecko")]
|
|
{
|
|
if let Ok(l) = input.try(computed::ExtremumLength::parse) {
|
|
return Ok(GenericMaxSize::ExtremumLength(l));
|
|
}
|
|
}
|
|
|
|
if input.try(|i| i.expect_ident_matching("none")).is_ok() {
|
|
return Ok(GenericMaxSize::None);
|
|
}
|
|
|
|
let length = NonNegativeLengthPercentage::parse_quirky(context, input, allow_quirks)?;
|
|
Ok(GenericMaxSize::LengthPercentage(length))
|
|
}
|
|
}
|