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