layout/taffy/stylo_taffy/
convert.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 style::Atom;
6use stylo_atoms::atom;
7use taffy::MaxTrackSizingFunction;
8use taffy::style_helpers::*;
9
10use super::stylo;
11
12#[inline]
13pub fn length_percentage(val: &stylo::LengthPercentage) -> taffy::LengthPercentage {
14    match val.unpack() {
15        stylo::UnpackedLengthPercentage::Length(len) => length(len.px()),
16        stylo::UnpackedLengthPercentage::Percentage(percentage) => percent(percentage.0),
17        // TODO: Support calc
18        stylo::UnpackedLengthPercentage::Calc(_) => percent(0.0),
19    }
20}
21
22#[inline]
23pub fn dimension(val: &stylo::Size) -> taffy::Dimension {
24    match val {
25        stylo::Size::LengthPercentage(val) => length_percentage(&val.0).into(),
26        stylo::Size::Auto => taffy::Dimension::AUTO,
27
28        // TODO: implement other values in Taffy
29        stylo::Size::MaxContent => taffy::Dimension::AUTO,
30        stylo::Size::MinContent => taffy::Dimension::AUTO,
31        stylo::Size::FitContent => taffy::Dimension::AUTO,
32        stylo::Size::FitContentFunction(_) => taffy::Dimension::AUTO,
33        stylo::Size::Stretch => taffy::Dimension::AUTO,
34
35        // Anchor positioning will be flagged off for time being
36        stylo::Size::AnchorSizeFunction(_) => unreachable!(),
37        stylo::Size::AnchorContainingCalcFunction(_) => unreachable!(),
38    }
39}
40
41#[inline]
42pub fn max_size_dimension(val: &stylo::MaxSize) -> taffy::Dimension {
43    match val {
44        stylo::MaxSize::LengthPercentage(val) => length_percentage(&val.0).into(),
45        stylo::MaxSize::None => taffy::Dimension::AUTO,
46
47        // TODO: implement other values in Taffy
48        stylo::MaxSize::MaxContent => taffy::Dimension::AUTO,
49        stylo::MaxSize::MinContent => taffy::Dimension::AUTO,
50        stylo::MaxSize::FitContent => taffy::Dimension::AUTO,
51        stylo::MaxSize::FitContentFunction(_) => taffy::Dimension::AUTO,
52        stylo::MaxSize::Stretch => taffy::Dimension::AUTO,
53
54        // Anchor positioning will be flagged off for time being
55        stylo::MaxSize::AnchorSizeFunction(_) => unreachable!(),
56        stylo::MaxSize::AnchorContainingCalcFunction(_) => unreachable!(),
57    }
58}
59
60#[inline]
61pub fn margin(val: &stylo::MarginVal) -> taffy::LengthPercentageAuto {
62    match val {
63        stylo::MarginVal::Auto => taffy::LengthPercentageAuto::AUTO,
64        stylo::MarginVal::LengthPercentage(val) => length_percentage(val).into(),
65
66        // Anchor positioning will be flagged off for time being
67        stylo::MarginVal::AnchorSizeFunction(_) => unreachable!(),
68        stylo::MarginVal::AnchorContainingCalcFunction(_) => unreachable!(),
69    }
70}
71
72#[inline]
73pub fn inset(val: &stylo::InsetVal) -> taffy::LengthPercentageAuto {
74    match val {
75        stylo::InsetVal::Auto => taffy::LengthPercentageAuto::AUTO,
76        stylo::InsetVal::LengthPercentage(val) => length_percentage(val).into(),
77
78        // Anchor positioning will be flagged off for time being
79        stylo::InsetVal::AnchorSizeFunction(_) => unreachable!(),
80        stylo::InsetVal::AnchorFunction(_) => unreachable!(),
81        stylo::InsetVal::AnchorContainingCalcFunction(_) => unreachable!(),
82    }
83}
84
85#[inline]
86pub fn is_block(input: stylo::Display) -> bool {
87    matches!(input.outside(), stylo::DisplayOutside::Block) &&
88        matches!(
89            input.inside(),
90            stylo::DisplayInside::Flow | stylo::DisplayInside::FlowRoot
91        )
92}
93
94#[inline]
95pub fn box_generation_mode(input: stylo::Display) -> taffy::BoxGenerationMode {
96    match input.inside() {
97        stylo::DisplayInside::None => taffy::BoxGenerationMode::None,
98        _ => taffy::BoxGenerationMode::Normal,
99    }
100}
101
102#[inline]
103pub fn box_sizing(input: stylo::BoxSizing) -> taffy::BoxSizing {
104    match input {
105        stylo::BoxSizing::BorderBox => taffy::BoxSizing::BorderBox,
106        stylo::BoxSizing::ContentBox => taffy::BoxSizing::ContentBox,
107    }
108}
109
110#[inline]
111pub fn position(input: stylo::Position) -> taffy::Position {
112    match input {
113        // TODO: support position:static
114        stylo::Position::Relative => taffy::Position::Relative,
115        stylo::Position::Static => taffy::Position::Relative,
116
117        // TODO: support position:fixed and sticky
118        stylo::Position::Absolute => taffy::Position::Absolute,
119        stylo::Position::Fixed => taffy::Position::Absolute,
120        stylo::Position::Sticky => taffy::Position::Relative,
121    }
122}
123
124#[inline]
125pub fn overflow(input: stylo::Overflow) -> taffy::Overflow {
126    // TODO: Enable Overflow::Clip in servo configuration of stylo
127    match input {
128        stylo::Overflow::Visible => taffy::Overflow::Visible,
129        stylo::Overflow::Hidden => taffy::Overflow::Hidden,
130        stylo::Overflow::Scroll => taffy::Overflow::Scroll,
131        stylo::Overflow::Clip => taffy::Overflow::Clip,
132        // TODO: Support Overflow::Auto in Taffy
133        stylo::Overflow::Auto => taffy::Overflow::Scroll,
134    }
135}
136
137#[inline]
138pub fn aspect_ratio(input: stylo::AspectRatio) -> Option<f32> {
139    match input.ratio {
140        stylo::PreferredRatio::None => None,
141        stylo::PreferredRatio::Ratio(val) => Some(val.0.0 / val.1.0),
142    }
143}
144
145#[inline]
146pub fn content_alignment(input: stylo::ContentDistribution) -> Option<taffy::AlignContent> {
147    match input.primary().value() {
148        stylo::AlignFlags::NORMAL => None,
149        stylo::AlignFlags::AUTO => None,
150        stylo::AlignFlags::START => Some(taffy::AlignContent::Start),
151        stylo::AlignFlags::END => Some(taffy::AlignContent::End),
152        stylo::AlignFlags::LEFT => Some(taffy::AlignContent::Start),
153        stylo::AlignFlags::RIGHT => Some(taffy::AlignContent::End),
154        stylo::AlignFlags::FLEX_START => Some(taffy::AlignContent::FlexStart),
155        stylo::AlignFlags::STRETCH => Some(taffy::AlignContent::Stretch),
156        stylo::AlignFlags::FLEX_END => Some(taffy::AlignContent::FlexEnd),
157        stylo::AlignFlags::CENTER => Some(taffy::AlignContent::Center),
158        stylo::AlignFlags::SPACE_BETWEEN => Some(taffy::AlignContent::SpaceBetween),
159        stylo::AlignFlags::SPACE_AROUND => Some(taffy::AlignContent::SpaceAround),
160        stylo::AlignFlags::SPACE_EVENLY => Some(taffy::AlignContent::SpaceEvenly),
161        // Should never be hit. But no real reason to panic here.
162        _ => None,
163    }
164}
165
166#[inline]
167pub fn item_alignment(input: stylo::AlignFlags) -> Option<taffy::AlignItems> {
168    match input.value() {
169        stylo::AlignFlags::AUTO => None,
170        stylo::AlignFlags::NORMAL => Some(taffy::AlignItems::Stretch),
171        stylo::AlignFlags::STRETCH => Some(taffy::AlignItems::Stretch),
172        stylo::AlignFlags::FLEX_START => Some(taffy::AlignItems::FlexStart),
173        stylo::AlignFlags::FLEX_END => Some(taffy::AlignItems::FlexEnd),
174        stylo::AlignFlags::SELF_START => Some(taffy::AlignItems::Start),
175        stylo::AlignFlags::SELF_END => Some(taffy::AlignItems::End),
176        stylo::AlignFlags::START => Some(taffy::AlignItems::Start),
177        stylo::AlignFlags::END => Some(taffy::AlignItems::End),
178        stylo::AlignFlags::LEFT => Some(taffy::AlignItems::Start),
179        stylo::AlignFlags::RIGHT => Some(taffy::AlignItems::End),
180        stylo::AlignFlags::CENTER => Some(taffy::AlignItems::Center),
181        stylo::AlignFlags::BASELINE => Some(taffy::AlignItems::Baseline),
182        // Should never be hit. But no real reason to panic here.
183        _ => None,
184    }
185}
186
187#[inline]
188pub fn gap(input: &stylo::Gap) -> taffy::LengthPercentage {
189    match input {
190        // For Flexbox and CSS Grid the "normal" value is 0px. This may need to be updated
191        // if we ever implement multi-column layout.
192        stylo::Gap::Normal => taffy::LengthPercentage::ZERO,
193        stylo::Gap::LengthPercentage(val) => length_percentage(&val.0),
194    }
195}
196
197// CSS Grid styles
198// ===============
199
200#[inline]
201pub fn grid_auto_flow(input: stylo::GridAutoFlow) -> taffy::GridAutoFlow {
202    let is_row = input.contains(stylo::GridAutoFlow::ROW);
203    let is_dense = input.contains(stylo::GridAutoFlow::DENSE);
204
205    match (is_row, is_dense) {
206        (true, false) => taffy::GridAutoFlow::Row,
207        (true, true) => taffy::GridAutoFlow::RowDense,
208        (false, false) => taffy::GridAutoFlow::Column,
209        (false, true) => taffy::GridAutoFlow::ColumnDense,
210    }
211}
212
213#[inline]
214pub fn grid_line(input: &stylo::GridLine) -> taffy::GridPlacement<Atom> {
215    if input.is_auto() {
216        taffy::GridPlacement::Auto
217    } else if input.is_span {
218        if input.ident.0 != atom!("") {
219            taffy::GridPlacement::NamedSpan(
220                input.ident.0.clone(),
221                input.line_num.try_into().unwrap(),
222            )
223        } else {
224            taffy::GridPlacement::Span(input.line_num as u16)
225        }
226    } else if input.ident.0 != atom!("") {
227        taffy::GridPlacement::NamedLine(input.ident.0.clone(), input.line_num as i16)
228    } else if input.line_num != 0 {
229        taffy::style_helpers::line(input.line_num as i16)
230    } else {
231        taffy::GridPlacement::Auto
232    }
233}
234
235#[inline]
236pub fn track_repeat(input: stylo::RepeatCount<i32>) -> taffy::RepetitionCount {
237    match input {
238        stylo::RepeatCount::Number(val) => taffy::RepetitionCount::Count(val.try_into().unwrap()),
239        stylo::RepeatCount::AutoFill => taffy::RepetitionCount::AutoFill,
240        stylo::RepeatCount::AutoFit => taffy::RepetitionCount::AutoFit,
241    }
242}
243
244#[inline]
245pub fn track_size(input: &stylo::TrackSize<stylo::LengthPercentage>) -> taffy::TrackSizingFunction {
246    match input {
247        stylo::TrackSize::Breadth(breadth) => taffy::MinMax {
248            min: min_track(breadth),
249            max: max_track(breadth),
250        },
251        stylo::TrackSize::Minmax(min, max) => taffy::MinMax {
252            min: min_track(min),
253            max: max_track(max),
254        },
255        stylo::TrackSize::FitContent(limit) => taffy::MinMax {
256            min: taffy::MinTrackSizingFunction::AUTO,
257            max: match limit {
258                stylo::TrackBreadth::Breadth(lp) => {
259                    MaxTrackSizingFunction::fit_content(length_percentage(lp))
260                },
261
262                // Are these valid? Taffy doesn't support this in any case
263                stylo::TrackBreadth::Fr(_) => unreachable!(),
264                stylo::TrackBreadth::Auto => unreachable!(),
265                stylo::TrackBreadth::MinContent => unreachable!(),
266                stylo::TrackBreadth::MaxContent => unreachable!(),
267            },
268        },
269    }
270}
271
272#[inline]
273pub fn min_track(
274    input: &stylo::TrackBreadth<stylo::LengthPercentage>,
275) -> taffy::MinTrackSizingFunction {
276    match input {
277        stylo::TrackBreadth::Breadth(lp) => length_percentage(lp).into(),
278        stylo::TrackBreadth::Fr(_) => taffy::MinTrackSizingFunction::AUTO,
279        stylo::TrackBreadth::Auto => taffy::MinTrackSizingFunction::AUTO,
280        stylo::TrackBreadth::MinContent => taffy::MinTrackSizingFunction::MIN_CONTENT,
281        stylo::TrackBreadth::MaxContent => taffy::MinTrackSizingFunction::MAX_CONTENT,
282    }
283}
284
285#[inline]
286pub fn max_track(
287    input: &stylo::TrackBreadth<stylo::LengthPercentage>,
288) -> taffy::MaxTrackSizingFunction {
289    match input {
290        stylo::TrackBreadth::Breadth(lp) => length_percentage(lp).into(),
291        stylo::TrackBreadth::Fr(val) => fr(*val),
292        stylo::TrackBreadth::Auto => taffy::MaxTrackSizingFunction::AUTO,
293        stylo::TrackBreadth::MinContent => taffy::MaxTrackSizingFunction::MIN_CONTENT,
294        stylo::TrackBreadth::MaxContent => taffy::MaxTrackSizingFunction::MAX_CONTENT,
295    }
296}