FlexFormattingContext.cpp 110 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296
  1. /*
  2. * Copyright (c) 2021-2023, Andreas Kling <kling@serenityos.org>
  3. * Copyright (c) 2021, Tobias Christiansen <tobyase@serenityos.org>
  4. *
  5. * SPDX-License-Identifier: BSD-2-Clause
  6. */
  7. #include "InlineFormattingContext.h"
  8. #include <AK/Function.h>
  9. #include <AK/QuickSort.h>
  10. #include <AK/StdLibExtras.h>
  11. #include <LibWeb/Layout/BlockContainer.h>
  12. #include <LibWeb/Layout/BlockFormattingContext.h>
  13. #include <LibWeb/Layout/Box.h>
  14. #include <LibWeb/Layout/FlexFormattingContext.h>
  15. #include <LibWeb/Layout/ReplacedBox.h>
  16. #include <LibWeb/Layout/TextNode.h>
  17. #include <LibWeb/Layout/Viewport.h>
  18. namespace Web::Layout {
  19. // NOTE: We use a custom clamping function here instead of AK::clamp(), since the AK version
  20. // will VERIFY(max >= min) and CSS explicitly allows that (see css-values-4.)
  21. template<typename T>
  22. [[nodiscard]] constexpr T css_clamp(T const& value, T const& min, T const& max)
  23. {
  24. return ::max(min, ::min(value, max));
  25. }
  26. CSSPixels FlexFormattingContext::get_pixel_width(Box const& box, CSS::Size const& size) const
  27. {
  28. return calculate_inner_width(box, containing_block_width_as_available_size(box), size);
  29. }
  30. CSSPixels FlexFormattingContext::get_pixel_height(Box const& box, CSS::Size const& size) const
  31. {
  32. return calculate_inner_height(box, containing_block_height_as_available_size(box), size);
  33. }
  34. FlexFormattingContext::FlexFormattingContext(LayoutState& state, Box const& flex_container, FormattingContext* parent)
  35. : FormattingContext(Type::Flex, state, flex_container, parent)
  36. , m_flex_container_state(m_state.get_mutable(flex_container))
  37. , m_flex_direction(flex_container.computed_values().flex_direction())
  38. {
  39. }
  40. FlexFormattingContext::~FlexFormattingContext() = default;
  41. CSSPixels FlexFormattingContext::automatic_content_width() const
  42. {
  43. return m_flex_container_state.content_width();
  44. }
  45. CSSPixels FlexFormattingContext::automatic_content_height() const
  46. {
  47. return m_flex_container_state.content_height();
  48. }
  49. void FlexFormattingContext::run(Box const& run_box, LayoutMode, AvailableSpace const& available_content_space)
  50. {
  51. VERIFY(&run_box == &flex_container());
  52. // NOTE: The available space provided by the parent context is basically our *content box*.
  53. // FFC is currently written in a way that expects that to include padding and border as well,
  54. // so we pad out the available space here to accommodate that.
  55. // FIXME: Refactor the necessary parts of FFC so we don't need this hack!
  56. auto available_width = available_content_space.width;
  57. if (available_width.is_definite())
  58. available_width = AvailableSize::make_definite(available_width.to_px_or_zero() + m_flex_container_state.border_box_left() + m_flex_container_state.border_box_right());
  59. auto available_height = available_content_space.height;
  60. if (available_height.is_definite())
  61. available_height = AvailableSize::make_definite(available_height.to_px_or_zero() + m_flex_container_state.border_box_top() + m_flex_container_state.border_box_bottom());
  62. m_available_space_for_flex_container = AxisAgnosticAvailableSpace {
  63. .main = is_row_layout() ? available_width : available_height,
  64. .cross = !is_row_layout() ? available_width : available_height,
  65. .space = { available_width, available_height },
  66. };
  67. // This implements https://www.w3.org/TR/css-flexbox-1/#layout-algorithm
  68. // 1. Generate anonymous flex items
  69. generate_anonymous_flex_items();
  70. // 2. Determine the available main and cross space for the flex items
  71. determine_available_space_for_items(AvailableSpace(available_width, available_height));
  72. {
  73. // https://drafts.csswg.org/css-flexbox-1/#definite-sizes
  74. // 3. If a single-line flex container has a definite cross size,
  75. // the automatic preferred outer cross size of any stretched flex items is the flex container’s inner cross size
  76. // (clamped to the flex item’s min and max cross size) and is considered definite.
  77. if (is_single_line() && has_definite_cross_size(flex_container())) {
  78. auto flex_container_inner_cross_size = inner_cross_size(flex_container());
  79. for (auto& item : m_flex_items) {
  80. if (!flex_item_is_stretched(item))
  81. continue;
  82. auto item_min_cross_size = has_cross_min_size(item.box) ? specified_cross_min_size(item.box) : 0;
  83. auto item_max_cross_size = has_cross_max_size(item.box) ? specified_cross_max_size(item.box) : CSSPixels::max();
  84. auto item_preferred_outer_cross_size = css_clamp(flex_container_inner_cross_size, item_min_cross_size, item_max_cross_size);
  85. auto item_inner_cross_size = item_preferred_outer_cross_size - item.margins.cross_before - item.margins.cross_after - item.padding.cross_before - item.padding.cross_after - item.borders.cross_before - item.borders.cross_after;
  86. set_cross_size(item.box, item_inner_cross_size);
  87. }
  88. }
  89. }
  90. // 3. Determine the flex base size and hypothetical main size of each item
  91. for (auto& item : m_flex_items) {
  92. if (item.box->is_replaced_box()) {
  93. // FIXME: Get rid of prepare_for_replaced_layout() and make replaced elements figure out their intrinsic size lazily.
  94. static_cast<ReplacedBox&>(*item.box).prepare_for_replaced_layout();
  95. }
  96. determine_flex_base_size_and_hypothetical_main_size(item);
  97. }
  98. if (available_width.is_intrinsic_sizing_constraint() || available_height.is_intrinsic_sizing_constraint()) {
  99. // We're computing intrinsic size for the flex container. This happens at the end of run().
  100. } else {
  101. // 4. Determine the main size of the flex container
  102. determine_main_size_of_flex_container();
  103. }
  104. // 5. Collect flex items into flex lines:
  105. // After this step no additional items are to be added to flex_lines or any of its items!
  106. collect_flex_items_into_flex_lines();
  107. // 6. Resolve the flexible lengths
  108. resolve_flexible_lengths();
  109. // Cross Size Determination
  110. // 7. Determine the hypothetical cross size of each item
  111. for (auto& item : m_flex_items) {
  112. determine_hypothetical_cross_size_of_item(item, false);
  113. }
  114. // 8. Calculate the cross size of each flex line.
  115. calculate_cross_size_of_each_flex_line();
  116. // 9. Handle 'align-content: stretch'.
  117. handle_align_content_stretch();
  118. // 10. Collapse visibility:collapse items.
  119. // FIXME: This
  120. // 11. Determine the used cross size of each flex item.
  121. determine_used_cross_size_of_each_flex_item();
  122. // 12. Distribute any remaining free space.
  123. distribute_any_remaining_free_space();
  124. // 13. Resolve cross-axis auto margins.
  125. resolve_cross_axis_auto_margins();
  126. // 14. Align all flex items along the cross-axis
  127. align_all_flex_items_along_the_cross_axis();
  128. // 15. Determine the flex container’s used cross size:
  129. determine_flex_container_used_cross_size();
  130. {
  131. // https://drafts.csswg.org/css-flexbox-1/#definite-sizes
  132. // 4. Once the cross size of a flex line has been determined,
  133. // the cross sizes of items in auto-sized flex containers are also considered definite for the purpose of layout.
  134. auto const& flex_container_computed_cross_size = is_row_layout() ? flex_container().computed_values().height() : flex_container().computed_values().width();
  135. if (flex_container_computed_cross_size.is_auto()) {
  136. for (auto& item : m_flex_items) {
  137. set_cross_size(item.box, item.cross_size.value());
  138. }
  139. }
  140. }
  141. {
  142. // NOTE: We re-resolve cross sizes here, now that we can resolve percentages.
  143. // 7. Determine the hypothetical cross size of each item
  144. for (auto& item : m_flex_items) {
  145. determine_hypothetical_cross_size_of_item(item, true);
  146. }
  147. // 11. Determine the used cross size of each flex item.
  148. determine_used_cross_size_of_each_flex_item();
  149. }
  150. // 16. Align all flex lines (per align-content)
  151. align_all_flex_lines();
  152. if (available_width.is_intrinsic_sizing_constraint() || available_height.is_intrinsic_sizing_constraint()) {
  153. // We're computing intrinsic size for the flex container.
  154. determine_intrinsic_size_of_flex_container();
  155. } else {
  156. // This is a normal layout (not intrinsic sizing).
  157. // AD-HOC: Finally, layout the inside of all flex items.
  158. copy_dimensions_from_flex_items_to_boxes();
  159. for (auto& item : m_flex_items) {
  160. auto& box_state = m_state.get(item.box);
  161. if (auto independent_formatting_context = layout_inside(item.box, LayoutMode::Normal, box_state.available_inner_space_or_constraints_from(m_available_space_for_flex_container->space)))
  162. independent_formatting_context->parent_context_did_dimension_child_root_box();
  163. compute_inset(item.box);
  164. }
  165. }
  166. }
  167. void FlexFormattingContext::parent_context_did_dimension_child_root_box()
  168. {
  169. flex_container().for_each_child_of_type<Box>([&](Layout::Box& box) {
  170. if (box.is_absolutely_positioned()) {
  171. auto& cb_state = m_state.get(*box.containing_block());
  172. auto available_width = AvailableSize::make_definite(cb_state.content_width() + cb_state.padding_left + cb_state.padding_right);
  173. auto available_height = AvailableSize::make_definite(cb_state.content_height() + cb_state.padding_top + cb_state.padding_bottom);
  174. layout_absolutely_positioned_element(box, AvailableSpace(available_width, available_height));
  175. }
  176. });
  177. }
  178. void FlexFormattingContext::populate_specified_margins(FlexItem& item, CSS::FlexDirection flex_direction) const
  179. {
  180. auto width_of_containing_block = m_state.get(*item.box->containing_block()).content_width();
  181. // FIXME: This should also take reverse-ness into account
  182. if (flex_direction == CSS::FlexDirection::Row || flex_direction == CSS::FlexDirection::RowReverse) {
  183. item.borders.main_before = item.box->computed_values().border_left().width;
  184. item.borders.main_after = item.box->computed_values().border_right().width;
  185. item.borders.cross_before = item.box->computed_values().border_top().width;
  186. item.borders.cross_after = item.box->computed_values().border_bottom().width;
  187. item.padding.main_before = item.box->computed_values().padding().left().to_px(item.box, width_of_containing_block);
  188. item.padding.main_after = item.box->computed_values().padding().right().to_px(item.box, width_of_containing_block);
  189. item.padding.cross_before = item.box->computed_values().padding().top().to_px(item.box, width_of_containing_block);
  190. item.padding.cross_after = item.box->computed_values().padding().bottom().to_px(item.box, width_of_containing_block);
  191. item.margins.main_before = item.box->computed_values().margin().left().to_px(item.box, width_of_containing_block);
  192. item.margins.main_after = item.box->computed_values().margin().right().to_px(item.box, width_of_containing_block);
  193. item.margins.cross_before = item.box->computed_values().margin().top().to_px(item.box, width_of_containing_block);
  194. item.margins.cross_after = item.box->computed_values().margin().bottom().to_px(item.box, width_of_containing_block);
  195. item.margins.main_before_is_auto = item.box->computed_values().margin().left().is_auto();
  196. item.margins.main_after_is_auto = item.box->computed_values().margin().right().is_auto();
  197. item.margins.cross_before_is_auto = item.box->computed_values().margin().top().is_auto();
  198. item.margins.cross_after_is_auto = item.box->computed_values().margin().bottom().is_auto();
  199. } else {
  200. item.borders.main_before = item.box->computed_values().border_top().width;
  201. item.borders.main_after = item.box->computed_values().border_bottom().width;
  202. item.borders.cross_before = item.box->computed_values().border_left().width;
  203. item.borders.cross_after = item.box->computed_values().border_right().width;
  204. item.padding.main_before = item.box->computed_values().padding().top().to_px(item.box, width_of_containing_block);
  205. item.padding.main_after = item.box->computed_values().padding().bottom().to_px(item.box, width_of_containing_block);
  206. item.padding.cross_before = item.box->computed_values().padding().left().to_px(item.box, width_of_containing_block);
  207. item.padding.cross_after = item.box->computed_values().padding().right().to_px(item.box, width_of_containing_block);
  208. item.margins.main_before = item.box->computed_values().margin().top().to_px(item.box, width_of_containing_block);
  209. item.margins.main_after = item.box->computed_values().margin().bottom().to_px(item.box, width_of_containing_block);
  210. item.margins.cross_before = item.box->computed_values().margin().left().to_px(item.box, width_of_containing_block);
  211. item.margins.cross_after = item.box->computed_values().margin().right().to_px(item.box, width_of_containing_block);
  212. item.margins.main_before_is_auto = item.box->computed_values().margin().top().is_auto();
  213. item.margins.main_after_is_auto = item.box->computed_values().margin().bottom().is_auto();
  214. item.margins.cross_before_is_auto = item.box->computed_values().margin().left().is_auto();
  215. item.margins.cross_after_is_auto = item.box->computed_values().margin().right().is_auto();
  216. }
  217. }
  218. // https://www.w3.org/TR/css-flexbox-1/#flex-items
  219. void FlexFormattingContext::generate_anonymous_flex_items()
  220. {
  221. // More like, sift through the already generated items.
  222. // After this step no items are to be added or removed from flex_items!
  223. // It holds every item we need to consider and there should be nothing in the following
  224. // calculations that could change that.
  225. // This is particularly important since we take references to the items stored in flex_items
  226. // later, whose addresses won't be stable if we added or removed any items.
  227. HashMap<int, Vector<FlexItem>> order_item_bucket;
  228. flex_container().for_each_child_of_type<Box>([&](Box& child_box) {
  229. if (can_skip_is_anonymous_text_run(child_box))
  230. return IterationDecision::Continue;
  231. // Skip any "out-of-flow" children
  232. if (child_box.is_out_of_flow(*this))
  233. return IterationDecision::Continue;
  234. child_box.set_flex_item(true);
  235. FlexItem item = { child_box };
  236. populate_specified_margins(item, m_flex_direction);
  237. auto& order_bucket = order_item_bucket.ensure(child_box.computed_values().order());
  238. order_bucket.append(move(item));
  239. return IterationDecision::Continue;
  240. });
  241. auto keys = order_item_bucket.keys();
  242. if (is_direction_reverse()) {
  243. quick_sort(keys, [](auto& a, auto& b) { return a > b; });
  244. } else {
  245. quick_sort(keys, [](auto& a, auto& b) { return a < b; });
  246. }
  247. for (auto key : keys) {
  248. auto order_bucket = order_item_bucket.get(key);
  249. if (order_bucket.has_value()) {
  250. auto& items = order_bucket.value();
  251. if (is_direction_reverse()) {
  252. for (auto item : items.in_reverse()) {
  253. m_flex_items.append(move(item));
  254. }
  255. } else {
  256. for (auto item : items) {
  257. m_flex_items.append(move(item));
  258. }
  259. }
  260. }
  261. }
  262. }
  263. bool FlexFormattingContext::has_definite_main_size(Box const& box) const
  264. {
  265. auto const& used_values = m_state.get(box);
  266. return is_row_layout() ? used_values.has_definite_width() : used_values.has_definite_height();
  267. }
  268. CSSPixels FlexFormattingContext::inner_main_size(Box const& box) const
  269. {
  270. auto const& box_state = m_state.get(box);
  271. return is_row_layout() ? box_state.content_width() : box_state.content_height();
  272. }
  273. CSSPixels FlexFormattingContext::inner_cross_size(Box const& box) const
  274. {
  275. auto const& box_state = m_state.get(box);
  276. return is_row_layout() ? box_state.content_height() : box_state.content_width();
  277. }
  278. bool FlexFormattingContext::has_main_min_size(Box const& box) const
  279. {
  280. auto const& value = is_row_layout() ? box.computed_values().min_width() : box.computed_values().min_height();
  281. return !value.is_auto();
  282. }
  283. bool FlexFormattingContext::has_cross_min_size(Box const& box) const
  284. {
  285. auto const& value = is_row_layout() ? box.computed_values().min_height() : box.computed_values().min_width();
  286. return !value.is_auto();
  287. }
  288. bool FlexFormattingContext::has_definite_cross_size(Box const& box) const
  289. {
  290. auto const& used_values = m_state.get(box);
  291. return is_row_layout() ? used_values.has_definite_height() : used_values.has_definite_width();
  292. }
  293. CSSPixels FlexFormattingContext::specified_main_min_size(Box const& box) const
  294. {
  295. return is_row_layout()
  296. ? get_pixel_width(box, box.computed_values().min_width())
  297. : get_pixel_height(box, box.computed_values().min_height());
  298. }
  299. CSSPixels FlexFormattingContext::specified_cross_min_size(Box const& box) const
  300. {
  301. return is_row_layout()
  302. ? get_pixel_height(box, box.computed_values().min_height())
  303. : get_pixel_width(box, box.computed_values().min_width());
  304. }
  305. bool FlexFormattingContext::has_main_max_size(Box const& box) const
  306. {
  307. auto const& value = is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
  308. return !value.is_none();
  309. }
  310. bool FlexFormattingContext::has_cross_max_size(Box const& box) const
  311. {
  312. auto const& value = !is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
  313. return !value.is_none();
  314. }
  315. CSSPixels FlexFormattingContext::specified_main_max_size(Box const& box) const
  316. {
  317. return is_row_layout()
  318. ? get_pixel_width(box, box.computed_values().max_width())
  319. : get_pixel_height(box, box.computed_values().max_height());
  320. }
  321. CSSPixels FlexFormattingContext::specified_cross_max_size(Box const& box) const
  322. {
  323. return is_row_layout()
  324. ? get_pixel_height(box, box.computed_values().max_height())
  325. : get_pixel_width(box, box.computed_values().max_width());
  326. }
  327. bool FlexFormattingContext::is_cross_auto(Box const& box) const
  328. {
  329. auto& cross_length = is_row_layout() ? box.computed_values().height() : box.computed_values().width();
  330. return cross_length.is_auto();
  331. }
  332. void FlexFormattingContext::set_main_size(Box const& box, CSSPixels size)
  333. {
  334. if (is_row_layout())
  335. m_state.get_mutable(box).set_content_width(size);
  336. else
  337. m_state.get_mutable(box).set_content_height(size);
  338. }
  339. void FlexFormattingContext::set_cross_size(Box const& box, CSSPixels size)
  340. {
  341. if (is_row_layout())
  342. m_state.get_mutable(box).set_content_height(size);
  343. else
  344. m_state.get_mutable(box).set_content_width(size);
  345. }
  346. void FlexFormattingContext::set_offset(Box const& box, CSSPixels main_offset, CSSPixels cross_offset)
  347. {
  348. if (is_row_layout())
  349. m_state.get_mutable(box).offset = CSSPixelPoint { main_offset, cross_offset };
  350. else
  351. m_state.get_mutable(box).offset = CSSPixelPoint { cross_offset, main_offset };
  352. }
  353. void FlexFormattingContext::set_main_axis_first_margin(FlexItem& item, CSSPixels margin)
  354. {
  355. item.margins.main_before = margin;
  356. if (is_row_layout())
  357. m_state.get_mutable(item.box).margin_left = margin;
  358. else
  359. m_state.get_mutable(item.box).margin_top = margin;
  360. }
  361. void FlexFormattingContext::set_main_axis_second_margin(FlexItem& item, CSSPixels margin)
  362. {
  363. item.margins.main_after = margin;
  364. if (is_row_layout())
  365. m_state.get_mutable(item.box).margin_right = margin;
  366. else
  367. m_state.get_mutable(item.box).margin_bottom = margin;
  368. }
  369. // https://drafts.csswg.org/css-flexbox-1/#algo-available
  370. void FlexFormattingContext::determine_available_space_for_items(AvailableSpace const& available_space)
  371. {
  372. // For each dimension, if that dimension of the flex container’s content box is a definite size, use that;
  373. // if that dimension of the flex container is being sized under a min or max-content constraint, the available space in that dimension is that constraint;
  374. // otherwise, subtract the flex container’s margin, border, and padding from the space available to the flex container in that dimension and use that value.
  375. // This might result in an infinite value.
  376. Optional<AvailableSize> available_width_for_items;
  377. if (m_flex_container_state.has_definite_width()) {
  378. available_width_for_items = AvailableSize::make_definite(m_flex_container_state.content_width());
  379. } else {
  380. if (available_space.width.is_intrinsic_sizing_constraint()) {
  381. available_width_for_items = available_space.width;
  382. } else {
  383. if (available_space.width.is_definite()) {
  384. auto remaining = available_space.width.to_px_or_zero()
  385. - m_flex_container_state.margin_left
  386. - m_flex_container_state.margin_right
  387. - m_flex_container_state.border_left
  388. - m_flex_container_state.padding_right
  389. - m_flex_container_state.padding_left
  390. - m_flex_container_state.padding_right;
  391. available_width_for_items = AvailableSize::make_definite(remaining);
  392. } else {
  393. available_width_for_items = AvailableSize::make_indefinite();
  394. }
  395. }
  396. }
  397. Optional<AvailableSize> available_height_for_items;
  398. if (m_flex_container_state.has_definite_height()) {
  399. available_height_for_items = AvailableSize::make_definite(m_flex_container_state.content_height());
  400. } else {
  401. if (available_space.height.is_intrinsic_sizing_constraint()) {
  402. available_height_for_items = available_space.height;
  403. } else {
  404. if (available_space.height.is_definite()) {
  405. auto remaining = available_space.height.to_px_or_zero()
  406. - m_flex_container_state.margin_top
  407. - m_flex_container_state.margin_bottom
  408. - m_flex_container_state.border_top
  409. - m_flex_container_state.padding_bottom
  410. - m_flex_container_state.padding_top
  411. - m_flex_container_state.padding_bottom;
  412. available_height_for_items = AvailableSize::make_definite(remaining);
  413. } else {
  414. available_height_for_items = AvailableSize::make_indefinite();
  415. }
  416. }
  417. }
  418. if (is_row_layout()) {
  419. m_available_space_for_items = AxisAgnosticAvailableSpace {
  420. .main = *available_width_for_items,
  421. .cross = *available_height_for_items,
  422. .space = { *available_width_for_items, *available_height_for_items },
  423. };
  424. } else {
  425. m_available_space_for_items = AxisAgnosticAvailableSpace {
  426. .main = *available_height_for_items,
  427. .cross = *available_width_for_items,
  428. .space = { *available_width_for_items, *available_height_for_items },
  429. };
  430. }
  431. }
  432. // https://drafts.csswg.org/css-flexbox-1/#propdef-flex-basis
  433. CSS::FlexBasis FlexFormattingContext::used_flex_basis_for_item(FlexItem const& item) const
  434. {
  435. auto flex_basis = item.box->computed_values().flex_basis();
  436. if (flex_basis.has<CSS::Size>() && flex_basis.get<CSS::Size>().is_auto()) {
  437. // https://drafts.csswg.org/css-flexbox-1/#valdef-flex-basis-auto
  438. // When specified on a flex item, the auto keyword retrieves the value of the main size property as the used flex-basis.
  439. // If that value is itself auto, then the used value is content.
  440. auto const& main_size = is_row_layout() ? item.box->computed_values().width() : item.box->computed_values().height();
  441. if (main_size.is_auto()) {
  442. flex_basis = CSS::FlexBasisContent {};
  443. } else {
  444. flex_basis = main_size;
  445. }
  446. }
  447. // For example, percentage values of flex-basis are resolved against the flex item’s containing block
  448. // (i.e. its flex container); and if that containing block’s size is indefinite,
  449. // the used value for flex-basis is content.
  450. if (flex_basis.has<CSS::Size>()
  451. && flex_basis.get<CSS::Size>().is_percentage()
  452. && !has_definite_main_size(flex_container())) {
  453. flex_basis = CSS::FlexBasisContent {};
  454. }
  455. return flex_basis;
  456. }
  457. CSSPixels FlexFormattingContext::calculate_main_size_from_cross_size_and_aspect_ratio(CSSPixels cross_size, CSSPixelFraction aspect_ratio) const
  458. {
  459. if (is_row_layout())
  460. return cross_size * aspect_ratio;
  461. return cross_size / aspect_ratio;
  462. }
  463. CSSPixels FlexFormattingContext::calculate_cross_size_from_main_size_and_aspect_ratio(CSSPixels main_size, CSSPixelFraction aspect_ratio) const
  464. {
  465. if (is_row_layout())
  466. return main_size / aspect_ratio;
  467. return main_size * aspect_ratio;
  468. }
  469. // This function takes a size in the main axis and adjusts it according to the aspect ratio of the box
  470. // if the min/max constraints in the cross axis forces us to come up with a new main axis size.
  471. CSSPixels FlexFormattingContext::adjust_main_size_through_aspect_ratio_for_cross_size_min_max_constraints(Box const& box, CSSPixels main_size, CSS::Size const& min_cross_size, CSS::Size const& max_cross_size) const
  472. {
  473. if (!max_cross_size.is_none()) {
  474. auto max_cross_size_px = max_cross_size.to_px(box, !is_row_layout() ? m_flex_container_state.content_width() : m_flex_container_state.content_height());
  475. main_size = min(main_size, calculate_main_size_from_cross_size_and_aspect_ratio(max_cross_size_px, box.preferred_aspect_ratio().value()));
  476. }
  477. if (!min_cross_size.is_auto()) {
  478. auto min_cross_size_px = min_cross_size.to_px(box, !is_row_layout() ? m_flex_container_state.content_width() : m_flex_container_state.content_height());
  479. main_size = max(main_size, calculate_main_size_from_cross_size_and_aspect_ratio(min_cross_size_px, box.preferred_aspect_ratio().value()));
  480. }
  481. return main_size;
  482. }
  483. // https://www.w3.org/TR/css-flexbox-1/#algo-main-item
  484. void FlexFormattingContext::determine_flex_base_size_and_hypothetical_main_size(FlexItem& item)
  485. {
  486. auto& child_box = item.box;
  487. item.flex_base_size = [&] {
  488. item.used_flex_basis = used_flex_basis_for_item(item);
  489. item.used_flex_basis_is_definite = [&](CSS::FlexBasis const& flex_basis) -> bool {
  490. if (!flex_basis.has<CSS::Size>())
  491. return false;
  492. auto const& size = flex_basis.get<CSS::Size>();
  493. if (size.is_auto() || size.is_min_content() || size.is_max_content() || size.is_fit_content())
  494. return false;
  495. if (size.is_length())
  496. return true;
  497. bool can_resolve_percentages = is_row_layout()
  498. ? m_flex_container_state.has_definite_width()
  499. : m_flex_container_state.has_definite_height();
  500. if (size.is_calculated()) {
  501. auto const& calc_value = size.calculated();
  502. if (calc_value.resolves_to_percentage())
  503. return can_resolve_percentages;
  504. if (calc_value.resolves_to_length()) {
  505. if (calc_value.contains_percentage())
  506. return can_resolve_percentages;
  507. return true;
  508. }
  509. return false;
  510. }
  511. VERIFY(size.is_percentage());
  512. return can_resolve_percentages;
  513. }(*item.used_flex_basis);
  514. // A. If the item has a definite used flex basis, that’s the flex base size.
  515. if (item.used_flex_basis_is_definite) {
  516. auto const& size = item.used_flex_basis->get<CSS::Size>();
  517. if (is_row_layout())
  518. return get_pixel_width(child_box, size);
  519. return get_pixel_height(child_box, size);
  520. }
  521. // B. If the flex item has ...
  522. // - an intrinsic aspect ratio,
  523. // - a used flex basis of content, and
  524. // - a definite cross size,
  525. if (item.box->has_preferred_aspect_ratio()
  526. && item.used_flex_basis->has<CSS::FlexBasisContent>()
  527. && has_definite_cross_size(item.box)) {
  528. // flex_base_size is calculated from definite cross size and intrinsic aspect ratio
  529. return adjust_main_size_through_aspect_ratio_for_cross_size_min_max_constraints(
  530. item.box,
  531. calculate_main_size_from_cross_size_and_aspect_ratio(inner_cross_size(item.box), item.box->preferred_aspect_ratio().value()),
  532. computed_cross_min_size(item.box),
  533. computed_cross_max_size(item.box));
  534. }
  535. // C. If the used flex basis is content or depends on its available space,
  536. // and the flex container is being sized under a min-content or max-content constraint
  537. // (e.g. when performing automatic table layout [CSS21]), size the item under that constraint.
  538. // The flex base size is the item’s resulting main size.
  539. if (item.used_flex_basis->has<CSS::FlexBasisContent>() && m_available_space_for_items->main.is_intrinsic_sizing_constraint()) {
  540. if (m_available_space_for_items->main.is_min_content())
  541. return calculate_min_content_main_size(item);
  542. return calculate_max_content_main_size(item);
  543. }
  544. // D. Otherwise, if the used flex basis is content or depends on its available space,
  545. // the available main size is infinite, and the flex item’s inline axis is parallel to the main axis,
  546. // lay the item out using the rules for a box in an orthogonal flow [CSS3-WRITING-MODES].
  547. // The flex base size is the item’s max-content main size.
  548. if (item.used_flex_basis->has<CSS::FlexBasisContent>()
  549. // FIXME: && main_size is infinite && inline axis is parallel to the main axis
  550. && false && false) {
  551. TODO();
  552. // Use rules for a flex_container in orthogonal flow
  553. }
  554. // E. Otherwise, size the item into the available space using its used flex basis in place of its main size,
  555. // treating a value of content as max-content. If a cross size is needed to determine the main size
  556. // (e.g. when the flex item’s main size is in its block axis) and the flex item’s cross size is auto and not definite,
  557. // in this calculation use fit-content as the flex item’s cross size.
  558. // The flex base size is the item’s resulting main size.
  559. // NOTE: If the flex item has a definite main size, just use that as the flex base size.
  560. if (has_definite_main_size(child_box))
  561. return inner_main_size(child_box);
  562. // NOTE: There's a fundamental problem with many CSS specifications in that they neglect to mention
  563. // which width to provide when calculating the intrinsic height of a box in various situations.
  564. // Spec bug: https://github.com/w3c/csswg-drafts/issues/2890
  565. // NOTE: This is one of many situations where that causes trouble: if this is a flex column layout,
  566. // we may need to calculate the intrinsic height of a flex item. This requires a width, but a
  567. // width won't be determined until later on in the flex layout algorithm.
  568. // In the specific case above (E), the spec mentions using `fit-content` in place of `auto`
  569. // if "a cross size is needed to determine the main size", so that's exactly what we do.
  570. // NOTE: Finding a suitable width for intrinsic height determination actually happens elsewhere,
  571. // in the various helpers that calculate the intrinsic sizes of a flex item,
  572. // e.g. calculate_min_content_main_size().
  573. if (item.used_flex_basis->has<CSS::FlexBasisContent>()) {
  574. return calculate_max_content_main_size(item);
  575. }
  576. return calculate_fit_content_main_size(item);
  577. }();
  578. // AD-HOC: This is not mentioned in the spec, but if the item has an aspect ratio,
  579. // we may need to adjust the main size in response to cross size min/max constraints.
  580. if (item.box->has_preferred_aspect_ratio()) {
  581. item.flex_base_size = adjust_main_size_through_aspect_ratio_for_cross_size_min_max_constraints(child_box, item.flex_base_size, computed_cross_min_size(child_box), computed_cross_max_size(child_box));
  582. }
  583. // The hypothetical main size is the item’s flex base size clamped according to its used min and max main sizes (and flooring the content box size at zero).
  584. auto clamp_min = has_main_min_size(child_box) ? specified_main_min_size(child_box) : automatic_minimum_size(item);
  585. auto clamp_max = has_main_max_size(child_box) ? specified_main_max_size(child_box) : CSSPixels::max();
  586. item.hypothetical_main_size = max(CSSPixels(0), css_clamp(item.flex_base_size, clamp_min, clamp_max));
  587. // NOTE: At this point, we set the hypothetical main size as the flex item's *temporary* main size.
  588. // The size may change again when we resolve flexible lengths, but this is necessary in order for
  589. // descendants of this flex item to resolve percentage sizes against something.
  590. //
  591. // The spec just barely hand-waves about this, but it seems to *roughly* match what other engines do.
  592. // See "Note" section here: https://drafts.csswg.org/css-flexbox-1/#definite-sizes
  593. if (is_row_layout())
  594. m_state.get_mutable(item.box).set_temporary_content_width(item.hypothetical_main_size);
  595. else
  596. m_state.get_mutable(item.box).set_temporary_content_height(item.hypothetical_main_size);
  597. }
  598. // https://drafts.csswg.org/css-flexbox-1/#min-size-auto
  599. CSSPixels FlexFormattingContext::automatic_minimum_size(FlexItem const& item) const
  600. {
  601. // To provide a more reasonable default minimum size for flex items,
  602. // the used value of a main axis automatic minimum size on a flex item that is not a scroll container is its content-based minimum size;
  603. // for scroll containers the automatic minimum size is zero, as usual.
  604. if (!item.box->is_scroll_container())
  605. return content_based_minimum_size(item);
  606. return 0;
  607. }
  608. // https://drafts.csswg.org/css-flexbox-1/#specified-size-suggestion
  609. Optional<CSSPixels> FlexFormattingContext::specified_size_suggestion(FlexItem const& item) const
  610. {
  611. // If the item’s preferred main size is definite and not automatic,
  612. // then the specified size suggestion is that size. It is otherwise undefined.
  613. if (has_definite_main_size(item.box) && !should_treat_main_size_as_auto(item.box)) {
  614. // NOTE: We use get_pixel_{width,height} to ensure that CSS box-sizing is respected.
  615. return is_row_layout() ? get_pixel_width(item.box, computed_main_size(item.box)) : get_pixel_height(item.box, computed_main_size(item.box));
  616. }
  617. return {};
  618. }
  619. // https://drafts.csswg.org/css-flexbox-1/#content-size-suggestion
  620. CSSPixels FlexFormattingContext::content_size_suggestion(FlexItem const& item) const
  621. {
  622. auto suggestion = calculate_min_content_main_size(item);
  623. if (item.box->has_preferred_aspect_ratio()) {
  624. suggestion = adjust_main_size_through_aspect_ratio_for_cross_size_min_max_constraints(item.box, suggestion, computed_cross_min_size(item.box), computed_cross_max_size(item.box));
  625. }
  626. return suggestion;
  627. }
  628. // https://drafts.csswg.org/css-flexbox-1/#transferred-size-suggestion
  629. Optional<CSSPixels> FlexFormattingContext::transferred_size_suggestion(FlexItem const& item) const
  630. {
  631. // If the item has a preferred aspect ratio and its preferred cross size is definite,
  632. // then the transferred size suggestion is that size
  633. // (clamped by its minimum and maximum cross sizes if they are definite), converted through the aspect ratio.
  634. if (item.box->has_preferred_aspect_ratio() && has_definite_cross_size(item.box)) {
  635. auto aspect_ratio = item.box->preferred_aspect_ratio().value();
  636. return adjust_main_size_through_aspect_ratio_for_cross_size_min_max_constraints(
  637. item.box,
  638. calculate_main_size_from_cross_size_and_aspect_ratio(inner_cross_size(item.box), aspect_ratio),
  639. computed_cross_min_size(item.box),
  640. computed_cross_max_size(item.box));
  641. }
  642. // It is otherwise undefined.
  643. return {};
  644. }
  645. // https://drafts.csswg.org/css-flexbox-1/#content-based-minimum-size
  646. CSSPixels FlexFormattingContext::content_based_minimum_size(FlexItem const& item) const
  647. {
  648. auto unclamped_size = [&] {
  649. // The content-based minimum size of a flex item is the smaller of its specified size suggestion
  650. // and its content size suggestion if its specified size suggestion exists;
  651. if (auto specified_size_suggestion = this->specified_size_suggestion(item); specified_size_suggestion.has_value()) {
  652. return min(specified_size_suggestion.value(), content_size_suggestion(item));
  653. }
  654. // otherwise, the smaller of its transferred size suggestion and its content size suggestion
  655. // if the element is replaced and its transferred size suggestion exists;
  656. if (item.box->is_replaced_box()) {
  657. if (auto transferred_size_suggestion = this->transferred_size_suggestion(item); transferred_size_suggestion.has_value()) {
  658. return min(transferred_size_suggestion.value(), content_size_suggestion(item));
  659. }
  660. }
  661. // otherwise its content size suggestion.
  662. return content_size_suggestion(item);
  663. }();
  664. // In all cases, the size is clamped by the maximum main size if it’s definite.
  665. if (has_main_max_size(item.box)) {
  666. return min(unclamped_size, specified_main_max_size(item.box));
  667. }
  668. return unclamped_size;
  669. }
  670. bool FlexFormattingContext::can_determine_size_of_child() const
  671. {
  672. return true;
  673. }
  674. void FlexFormattingContext::determine_width_of_child(Box const&, AvailableSpace const&)
  675. {
  676. // NOTE: For now, we simply do nothing here. If a child context is calling up to us
  677. // and asking us to determine its width, we've already done so as part of the
  678. // flex layout algorithm.
  679. }
  680. void FlexFormattingContext::determine_height_of_child(Box const&, AvailableSpace const&)
  681. {
  682. // NOTE: For now, we simply do nothing here. If a child context is calling up to us
  683. // and asking us to determine its height, we've already done so as part of the
  684. // flex layout algorithm.
  685. }
  686. // https://drafts.csswg.org/css-flexbox-1/#algo-main-container
  687. void FlexFormattingContext::determine_main_size_of_flex_container()
  688. {
  689. // Determine the main size of the flex container using the rules of the formatting context in which it participates.
  690. // NOTE: The automatic block size of a block-level flex container is its max-content size.
  691. // FIXME: The code below doesn't know how to size absolutely positioned flex containers at all.
  692. // We just leave it alone for now and let the parent context deal with it.
  693. if (flex_container().is_absolutely_positioned())
  694. return;
  695. // FIXME: Once all parent contexts now how to size a given child, we can remove
  696. // `can_determine_size_of_child()`.
  697. if (parent()->can_determine_size_of_child()) {
  698. if (is_row_layout()) {
  699. parent()->determine_width_of_child(flex_container(), m_available_space_for_flex_container->space);
  700. } else {
  701. parent()->determine_height_of_child(flex_container(), m_available_space_for_flex_container->space);
  702. }
  703. return;
  704. }
  705. if (is_row_layout()) {
  706. if (!flex_container().is_out_of_flow(*parent()) && m_state.get(*flex_container().containing_block()).has_definite_width()) {
  707. set_main_size(flex_container(), calculate_stretch_fit_width(flex_container(), m_available_space_for_flex_container->space.width));
  708. } else {
  709. set_main_size(flex_container(), calculate_max_content_width(flex_container()));
  710. }
  711. } else {
  712. if (!has_definite_main_size(flex_container()))
  713. set_main_size(flex_container(), calculate_max_content_height(flex_container(), m_available_space_for_flex_container->space.width.to_px_or_zero()));
  714. }
  715. }
  716. // https://www.w3.org/TR/css-flexbox-1/#algo-line-break
  717. void FlexFormattingContext::collect_flex_items_into_flex_lines()
  718. {
  719. // FIXME: Also support wrap-reverse
  720. // If the flex container is single-line, collect all the flex items into a single flex line.
  721. if (is_single_line()) {
  722. FlexLine line;
  723. for (auto& item : m_flex_items) {
  724. line.items.append(item);
  725. }
  726. m_flex_lines.append(move(line));
  727. return;
  728. }
  729. // Otherwise, starting from the first uncollected item, collect consecutive items one by one
  730. // until the first time that the next collected item would not fit into the flex container’s inner main size
  731. // (or until a forced break is encountered, see §10 Fragmenting Flex Layout).
  732. // If the very first uncollected item wouldn't fit, collect just it into the line.
  733. // For this step, the size of a flex item is its outer hypothetical main size. (Note: This can be negative.)
  734. // Repeat until all flex items have been collected into flex lines.
  735. FlexLine line;
  736. CSSPixels line_main_size = 0;
  737. for (auto& item : m_flex_items) {
  738. auto const outer_hypothetical_main_size = item.outer_hypothetical_main_size();
  739. if (!line.items.is_empty() && (line_main_size + outer_hypothetical_main_size) > m_available_space_for_items->main) {
  740. m_flex_lines.append(move(line));
  741. line = {};
  742. line_main_size = 0;
  743. }
  744. line.items.append(item);
  745. line_main_size += outer_hypothetical_main_size;
  746. // CSS-FLEXBOX-2: Account for gap between flex items.
  747. line_main_size += main_gap();
  748. }
  749. m_flex_lines.append(move(line));
  750. }
  751. // https://drafts.csswg.org/css-flexbox-1/#resolve-flexible-lengths
  752. void FlexFormattingContext::resolve_flexible_lengths_for_line(FlexLine& line)
  753. {
  754. // AD-HOC: The spec tells us to use the "flex container’s inner main size" in this algorithm,
  755. // but that doesn't work when we're sizing under a max-content constraint.
  756. // In that case, there is effectively infinite size available in the main axis,
  757. // but the inner main size has not been assigned yet.
  758. // We solve this by calculating our own "available main size" here, which is essentially
  759. // infinity under max-content, 0 under min-content, and the inner main size otherwise.
  760. AvailableSize available_main_size { AvailableSize::make_indefinite() };
  761. if (m_available_space_for_items->main.is_intrinsic_sizing_constraint())
  762. available_main_size = m_available_space_for_items->main;
  763. else
  764. available_main_size = AvailableSize::make_definite(inner_main_size(flex_container()));
  765. // 1. Determine the used flex factor.
  766. // Sum the outer hypothetical main sizes of all items on the line.
  767. // If the sum is less than the flex container’s inner main size,
  768. // use the flex grow factor for the rest of this algorithm; otherwise, use the flex shrink factor
  769. enum FlexFactor {
  770. FlexGrowFactor,
  771. FlexShrinkFactor
  772. };
  773. auto used_flex_factor = [&]() -> FlexFactor {
  774. CSSPixels sum = 0;
  775. for (auto const& item : line.items) {
  776. sum += item.outer_hypothetical_main_size();
  777. }
  778. // CSS-FLEXBOX-2: Account for gap between flex items.
  779. sum += main_gap() * (line.items.size() - 1);
  780. // AD-HOC: Note that we're using our own "available main size" explained above
  781. // instead of the flex container’s inner main size.
  782. if (sum < available_main_size)
  783. return FlexFactor::FlexGrowFactor;
  784. return FlexFactor::FlexShrinkFactor;
  785. }();
  786. // 2. Each item in the flex line has a target main size, initially set to its flex base size.
  787. // Each item is initially unfrozen and may become frozen.
  788. for (auto& item : line.items) {
  789. item.target_main_size = item.flex_base_size;
  790. item.frozen = false;
  791. }
  792. // 3. Size inflexible items.
  793. for (FlexItem& item : line.items) {
  794. if (used_flex_factor == FlexFactor::FlexGrowFactor) {
  795. item.flex_factor = item.box->computed_values().flex_grow();
  796. } else if (used_flex_factor == FlexFactor::FlexShrinkFactor) {
  797. item.flex_factor = item.box->computed_values().flex_shrink();
  798. }
  799. // Freeze, setting its target main size to its hypothetical main size…
  800. // - any item that has a flex factor of zero
  801. // - if using the flex grow factor: any item that has a flex base size greater than its hypothetical main size
  802. // - if using the flex shrink factor: any item that has a flex base size smaller than its hypothetical main size
  803. if (item.flex_factor.value() == 0
  804. || (used_flex_factor == FlexFactor::FlexGrowFactor && item.flex_base_size > item.hypothetical_main_size)
  805. || (used_flex_factor == FlexFactor::FlexShrinkFactor && item.flex_base_size < item.hypothetical_main_size)) {
  806. item.frozen = true;
  807. item.target_main_size = item.hypothetical_main_size;
  808. }
  809. }
  810. // 4. Calculate initial free space
  811. // Sum the outer sizes of all items on the line, and subtract this from the flex container’s inner main size.
  812. // For frozen items, use their outer target main size; for other items, use their outer flex base size.
  813. auto calculate_remaining_free_space = [&]() -> Optional<CSSPixels> {
  814. // AD-HOC: If the container is sized under max-content constraints, then remaining_free_space won't have
  815. // a value to avoid leaking an infinite value into layout calculations.
  816. if (available_main_size.is_intrinsic_sizing_constraint())
  817. return {};
  818. CSSPixels sum = 0;
  819. for (auto const& item : line.items) {
  820. if (item.frozen)
  821. sum += item.outer_target_main_size();
  822. else
  823. sum += item.outer_flex_base_size();
  824. }
  825. // CSS-FLEXBOX-2: Account for gap between flex items.
  826. sum += main_gap() * (line.items.size() - 1);
  827. // AD-HOC: Note that we're using our own "available main size" explained above
  828. // instead of the flex container’s inner main size.
  829. return available_main_size.to_px_or_zero() - sum;
  830. };
  831. auto const initial_free_space = calculate_remaining_free_space();
  832. // 5. Loop
  833. while (true) {
  834. // a. Check for flexible items.
  835. // If all the flex items on the line are frozen, free space has been distributed; exit this loop.
  836. if (all_of(line.items, [](auto const& item) { return item.frozen; })) {
  837. break;
  838. }
  839. // b. Calculate the remaining free space as for initial free space, above.
  840. line.remaining_free_space = calculate_remaining_free_space();
  841. // If the sum of the unfrozen flex items’ flex factors is less than one, multiply the initial free space by this sum.
  842. if (auto sum_of_flex_factor_of_unfrozen_items = line.sum_of_flex_factor_of_unfrozen_items(); sum_of_flex_factor_of_unfrozen_items < 1 && initial_free_space.has_value()) {
  843. auto value = CSSPixels::nearest_value_for(initial_free_space.value() * sum_of_flex_factor_of_unfrozen_items);
  844. // If the magnitude of this value is less than the magnitude of the remaining free space, use this as the remaining free space.
  845. if (abs(value) < abs(line.remaining_free_space.value()))
  846. line.remaining_free_space = value;
  847. }
  848. // AD-HOC: We allow the remaining free space to be infinite, but we can't let infinity
  849. // leak into the layout geometry, so we treat infinity as zero when used in arithmetic.
  850. auto remaining_free_space_or_zero_if_infinite = line.remaining_free_space.has_value() ? line.remaining_free_space.value() : 0;
  851. // c. If the remaining free space is non-zero, distribute it proportional to the flex factors:
  852. if (line.remaining_free_space != 0) {
  853. // If using the flex grow factor
  854. if (used_flex_factor == FlexFactor::FlexGrowFactor) {
  855. // For every unfrozen item on the line,
  856. // find the ratio of the item’s flex grow factor to the sum of the flex grow factors of all unfrozen items on the line.
  857. auto sum_of_flex_factor_of_unfrozen_items = line.sum_of_flex_factor_of_unfrozen_items();
  858. for (auto& item : line.items) {
  859. if (item.frozen)
  860. continue;
  861. double ratio = item.flex_factor.value() / sum_of_flex_factor_of_unfrozen_items;
  862. // Set the item’s target main size to its flex base size plus a fraction of the remaining free space proportional to the ratio.
  863. item.target_main_size = item.flex_base_size + remaining_free_space_or_zero_if_infinite.scaled(ratio);
  864. }
  865. }
  866. // If using the flex shrink factor
  867. else if (used_flex_factor == FlexFactor::FlexShrinkFactor) {
  868. // For every unfrozen item on the line, multiply its flex shrink factor by its inner flex base size, and note this as its scaled flex shrink factor.
  869. for (auto& item : line.items) {
  870. if (item.frozen)
  871. continue;
  872. item.scaled_flex_shrink_factor = item.flex_factor.value() * item.flex_base_size.to_double();
  873. }
  874. auto sum_of_scaled_flex_shrink_factors_of_all_unfrozen_items_on_line = line.sum_of_scaled_flex_shrink_factor_of_unfrozen_items();
  875. for (auto& item : line.items) {
  876. if (item.frozen)
  877. continue;
  878. // Find the ratio of the item’s scaled flex shrink factor to the sum of the scaled flex shrink factors of all unfrozen items on the line.
  879. double ratio = 1.0;
  880. if (sum_of_scaled_flex_shrink_factors_of_all_unfrozen_items_on_line != 0)
  881. ratio = item.scaled_flex_shrink_factor / sum_of_scaled_flex_shrink_factors_of_all_unfrozen_items_on_line;
  882. // Set the item’s target main size to its flex base size minus a fraction of the absolute value of the remaining free space proportional to the ratio.
  883. // (Note this may result in a negative inner main size; it will be corrected in the next step.)
  884. item.target_main_size = item.flex_base_size - abs(remaining_free_space_or_zero_if_infinite).scaled(ratio);
  885. }
  886. }
  887. }
  888. // d. Fix min/max violations.
  889. CSSPixels total_violation = 0;
  890. // Clamp each non-frozen item’s target main size by its used min and max main sizes and floor its content-box size at zero.
  891. for (auto& item : line.items) {
  892. if (item.frozen)
  893. continue;
  894. auto used_min_main_size = has_main_min_size(item.box)
  895. ? specified_main_min_size(item.box)
  896. : automatic_minimum_size(item);
  897. auto used_max_main_size = has_main_max_size(item.box)
  898. ? specified_main_max_size(item.box)
  899. : CSSPixels::max();
  900. auto original_target_main_size = item.target_main_size;
  901. item.target_main_size = css_clamp(item.target_main_size, used_min_main_size, used_max_main_size);
  902. item.target_main_size = max(item.target_main_size, CSSPixels(0));
  903. // If the item’s target main size was made smaller by this, it’s a max violation.
  904. if (item.target_main_size < original_target_main_size)
  905. item.is_max_violation = true;
  906. // If the item’s target main size was made larger by this, it’s a min violation.
  907. if (item.target_main_size > original_target_main_size)
  908. item.is_min_violation = true;
  909. total_violation += item.target_main_size - original_target_main_size;
  910. }
  911. // e. Freeze over-flexed items.
  912. // The total violation is the sum of the adjustments from the previous step ∑(clamped size - unclamped size).
  913. // If the total violation is:
  914. // Zero
  915. // Freeze all items.
  916. if (total_violation == 0) {
  917. for (auto& item : line.items) {
  918. if (!item.frozen)
  919. item.frozen = true;
  920. }
  921. }
  922. // Positive
  923. // Freeze all the items with min violations.
  924. else if (total_violation > 0) {
  925. for (auto& item : line.items) {
  926. if (!item.frozen && item.is_min_violation)
  927. item.frozen = true;
  928. }
  929. }
  930. // Negative
  931. // Freeze all the items with max violations.
  932. else {
  933. for (auto& item : line.items) {
  934. if (!item.frozen && item.is_max_violation)
  935. item.frozen = true;
  936. }
  937. }
  938. // NOTE: This freezes at least one item, ensuring that the loop makes progress and eventually terminates.
  939. // f. Return to the start of this loop.
  940. }
  941. // NOTE: Calculate the remaining free space once again here, since it's needed later when aligning items.
  942. line.remaining_free_space = calculate_remaining_free_space();
  943. // 6. Set each item’s used main size to its target main size.
  944. for (auto& item : line.items) {
  945. item.main_size = item.target_main_size;
  946. set_main_size(item.box, item.target_main_size);
  947. }
  948. }
  949. // https://drafts.csswg.org/css-flexbox-1/#resolve-flexible-lengths
  950. void FlexFormattingContext::resolve_flexible_lengths()
  951. {
  952. for (auto& line : m_flex_lines) {
  953. resolve_flexible_lengths_for_line(line);
  954. }
  955. }
  956. // https://drafts.csswg.org/css-flexbox-1/#algo-cross-item
  957. void FlexFormattingContext::determine_hypothetical_cross_size_of_item(FlexItem& item, bool resolve_percentage_min_max_sizes)
  958. {
  959. // Determine the hypothetical cross size of each item by performing layout
  960. // as if it were an in-flow block-level box with the used main size
  961. // and the given available space, treating auto as fit-content.
  962. auto const& computed_min_size = this->computed_cross_min_size(item.box);
  963. auto const& computed_max_size = this->computed_cross_max_size(item.box);
  964. auto clamp_min = (!computed_min_size.is_auto() && (resolve_percentage_min_max_sizes || !computed_min_size.contains_percentage())) ? specified_cross_min_size(item.box) : 0;
  965. auto clamp_max = (!computed_max_size.is_none() && (resolve_percentage_min_max_sizes || !computed_max_size.contains_percentage())) ? specified_cross_max_size(item.box) : CSSPixels::max();
  966. // If we have a definite cross size, this is easy! No need to perform layout, we can just use it as-is.
  967. if (has_definite_cross_size(item.box)) {
  968. // To avoid subtracting padding and border twice for `box-sizing: border-box` only min and max clamp should happen on a second pass
  969. if (resolve_percentage_min_max_sizes) {
  970. item.hypothetical_cross_size = css_clamp(item.hypothetical_cross_size, clamp_min, clamp_max);
  971. return;
  972. }
  973. item.hypothetical_cross_size = css_clamp(inner_cross_size(item.box), clamp_min, clamp_max);
  974. return;
  975. }
  976. if (item.box->has_preferred_aspect_ratio() && item.main_size.has_value()) {
  977. item.hypothetical_cross_size = calculate_cross_size_from_main_size_and_aspect_ratio(item.main_size.value(), item.box->preferred_aspect_ratio().value());
  978. return;
  979. }
  980. auto computed_cross_size = [&]() -> CSS::Size {
  981. // "... treating auto as fit-content"
  982. if (should_treat_cross_size_as_auto(item.box))
  983. return CSS::Size::make_fit_content();
  984. return this->computed_cross_size(item.box);
  985. }();
  986. if (computed_cross_size.is_min_content()) {
  987. item.hypothetical_cross_size = css_clamp(calculate_min_content_cross_size(item), clamp_min, clamp_max);
  988. return;
  989. }
  990. if (computed_cross_size.is_max_content()) {
  991. item.hypothetical_cross_size = css_clamp(calculate_max_content_cross_size(item), clamp_min, clamp_max);
  992. return;
  993. }
  994. if (computed_cross_size.is_fit_content()) {
  995. CSSPixels fit_content_cross_size = 0;
  996. if (is_row_layout()) {
  997. auto available_width = item.main_size.has_value() ? AvailableSize::make_definite(item.main_size.value()) : AvailableSize::make_indefinite();
  998. auto available_height = AvailableSize::make_indefinite();
  999. fit_content_cross_size = calculate_fit_content_height(item.box, AvailableSpace(available_width, available_height));
  1000. } else {
  1001. fit_content_cross_size = calculate_fit_content_width(item.box, m_available_space_for_items->space);
  1002. }
  1003. item.hypothetical_cross_size = css_clamp(fit_content_cross_size, clamp_min, clamp_max);
  1004. return;
  1005. }
  1006. // For indefinite cross sizes, we perform a throwaway layout and then measure it.
  1007. LayoutState throwaway_state(&m_state);
  1008. auto& box_state = throwaway_state.get_mutable(item.box);
  1009. if (is_row_layout()) {
  1010. box_state.set_content_width(item.main_size.value());
  1011. } else {
  1012. box_state.set_content_height(item.main_size.value());
  1013. }
  1014. // Item has definite main size, layout with that as the used main size.
  1015. auto independent_formatting_context = create_independent_formatting_context_if_needed(throwaway_state, item.box);
  1016. // NOTE: Flex items should always create an independent formatting context!
  1017. VERIFY(independent_formatting_context);
  1018. auto available_width = is_row_layout() ? AvailableSize::make_definite(item.main_size.value()) : AvailableSize::make_indefinite();
  1019. auto available_height = is_row_layout() ? AvailableSize::make_indefinite() : AvailableSize::make_definite(item.main_size.value());
  1020. independent_formatting_context->run(item.box, LayoutMode::Normal, AvailableSpace(available_width, available_height));
  1021. auto automatic_cross_size = is_row_layout() ? independent_formatting_context->automatic_content_height()
  1022. : independent_formatting_context->automatic_content_width();
  1023. item.hypothetical_cross_size = css_clamp(automatic_cross_size, clamp_min, clamp_max);
  1024. }
  1025. // https://www.w3.org/TR/css-flexbox-1/#algo-cross-line
  1026. void FlexFormattingContext::calculate_cross_size_of_each_flex_line()
  1027. {
  1028. // If the flex container is single-line and has a definite cross size, the cross size of the flex line is the flex container’s inner cross size.
  1029. if (is_single_line() && has_definite_cross_size(flex_container())) {
  1030. m_flex_lines[0].cross_size = inner_cross_size(flex_container());
  1031. return;
  1032. }
  1033. // Otherwise, for each flex line:
  1034. for (auto& flex_line : m_flex_lines) {
  1035. // FIXME: 1. Collect all the flex items whose inline-axis is parallel to the main-axis, whose align-self is baseline,
  1036. // and whose cross-axis margins are both non-auto. Find the largest of the distances between each item’s baseline
  1037. // and its hypothetical outer cross-start edge, and the largest of the distances between each item’s baseline
  1038. // and its hypothetical outer cross-end edge, and sum these two values.
  1039. // 2. Among all the items not collected by the previous step, find the largest outer hypothetical cross size.
  1040. CSSPixels largest_hypothetical_cross_size = 0;
  1041. for (auto& item : flex_line.items) {
  1042. if (largest_hypothetical_cross_size < item.hypothetical_cross_size_with_margins())
  1043. largest_hypothetical_cross_size = item.hypothetical_cross_size_with_margins();
  1044. }
  1045. // 3. The used cross-size of the flex line is the largest of the numbers found in the previous two steps and zero.
  1046. flex_line.cross_size = max(CSSPixels(0), largest_hypothetical_cross_size);
  1047. }
  1048. // If the flex container is single-line, then clamp the line’s cross-size to be within the container’s computed min and max cross sizes.
  1049. // Note that if CSS 2.1’s definition of min/max-width/height applied more generally, this behavior would fall out automatically.
  1050. // AD-HOC: We don't do this when the flex container is being sized under a min-content or max-content constraint.
  1051. if (is_single_line() && !m_available_space_for_flex_container->cross.is_intrinsic_sizing_constraint()) {
  1052. auto const& computed_min_size = this->computed_cross_min_size(flex_container());
  1053. auto const& computed_max_size = this->computed_cross_max_size(flex_container());
  1054. auto cross_min_size = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_cross_min_size(flex_container()) : 0;
  1055. auto cross_max_size = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_cross_max_size(flex_container()) : CSSPixels::max();
  1056. m_flex_lines[0].cross_size = css_clamp(m_flex_lines[0].cross_size, cross_min_size, cross_max_size);
  1057. }
  1058. }
  1059. // https://www.w3.org/TR/css-flexbox-1/#algo-stretch
  1060. void FlexFormattingContext::determine_used_cross_size_of_each_flex_item()
  1061. {
  1062. for (auto& flex_line : m_flex_lines) {
  1063. for (auto& item : flex_line.items) {
  1064. // If a flex item has align-self: stretch, its computed cross size property is auto,
  1065. // and neither of its cross-axis margins are auto, the used outer cross size is the used cross size of its flex line,
  1066. // clamped according to the item’s used min and max cross sizes.
  1067. auto flex_item_alignment = alignment_for_item(item.box);
  1068. if ((flex_item_alignment == CSS::AlignItems::Stretch || flex_item_alignment == CSS::AlignItems::Normal)
  1069. && is_cross_auto(item.box)
  1070. && !item.margins.cross_before_is_auto
  1071. && !item.margins.cross_after_is_auto) {
  1072. auto unclamped_cross_size = flex_line.cross_size
  1073. - item.margins.cross_before - item.margins.cross_after
  1074. - item.padding.cross_before - item.padding.cross_after
  1075. - item.borders.cross_before - item.borders.cross_after;
  1076. auto const& computed_min_size = computed_cross_min_size(item.box);
  1077. auto const& computed_max_size = computed_cross_max_size(item.box);
  1078. auto cross_min_size = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_cross_min_size(item.box) : 0;
  1079. auto cross_max_size = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_cross_max_size(item.box) : CSSPixels::max();
  1080. item.cross_size = css_clamp(unclamped_cross_size, cross_min_size, cross_max_size);
  1081. } else {
  1082. // Otherwise, the used cross size is the item’s hypothetical cross size.
  1083. item.cross_size = item.hypothetical_cross_size;
  1084. }
  1085. }
  1086. }
  1087. }
  1088. // https://www.w3.org/TR/css-flexbox-1/#algo-main-align
  1089. void FlexFormattingContext::distribute_any_remaining_free_space()
  1090. {
  1091. for (auto& flex_line : m_flex_lines) {
  1092. // 12.1.
  1093. CSSPixels used_main_space = 0;
  1094. size_t auto_margins = 0;
  1095. for (auto& item : flex_line.items) {
  1096. used_main_space += item.main_size.value();
  1097. if (item.margins.main_before_is_auto)
  1098. ++auto_margins;
  1099. if (item.margins.main_after_is_auto)
  1100. ++auto_margins;
  1101. used_main_space += item.margins.main_before + item.margins.main_after
  1102. + item.borders.main_before + item.borders.main_after
  1103. + item.padding.main_before + item.padding.main_after;
  1104. }
  1105. // CSS-FLEXBOX-2: Account for gap between flex items.
  1106. used_main_space += main_gap() * (flex_line.items.size() - 1);
  1107. if (flex_line.remaining_free_space.has_value() && flex_line.remaining_free_space.value() > 0 && auto_margins > 0) {
  1108. CSSPixels size_per_auto_margin = flex_line.remaining_free_space.value() / auto_margins;
  1109. for (auto& item : flex_line.items) {
  1110. if (item.margins.main_before_is_auto)
  1111. set_main_axis_first_margin(item, size_per_auto_margin);
  1112. if (item.margins.main_after_is_auto)
  1113. set_main_axis_second_margin(item, size_per_auto_margin);
  1114. }
  1115. } else {
  1116. for (auto& item : flex_line.items) {
  1117. if (item.margins.main_before_is_auto)
  1118. set_main_axis_first_margin(item, 0);
  1119. if (item.margins.main_after_is_auto)
  1120. set_main_axis_second_margin(item, 0);
  1121. }
  1122. }
  1123. // 12.2.
  1124. // CSS-FLEXBOX-2: Account for gap between items.
  1125. CSSPixels space_between_items = main_gap();
  1126. CSSPixels initial_offset = 0;
  1127. auto number_of_items = flex_line.items.size();
  1128. if (auto_margins == 0 && number_of_items > 0) {
  1129. switch (flex_container().computed_values().justify_content()) {
  1130. case CSS::JustifyContent::Start:
  1131. initial_offset = 0;
  1132. break;
  1133. case CSS::JustifyContent::Stretch:
  1134. case CSS::JustifyContent::Normal:
  1135. case CSS::JustifyContent::FlexStart:
  1136. if (is_direction_reverse()) {
  1137. initial_offset = inner_main_size(flex_container());
  1138. } else {
  1139. initial_offset = 0;
  1140. }
  1141. break;
  1142. case CSS::JustifyContent::End:
  1143. initial_offset = inner_main_size(flex_container());
  1144. break;
  1145. case CSS::JustifyContent::FlexEnd:
  1146. if (is_direction_reverse()) {
  1147. initial_offset = 0;
  1148. } else {
  1149. initial_offset = inner_main_size(flex_container());
  1150. }
  1151. break;
  1152. case CSS::JustifyContent::Center:
  1153. initial_offset = (inner_main_size(flex_container()) - used_main_space) / 2;
  1154. if (is_direction_reverse()) {
  1155. initial_offset = inner_main_size(flex_container()) - initial_offset;
  1156. }
  1157. break;
  1158. case CSS::JustifyContent::SpaceBetween:
  1159. if (is_direction_reverse()) {
  1160. initial_offset = inner_main_size(flex_container());
  1161. } else {
  1162. initial_offset = 0;
  1163. }
  1164. if (flex_line.remaining_free_space.has_value() && number_of_items > 1)
  1165. space_between_items = flex_line.remaining_free_space.value() / (number_of_items - 1);
  1166. break;
  1167. case CSS::JustifyContent::SpaceAround:
  1168. if (flex_line.remaining_free_space.has_value())
  1169. space_between_items = flex_line.remaining_free_space.value() / number_of_items;
  1170. if (is_direction_reverse()) {
  1171. initial_offset = inner_main_size(flex_container()) - space_between_items / 2;
  1172. } else {
  1173. initial_offset = space_between_items / 2;
  1174. }
  1175. break;
  1176. case CSS::JustifyContent::SpaceEvenly:
  1177. if (flex_line.remaining_free_space.has_value())
  1178. space_between_items = flex_line.remaining_free_space.value() / (number_of_items + 1);
  1179. if (is_direction_reverse()) {
  1180. initial_offset = inner_main_size(flex_container()) - space_between_items;
  1181. } else {
  1182. initial_offset = space_between_items;
  1183. }
  1184. break;
  1185. }
  1186. }
  1187. // For reverse, we use FlexRegionRenderCursor::Right
  1188. // to indicate the cursor offset is the end and render backwards
  1189. // Otherwise the cursor offset is the 'start' of the region or initial offset
  1190. enum class FlexRegionRenderCursor {
  1191. Left,
  1192. Right
  1193. };
  1194. auto flex_region_render_cursor = FlexRegionRenderCursor::Left;
  1195. if (auto_margins == 0) {
  1196. switch (flex_container().computed_values().justify_content()) {
  1197. case CSS::JustifyContent::Normal:
  1198. case CSS::JustifyContent::FlexStart:
  1199. case CSS::JustifyContent::Center:
  1200. case CSS::JustifyContent::SpaceAround:
  1201. case CSS::JustifyContent::SpaceBetween:
  1202. case CSS::JustifyContent::SpaceEvenly:
  1203. case CSS::JustifyContent::Stretch:
  1204. if (is_direction_reverse()) {
  1205. flex_region_render_cursor = FlexRegionRenderCursor::Right;
  1206. }
  1207. break;
  1208. case CSS::JustifyContent::End:
  1209. flex_region_render_cursor = FlexRegionRenderCursor::Right;
  1210. break;
  1211. case CSS::JustifyContent::FlexEnd:
  1212. if (!is_direction_reverse()) {
  1213. flex_region_render_cursor = FlexRegionRenderCursor::Right;
  1214. }
  1215. break;
  1216. default:
  1217. break;
  1218. }
  1219. }
  1220. CSSPixels cursor_offset = initial_offset;
  1221. auto place_item = [&](FlexItem& item) {
  1222. auto amount_of_main_size_used = item.main_size.value()
  1223. + item.margins.main_before
  1224. + item.borders.main_before
  1225. + item.padding.main_before
  1226. + item.margins.main_after
  1227. + item.borders.main_after
  1228. + item.padding.main_after
  1229. + space_between_items;
  1230. if (is_direction_reverse() && flex_region_render_cursor == FlexRegionRenderCursor::Right) {
  1231. item.main_offset = cursor_offset - item.main_size.value() - item.margins.main_after - item.borders.main_after - item.padding.main_after;
  1232. cursor_offset -= amount_of_main_size_used;
  1233. } else if (flex_region_render_cursor == FlexRegionRenderCursor::Right) {
  1234. cursor_offset -= amount_of_main_size_used;
  1235. item.main_offset = cursor_offset + item.margins.main_before + item.borders.main_before + item.padding.main_before;
  1236. } else {
  1237. item.main_offset = cursor_offset + item.margins.main_before + item.borders.main_before + item.padding.main_before;
  1238. cursor_offset += amount_of_main_size_used;
  1239. }
  1240. };
  1241. if (flex_region_render_cursor == FlexRegionRenderCursor::Right) {
  1242. for (ssize_t i = flex_line.items.size() - 1; i >= 0; --i) {
  1243. auto& item = flex_line.items[i];
  1244. place_item(item);
  1245. }
  1246. } else {
  1247. for (size_t i = 0; i < flex_line.items.size(); ++i) {
  1248. auto& item = flex_line.items[i];
  1249. place_item(item);
  1250. }
  1251. }
  1252. }
  1253. }
  1254. void FlexFormattingContext::dump_items() const
  1255. {
  1256. dbgln("\033[34;1mflex-container\033[0m {}, direction: {}, current-size: {}x{}", flex_container().debug_description(), is_row_layout() ? "row" : "column", m_flex_container_state.content_width(), m_flex_container_state.content_height());
  1257. for (size_t i = 0; i < m_flex_lines.size(); ++i) {
  1258. dbgln("{} flex-line #{}:", flex_container().debug_description(), i);
  1259. for (size_t j = 0; j < m_flex_lines[i].items.size(); ++j) {
  1260. auto& item = m_flex_lines[i].items[j];
  1261. dbgln("{} flex-item #{}: {} (main:{}, cross:{})", flex_container().debug_description(), j, item.box->debug_description(), item.main_size.value_or(-1), item.cross_size.value_or(-1));
  1262. }
  1263. }
  1264. }
  1265. CSS::AlignItems FlexFormattingContext::alignment_for_item(Box const& box) const
  1266. {
  1267. switch (box.computed_values().align_self()) {
  1268. case CSS::AlignSelf::Auto:
  1269. return flex_container().computed_values().align_items();
  1270. case CSS::AlignSelf::End:
  1271. return CSS::AlignItems::End;
  1272. case CSS::AlignSelf::Normal:
  1273. return CSS::AlignItems::Normal;
  1274. case CSS::AlignSelf::SelfStart:
  1275. return CSS::AlignItems::SelfStart;
  1276. case CSS::AlignSelf::SelfEnd:
  1277. return CSS::AlignItems::SelfEnd;
  1278. case CSS::AlignSelf::FlexStart:
  1279. return CSS::AlignItems::FlexStart;
  1280. case CSS::AlignSelf::FlexEnd:
  1281. return CSS::AlignItems::FlexEnd;
  1282. case CSS::AlignSelf::Center:
  1283. return CSS::AlignItems::Center;
  1284. case CSS::AlignSelf::Baseline:
  1285. return CSS::AlignItems::Baseline;
  1286. case CSS::AlignSelf::Start:
  1287. return CSS::AlignItems::Start;
  1288. case CSS::AlignSelf::Stretch:
  1289. return CSS::AlignItems::Stretch;
  1290. case CSS::AlignSelf::Safe:
  1291. return CSS::AlignItems::Safe;
  1292. case CSS::AlignSelf::Unsafe:
  1293. return CSS::AlignItems::Unsafe;
  1294. default:
  1295. VERIFY_NOT_REACHED();
  1296. }
  1297. }
  1298. void FlexFormattingContext::align_all_flex_items_along_the_cross_axis()
  1299. {
  1300. // FIXME: Take better care of margins
  1301. for (auto& flex_line : m_flex_lines) {
  1302. for (auto& item : flex_line.items) {
  1303. CSSPixels half_line_size = flex_line.cross_size / 2;
  1304. switch (alignment_for_item(item.box)) {
  1305. case CSS::AlignItems::Baseline:
  1306. // FIXME: Implement this
  1307. // Fallthrough
  1308. case CSS::AlignItems::Start:
  1309. case CSS::AlignItems::FlexStart:
  1310. case CSS::AlignItems::Stretch:
  1311. case CSS::AlignItems::Normal:
  1312. item.cross_offset = -half_line_size + item.margins.cross_before + item.borders.cross_before + item.padding.cross_before;
  1313. break;
  1314. case CSS::AlignItems::End:
  1315. case CSS::AlignItems::FlexEnd:
  1316. item.cross_offset = half_line_size - item.cross_size.value() - item.margins.cross_after - item.borders.cross_after - item.padding.cross_after;
  1317. break;
  1318. case CSS::AlignItems::Center:
  1319. item.cross_offset = -(item.cross_size.value() / 2);
  1320. break;
  1321. default:
  1322. break;
  1323. }
  1324. }
  1325. }
  1326. }
  1327. // https://www.w3.org/TR/css-flexbox-1/#algo-cross-container
  1328. void FlexFormattingContext::determine_flex_container_used_cross_size()
  1329. {
  1330. CSSPixels cross_size = 0;
  1331. if (has_definite_cross_size(flex_container())) {
  1332. // Flex container has definite cross size: easy-peasy.
  1333. cross_size = inner_cross_size(flex_container());
  1334. } else {
  1335. // Flex container has indefinite cross size.
  1336. auto cross_size_value = is_row_layout() ? flex_container().computed_values().height() : flex_container().computed_values().width();
  1337. if (cross_size_value.is_auto() || cross_size_value.contains_percentage()) {
  1338. // If a content-based cross size is needed, use the sum of the flex lines' cross sizes.
  1339. CSSPixels sum_of_flex_lines_cross_sizes = 0;
  1340. for (auto& flex_line : m_flex_lines) {
  1341. sum_of_flex_lines_cross_sizes += flex_line.cross_size;
  1342. }
  1343. cross_size = sum_of_flex_lines_cross_sizes;
  1344. if (cross_size_value.contains_percentage()) {
  1345. // FIXME: Handle percentage values here! Right now we're just treating them as "auto"
  1346. }
  1347. } else {
  1348. // Otherwise, resolve the indefinite size at this point.
  1349. cross_size = cross_size_value.to_px(flex_container(), inner_cross_size(*flex_container().containing_block()));
  1350. }
  1351. }
  1352. // AD-HOC: We don't apply min/max cross size constraints when sizing the flex container under an intrinsic sizing constraint.
  1353. if (!m_available_space_for_flex_container->cross.is_intrinsic_sizing_constraint()) {
  1354. auto const& computed_min_size = this->computed_cross_min_size(flex_container());
  1355. auto const& computed_max_size = this->computed_cross_max_size(flex_container());
  1356. auto cross_min_size = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_cross_min_size(flex_container()) : 0;
  1357. auto cross_max_size = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_cross_max_size(flex_container()) : CSSPixels::max();
  1358. set_cross_size(flex_container(), css_clamp(cross_size, cross_min_size, cross_max_size));
  1359. } else {
  1360. set_cross_size(flex_container(), cross_size);
  1361. }
  1362. }
  1363. // https://www.w3.org/TR/css-flexbox-1/#algo-line-align
  1364. void FlexFormattingContext::align_all_flex_lines()
  1365. {
  1366. if (m_flex_lines.is_empty())
  1367. return;
  1368. // FIXME: Support reverse
  1369. CSSPixels cross_size_of_flex_container = inner_cross_size(flex_container());
  1370. if (is_single_line()) {
  1371. // For single-line flex containers, we only need to center the line along the cross axis.
  1372. auto& flex_line = m_flex_lines[0];
  1373. CSSPixels center_of_line = cross_size_of_flex_container / 2;
  1374. for (auto& item : flex_line.items) {
  1375. item.cross_offset += center_of_line;
  1376. }
  1377. } else {
  1378. CSSPixels sum_of_flex_line_cross_sizes = 0;
  1379. for (auto& line : m_flex_lines)
  1380. sum_of_flex_line_cross_sizes += line.cross_size;
  1381. // CSS-FLEXBOX-2: Account for gap between flex lines.
  1382. sum_of_flex_line_cross_sizes += cross_gap() * (m_flex_lines.size() - 1);
  1383. CSSPixels start_of_current_line = 0;
  1384. CSSPixels gap_size = 0;
  1385. switch (flex_container().computed_values().align_content()) {
  1386. case CSS::AlignContent::FlexStart:
  1387. start_of_current_line = 0;
  1388. break;
  1389. case CSS::AlignContent::FlexEnd:
  1390. start_of_current_line = cross_size_of_flex_container - sum_of_flex_line_cross_sizes;
  1391. break;
  1392. case CSS::AlignContent::Center:
  1393. start_of_current_line = (cross_size_of_flex_container / 2) - (sum_of_flex_line_cross_sizes / 2);
  1394. break;
  1395. case CSS::AlignContent::SpaceBetween: {
  1396. start_of_current_line = 0;
  1397. auto leftover_free_space = cross_size_of_flex_container - sum_of_flex_line_cross_sizes;
  1398. if (leftover_free_space >= 0) {
  1399. int gap_count = m_flex_lines.size() - 1;
  1400. gap_size = leftover_free_space / gap_count;
  1401. }
  1402. break;
  1403. }
  1404. case CSS::AlignContent::SpaceAround: {
  1405. auto leftover_free_space = cross_size_of_flex_container - sum_of_flex_line_cross_sizes;
  1406. if (leftover_free_space < 0) {
  1407. // If the leftover free-space is negative this value is identical to center.
  1408. start_of_current_line = (cross_size_of_flex_container / 2) - (sum_of_flex_line_cross_sizes / 2);
  1409. break;
  1410. }
  1411. gap_size = leftover_free_space / m_flex_lines.size();
  1412. // The spacing between the first/last lines and the flex container edges is half the size of the spacing between flex lines.
  1413. start_of_current_line = gap_size / 2;
  1414. break;
  1415. }
  1416. case CSS::AlignContent::SpaceEvenly: {
  1417. auto leftover_free_space = cross_size_of_flex_container - sum_of_flex_line_cross_sizes;
  1418. if (leftover_free_space < 0) {
  1419. // If the leftover free-space is negative this value is identical to center.
  1420. start_of_current_line = (cross_size_of_flex_container / 2) - (sum_of_flex_line_cross_sizes / 2);
  1421. break;
  1422. }
  1423. gap_size = leftover_free_space / (m_flex_lines.size() + 1);
  1424. // The spacing between the first/last lines and the flex container edges is the size of the spacing between flex lines.
  1425. start_of_current_line = gap_size;
  1426. break;
  1427. }
  1428. case CSS::AlignContent::Normal:
  1429. case CSS::AlignContent::Stretch:
  1430. start_of_current_line = 0;
  1431. break;
  1432. }
  1433. for (auto& flex_line : m_flex_lines) {
  1434. CSSPixels center_of_current_line = start_of_current_line + (flex_line.cross_size / 2);
  1435. for (auto& item : flex_line.items) {
  1436. item.cross_offset += center_of_current_line;
  1437. }
  1438. start_of_current_line += flex_line.cross_size + gap_size;
  1439. // CSS-FLEXBOX-2: Account for gap between flex lines.
  1440. start_of_current_line += cross_gap();
  1441. }
  1442. }
  1443. }
  1444. void FlexFormattingContext::copy_dimensions_from_flex_items_to_boxes()
  1445. {
  1446. for (auto& item : m_flex_items) {
  1447. auto const& box = item.box;
  1448. auto& box_state = m_state.get_mutable(box);
  1449. box_state.padding_left = box->computed_values().padding().left().to_px(box, m_flex_container_state.content_width());
  1450. box_state.padding_right = box->computed_values().padding().right().to_px(box, m_flex_container_state.content_width());
  1451. box_state.padding_top = box->computed_values().padding().top().to_px(box, m_flex_container_state.content_width());
  1452. box_state.padding_bottom = box->computed_values().padding().bottom().to_px(box, m_flex_container_state.content_width());
  1453. box_state.margin_left = box->computed_values().margin().left().to_px(box, m_flex_container_state.content_width());
  1454. box_state.margin_right = box->computed_values().margin().right().to_px(box, m_flex_container_state.content_width());
  1455. box_state.margin_top = box->computed_values().margin().top().to_px(box, m_flex_container_state.content_width());
  1456. box_state.margin_bottom = box->computed_values().margin().bottom().to_px(box, m_flex_container_state.content_width());
  1457. box_state.border_left = box->computed_values().border_left().width;
  1458. box_state.border_right = box->computed_values().border_right().width;
  1459. box_state.border_top = box->computed_values().border_top().width;
  1460. box_state.border_bottom = box->computed_values().border_bottom().width;
  1461. set_main_size(box, item.main_size.value());
  1462. set_cross_size(box, item.cross_size.value());
  1463. set_offset(box, item.main_offset, item.cross_offset);
  1464. }
  1465. }
  1466. // https://drafts.csswg.org/css-flexbox-1/#intrinsic-sizes
  1467. void FlexFormattingContext::determine_intrinsic_size_of_flex_container()
  1468. {
  1469. if (m_available_space_for_flex_container->main.is_intrinsic_sizing_constraint()) {
  1470. CSSPixels main_size = calculate_intrinsic_main_size_of_flex_container();
  1471. set_main_size(flex_container(), main_size);
  1472. }
  1473. if (m_available_space_for_items->cross.is_intrinsic_sizing_constraint()) {
  1474. CSSPixels cross_size = calculate_intrinsic_cross_size_of_flex_container();
  1475. set_cross_size(flex_container(), cross_size);
  1476. }
  1477. }
  1478. // https://drafts.csswg.org/css-flexbox-1/#intrinsic-main-sizes
  1479. CSSPixels FlexFormattingContext::calculate_intrinsic_main_size_of_flex_container()
  1480. {
  1481. // The min-content main size of a single-line flex container is calculated identically to the max-content main size,
  1482. // except that the flex items’ min-content contributions are used instead of their max-content contributions.
  1483. // However, for a multi-line container, it is simply the largest min-content contribution of all the non-collapsed flex items in the flex container.
  1484. if (!is_single_line() && m_available_space_for_items->main.is_min_content()) {
  1485. CSSPixels largest_contribution = 0;
  1486. for (auto const& item : m_flex_items) {
  1487. // FIXME: Skip collapsed flex items.
  1488. largest_contribution = max(largest_contribution, calculate_main_min_content_contribution(item));
  1489. }
  1490. return largest_contribution;
  1491. }
  1492. // The max-content main size of a flex container is, fundamentally, the smallest size the flex container
  1493. // can take such that when flex layout is run with that container size, each flex item ends up at least
  1494. // as large as its max-content contribution, to the extent allowed by the items’ flexibility.
  1495. // It is calculated, considering only non-collapsed flex items, by:
  1496. // 1. For each flex item, subtract its outer flex base size from its max-content contribution size.
  1497. // If that result is positive, divide it by the item’s flex grow factor if the flex grow factor is ≥ 1,
  1498. // or multiply it by the flex grow factor if the flex grow factor is < 1; if the result is negative,
  1499. // divide it by the item’s scaled flex shrink factor (if dividing by zero, treat the result as negative infinity).
  1500. // This is the item’s desired flex fraction.
  1501. for (auto& item : m_flex_items) {
  1502. CSSPixels contribution = 0;
  1503. if (m_available_space_for_items->main.is_min_content())
  1504. contribution = calculate_main_min_content_contribution(item);
  1505. else if (m_available_space_for_items->main.is_max_content())
  1506. contribution = calculate_main_max_content_contribution(item);
  1507. CSSPixels outer_flex_base_size = item.flex_base_size + item.margins.main_before + item.margins.main_after + item.borders.main_before + item.borders.main_after + item.padding.main_before + item.padding.main_after;
  1508. CSSPixels result = contribution - outer_flex_base_size;
  1509. if (result > 0) {
  1510. if (item.box->computed_values().flex_grow() >= 1) {
  1511. result.scale_by(1 / item.box->computed_values().flex_grow());
  1512. } else {
  1513. result.scale_by(item.box->computed_values().flex_grow());
  1514. }
  1515. } else if (result < 0) {
  1516. if (item.scaled_flex_shrink_factor == 0)
  1517. result = CSSPixels::min();
  1518. else
  1519. result.scale_by(1 / item.scaled_flex_shrink_factor);
  1520. }
  1521. item.desired_flex_fraction = result.to_double();
  1522. }
  1523. // 2. Place all flex items into lines of infinite length.
  1524. m_flex_lines.clear();
  1525. if (!m_flex_items.is_empty())
  1526. m_flex_lines.append(FlexLine {});
  1527. for (auto& item : m_flex_items) {
  1528. // FIXME: Honor breaking requests.
  1529. m_flex_lines.last().items.append(item);
  1530. }
  1531. // Within each line, find the greatest (most positive) desired flex fraction among all the flex items.
  1532. // This is the line’s chosen flex fraction.
  1533. for (auto& flex_line : m_flex_lines) {
  1534. float greatest_desired_flex_fraction = 0;
  1535. float sum_of_flex_grow_factors = 0;
  1536. float sum_of_flex_shrink_factors = 0;
  1537. for (auto& item : flex_line.items) {
  1538. greatest_desired_flex_fraction = max(greatest_desired_flex_fraction, item.desired_flex_fraction);
  1539. sum_of_flex_grow_factors += item.box->computed_values().flex_grow();
  1540. sum_of_flex_shrink_factors += item.box->computed_values().flex_shrink();
  1541. }
  1542. float chosen_flex_fraction = greatest_desired_flex_fraction;
  1543. // 3. If the chosen flex fraction is positive, and the sum of the line’s flex grow factors is less than 1,
  1544. // divide the chosen flex fraction by that sum.
  1545. if (chosen_flex_fraction > 0 && sum_of_flex_grow_factors < 1)
  1546. chosen_flex_fraction /= sum_of_flex_grow_factors;
  1547. // If the chosen flex fraction is negative, and the sum of the line’s flex shrink factors is less than 1,
  1548. // multiply the chosen flex fraction by that sum.
  1549. if (chosen_flex_fraction < 0 && sum_of_flex_shrink_factors < 1)
  1550. chosen_flex_fraction *= sum_of_flex_shrink_factors;
  1551. flex_line.chosen_flex_fraction = chosen_flex_fraction;
  1552. }
  1553. auto determine_main_size = [&]() -> CSSPixels {
  1554. CSSPixels largest_sum = 0;
  1555. for (auto& flex_line : m_flex_lines) {
  1556. // 4. Add each item’s flex base size to the product of its flex grow factor (scaled flex shrink factor, if shrinking)
  1557. // and the chosen flex fraction, then clamp that result by the max main size floored by the min main size.
  1558. CSSPixels sum = 0;
  1559. for (auto& item : flex_line.items) {
  1560. double product = 0;
  1561. if (item.desired_flex_fraction > 0)
  1562. product = flex_line.chosen_flex_fraction * static_cast<double>(item.box->computed_values().flex_grow());
  1563. else if (item.desired_flex_fraction < 0)
  1564. product = flex_line.chosen_flex_fraction * item.scaled_flex_shrink_factor;
  1565. auto result = item.flex_base_size + CSSPixels::nearest_value_for(product);
  1566. auto const& computed_min_size = this->computed_main_min_size(item.box);
  1567. auto const& computed_max_size = this->computed_main_max_size(item.box);
  1568. auto clamp_min = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_main_min_size(item.box) : automatic_minimum_size(item);
  1569. auto clamp_max = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_main_max_size(item.box) : CSSPixels::max();
  1570. result = css_clamp(result, clamp_min, clamp_max);
  1571. // NOTE: The spec doesn't mention anything about the *outer* size here, but if we don't add the margin box,
  1572. // flex items with non-zero padding/border/margin in the main axis end up overflowing the container.
  1573. result = item.add_main_margin_box_sizes(result);
  1574. sum += result;
  1575. }
  1576. // CSS-FLEXBOX-2: Account for gap between flex items.
  1577. sum += main_gap() * (flex_line.items.size() - 1);
  1578. largest_sum = max(largest_sum, sum);
  1579. }
  1580. // 5. The flex container’s max-content size is the largest sum (among all the lines) of the afore-calculated sizes of all items within a single line.
  1581. return largest_sum;
  1582. };
  1583. auto main_size = determine_main_size();
  1584. set_main_size(flex_container(), main_size);
  1585. return main_size;
  1586. }
  1587. // https://drafts.csswg.org/css-flexbox-1/#intrinsic-cross-sizes
  1588. CSSPixels FlexFormattingContext::calculate_intrinsic_cross_size_of_flex_container()
  1589. {
  1590. // The min-content/max-content cross size of a single-line flex container
  1591. // is the largest min-content contribution/max-content contribution (respectively) of its flex items.
  1592. if (is_single_line()) {
  1593. auto calculate_largest_contribution = [&](bool resolve_percentage_min_max_sizes) {
  1594. CSSPixels largest_contribution = 0;
  1595. for (auto& item : m_flex_items) {
  1596. CSSPixels contribution = 0;
  1597. if (m_available_space_for_items->cross.is_min_content())
  1598. contribution = calculate_cross_min_content_contribution(item, resolve_percentage_min_max_sizes);
  1599. else if (m_available_space_for_items->cross.is_max_content())
  1600. contribution = calculate_cross_max_content_contribution(item, resolve_percentage_min_max_sizes);
  1601. largest_contribution = max(largest_contribution, contribution);
  1602. }
  1603. return largest_contribution;
  1604. };
  1605. auto first_pass_largest_contribution = calculate_largest_contribution(false);
  1606. set_cross_size(flex_container(), first_pass_largest_contribution);
  1607. auto second_pass_largest_contribution = calculate_largest_contribution(true);
  1608. return second_pass_largest_contribution;
  1609. }
  1610. if (is_row_layout()) {
  1611. // row multi-line flex container cross-size
  1612. // The min-content/max-content cross size is the sum of the flex line cross sizes resulting from
  1613. // sizing the flex container under a cross-axis min-content constraint/max-content constraint (respectively).
  1614. // NOTE: We fall through to the ad-hoc section below.
  1615. } else {
  1616. // column multi-line flex container cross-size
  1617. // The min-content cross size is the largest min-content contribution among all of its flex items.
  1618. if (m_available_space_for_items->cross.is_min_content()) {
  1619. auto calculate_largest_contribution = [&](bool resolve_percentage_min_max_sizes) {
  1620. CSSPixels largest_contribution = 0;
  1621. for (auto& item : m_flex_items) {
  1622. CSSPixels contribution = calculate_cross_min_content_contribution(item, resolve_percentage_min_max_sizes);
  1623. largest_contribution = max(largest_contribution, contribution);
  1624. }
  1625. return largest_contribution;
  1626. };
  1627. auto first_pass_largest_contribution = calculate_largest_contribution(false);
  1628. set_cross_size(flex_container(), first_pass_largest_contribution);
  1629. auto second_pass_largest_contribution = calculate_largest_contribution(true);
  1630. return second_pass_largest_contribution;
  1631. }
  1632. // The max-content cross size is the sum of the flex line cross sizes resulting from
  1633. // sizing the flex container under a cross-axis max-content constraint,
  1634. // using the largest max-content cross-size contribution among the flex items
  1635. // as the available space in the cross axis for each of the flex items during layout.
  1636. // NOTE: We fall through to the ad-hoc section below.
  1637. }
  1638. CSSPixels sum_of_flex_line_cross_sizes = 0;
  1639. for (auto& flex_line : m_flex_lines) {
  1640. sum_of_flex_line_cross_sizes += flex_line.cross_size;
  1641. }
  1642. // CSS-FLEXBOX-2: Account for gap between flex lines.
  1643. sum_of_flex_line_cross_sizes += cross_gap() * (m_flex_lines.size() - 1);
  1644. return sum_of_flex_line_cross_sizes;
  1645. }
  1646. // https://drafts.csswg.org/css-flexbox-1/#intrinsic-item-contributions
  1647. CSSPixels FlexFormattingContext::calculate_main_min_content_contribution(FlexItem const& item) const
  1648. {
  1649. // The main-size min-content contribution of a flex item is
  1650. // the larger of its outer min-content size and outer preferred size if that is not auto,
  1651. // clamped by its min/max main size.
  1652. auto larger_size = [&] {
  1653. auto inner_min_content_size = calculate_min_content_main_size(item);
  1654. if (computed_main_size(item.box).is_auto())
  1655. return inner_min_content_size;
  1656. auto inner_preferred_size = is_row_layout() ? get_pixel_width(item.box, computed_main_size(item.box)) : get_pixel_height(item.box, computed_main_size(item.box));
  1657. return max(inner_min_content_size, inner_preferred_size);
  1658. }();
  1659. auto clamp_min = has_main_min_size(item.box) ? specified_main_min_size(item.box) : automatic_minimum_size(item);
  1660. auto clamp_max = has_main_max_size(item.box) ? specified_main_max_size(item.box) : CSSPixels::max();
  1661. auto clamped_inner_size = css_clamp(larger_size, clamp_min, clamp_max);
  1662. return item.add_main_margin_box_sizes(clamped_inner_size);
  1663. }
  1664. // https://drafts.csswg.org/css-flexbox-1/#intrinsic-item-contributions
  1665. CSSPixels FlexFormattingContext::calculate_main_max_content_contribution(FlexItem const& item) const
  1666. {
  1667. // The main-size max-content contribution of a flex item is
  1668. // the larger of its outer max-content size and outer preferred size if that is not auto,
  1669. // clamped by its min/max main size.
  1670. auto larger_size = [&] {
  1671. auto inner_max_content_size = calculate_max_content_main_size(item);
  1672. if (computed_main_size(item.box).is_auto())
  1673. return inner_max_content_size;
  1674. auto inner_preferred_size = is_row_layout() ? get_pixel_width(item.box, computed_main_size(item.box)) : get_pixel_height(item.box, computed_main_size(item.box));
  1675. return max(inner_max_content_size, inner_preferred_size);
  1676. }();
  1677. auto clamp_min = has_main_min_size(item.box) ? specified_main_min_size(item.box) : automatic_minimum_size(item);
  1678. auto clamp_max = has_main_max_size(item.box) ? specified_main_max_size(item.box) : CSSPixels::max();
  1679. auto clamped_inner_size = css_clamp(larger_size, clamp_min, clamp_max);
  1680. return item.add_main_margin_box_sizes(clamped_inner_size);
  1681. }
  1682. bool FlexFormattingContext::should_treat_main_size_as_auto(Box const& box) const
  1683. {
  1684. if (is_row_layout())
  1685. return should_treat_width_as_auto(box, m_available_space_for_items->space);
  1686. return should_treat_height_as_auto(box, m_available_space_for_items->space);
  1687. }
  1688. bool FlexFormattingContext::should_treat_cross_size_as_auto(Box const& box) const
  1689. {
  1690. if (is_row_layout())
  1691. return should_treat_height_as_auto(box, m_available_space_for_items->space);
  1692. return should_treat_width_as_auto(box, m_available_space_for_items->space);
  1693. }
  1694. CSSPixels FlexFormattingContext::calculate_cross_min_content_contribution(FlexItem const& item, bool resolve_percentage_min_max_sizes) const
  1695. {
  1696. auto size = [&] {
  1697. if (should_treat_cross_size_as_auto(item.box))
  1698. return calculate_min_content_cross_size(item);
  1699. return !is_row_layout() ? get_pixel_width(item.box, computed_cross_size(item.box)) : get_pixel_height(item.box, computed_cross_size(item.box));
  1700. }();
  1701. auto const& computed_min_size = this->computed_cross_min_size(item.box);
  1702. auto const& computed_max_size = this->computed_cross_max_size(item.box);
  1703. auto clamp_min = (!computed_min_size.is_auto() && (resolve_percentage_min_max_sizes || !computed_min_size.contains_percentage())) ? specified_cross_min_size(item.box) : 0;
  1704. auto clamp_max = (!computed_max_size.is_none() && (resolve_percentage_min_max_sizes || !computed_max_size.contains_percentage())) ? specified_cross_max_size(item.box) : CSSPixels::max();
  1705. auto clamped_inner_size = css_clamp(size, clamp_min, clamp_max);
  1706. return item.add_cross_margin_box_sizes(clamped_inner_size);
  1707. }
  1708. CSSPixels FlexFormattingContext::calculate_cross_max_content_contribution(FlexItem const& item, bool resolve_percentage_min_max_sizes) const
  1709. {
  1710. auto size = [&] {
  1711. if (should_treat_cross_size_as_auto(item.box))
  1712. return calculate_max_content_cross_size(item);
  1713. return !is_row_layout() ? get_pixel_width(item.box, computed_cross_size(item.box)) : get_pixel_height(item.box, computed_cross_size(item.box));
  1714. }();
  1715. auto const& computed_min_size = this->computed_cross_min_size(item.box);
  1716. auto const& computed_max_size = this->computed_cross_max_size(item.box);
  1717. auto clamp_min = (!computed_min_size.is_auto() && (resolve_percentage_min_max_sizes || !computed_min_size.contains_percentage())) ? specified_cross_min_size(item.box) : 0;
  1718. auto clamp_max = (!computed_max_size.is_none() && (resolve_percentage_min_max_sizes || !computed_max_size.contains_percentage())) ? specified_cross_max_size(item.box) : CSSPixels::max();
  1719. auto clamped_inner_size = css_clamp(size, clamp_min, clamp_max);
  1720. return item.add_cross_margin_box_sizes(clamped_inner_size);
  1721. }
  1722. CSSPixels FlexFormattingContext::calculate_width_to_use_when_determining_intrinsic_height_of_item(FlexItem const& item) const
  1723. {
  1724. auto const& box = *item.box;
  1725. auto computed_width = box.computed_values().width();
  1726. auto const& computed_min_width = box.computed_values().min_width();
  1727. auto const& computed_max_width = box.computed_values().max_width();
  1728. auto clamp_min = (!computed_min_width.is_auto() && (!computed_min_width.contains_percentage())) ? specified_cross_min_size(box) : 0;
  1729. auto clamp_max = (!computed_max_width.is_none() && (!computed_max_width.contains_percentage())) ? specified_cross_max_size(box) : CSSPixels::max();
  1730. CSSPixels width;
  1731. if (should_treat_width_as_auto(box, m_available_space_for_items->space) || computed_width.is_fit_content())
  1732. width = calculate_fit_content_width(box, m_available_space_for_items->space);
  1733. else if (computed_width.is_min_content())
  1734. width = calculate_min_content_width(box);
  1735. else if (computed_width.is_max_content())
  1736. width = calculate_max_content_width(box);
  1737. return css_clamp(width, clamp_min, clamp_max);
  1738. }
  1739. CSSPixels FlexFormattingContext::calculate_min_content_main_size(FlexItem const& item) const
  1740. {
  1741. if (is_row_layout()) {
  1742. return calculate_min_content_width(item.box);
  1743. }
  1744. auto available_space = m_state.get(item.box).available_inner_space_or_constraints_from(m_available_space_for_items->space);
  1745. if (available_space.width.is_indefinite()) {
  1746. available_space.width = AvailableSize::make_definite(calculate_width_to_use_when_determining_intrinsic_height_of_item(item));
  1747. }
  1748. return calculate_min_content_height(item.box, available_space.width.to_px_or_zero());
  1749. }
  1750. CSSPixels FlexFormattingContext::calculate_max_content_main_size(FlexItem const& item) const
  1751. {
  1752. if (is_row_layout()) {
  1753. return calculate_max_content_width(item.box);
  1754. }
  1755. auto available_space = m_state.get(item.box).available_inner_space_or_constraints_from(m_available_space_for_items->space);
  1756. if (available_space.width.is_indefinite()) {
  1757. available_space.width = AvailableSize::make_definite(calculate_width_to_use_when_determining_intrinsic_height_of_item(item));
  1758. }
  1759. return calculate_max_content_height(item.box, available_space.width.to_px_or_zero());
  1760. }
  1761. CSSPixels FlexFormattingContext::calculate_fit_content_main_size(FlexItem const& item) const
  1762. {
  1763. if (is_row_layout())
  1764. return calculate_fit_content_width(item.box, m_available_space_for_items->space);
  1765. return calculate_fit_content_height(item.box, m_available_space_for_items->space);
  1766. }
  1767. CSSPixels FlexFormattingContext::calculate_fit_content_cross_size(FlexItem const& item) const
  1768. {
  1769. if (!is_row_layout())
  1770. return calculate_fit_content_width(item.box, m_available_space_for_items->space);
  1771. return calculate_fit_content_height(item.box, m_available_space_for_items->space);
  1772. }
  1773. CSSPixels FlexFormattingContext::calculate_min_content_cross_size(FlexItem const& item) const
  1774. {
  1775. if (is_row_layout()) {
  1776. auto available_space = m_state.get(item.box).available_inner_space_or_constraints_from(m_available_space_for_flex_container->space);
  1777. if (available_space.width.is_indefinite()) {
  1778. available_space.width = AvailableSize::make_definite(calculate_width_to_use_when_determining_intrinsic_height_of_item(item));
  1779. }
  1780. return calculate_min_content_height(item.box, available_space.width.to_px_or_zero());
  1781. }
  1782. return calculate_min_content_width(item.box);
  1783. }
  1784. CSSPixels FlexFormattingContext::calculate_max_content_cross_size(FlexItem const& item) const
  1785. {
  1786. if (is_row_layout()) {
  1787. auto available_space = m_state.get(item.box).available_inner_space_or_constraints_from(m_available_space_for_flex_container->space);
  1788. if (available_space.width.is_indefinite()) {
  1789. available_space.width = AvailableSize::make_definite(calculate_width_to_use_when_determining_intrinsic_height_of_item(item));
  1790. }
  1791. return calculate_max_content_height(item.box, available_space.width.to_px_or_zero());
  1792. }
  1793. return calculate_max_content_width(item.box);
  1794. }
  1795. // https://drafts.csswg.org/css-flexbox-1/#stretched
  1796. bool FlexFormattingContext::flex_item_is_stretched(FlexItem const& item) const
  1797. {
  1798. auto alignment = alignment_for_item(item.box);
  1799. if (alignment != CSS::AlignItems::Stretch && alignment != CSS::AlignItems::Normal)
  1800. return false;
  1801. // If the cross size property of the flex item computes to auto, and neither of the cross-axis margins are auto, the flex item is stretched.
  1802. auto const& computed_cross_size = is_row_layout() ? item.box->computed_values().height() : item.box->computed_values().width();
  1803. return computed_cross_size.is_auto() && !item.margins.cross_before_is_auto && !item.margins.cross_after_is_auto;
  1804. }
  1805. CSS::Size const& FlexFormattingContext::computed_main_size(Box const& box) const
  1806. {
  1807. return is_row_layout() ? box.computed_values().width() : box.computed_values().height();
  1808. }
  1809. CSS::Size const& FlexFormattingContext::computed_main_min_size(Box const& box) const
  1810. {
  1811. return is_row_layout() ? box.computed_values().min_width() : box.computed_values().min_height();
  1812. }
  1813. CSS::Size const& FlexFormattingContext::computed_main_max_size(Box const& box) const
  1814. {
  1815. return is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
  1816. }
  1817. CSS::Size const& FlexFormattingContext::computed_cross_size(Box const& box) const
  1818. {
  1819. return !is_row_layout() ? box.computed_values().width() : box.computed_values().height();
  1820. }
  1821. CSS::Size const& FlexFormattingContext::computed_cross_min_size(Box const& box) const
  1822. {
  1823. return !is_row_layout() ? box.computed_values().min_width() : box.computed_values().min_height();
  1824. }
  1825. CSS::Size const& FlexFormattingContext::computed_cross_max_size(Box const& box) const
  1826. {
  1827. return !is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
  1828. }
  1829. // https://drafts.csswg.org/css-flexbox-1/#algo-cross-margins
  1830. void FlexFormattingContext::resolve_cross_axis_auto_margins()
  1831. {
  1832. for (auto& line : m_flex_lines) {
  1833. for (auto& item : line.items) {
  1834. // If a flex item has auto cross-axis margins:
  1835. if (!item.margins.cross_before_is_auto && !item.margins.cross_after_is_auto)
  1836. continue;
  1837. // If its outer cross size (treating those auto margins as zero) is less than the cross size of its flex line,
  1838. // distribute the difference in those sizes equally to the auto margins.
  1839. auto outer_cross_size = item.cross_size.value() + item.padding.cross_before + item.padding.cross_after + item.borders.cross_before + item.borders.cross_after;
  1840. if (outer_cross_size < line.cross_size) {
  1841. CSSPixels remainder = line.cross_size - outer_cross_size;
  1842. if (item.margins.cross_before_is_auto && item.margins.cross_after_is_auto) {
  1843. item.margins.cross_before = remainder / 2;
  1844. item.margins.cross_after = remainder / 2;
  1845. } else if (item.margins.cross_before_is_auto) {
  1846. item.margins.cross_before = remainder;
  1847. } else {
  1848. item.margins.cross_after = remainder;
  1849. }
  1850. } else {
  1851. // FIXME: Otherwise, if the block-start or inline-start margin (whichever is in the cross axis) is auto, set it to zero.
  1852. // Set the opposite margin so that the outer cross size of the item equals the cross size of its flex line.
  1853. }
  1854. }
  1855. }
  1856. }
  1857. // https://drafts.csswg.org/css-flexbox-1/#algo-line-stretch
  1858. void FlexFormattingContext::handle_align_content_stretch()
  1859. {
  1860. // If the flex container has a definite cross size,
  1861. if (!has_definite_cross_size(flex_container()))
  1862. return;
  1863. // align-content is stretch,
  1864. if (flex_container().computed_values().align_content() != CSS::AlignContent::Stretch && flex_container().computed_values().align_content() != CSS::AlignContent::Normal)
  1865. return;
  1866. // and the sum of the flex lines' cross sizes is less than the flex container’s inner cross size,
  1867. CSSPixels sum_of_flex_line_cross_sizes = 0;
  1868. for (auto& line : m_flex_lines)
  1869. sum_of_flex_line_cross_sizes += line.cross_size;
  1870. // CSS-FLEXBOX-2: Account for gap between flex lines.
  1871. sum_of_flex_line_cross_sizes += cross_gap() * (m_flex_lines.size() - 1);
  1872. if (sum_of_flex_line_cross_sizes >= inner_cross_size(flex_container()))
  1873. return;
  1874. // increase the cross size of each flex line by equal amounts
  1875. // such that the sum of their cross sizes exactly equals the flex container’s inner cross size.
  1876. CSSPixels remainder = inner_cross_size(flex_container()) - sum_of_flex_line_cross_sizes;
  1877. CSSPixels extra_per_line = remainder / m_flex_lines.size();
  1878. for (auto& line : m_flex_lines)
  1879. line.cross_size += extra_per_line;
  1880. }
  1881. // https://drafts.csswg.org/css-flexbox-1/#abspos-items
  1882. CSSPixelPoint FlexFormattingContext::calculate_static_position(Box const& box) const
  1883. {
  1884. // The cross-axis edges of the static-position rectangle of an absolutely-positioned child
  1885. // of a flex container are the content edges of the flex container.
  1886. CSSPixels cross_offset = 0;
  1887. CSSPixels half_line_size = inner_cross_size(flex_container()) / 2;
  1888. auto const& box_state = m_state.get(box);
  1889. CSSPixels cross_margin_before = is_row_layout() ? box_state.margin_top : box_state.margin_left;
  1890. CSSPixels cross_margin_after = is_row_layout() ? box_state.margin_bottom : box_state.margin_right;
  1891. CSSPixels cross_border_before = is_row_layout() ? box_state.border_top : box_state.border_left;
  1892. CSSPixels cross_border_after = is_row_layout() ? box_state.border_bottom : box_state.border_right;
  1893. CSSPixels cross_padding_after = is_row_layout() ? box_state.padding_bottom : box_state.padding_right;
  1894. CSSPixels main_border_before = is_row_layout() ? box_state.border_left : box_state.border_top;
  1895. CSSPixels main_border_after = is_row_layout() ? box_state.border_right : box_state.border_bottom;
  1896. switch (alignment_for_item(box)) {
  1897. case CSS::AlignItems::Baseline:
  1898. // FIXME: Implement this
  1899. // Fallthrough
  1900. case CSS::AlignItems::Start:
  1901. case CSS::AlignItems::FlexStart:
  1902. case CSS::AlignItems::SelfStart:
  1903. case CSS::AlignItems::Stretch:
  1904. case CSS::AlignItems::Normal:
  1905. cross_offset = -half_line_size + cross_margin_before;
  1906. break;
  1907. case CSS::AlignItems::End:
  1908. case CSS::AlignItems::SelfEnd:
  1909. case CSS::AlignItems::FlexEnd:
  1910. cross_offset = half_line_size - inner_cross_size(box) - cross_margin_after - cross_border_after - cross_padding_after;
  1911. break;
  1912. case CSS::AlignItems::Center:
  1913. cross_offset = -((inner_cross_size(box) + cross_border_before + cross_border_after) / 2);
  1914. break;
  1915. default:
  1916. break;
  1917. }
  1918. cross_offset += inner_cross_size(flex_container()) / 2;
  1919. // The main-axis edges of the static-position rectangle are where the margin edges of the child
  1920. // would be positioned if it were the sole flex item in the flex container,
  1921. // assuming both the child and the flex container were fixed-size boxes of their used size.
  1922. // (For this purpose, auto margins are treated as zero.
  1923. bool pack_from_end = true;
  1924. CSSPixels main_offset = 0;
  1925. switch (flex_container().computed_values().justify_content()) {
  1926. case CSS::JustifyContent::Start:
  1927. pack_from_end = false;
  1928. break;
  1929. case CSS::JustifyContent::Stretch:
  1930. case CSS::JustifyContent::Normal:
  1931. case CSS::JustifyContent::FlexStart:
  1932. case CSS::JustifyContent::SpaceBetween:
  1933. pack_from_end = is_direction_reverse();
  1934. break;
  1935. case CSS::JustifyContent::End:
  1936. pack_from_end = true;
  1937. break;
  1938. case CSS::JustifyContent::FlexEnd:
  1939. pack_from_end = !is_direction_reverse();
  1940. break;
  1941. case CSS::JustifyContent::Center:
  1942. case CSS::JustifyContent::SpaceAround:
  1943. case CSS::JustifyContent::SpaceEvenly:
  1944. pack_from_end = false;
  1945. main_offset = (inner_main_size(flex_container()) - inner_main_size(box) - main_border_before - main_border_after) / 2;
  1946. break;
  1947. }
  1948. if (pack_from_end)
  1949. main_offset += inner_main_size(flex_container()) - inner_main_size(box) - main_border_before - main_border_after;
  1950. auto static_position_offset = is_row_layout() ? CSSPixelPoint { main_offset, cross_offset } : CSSPixelPoint { cross_offset, main_offset };
  1951. auto absolute_position_of_flex_container = absolute_content_rect(flex_container()).location();
  1952. auto absolute_position_of_abspos_containing_block = absolute_content_rect(*box.containing_block()).location();
  1953. auto diff = absolute_position_of_flex_container - absolute_position_of_abspos_containing_block;
  1954. return static_position_offset + diff;
  1955. }
  1956. double FlexFormattingContext::FlexLine::sum_of_flex_factor_of_unfrozen_items() const
  1957. {
  1958. double sum = 0;
  1959. for (auto const& item : items) {
  1960. if (!item.frozen)
  1961. sum += item.flex_factor.value();
  1962. }
  1963. return sum;
  1964. }
  1965. double FlexFormattingContext::FlexLine::sum_of_scaled_flex_shrink_factor_of_unfrozen_items() const
  1966. {
  1967. double sum = 0;
  1968. for (auto const& item : items) {
  1969. if (!item.frozen)
  1970. sum += item.scaled_flex_shrink_factor;
  1971. }
  1972. return sum;
  1973. }
  1974. CSSPixels FlexFormattingContext::main_gap() const
  1975. {
  1976. auto const& computed_values = flex_container().computed_values();
  1977. auto gap = is_row_layout() ? computed_values.column_gap() : computed_values.row_gap();
  1978. return gap.to_px(flex_container(), inner_main_size(flex_container()));
  1979. }
  1980. CSSPixels FlexFormattingContext::cross_gap() const
  1981. {
  1982. auto const& computed_values = flex_container().computed_values();
  1983. auto gap = is_row_layout() ? computed_values.row_gap() : computed_values.column_gap();
  1984. return gap.to_px(flex_container(), inner_cross_size(flex_container()));
  1985. }
  1986. }