FlexFormattingContext.cpp 45 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022
  1. /*
  2. * Copyright (c) 2021, 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/StdLibExtras.h>
  10. #include <LibWeb/Layout/BlockContainer.h>
  11. #include <LibWeb/Layout/BlockFormattingContext.h>
  12. #include <LibWeb/Layout/Box.h>
  13. #include <LibWeb/Layout/FlexFormattingContext.h>
  14. #include <LibWeb/Layout/InitialContainingBlock.h>
  15. #include <LibWeb/Layout/TextNode.h>
  16. namespace Web::Layout {
  17. static float get_pixel_size(FormattingState const& state, Box const& box, Optional<CSS::LengthPercentage> const& length_percentage)
  18. {
  19. if (!length_percentage.has_value())
  20. return 0;
  21. auto inner_main_size = CSS::Length::make_px(state.get(*box.containing_block()).content_width);
  22. return length_percentage->resolved(box, inner_main_size).to_px(box);
  23. }
  24. static bool is_undefined_or_auto(Optional<CSS::LengthPercentage> const& length_percentage)
  25. {
  26. if (!length_percentage.has_value())
  27. return true;
  28. return length_percentage->is_length() && length_percentage->length().is_auto();
  29. }
  30. FlexFormattingContext::FlexFormattingContext(FormattingState& state, Box const& flex_container, FormattingContext* parent)
  31. : FormattingContext(Type::Flex, state, flex_container, parent)
  32. , m_flex_container_state(m_state.ensure(flex_container))
  33. , m_flex_direction(flex_container.computed_values().flex_direction())
  34. {
  35. }
  36. FlexFormattingContext::~FlexFormattingContext()
  37. {
  38. }
  39. void FlexFormattingContext::run(Box const& run_box, LayoutMode)
  40. {
  41. VERIFY(&run_box == &flex_container());
  42. // This implements https://www.w3.org/TR/css-flexbox-1/#layout-algorithm
  43. // FIXME: Implement reverse and ordering.
  44. // 1. Generate anonymous flex items
  45. generate_anonymous_flex_items();
  46. // 2. Determine the available main and cross space for the flex items
  47. float main_max_size = NumericLimits<float>::max();
  48. float main_min_size = 0;
  49. float cross_max_size = NumericLimits<float>::max();
  50. float cross_min_size = 0;
  51. bool main_is_constrained = false;
  52. bool cross_is_constrained = false;
  53. bool main_size_is_infinite = false;
  54. auto available_space = determine_available_main_and_cross_space(main_size_is_infinite, main_is_constrained, cross_is_constrained, main_min_size, main_max_size, cross_min_size, cross_max_size);
  55. auto main_available_size = available_space.main;
  56. [[maybe_unused]] auto cross_available_size = available_space.cross;
  57. // 3. Determine the flex base size and hypothetical main size of each item
  58. for (auto& flex_item : m_flex_items) {
  59. determine_flex_base_size_and_hypothetical_main_size(flex_item);
  60. }
  61. // 4. Determine the main size of the flex container
  62. determine_main_size_of_flex_container(main_is_constrained, main_size_is_infinite, main_available_size, main_min_size, main_max_size);
  63. // 5. Collect flex items into flex lines:
  64. // After this step no additional items are to be added to flex_lines or any of its items!
  65. collect_flex_items_into_flex_lines(main_available_size);
  66. // 6. Resolve the flexible lengths
  67. resolve_flexible_lengths(main_available_size);
  68. // Cross Size Determination
  69. // 7. Determine the hypothetical cross size of each item
  70. for (auto& flex_item : m_flex_items) {
  71. flex_item.hypothetical_cross_size = determine_hypothetical_cross_size_of_item(flex_item.box);
  72. }
  73. // 8. Calculate the cross size of each flex line.
  74. calculate_cross_size_of_each_flex_line(cross_min_size, cross_max_size);
  75. // 9. Handle 'align-content: stretch'.
  76. // FIXME: This
  77. // 10. Collapse visibility:collapse items.
  78. // FIXME: This
  79. // 11. Determine the used cross size of each flex item.
  80. determine_used_cross_size_of_each_flex_item();
  81. // 12. Distribute any remaining free space.
  82. distribute_any_remaining_free_space(main_available_size);
  83. // 13. Resolve cross-axis auto margins.
  84. // FIXME: This
  85. // 14. Align all flex items along the cross-axis
  86. align_all_flex_items_along_the_cross_axis();
  87. // 15. Determine the flex container’s used cross size:
  88. determine_flex_container_used_cross_size(cross_min_size, cross_max_size);
  89. // 16. Align all flex lines (per align-content)
  90. align_all_flex_lines();
  91. }
  92. void FlexFormattingContext::populate_specified_margins(FlexItem& item, CSS::FlexDirection flex_direction) const
  93. {
  94. auto width_of_containing_block = m_state.get(*item.box.containing_block()).content_width;
  95. auto width_of_containing_block_as_length = CSS::Length::make_px(width_of_containing_block);
  96. // FIXME: This should also take reverse-ness into account
  97. if (flex_direction == CSS::FlexDirection::Row || flex_direction == CSS::FlexDirection::RowReverse) {
  98. item.margins.main_before = item.box.computed_values().margin().left.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  99. item.margins.main_after = item.box.computed_values().margin().right.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  100. item.margins.cross_before = item.box.computed_values().margin().top.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  101. item.margins.cross_after = item.box.computed_values().margin().bottom.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  102. } else {
  103. item.margins.main_before = item.box.computed_values().margin().top.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  104. item.margins.main_after = item.box.computed_values().margin().bottom.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  105. item.margins.cross_before = item.box.computed_values().margin().left.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  106. item.margins.cross_after = item.box.computed_values().margin().right.resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
  107. }
  108. };
  109. // https://www.w3.org/TR/css-flexbox-1/#flex-items
  110. void FlexFormattingContext::generate_anonymous_flex_items()
  111. {
  112. auto& containing_block_state = m_state.get(*flex_container().containing_block());
  113. // More like, sift through the already generated items.
  114. // After this step no items are to be added or removed from flex_items!
  115. // It holds every item we need to consider and there should be nothing in the following
  116. // calculations that could change that.
  117. // This is particularly important since we take references to the items stored in flex_items
  118. // later, whose addresses won't be stable if we added or removed any items.
  119. if (!flex_container().has_definite_width()) {
  120. m_flex_container_state.content_width = containing_block_state.content_width;
  121. } else {
  122. auto container_width = containing_block_state.content_width;
  123. auto& maybe_width = flex_container().computed_values().width();
  124. if (maybe_width.has_value()) {
  125. auto width = maybe_width->resolved(flex_container(), CSS::Length::make_px(container_width)).to_px(flex_container());
  126. m_flex_container_state.content_width = width;
  127. } else {
  128. m_flex_container_state.content_width = 0;
  129. }
  130. }
  131. if (!flex_container().has_definite_height()) {
  132. m_flex_container_state.content_height = containing_block_state.content_height;
  133. } else {
  134. auto container_height = containing_block_state.content_height;
  135. auto& maybe_height = flex_container().computed_values().height();
  136. if (maybe_height.has_value()) {
  137. auto height = maybe_height->resolved(flex_container(), CSS::Length::make_px(container_height)).to_px(flex_container());
  138. m_flex_container_state.content_height = height;
  139. } else {
  140. m_flex_container_state.content_height = 0;
  141. }
  142. }
  143. flex_container().for_each_child_of_type<Box>([&](Box& child_box) {
  144. (void)layout_inside(child_box, LayoutMode::Default);
  145. // Skip anonymous text runs that are only whitespace.
  146. if (child_box.is_anonymous() && !child_box.first_child_of_type<BlockContainer>()) {
  147. bool contains_only_white_space = true;
  148. child_box.for_each_in_inclusive_subtree_of_type<TextNode>([&contains_only_white_space](auto& text_node) {
  149. if (!text_node.text_for_rendering().is_whitespace()) {
  150. contains_only_white_space = false;
  151. return IterationDecision::Break;
  152. }
  153. return IterationDecision::Continue;
  154. });
  155. if (contains_only_white_space)
  156. return IterationDecision::Continue;
  157. }
  158. // Skip any "out-of-flow" children
  159. if (child_box.is_out_of_flow(*this))
  160. return IterationDecision::Continue;
  161. child_box.set_flex_item(true);
  162. FlexItem flex_item = { child_box };
  163. populate_specified_margins(flex_item, m_flex_direction);
  164. m_flex_items.append(move(flex_item));
  165. return IterationDecision::Continue;
  166. });
  167. }
  168. bool FlexFormattingContext::has_definite_main_size(Box const& box) const
  169. {
  170. return is_row_layout() ? box.has_definite_width() : box.has_definite_height();
  171. }
  172. float FlexFormattingContext::specified_main_size(Box const& box) const
  173. {
  174. auto const& box_state = m_state.get(box);
  175. return is_row_layout() ? box_state.content_width : box_state.content_height;
  176. }
  177. float FlexFormattingContext::specified_cross_size(Box const& box) const
  178. {
  179. auto const& box_state = m_state.get(box);
  180. return is_row_layout() ? box_state.content_height : box_state.content_width;
  181. }
  182. bool FlexFormattingContext::has_main_min_size(Box const& box) const
  183. {
  184. auto value = is_row_layout() ? box.computed_values().min_width() : box.computed_values().min_height();
  185. return !is_undefined_or_auto(value);
  186. }
  187. bool FlexFormattingContext::has_cross_min_size(Box const& box) const
  188. {
  189. auto value = is_row_layout() ? box.computed_values().min_height() : box.computed_values().min_width();
  190. return !is_undefined_or_auto(value);
  191. }
  192. bool FlexFormattingContext::has_definite_cross_size(Box const& box) const
  193. {
  194. return (is_row_layout() ? box.has_definite_height() : box.has_definite_width()) && cross_size_is_absolute_or_resolved_nicely(box);
  195. }
  196. bool FlexFormattingContext::cross_size_is_absolute_or_resolved_nicely(NodeWithStyle const& box) const
  197. {
  198. auto length_percentage = is_row_layout() ? box.computed_values().height() : box.computed_values().width();
  199. if (!length_percentage.has_value())
  200. return false;
  201. // FIXME: Handle calc here.
  202. if (length_percentage->is_length()) {
  203. auto& length = length_percentage->length();
  204. if (length.is_absolute() || length.is_relative())
  205. return true;
  206. if (length.is_auto())
  207. return false;
  208. }
  209. if (!box.parent())
  210. return false;
  211. if (length_percentage->is_percentage() && cross_size_is_absolute_or_resolved_nicely(*box.parent()))
  212. return true;
  213. return false;
  214. }
  215. float FlexFormattingContext::specified_main_size_of_child_box(Box const& child_box) const
  216. {
  217. auto main_size_of_parent = specified_main_size(flex_container());
  218. auto& value = is_row_layout() ? child_box.computed_values().width() : child_box.computed_values().height();
  219. if (!value.has_value())
  220. return 0;
  221. return value->resolved(child_box, CSS::Length::make_px(main_size_of_parent)).to_px(child_box);
  222. }
  223. float FlexFormattingContext::specified_main_min_size(Box const& box) const
  224. {
  225. return is_row_layout()
  226. ? get_pixel_size(m_state, box, box.computed_values().min_width())
  227. : get_pixel_size(m_state, box, box.computed_values().min_height());
  228. }
  229. float FlexFormattingContext::specified_cross_min_size(Box const& box) const
  230. {
  231. return is_row_layout()
  232. ? get_pixel_size(m_state, box, box.computed_values().min_height())
  233. : get_pixel_size(m_state, box, box.computed_values().min_width());
  234. }
  235. bool FlexFormattingContext::has_main_max_size(Box const& box) const
  236. {
  237. return is_row_layout()
  238. ? !is_undefined_or_auto(box.computed_values().max_width())
  239. : !is_undefined_or_auto(box.computed_values().max_height());
  240. }
  241. bool FlexFormattingContext::has_cross_max_size(Box const& box) const
  242. {
  243. return is_row_layout()
  244. ? !is_undefined_or_auto(box.computed_values().max_height())
  245. : !is_undefined_or_auto(box.computed_values().max_width());
  246. }
  247. float FlexFormattingContext::specified_main_max_size(Box const& box) const
  248. {
  249. return is_row_layout()
  250. ? get_pixel_size(m_state, box, box.computed_values().max_width())
  251. : get_pixel_size(m_state, box, box.computed_values().max_height());
  252. }
  253. float FlexFormattingContext::specified_cross_max_size(Box const& box) const
  254. {
  255. return is_row_layout()
  256. ? get_pixel_size(m_state, box, box.computed_values().max_height())
  257. : get_pixel_size(m_state, box, box.computed_values().max_width());
  258. }
  259. float FlexFormattingContext::calculated_main_size(Box const& box) const
  260. {
  261. auto const& box_state = m_state.get(box);
  262. return is_row_layout() ? box_state.content_width : box_state.content_height;
  263. }
  264. bool FlexFormattingContext::is_cross_auto(Box const& box) const
  265. {
  266. auto& cross_length = is_row_layout() ? box.computed_values().height() : box.computed_values().width();
  267. return cross_length.has_value() && cross_length->is_length() && cross_length->length().is_auto();
  268. }
  269. bool FlexFormattingContext::is_main_axis_margin_first_auto(Box const& box) const
  270. {
  271. if (is_row_layout())
  272. return box.computed_values().margin().left.is_length() && box.computed_values().margin().left.length().is_auto();
  273. return box.computed_values().margin().top.is_length() && box.computed_values().margin().top.length().is_auto();
  274. }
  275. bool FlexFormattingContext::is_main_axis_margin_second_auto(Box const& box) const
  276. {
  277. if (is_row_layout())
  278. return box.computed_values().margin().right.is_length() && box.computed_values().margin().right.length().is_auto();
  279. return box.computed_values().margin().bottom.is_length() && box.computed_values().margin().bottom.length().is_auto();
  280. }
  281. void FlexFormattingContext::set_main_size(Box const& box, float size)
  282. {
  283. if (is_row_layout())
  284. m_state.ensure(box).content_width = size;
  285. else
  286. m_state.ensure(box).content_height = size;
  287. }
  288. void FlexFormattingContext::set_cross_size(Box const& box, float size)
  289. {
  290. if (is_row_layout())
  291. m_state.ensure(box).content_height = size;
  292. else
  293. m_state.ensure(box).content_width = size;
  294. }
  295. void FlexFormattingContext::set_offset(Box const& box, float main_offset, float cross_offset)
  296. {
  297. if (is_row_layout())
  298. m_state.ensure(box).offset = Gfx::FloatPoint { main_offset, cross_offset };
  299. else
  300. m_state.ensure(box).offset = Gfx::FloatPoint { cross_offset, main_offset };
  301. }
  302. void FlexFormattingContext::set_main_axis_first_margin(Box const& box, float margin)
  303. {
  304. if (is_row_layout())
  305. m_state.ensure(box).margin_left = margin;
  306. else
  307. m_state.ensure(box).margin_top = margin;
  308. }
  309. void FlexFormattingContext::set_main_axis_second_margin(Box const& box, float margin)
  310. {
  311. if (is_row_layout())
  312. m_state.ensure(box).margin_right = margin;
  313. else
  314. m_state.ensure(box).margin_bottom = margin;
  315. }
  316. float FlexFormattingContext::sum_of_margin_padding_border_in_main_axis(Box const& box) const
  317. {
  318. auto const& box_state = m_state.get(box);
  319. if (is_row_layout()) {
  320. return box_state.margin_left + box_state.margin_right
  321. + box_state.padding_left + box_state.padding_right
  322. + box_state.border_left + box_state.border_right;
  323. } else {
  324. return box_state.margin_top + box_state.margin_bottom
  325. + box_state.padding_top + box_state.padding_bottom
  326. + box_state.border_top + box_state.border_bottom;
  327. }
  328. }
  329. // https://www.w3.org/TR/css-flexbox-1/#algo-available
  330. FlexFormattingContext::AvailableSpace FlexFormattingContext::determine_available_main_and_cross_space(bool& main_size_is_infinite, bool& main_is_constrained, bool& cross_is_constrained, float& main_min_size, float& main_max_size, float& cross_min_size, float& cross_max_size) const
  331. {
  332. auto containing_block_effective_main_size = [&](Box const& box) {
  333. auto& containing_block = *box.containing_block();
  334. if (is_row_layout()) {
  335. if (containing_block.has_definite_width())
  336. return m_state.get(containing_block).content_width;
  337. main_size_is_infinite = true;
  338. return NumericLimits<float>::max();
  339. } else {
  340. if (containing_block.has_definite_height())
  341. return m_state.get(containing_block).content_height;
  342. main_size_is_infinite = true;
  343. return NumericLimits<float>::max();
  344. }
  345. };
  346. float main_available_space = 0;
  347. main_is_constrained = false;
  348. // For each dimension,
  349. // if that dimension of the flex container’s content box is a definite size, use that;
  350. // 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;
  351. // 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. (This might result in an infinite value.)
  352. if (has_definite_main_size(flex_container())) {
  353. main_is_constrained = true;
  354. main_available_space = specified_main_size(flex_container());
  355. } else {
  356. if (has_main_max_size(flex_container())) {
  357. main_max_size = specified_main_max_size(flex_container());
  358. main_available_space = main_max_size;
  359. main_is_constrained = true;
  360. }
  361. if (has_main_min_size(flex_container())) {
  362. main_min_size = specified_main_min_size(flex_container());
  363. main_is_constrained = true;
  364. }
  365. if (!main_is_constrained) {
  366. auto available_main_size = containing_block_effective_main_size(flex_container());
  367. main_available_space = available_main_size - sum_of_margin_padding_border_in_main_axis(flex_container());
  368. if (flex_container().computed_values().flex_wrap() == CSS::FlexWrap::Wrap || flex_container().computed_values().flex_wrap() == CSS::FlexWrap::WrapReverse) {
  369. main_available_space = specified_main_size(*flex_container().containing_block());
  370. main_is_constrained = true;
  371. }
  372. }
  373. }
  374. float cross_available_space = 0;
  375. cross_is_constrained = false;
  376. if (has_definite_cross_size(flex_container())) {
  377. cross_available_space = specified_cross_size(flex_container());
  378. } else {
  379. if (has_cross_max_size(flex_container())) {
  380. cross_max_size = specified_cross_max_size(flex_container());
  381. cross_is_constrained = true;
  382. }
  383. if (has_cross_min_size(flex_container())) {
  384. cross_min_size = specified_cross_min_size(flex_container());
  385. cross_is_constrained = true;
  386. }
  387. // FIXME: Is this right? Probably not.
  388. if (!cross_is_constrained)
  389. cross_available_space = cross_max_size;
  390. }
  391. return AvailableSpace { .main = main_available_space, .cross = cross_available_space };
  392. }
  393. float FlexFormattingContext::layout_for_maximum_main_size(Box const& box)
  394. {
  395. bool main_constrained = false;
  396. if (is_row_layout()) {
  397. if (!is_undefined_or_auto(box.computed_values().width()) || !is_undefined_or_auto(box.computed_values().min_width())) {
  398. main_constrained = true;
  399. }
  400. } else {
  401. if (!is_undefined_or_auto(box.computed_values().height()) || !is_undefined_or_auto(box.computed_values().min_height())) {
  402. main_constrained = true;
  403. }
  404. }
  405. if (!main_constrained && box.children_are_inline()) {
  406. auto& block_container = verify_cast<BlockContainer>(box);
  407. BlockFormattingContext bfc(m_state, block_container, this);
  408. bfc.run(box, LayoutMode::Default);
  409. InlineFormattingContext ifc(m_state, block_container, bfc);
  410. if (is_row_layout()) {
  411. ifc.run(box, LayoutMode::OnlyRequiredLineBreaks);
  412. return m_state.get(box).content_width;
  413. } else {
  414. ifc.run(box, LayoutMode::AllPossibleLineBreaks);
  415. return m_state.get(box).content_height;
  416. }
  417. }
  418. if (is_row_layout()) {
  419. (void)layout_inside(box, LayoutMode::OnlyRequiredLineBreaks);
  420. return m_state.get(box).content_width;
  421. } else {
  422. return BlockFormattingContext::compute_theoretical_height(m_state, box);
  423. }
  424. }
  425. // https://www.w3.org/TR/css-flexbox-1/#algo-main-item
  426. void FlexFormattingContext::determine_flex_base_size_and_hypothetical_main_size(FlexItem& flex_item)
  427. {
  428. auto& child_box = flex_item.box;
  429. flex_item.flex_base_size = [&] {
  430. auto const& used_flex_basis = child_box.computed_values().flex_basis();
  431. // A. If the item has a definite used flex basis, that’s the flex base size.
  432. if (used_flex_basis.is_definite()) {
  433. auto specified_base_size = get_pixel_size(m_state, child_box, used_flex_basis.length_percentage.value());
  434. if (specified_base_size == 0)
  435. return calculated_main_size(flex_item.box);
  436. return specified_base_size;
  437. }
  438. // B. If the flex item has ...
  439. // - an intrinsic aspect ratio,
  440. // - a used flex basis of content, and
  441. // - a definite cross size,
  442. if (flex_item.box.has_intrinsic_aspect_ratio()
  443. && used_flex_basis.type == CSS::FlexBasis::Content
  444. && has_definite_cross_size(child_box)) {
  445. TODO();
  446. // flex_base_size is calculated from definite cross size and intrinsic aspect ratio
  447. }
  448. // C. If the used flex basis is content or depends on its available space,
  449. // and the flex container is being sized under a min-content or max-content constraint
  450. // (e.g. when performing automatic table layout [CSS21]), size the item under that constraint.
  451. // The flex base size is the item’s resulting main size.
  452. if (used_flex_basis.type == CSS::FlexBasis::Content
  453. // FIXME: && sized under min-content or max-content constraints
  454. && false) {
  455. TODO();
  456. // Size child_box under the constraints, flex_base_size is then the resulting main_size.
  457. }
  458. // D. Otherwise, if the used flex basis is content or depends on its available space,
  459. // the available main size is infinite, and the flex item’s inline axis is parallel to the main axis,
  460. // lay the item out using the rules for a box in an orthogonal flow [CSS3-WRITING-MODES].
  461. // The flex base size is the item’s max-content main size.
  462. if (used_flex_basis.type == CSS::FlexBasis::Content
  463. // FIXME: && main_size is infinite && inline axis is parallel to the main axis
  464. && false && false) {
  465. TODO();
  466. // Use rules for a flex_container in orthogonal flow
  467. }
  468. // E. Otherwise, size the item into the available space using its used flex basis in place of its main size,
  469. // treating a value of content as max-content. If a cross size is needed to determine the main size
  470. // (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,
  471. // in this calculation use fit-content as the flex item’s cross size.
  472. // The flex base size is the item’s resulting main size.
  473. // FIXME: This is probably too naive.
  474. // FIXME: Care about FlexBasis::Auto
  475. if (has_definite_main_size(child_box))
  476. return specified_main_size_of_child_box(child_box);
  477. return layout_for_maximum_main_size(child_box);
  478. }();
  479. // 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).
  480. auto clamp_min = has_main_min_size(child_box) ? specified_main_min_size(child_box) : 0;
  481. auto clamp_max = has_main_max_size(child_box) ? specified_main_max_size(child_box) : NumericLimits<float>::max();
  482. flex_item.hypothetical_main_size = clamp(flex_item.flex_base_size, clamp_min, clamp_max);
  483. }
  484. // https://www.w3.org/TR/css-flexbox-1/#algo-main-container
  485. void FlexFormattingContext::determine_main_size_of_flex_container(bool const main_is_constrained, bool const main_size_is_infinite, float& main_available_size, float const main_min_size, float const main_max_size)
  486. {
  487. if ((!main_is_constrained && main_size_is_infinite) || main_available_size == 0) {
  488. // Uses https://www.w3.org/TR/css-flexbox-1/#intrinsic-main-sizes
  489. // 9.9.1
  490. // 1.
  491. float largest_max_content_flex_fraction = 0;
  492. for (auto& flex_item : m_flex_items) {
  493. // FIXME: This needs some serious work.
  494. float max_content_contribution = calculated_main_size(flex_item.box);
  495. float max_content_flex_fraction = max_content_contribution - flex_item.flex_base_size;
  496. if (max_content_flex_fraction > 0) {
  497. max_content_flex_fraction /= max(flex_item.box.computed_values().flex_grow(), 1.0f);
  498. } else {
  499. max_content_flex_fraction /= max(flex_item.box.computed_values().flex_shrink(), 1.0f) * flex_item.flex_base_size;
  500. }
  501. flex_item.max_content_flex_fraction = max_content_flex_fraction;
  502. if (max_content_flex_fraction > largest_max_content_flex_fraction)
  503. largest_max_content_flex_fraction = max_content_flex_fraction;
  504. }
  505. // 2. Omitted
  506. // 3.
  507. float result = 0;
  508. for (auto& flex_item : m_flex_items) {
  509. auto product = 0;
  510. if (flex_item.max_content_flex_fraction > 0) {
  511. product = largest_max_content_flex_fraction * flex_item.box.computed_values().flex_grow();
  512. } else {
  513. product = largest_max_content_flex_fraction * max(flex_item.box.computed_values().flex_shrink(), 1.0f) * flex_item.flex_base_size;
  514. }
  515. result += flex_item.flex_base_size + product;
  516. }
  517. main_available_size = clamp(result, main_min_size, main_max_size);
  518. }
  519. set_main_size(flex_container(), main_available_size);
  520. }
  521. // https://www.w3.org/TR/css-flexbox-1/#algo-line-break
  522. void FlexFormattingContext::collect_flex_items_into_flex_lines(float const main_available_size)
  523. {
  524. // FIXME: Also support wrap-reverse
  525. // If the flex container is single-line, collect all the flex items into a single flex line.
  526. if (is_single_line()) {
  527. FlexLine line;
  528. for (auto& flex_item : m_flex_items) {
  529. line.items.append(&flex_item);
  530. }
  531. m_flex_lines.append(move(line));
  532. return;
  533. }
  534. // Otherwise, starting from the first uncollected item, collect consecutive items one by one
  535. // until the first time that the next collected item would not fit into the flex container’s inner main size
  536. // (or until a forced break is encountered, see §10 Fragmenting Flex Layout).
  537. // If the very first uncollected item wouldn't fit, collect just it into the line.
  538. // For this step, the size of a flex item is its outer hypothetical main size. (Note: This can be negative.)
  539. // Repeat until all flex items have been collected into flex lines.
  540. FlexLine line;
  541. float line_main_size = 0;
  542. for (auto& flex_item : m_flex_items) {
  543. if ((line_main_size + flex_item.hypothetical_main_size) > main_available_size) {
  544. m_flex_lines.append(move(line));
  545. line = {};
  546. line_main_size = 0;
  547. }
  548. line.items.append(&flex_item);
  549. line_main_size += flex_item.hypothetical_main_size;
  550. }
  551. m_flex_lines.append(move(line));
  552. }
  553. // https://www.w3.org/TR/css-flexbox-1/#resolve-flexible-lengths
  554. void FlexFormattingContext::resolve_flexible_lengths(float const main_available_size)
  555. {
  556. enum FlexFactor {
  557. FlexGrowFactor,
  558. FlexShrinkFactor
  559. };
  560. FlexFactor used_flex_factor;
  561. // 6.1. Determine used flex factor
  562. for (auto& flex_line : m_flex_lines) {
  563. size_t number_of_unfrozen_items_on_line = flex_line.items.size();
  564. float sum_of_hypothetical_main_sizes = 0;
  565. for (auto& flex_item : flex_line.items) {
  566. sum_of_hypothetical_main_sizes += flex_item->hypothetical_main_size;
  567. }
  568. if (sum_of_hypothetical_main_sizes < main_available_size)
  569. used_flex_factor = FlexFactor::FlexGrowFactor;
  570. else
  571. used_flex_factor = FlexFactor::FlexShrinkFactor;
  572. for (auto& flex_item : flex_line.items) {
  573. if (used_flex_factor == FlexFactor::FlexGrowFactor)
  574. flex_item->flex_factor = flex_item->box.computed_values().flex_grow();
  575. else if (used_flex_factor == FlexFactor::FlexShrinkFactor)
  576. flex_item->flex_factor = flex_item->box.computed_values().flex_shrink();
  577. }
  578. // 6.2. Size inflexible items
  579. auto freeze_item_setting_target_main_size_to_hypothetical_main_size = [&number_of_unfrozen_items_on_line](FlexItem& item) {
  580. item.target_main_size = item.hypothetical_main_size;
  581. number_of_unfrozen_items_on_line--;
  582. item.frozen = true;
  583. };
  584. for (auto& flex_item : flex_line.items) {
  585. if (flex_item->flex_factor.has_value() && flex_item->flex_factor.value() == 0) {
  586. freeze_item_setting_target_main_size_to_hypothetical_main_size(*flex_item);
  587. } else if (used_flex_factor == FlexFactor::FlexGrowFactor) {
  588. // FIXME: Spec doesn't include the == case, but we take a too basic approach to calculating the values used so this is appropriate
  589. if (flex_item->flex_base_size > flex_item->hypothetical_main_size) {
  590. freeze_item_setting_target_main_size_to_hypothetical_main_size(*flex_item);
  591. }
  592. } else if (used_flex_factor == FlexFactor::FlexShrinkFactor) {
  593. if (flex_item->flex_base_size < flex_item->hypothetical_main_size) {
  594. freeze_item_setting_target_main_size_to_hypothetical_main_size(*flex_item);
  595. }
  596. }
  597. }
  598. // 6.3. Calculate initial free space
  599. auto calculate_free_space = [&]() {
  600. float sum_of_items_on_line = 0;
  601. for (auto& flex_item : flex_line.items) {
  602. if (flex_item->frozen)
  603. sum_of_items_on_line += flex_item->target_main_size;
  604. else
  605. sum_of_items_on_line += flex_item->flex_base_size;
  606. }
  607. return main_available_size - sum_of_items_on_line;
  608. };
  609. float initial_free_space = calculate_free_space();
  610. // 6.4 Loop
  611. auto for_each_unfrozen_item = [&flex_line](auto callback) {
  612. for (auto& flex_item : flex_line.items) {
  613. if (!flex_item->frozen)
  614. callback(flex_item);
  615. }
  616. };
  617. while (number_of_unfrozen_items_on_line > 0) {
  618. // b Calculate the remaining free space
  619. auto remaining_free_space = calculate_free_space();
  620. float sum_of_unfrozen_flex_items_flex_factors = 0;
  621. for_each_unfrozen_item([&](FlexItem* item) {
  622. sum_of_unfrozen_flex_items_flex_factors += item->flex_factor.value_or(1);
  623. });
  624. if (sum_of_unfrozen_flex_items_flex_factors < 1) {
  625. auto intermediate_free_space = initial_free_space * sum_of_unfrozen_flex_items_flex_factors;
  626. if (AK::abs(intermediate_free_space) < AK::abs(remaining_free_space))
  627. remaining_free_space = intermediate_free_space;
  628. }
  629. // c Distribute free space proportional to the flex factors
  630. if (remaining_free_space != 0) {
  631. if (used_flex_factor == FlexFactor::FlexGrowFactor) {
  632. float sum_of_flex_grow_factor_of_unfrozen_items = sum_of_unfrozen_flex_items_flex_factors;
  633. for_each_unfrozen_item([&](FlexItem* flex_item) {
  634. float ratio = flex_item->flex_factor.value_or(1) / sum_of_flex_grow_factor_of_unfrozen_items;
  635. flex_item->target_main_size = flex_item->flex_base_size + (remaining_free_space * ratio);
  636. });
  637. } else if (used_flex_factor == FlexFactor::FlexShrinkFactor) {
  638. float sum_of_scaled_flex_shrink_factor_of_unfrozen_items = 0;
  639. for_each_unfrozen_item([&](FlexItem* flex_item) {
  640. flex_item->scaled_flex_shrink_factor = flex_item->flex_factor.value_or(1) * flex_item->flex_base_size;
  641. sum_of_scaled_flex_shrink_factor_of_unfrozen_items += flex_item->scaled_flex_shrink_factor;
  642. });
  643. for_each_unfrozen_item([&](FlexItem* flex_item) {
  644. float ratio = 1.0f;
  645. if (sum_of_scaled_flex_shrink_factor_of_unfrozen_items != 0.0f)
  646. ratio = flex_item->scaled_flex_shrink_factor / sum_of_scaled_flex_shrink_factor_of_unfrozen_items;
  647. flex_item->target_main_size = flex_item->flex_base_size - (AK::abs(remaining_free_space) * ratio);
  648. });
  649. }
  650. } else {
  651. // This isn't spec but makes sense.
  652. for_each_unfrozen_item([&](FlexItem* flex_item) {
  653. flex_item->target_main_size = flex_item->flex_base_size;
  654. });
  655. }
  656. // d Fix min/max violations.
  657. float adjustments = 0.0f;
  658. for_each_unfrozen_item([&](FlexItem* item) {
  659. auto min_main = has_main_min_size(item->box)
  660. ? specified_main_min_size(item->box)
  661. : 0;
  662. auto max_main = has_main_max_size(item->box)
  663. ? specified_main_max_size(item->box)
  664. : NumericLimits<float>::max();
  665. float original_target_size = item->target_main_size;
  666. if (item->target_main_size < min_main) {
  667. item->target_main_size = min_main;
  668. item->is_min_violation = true;
  669. }
  670. if (item->target_main_size > max_main) {
  671. item->target_main_size = max_main;
  672. item->is_max_violation = true;
  673. }
  674. float delta = item->target_main_size - original_target_size;
  675. adjustments += delta;
  676. });
  677. // e Freeze over-flexed items
  678. float total_violation = adjustments;
  679. if (total_violation == 0) {
  680. for_each_unfrozen_item([&](FlexItem* item) {
  681. --number_of_unfrozen_items_on_line;
  682. item->frozen = true;
  683. });
  684. } else if (total_violation > 0) {
  685. for_each_unfrozen_item([&](FlexItem* item) {
  686. if (item->is_min_violation) {
  687. --number_of_unfrozen_items_on_line;
  688. item->frozen = true;
  689. }
  690. });
  691. } else if (total_violation < 0) {
  692. for_each_unfrozen_item([&](FlexItem* item) {
  693. if (item->is_max_violation) {
  694. --number_of_unfrozen_items_on_line;
  695. item->frozen = true;
  696. }
  697. });
  698. }
  699. }
  700. // 6.5.
  701. for (auto& flex_item : flex_line.items) {
  702. flex_item->main_size = flex_item->target_main_size;
  703. }
  704. }
  705. }
  706. // https://www.w3.org/TR/css-flexbox-1/#algo-cross-item
  707. float FlexFormattingContext::determine_hypothetical_cross_size_of_item(Box const& box)
  708. {
  709. bool cross_constrained = false;
  710. if (is_row_layout()) {
  711. if (!is_undefined_or_auto(box.computed_values().height()) || !is_undefined_or_auto(box.computed_values().min_height())) {
  712. cross_constrained = true;
  713. }
  714. } else {
  715. if (!is_undefined_or_auto(box.computed_values().width()) || !is_undefined_or_auto(box.computed_values().min_width())) {
  716. cross_constrained = true;
  717. }
  718. }
  719. if (!cross_constrained && box.children_are_inline()) {
  720. auto& block_container = verify_cast<BlockContainer>(box);
  721. BlockFormattingContext bfc(m_state, block_container, this);
  722. bfc.run(box, LayoutMode::Default);
  723. InlineFormattingContext ifc(m_state, block_container, bfc);
  724. ifc.run(box, LayoutMode::OnlyRequiredLineBreaks);
  725. auto const& box_state = m_state.get(box);
  726. return is_row_layout() ? box_state.content_height : box_state.content_width;
  727. }
  728. if (is_row_layout())
  729. return BlockFormattingContext::compute_theoretical_height(m_state, box);
  730. BlockFormattingContext context(m_state, verify_cast<BlockContainer>(box), this);
  731. context.compute_width(box);
  732. return m_state.get(box).content_width;
  733. }
  734. // https://www.w3.org/TR/css-flexbox-1/#algo-cross-line
  735. void FlexFormattingContext::calculate_cross_size_of_each_flex_line(float const cross_min_size, float const cross_max_size)
  736. {
  737. // 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.
  738. if (is_single_line() && has_definite_cross_size(flex_container())) {
  739. m_flex_lines[0].cross_size = specified_cross_size(flex_container());
  740. return;
  741. }
  742. // Otherwise, for each flex line:
  743. for (auto& flex_line : m_flex_lines) {
  744. // FIXME: 1. Collect all the flex items whose inline-axis is parallel to the main-axis, whose align-self is baseline,
  745. // and whose cross-axis margins are both non-auto. Find the largest of the distances between each item’s baseline
  746. // and its hypothetical outer cross-start edge, and the largest of the distances between each item’s baseline
  747. // and its hypothetical outer cross-end edge, and sum these two values.
  748. // FIXME: This isn't spec but makes sense here
  749. if (has_definite_cross_size(flex_container()) && flex_container().computed_values().align_items() == CSS::AlignItems::Stretch) {
  750. flex_line.cross_size = specified_cross_size(flex_container()) / m_flex_lines.size();
  751. continue;
  752. }
  753. // 2. Among all the items not collected by the previous step, find the largest outer hypothetical cross size.
  754. float largest_hypothetical_cross_size = 0;
  755. for (auto& flex_item : flex_line.items) {
  756. if (largest_hypothetical_cross_size < flex_item->hypothetical_cross_size_with_margins())
  757. largest_hypothetical_cross_size = flex_item->hypothetical_cross_size_with_margins();
  758. }
  759. // 3. The used cross-size of the flex line is the largest of the numbers found in the previous two steps and zero.
  760. flex_line.cross_size = max(0.0f, largest_hypothetical_cross_size);
  761. }
  762. // 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.
  763. // Note that if CSS 2.1’s definition of min/max-width/height applied more generally, this behavior would fall out automatically.
  764. if (is_single_line())
  765. clamp(m_flex_lines[0].cross_size, cross_min_size, cross_max_size);
  766. }
  767. // https://www.w3.org/TR/css-flexbox-1/#algo-stretch
  768. void FlexFormattingContext::determine_used_cross_size_of_each_flex_item()
  769. {
  770. // FIXME: Get the alignment via "align-self" of the item (which accesses "align-items" of the parent if unset)
  771. for (auto& flex_line : m_flex_lines) {
  772. for (auto& flex_item : flex_line.items) {
  773. if (is_cross_auto(flex_item->box) && flex_container().computed_values().align_items() == CSS::AlignItems::Stretch) {
  774. flex_item->cross_size = flex_line.cross_size;
  775. } else {
  776. flex_item->cross_size = flex_item->hypothetical_cross_size;
  777. }
  778. }
  779. }
  780. }
  781. // https://www.w3.org/TR/css-flexbox-1/#algo-main-align
  782. void FlexFormattingContext::distribute_any_remaining_free_space(float const main_available_size)
  783. {
  784. for (auto& flex_line : m_flex_lines) {
  785. // 12.1.
  786. float used_main_space = 0;
  787. size_t auto_margins = 0;
  788. for (auto& flex_item : flex_line.items) {
  789. used_main_space += flex_item->main_size;
  790. if (is_main_axis_margin_first_auto(flex_item->box))
  791. ++auto_margins;
  792. if (is_main_axis_margin_second_auto(flex_item->box))
  793. ++auto_margins;
  794. }
  795. float remaining_free_space = main_available_size - used_main_space;
  796. if (remaining_free_space > 0) {
  797. float size_per_auto_margin = remaining_free_space / (float)auto_margins;
  798. for (auto& flex_item : flex_line.items) {
  799. if (is_main_axis_margin_first_auto(flex_item->box))
  800. set_main_axis_first_margin(flex_item->box, size_per_auto_margin);
  801. if (is_main_axis_margin_second_auto(flex_item->box))
  802. set_main_axis_second_margin(flex_item->box, size_per_auto_margin);
  803. }
  804. } else {
  805. for (auto& flex_item : flex_line.items) {
  806. if (is_main_axis_margin_first_auto(flex_item->box))
  807. set_main_axis_first_margin(flex_item->box, 0);
  808. if (is_main_axis_margin_second_auto(flex_item->box))
  809. set_main_axis_second_margin(flex_item->box, 0);
  810. }
  811. }
  812. // 12.2.
  813. float space_between_items = 0;
  814. float space_before_first_item = 0;
  815. auto number_of_items = flex_line.items.size();
  816. switch (flex_container().computed_values().justify_content()) {
  817. case CSS::JustifyContent::FlexStart:
  818. break;
  819. case CSS::JustifyContent::FlexEnd:
  820. space_before_first_item = main_available_size - used_main_space;
  821. break;
  822. case CSS::JustifyContent::Center:
  823. space_before_first_item = (main_available_size - used_main_space) / 2.0f;
  824. break;
  825. case CSS::JustifyContent::SpaceBetween:
  826. space_between_items = remaining_free_space / (number_of_items - 1);
  827. break;
  828. case CSS::JustifyContent::SpaceAround:
  829. space_between_items = remaining_free_space / number_of_items;
  830. space_before_first_item = space_between_items / 2.0f;
  831. break;
  832. }
  833. // FIXME: Support reverse
  834. float main_offset = space_before_first_item;
  835. for (auto& flex_item : flex_line.items) {
  836. flex_item->main_offset = main_offset;
  837. main_offset += flex_item->main_size + space_between_items;
  838. }
  839. }
  840. }
  841. void FlexFormattingContext::align_all_flex_items_along_the_cross_axis()
  842. {
  843. // FIXME: Get the alignment via "align-self" of the item (which accesses "align-items" of the parent if unset)
  844. // FIXME: Take better care of margins
  845. float line_cross_offset = 0;
  846. for (auto& flex_line : m_flex_lines) {
  847. for (auto* flex_item : flex_line.items) {
  848. switch (flex_container().computed_values().align_items()) {
  849. case CSS::AlignItems::Baseline:
  850. // FIXME: Implement this
  851. // Fallthrough
  852. case CSS::AlignItems::FlexStart:
  853. case CSS::AlignItems::Stretch:
  854. flex_item->cross_offset = line_cross_offset + flex_item->margins.cross_before;
  855. break;
  856. case CSS::AlignItems::FlexEnd:
  857. flex_item->cross_offset = line_cross_offset + flex_line.cross_size - flex_item->cross_size;
  858. break;
  859. case CSS::AlignItems::Center:
  860. flex_item->cross_offset = line_cross_offset + (flex_line.cross_size / 2.0f) - (flex_item->cross_size / 2.0f);
  861. break;
  862. default:
  863. break;
  864. }
  865. }
  866. line_cross_offset += flex_line.cross_size;
  867. }
  868. }
  869. // https://www.w3.org/TR/css-flexbox-1/#algo-cross-container
  870. void FlexFormattingContext::determine_flex_container_used_cross_size(float const cross_min_size, float const cross_max_size)
  871. {
  872. if (has_definite_cross_size(flex_container())) {
  873. float clamped_cross_size = clamp(specified_cross_size(flex_container()), cross_min_size, cross_max_size);
  874. set_cross_size(flex_container(), clamped_cross_size);
  875. } else {
  876. float sum_of_flex_lines_cross_sizes = 0;
  877. for (auto& flex_line : m_flex_lines) {
  878. sum_of_flex_lines_cross_sizes += flex_line.cross_size;
  879. }
  880. float clamped_cross_size = clamp(sum_of_flex_lines_cross_sizes, cross_min_size, cross_max_size);
  881. set_cross_size(flex_container(), clamped_cross_size);
  882. }
  883. }
  884. // https://www.w3.org/TR/css-flexbox-1/#algo-line-align
  885. void FlexFormattingContext::align_all_flex_lines()
  886. {
  887. // FIXME: Support align-content
  888. // FIXME: Support reverse
  889. for (auto& flex_line : m_flex_lines) {
  890. for (auto* flex_item : flex_line.items) {
  891. set_main_size(flex_item->box, flex_item->main_size);
  892. set_cross_size(flex_item->box, flex_item->cross_size);
  893. set_offset(flex_item->box, flex_item->main_offset, flex_item->cross_offset);
  894. }
  895. }
  896. }
  897. }