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 direction(input: stylo::Direction) -> taffy::Direction {
114    match input {
115        stylo::Direction::Ltr => taffy::Direction::Ltr,
116        stylo::Direction::Rtl => taffy::Direction::Rtl,
117    }
118}
119
120#[inline]
121pub fn position(input: stylo::Position) -> taffy::Position {
122    match input {
123        // TODO: support position:static
124        stylo::Position::Relative => taffy::Position::Relative,
125        stylo::Position::Static => taffy::Position::Relative,
126
127        // TODO: support position:fixed and sticky
128        stylo::Position::Absolute => taffy::Position::Absolute,
129        stylo::Position::Fixed => taffy::Position::Absolute,
130        stylo::Position::Sticky => taffy::Position::Relative,
131    }
132}
133
134#[inline]
135pub fn overflow(input: stylo::Overflow) -> taffy::Overflow {
136    // TODO: Enable Overflow::Clip in servo configuration of stylo
137    match input {
138        stylo::Overflow::Visible => taffy::Overflow::Visible,
139        stylo::Overflow::Hidden => taffy::Overflow::Hidden,
140        stylo::Overflow::Scroll => taffy::Overflow::Scroll,
141        stylo::Overflow::Clip => taffy::Overflow::Clip,
142        // TODO: Support Overflow::Auto in Taffy
143        stylo::Overflow::Auto => taffy::Overflow::Scroll,
144    }
145}
146
147#[inline]
148pub fn aspect_ratio(input: stylo::AspectRatio) -> Option<f32> {
149    match input.ratio {
150        stylo::PreferredRatio::None => None,
151        stylo::PreferredRatio::Ratio(val) => Some(val.0.0 / val.1.0),
152    }
153}
154
155#[inline]
156pub fn content_alignment(input: stylo::ContentDistribution) -> Option<taffy::AlignContent> {
157    match input.primary().value() {
158        stylo::AlignFlags::NORMAL => None,
159        stylo::AlignFlags::AUTO => None,
160        stylo::AlignFlags::START => Some(taffy::AlignContent::Start),
161        stylo::AlignFlags::END => Some(taffy::AlignContent::End),
162        stylo::AlignFlags::LEFT => Some(taffy::AlignContent::Start),
163        stylo::AlignFlags::RIGHT => Some(taffy::AlignContent::End),
164        stylo::AlignFlags::FLEX_START => Some(taffy::AlignContent::FlexStart),
165        stylo::AlignFlags::STRETCH => Some(taffy::AlignContent::Stretch),
166        stylo::AlignFlags::FLEX_END => Some(taffy::AlignContent::FlexEnd),
167        stylo::AlignFlags::CENTER => Some(taffy::AlignContent::Center),
168        stylo::AlignFlags::SPACE_BETWEEN => Some(taffy::AlignContent::SpaceBetween),
169        stylo::AlignFlags::SPACE_AROUND => Some(taffy::AlignContent::SpaceAround),
170        stylo::AlignFlags::SPACE_EVENLY => Some(taffy::AlignContent::SpaceEvenly),
171        // Should never be hit. But no real reason to panic here.
172        _ => None,
173    }
174}
175
176#[inline]
177pub fn item_alignment(input: stylo::AlignFlags) -> Option<taffy::AlignItems> {
178    match input.value() {
179        stylo::AlignFlags::AUTO => None,
180        stylo::AlignFlags::NORMAL => Some(taffy::AlignItems::Stretch),
181        stylo::AlignFlags::STRETCH => Some(taffy::AlignItems::Stretch),
182        stylo::AlignFlags::FLEX_START => Some(taffy::AlignItems::FlexStart),
183        stylo::AlignFlags::FLEX_END => Some(taffy::AlignItems::FlexEnd),
184        stylo::AlignFlags::SELF_START => Some(taffy::AlignItems::Start),
185        stylo::AlignFlags::SELF_END => Some(taffy::AlignItems::End),
186        stylo::AlignFlags::START => Some(taffy::AlignItems::Start),
187        stylo::AlignFlags::END => Some(taffy::AlignItems::End),
188        stylo::AlignFlags::LEFT => Some(taffy::AlignItems::Start),
189        stylo::AlignFlags::RIGHT => Some(taffy::AlignItems::End),
190        stylo::AlignFlags::CENTER => Some(taffy::AlignItems::Center),
191        stylo::AlignFlags::BASELINE => Some(taffy::AlignItems::Baseline),
192        // Should never be hit. But no real reason to panic here.
193        _ => None,
194    }
195}
196
197#[inline]
198pub fn gap(input: &stylo::Gap) -> taffy::LengthPercentage {
199    match input {
200        // For Flexbox and CSS Grid the "normal" value is 0px. This may need to be updated
201        // if we ever implement multi-column layout.
202        stylo::Gap::Normal => taffy::LengthPercentage::ZERO,
203        stylo::Gap::LengthPercentage(val) => length_percentage(&val.0),
204    }
205}
206
207// CSS Grid styles
208// ===============
209
210#[inline]
211pub fn grid_auto_flow(input: stylo::GridAutoFlow) -> taffy::GridAutoFlow {
212    let is_row = input.contains(stylo::GridAutoFlow::ROW);
213    let is_dense = input.contains(stylo::GridAutoFlow::DENSE);
214
215    match (is_row, is_dense) {
216        (true, false) => taffy::GridAutoFlow::Row,
217        (true, true) => taffy::GridAutoFlow::RowDense,
218        (false, false) => taffy::GridAutoFlow::Column,
219        (false, true) => taffy::GridAutoFlow::ColumnDense,
220    }
221}
222
223#[inline]
224pub fn grid_line(input: &stylo::GridLine) -> taffy::GridPlacement<Atom> {
225    if input.is_auto() {
226        taffy::GridPlacement::Auto
227    } else if input.is_span {
228        if input.ident.0 != atom!("") {
229            taffy::GridPlacement::NamedSpan(
230                input.ident.0.clone(),
231                input.line_num.try_into().unwrap(),
232            )
233        } else {
234            taffy::GridPlacement::Span(input.line_num as u16)
235        }
236    } else if input.ident.0 != atom!("") {
237        taffy::GridPlacement::NamedLine(input.ident.0.clone(), input.line_num as i16)
238    } else if input.line_num != 0 {
239        taffy::style_helpers::line(input.line_num as i16)
240    } else {
241        taffy::GridPlacement::Auto
242    }
243}
244
245#[inline]
246pub fn track_repeat(input: stylo::RepeatCount<i32>) -> taffy::RepetitionCount {
247    match input {
248        stylo::RepeatCount::Number(val) => taffy::RepetitionCount::Count(val.try_into().unwrap()),
249        stylo::RepeatCount::AutoFill => taffy::RepetitionCount::AutoFill,
250        stylo::RepeatCount::AutoFit => taffy::RepetitionCount::AutoFit,
251    }
252}
253
254#[inline]
255pub fn track_size(input: &stylo::TrackSize<stylo::LengthPercentage>) -> taffy::TrackSizingFunction {
256    match input {
257        stylo::TrackSize::Breadth(breadth) => taffy::MinMax {
258            min: min_track(breadth),
259            max: max_track(breadth),
260        },
261        stylo::TrackSize::Minmax(min, max) => taffy::MinMax {
262            min: min_track(min),
263            max: max_track(max),
264        },
265        stylo::TrackSize::FitContent(limit) => taffy::MinMax {
266            min: taffy::MinTrackSizingFunction::AUTO,
267            max: match limit {
268                stylo::TrackBreadth::Breadth(lp) => {
269                    MaxTrackSizingFunction::fit_content(length_percentage(lp))
270                },
271
272                // Are these valid? Taffy doesn't support this in any case
273                stylo::TrackBreadth::Fr(_) => unreachable!(),
274                stylo::TrackBreadth::Auto => unreachable!(),
275                stylo::TrackBreadth::MinContent => unreachable!(),
276                stylo::TrackBreadth::MaxContent => unreachable!(),
277            },
278        },
279    }
280}
281
282#[inline]
283pub fn min_track(
284    input: &stylo::TrackBreadth<stylo::LengthPercentage>,
285) -> taffy::MinTrackSizingFunction {
286    match input {
287        stylo::TrackBreadth::Breadth(lp) => length_percentage(lp).into(),
288        stylo::TrackBreadth::Fr(_) => taffy::MinTrackSizingFunction::AUTO,
289        stylo::TrackBreadth::Auto => taffy::MinTrackSizingFunction::AUTO,
290        stylo::TrackBreadth::MinContent => taffy::MinTrackSizingFunction::MIN_CONTENT,
291        stylo::TrackBreadth::MaxContent => taffy::MinTrackSizingFunction::MAX_CONTENT,
292    }
293}
294
295#[inline]
296pub fn max_track(
297    input: &stylo::TrackBreadth<stylo::LengthPercentage>,
298) -> taffy::MaxTrackSizingFunction {
299    match input {
300        stylo::TrackBreadth::Breadth(lp) => length_percentage(lp).into(),
301        stylo::TrackBreadth::Fr(val) => fr(*val),
302        stylo::TrackBreadth::Auto => taffy::MaxTrackSizingFunction::AUTO,
303        stylo::TrackBreadth::MinContent => taffy::MaxTrackSizingFunction::MIN_CONTENT,
304        stylo::TrackBreadth::MaxContent => taffy::MaxTrackSizingFunction::MAX_CONTENT,
305    }
306}