GridFormattingContext.cpp 94 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858
  1. /*
  2. * Copyright (c) 2022-2023, Martin Falisse <mfalisse@outlook.com>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <LibWeb/DOM/Node.h>
  7. #include <LibWeb/Layout/Box.h>
  8. #include <LibWeb/Layout/GridFormattingContext.h>
  9. namespace Web::Layout {
  10. GridFormattingContext::GridFormattingContext(LayoutState& state, Box const& grid_container, FormattingContext* parent)
  11. : FormattingContext(Type::Grid, state, grid_container, parent)
  12. {
  13. }
  14. GridFormattingContext::~GridFormattingContext() = default;
  15. CSSPixels GridFormattingContext::resolve_definite_track_size(CSS::GridSize const& grid_size, AvailableSpace const& available_space)
  16. {
  17. VERIFY(grid_size.is_definite());
  18. switch (grid_size.type()) {
  19. case CSS::GridSize::Type::LengthPercentage: {
  20. if (!grid_size.length_percentage().is_auto()) {
  21. return grid_size.css_size().to_px(grid_container(), available_space.width.to_px());
  22. }
  23. break;
  24. }
  25. default:
  26. VERIFY_NOT_REACHED();
  27. }
  28. return 0;
  29. }
  30. int GridFormattingContext::get_count_of_tracks(Vector<CSS::ExplicitGridTrack> const& track_list, AvailableSpace const& available_space)
  31. {
  32. auto track_count = 0;
  33. for (auto const& explicit_grid_track : track_list) {
  34. if (explicit_grid_track.is_repeat() && explicit_grid_track.repeat().is_default())
  35. track_count += explicit_grid_track.repeat().repeat_count() * explicit_grid_track.repeat().grid_track_size_list().track_list().size();
  36. else
  37. track_count += 1;
  38. }
  39. if (track_list.size() == 1
  40. && track_list.first().is_repeat()
  41. && (track_list.first().repeat().is_auto_fill() || track_list.first().repeat().is_auto_fit())) {
  42. track_count = count_of_repeated_auto_fill_or_fit_tracks(track_list, available_space);
  43. }
  44. return track_count;
  45. }
  46. int GridFormattingContext::count_of_repeated_auto_fill_or_fit_tracks(Vector<CSS::ExplicitGridTrack> const& track_list, AvailableSpace const& available_space)
  47. {
  48. // https://www.w3.org/TR/css-grid-2/#auto-repeat
  49. // 7.2.3.2. Repeat-to-fill: auto-fill and auto-fit repetitions
  50. // On a subgridded axis, the auto-fill keyword is only valid once per <line-name-list>, and repeats
  51. // enough times for the name list to match the subgrid’s specified grid span (falling back to 0 if
  52. // the span is already fulfilled).
  53. // Otherwise on a standalone axis, when auto-fill is given as the repetition number
  54. // If the grid container has a definite size or max size in the relevant axis, then the number of
  55. // repetitions is the largest possible positive integer that does not cause the grid to overflow the
  56. // content box of its grid container
  57. CSSPixels sum_of_grid_track_sizes = 0;
  58. // (treating each track as its max track sizing function if that is definite or its minimum track sizing
  59. // function otherwise, flooring the max track sizing function by the min track sizing function if both
  60. // are definite, and taking gap into account)
  61. // FIXME: take gap into account
  62. for (auto& explicit_grid_track : track_list.first().repeat().grid_track_size_list().track_list()) {
  63. auto track_sizing_function = explicit_grid_track;
  64. if (track_sizing_function.is_minmax()) {
  65. if (track_sizing_function.minmax().max_grid_size().is_definite() && !track_sizing_function.minmax().min_grid_size().is_definite())
  66. sum_of_grid_track_sizes += resolve_definite_track_size(track_sizing_function.minmax().max_grid_size(), available_space);
  67. else if (track_sizing_function.minmax().min_grid_size().is_definite() && !track_sizing_function.minmax().max_grid_size().is_definite())
  68. sum_of_grid_track_sizes += resolve_definite_track_size(track_sizing_function.minmax().min_grid_size(), available_space);
  69. else if (track_sizing_function.minmax().min_grid_size().is_definite() && track_sizing_function.minmax().max_grid_size().is_definite())
  70. sum_of_grid_track_sizes += min(resolve_definite_track_size(track_sizing_function.minmax().min_grid_size(), available_space), resolve_definite_track_size(track_sizing_function.minmax().max_grid_size(), available_space));
  71. } else {
  72. sum_of_grid_track_sizes += min(resolve_definite_track_size(track_sizing_function.grid_size(), available_space), resolve_definite_track_size(track_sizing_function.grid_size(), available_space));
  73. }
  74. }
  75. return max(1, static_cast<int>((get_free_space(available_space, GridDimension::Column).to_px() / sum_of_grid_track_sizes).value()));
  76. // For the purpose of finding the number of auto-repeated tracks in a standalone axis, the UA must
  77. // floor the track size to a UA-specified value to avoid division by zero. It is suggested that this
  78. // floor be 1px.
  79. }
  80. void GridFormattingContext::place_item_with_row_and_column_position(Box const& child_box)
  81. {
  82. int row_start = child_box.computed_values().grid_row_start().raw_value() - 1;
  83. int row_end = child_box.computed_values().grid_row_end().raw_value() - 1;
  84. int column_start = child_box.computed_values().grid_column_start().raw_value() - 1;
  85. int column_end = child_box.computed_values().grid_column_end().raw_value() - 1;
  86. // https://www.w3.org/TR/css-grid-2/#line-placement
  87. // 8.3. Line-based Placement: the grid-row-start, grid-column-start, grid-row-end, and grid-column-end properties
  88. // https://www.w3.org/TR/css-grid-2/#grid-placement-slot
  89. // First attempt to match the grid area’s edge to a named grid area: if there is a grid line whose
  90. // line name is <custom-ident>-start (for grid-*-start) / <custom-ident>-end (for grid-*-end),
  91. // contributes the first such line to the grid item’s placement.
  92. // Otherwise, treat this as if the integer 1 had been specified along with the <custom-ident>.
  93. // https://www.w3.org/TR/css-grid-2/#grid-placement-int
  94. // Contributes the Nth grid line to the grid item’s placement. If a negative integer is given, it
  95. // instead counts in reverse, starting from the end edge of the explicit grid.
  96. if (row_end < 0)
  97. row_end = m_occupation_grid.row_count() + row_end + 2;
  98. if (column_end < 0)
  99. column_end = m_occupation_grid.column_count() + column_end + 2;
  100. // If a name is given as a <custom-ident>, only lines with that name are counted. If not enough
  101. // lines with that name exist, all implicit grid lines are assumed to have that name for the purpose
  102. // of finding this position.
  103. // https://www.w3.org/TR/css-grid-2/#grid-placement-span-int
  104. // Contributes a grid span to the grid item’s placement such that the corresponding edge of the grid
  105. // item’s grid area is N lines from its opposite edge in the corresponding direction. For example,
  106. // grid-column-end: span 2 indicates the second grid line in the endward direction from the
  107. // grid-column-start line.
  108. int row_span = 1;
  109. int column_span = 1;
  110. if (child_box.computed_values().grid_row_start().is_position() && child_box.computed_values().grid_row_end().is_span())
  111. row_span = child_box.computed_values().grid_row_end().raw_value();
  112. if (child_box.computed_values().grid_column_start().is_position() && child_box.computed_values().grid_column_end().is_span())
  113. column_span = child_box.computed_values().grid_column_end().raw_value();
  114. if (child_box.computed_values().grid_row_end().is_position() && child_box.computed_values().grid_row_start().is_span()) {
  115. row_span = child_box.computed_values().grid_row_start().raw_value();
  116. row_start = row_end - row_span;
  117. }
  118. if (child_box.computed_values().grid_column_end().is_position() && child_box.computed_values().grid_column_start().is_span()) {
  119. column_span = child_box.computed_values().grid_column_start().raw_value();
  120. column_start = column_end - column_span;
  121. }
  122. // If a name is given as a <custom-ident>, only lines with that name are counted. If not enough
  123. // lines with that name exist, all implicit grid lines on the side of the explicit grid
  124. // corresponding to the search direction are assumed to have that name for the purpose of counting
  125. // this span.
  126. // https://drafts.csswg.org/css-grid/#grid-placement-auto
  127. // auto
  128. // The property contributes nothing to the grid item’s placement, indicating auto-placement or a
  129. // default span of one. (See § 8 Placing Grid Items, above.)
  130. // https://www.w3.org/TR/css-grid-2/#common-uses-named-lines
  131. // 8.1.3. Named Lines and Spans
  132. // Instead of counting lines by number, lines can be referenced by their line name:
  133. if (child_box.computed_values().grid_column_end().has_line_name()) {
  134. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_column_end().line_name()); grid_area_index > -1)
  135. column_end = m_valid_grid_areas[grid_area_index].column_end;
  136. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_column_end().line_name(), grid_container().computed_values().grid_template_columns()); line_name_index > -1)
  137. column_end = line_name_index;
  138. else
  139. column_end = 1;
  140. column_start = column_end - 1;
  141. }
  142. if (child_box.computed_values().grid_column_start().has_line_name()) {
  143. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_column_end().line_name()); grid_area_index > -1)
  144. column_start = m_valid_grid_areas[grid_area_index].column_start;
  145. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_column_start().line_name(), grid_container().computed_values().grid_template_columns()); line_name_index > -1)
  146. column_start = line_name_index;
  147. else
  148. column_start = 0;
  149. }
  150. if (child_box.computed_values().grid_row_end().has_line_name()) {
  151. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_row_end().line_name()); grid_area_index > -1)
  152. row_end = m_valid_grid_areas[grid_area_index].row_end;
  153. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_row_end().line_name(), grid_container().computed_values().grid_template_rows()); line_name_index > -1)
  154. row_end = line_name_index;
  155. else
  156. row_end = 1;
  157. row_start = row_end - 1;
  158. }
  159. if (child_box.computed_values().grid_row_start().has_line_name()) {
  160. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_row_end().line_name()); grid_area_index > -1)
  161. row_start = m_valid_grid_areas[grid_area_index].row_start;
  162. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_row_start().line_name(), grid_container().computed_values().grid_template_rows()); line_name_index > -1)
  163. row_start = line_name_index;
  164. else
  165. row_start = 0;
  166. }
  167. // If there are multiple lines of the same name, they effectively establish a named set of grid
  168. // lines, which can be exclusively indexed by filtering the placement by name:
  169. // https://drafts.csswg.org/css-grid/#grid-placement-errors
  170. // 8.3.1. Grid Placement Conflict Handling
  171. // If the placement for a grid item contains two lines, and the start line is further end-ward than
  172. // the end line, swap the two lines. If the start line is equal to the end line, remove the end
  173. // line.
  174. if (child_box.computed_values().grid_row_start().is_position() && child_box.computed_values().grid_row_end().is_position()) {
  175. if (row_start > row_end)
  176. swap(row_start, row_end);
  177. if (row_start != row_end)
  178. row_span = row_end - row_start;
  179. }
  180. if (child_box.computed_values().grid_column_start().is_position() && child_box.computed_values().grid_column_end().is_position()) {
  181. if (column_start > column_end)
  182. swap(column_start, column_end);
  183. if (column_start != column_end)
  184. column_span = column_end - column_start;
  185. }
  186. // If the placement contains two spans, remove the one contributed by the end grid-placement
  187. // property.
  188. if (child_box.computed_values().grid_row_start().is_span() && child_box.computed_values().grid_row_end().is_span())
  189. row_span = child_box.computed_values().grid_row_start().raw_value();
  190. if (child_box.computed_values().grid_column_start().is_span() && child_box.computed_values().grid_column_end().is_span())
  191. column_span = child_box.computed_values().grid_column_start().raw_value();
  192. // FIXME: If the placement contains only a span for a named line, replace it with a span of 1.
  193. m_grid_items.append(GridItem(child_box, row_start, row_span, column_start, column_span));
  194. m_occupation_grid.set_occupied(column_start, column_start + column_span, row_start, row_start + row_span);
  195. }
  196. void GridFormattingContext::place_item_with_row_position(Box const& child_box)
  197. {
  198. int row_start = child_box.computed_values().grid_row_start().raw_value() - 1;
  199. int row_end = child_box.computed_values().grid_row_end().raw_value() - 1;
  200. // https://www.w3.org/TR/css-grid-2/#line-placement
  201. // 8.3. Line-based Placement: the grid-row-start, grid-column-start, grid-row-end, and grid-column-end properties
  202. // https://www.w3.org/TR/css-grid-2/#grid-placement-slot
  203. // First attempt to match the grid area’s edge to a named grid area: if there is a grid line whose
  204. // line name is <custom-ident>-start (for grid-*-start) / <custom-ident>-end (for grid-*-end),
  205. // contributes the first such line to the grid item’s placement.
  206. // Otherwise, treat this as if the integer 1 had been specified along with the <custom-ident>.
  207. // https://www.w3.org/TR/css-grid-2/#grid-placement-int
  208. // Contributes the Nth grid line to the grid item’s placement. If a negative integer is given, it
  209. // instead counts in reverse, starting from the end edge of the explicit grid.
  210. if (row_end < 0)
  211. row_end = m_occupation_grid.row_count() + row_end + 2;
  212. // If a name is given as a <custom-ident>, only lines with that name are counted. If not enough
  213. // lines with that name exist, all implicit grid lines are assumed to have that name for the purpose
  214. // of finding this position.
  215. // https://www.w3.org/TR/css-grid-2/#grid-placement-span-int
  216. // Contributes a grid span to the grid item’s placement such that the corresponding edge of the grid
  217. // item’s grid area is N lines from its opposite edge in the corresponding direction. For example,
  218. // grid-column-end: span 2 indicates the second grid line in the endward direction from the
  219. // grid-column-start line.
  220. int row_span = 1;
  221. if (child_box.computed_values().grid_row_start().is_position() && child_box.computed_values().grid_row_end().is_span())
  222. row_span = child_box.computed_values().grid_row_end().raw_value();
  223. if (child_box.computed_values().grid_row_end().is_position() && child_box.computed_values().grid_row_start().is_span()) {
  224. row_span = child_box.computed_values().grid_row_start().raw_value();
  225. row_start = row_end - row_span;
  226. // FIXME: Remove me once have implemented spans overflowing into negative indexes, e.g., grid-row: span 2 / 1
  227. if (row_start < 0)
  228. row_start = 0;
  229. }
  230. // If a name is given as a <custom-ident>, only lines with that name are counted. If not enough
  231. // lines with that name exist, all implicit grid lines on the side of the explicit grid
  232. // corresponding to the search direction are assumed to have that name for the purpose of counting
  233. // this span.
  234. // https://drafts.csswg.org/css-grid/#grid-placement-auto
  235. // auto
  236. // The property contributes nothing to the grid item’s placement, indicating auto-placement or a
  237. // default span of one. (See § 8 Placing Grid Items, above.)
  238. // https://www.w3.org/TR/css-grid-2/#common-uses-named-lines
  239. // 8.1.3. Named Lines and Spans
  240. // Instead of counting lines by number, lines can be referenced by their line name:
  241. if (child_box.computed_values().grid_row_end().has_line_name()) {
  242. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_row_end().line_name()); grid_area_index > -1)
  243. row_end = m_valid_grid_areas[grid_area_index].row_end;
  244. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_row_end().line_name(), grid_container().computed_values().grid_template_rows()); line_name_index > -1)
  245. row_end = line_name_index;
  246. else
  247. row_end = 1;
  248. row_start = row_end - 1;
  249. }
  250. if (child_box.computed_values().grid_row_start().has_line_name()) {
  251. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_row_end().line_name()); grid_area_index > -1)
  252. row_start = m_valid_grid_areas[grid_area_index].row_start;
  253. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_row_start().line_name(), grid_container().computed_values().grid_template_rows()); line_name_index > -1)
  254. row_start = line_name_index;
  255. else
  256. row_start = 0;
  257. }
  258. // If there are multiple lines of the same name, they effectively establish a named set of grid
  259. // lines, which can be exclusively indexed by filtering the placement by name:
  260. // https://drafts.csswg.org/css-grid/#grid-placement-errors
  261. // 8.3.1. Grid Placement Conflict Handling
  262. // If the placement for a grid item contains two lines, and the start line is further end-ward than
  263. // the end line, swap the two lines. If the start line is equal to the end line, remove the end
  264. // line.
  265. if (child_box.computed_values().grid_row_start().is_position() && child_box.computed_values().grid_row_end().is_position()) {
  266. if (row_start > row_end)
  267. swap(row_start, row_end);
  268. if (row_start != row_end)
  269. row_span = row_end - row_start;
  270. }
  271. // FIXME: Have yet to find the spec for this.
  272. if (!child_box.computed_values().grid_row_start().is_position() && child_box.computed_values().grid_row_end().is_position() && row_end == 0)
  273. row_start = 0;
  274. // If the placement contains two spans, remove the one contributed by the end grid-placement
  275. // property.
  276. if (child_box.computed_values().grid_row_start().is_span() && child_box.computed_values().grid_row_end().is_span())
  277. row_span = child_box.computed_values().grid_row_start().raw_value();
  278. // FIXME: If the placement contains only a span for a named line, replace it with a span of 1.
  279. int column_start = 0;
  280. auto column_span = child_box.computed_values().grid_column_start().is_span() ? child_box.computed_values().grid_column_start().raw_value() : 1;
  281. // https://drafts.csswg.org/css-grid/#auto-placement-algo
  282. // 8.5. Grid Item Placement Algorithm
  283. // 3.3. If the largest column span among all the items without a definite column position is larger
  284. // than the width of the implicit grid, add columns to the end of the implicit grid to accommodate
  285. // that column span.
  286. bool found_available_column = false;
  287. for (size_t column_index = column_start; column_index < m_occupation_grid.column_count(); column_index++) {
  288. if (!m_occupation_grid.is_occupied(column_index, row_start)) {
  289. found_available_column = true;
  290. column_start = column_index;
  291. break;
  292. }
  293. }
  294. if (!found_available_column) {
  295. column_start = m_occupation_grid.column_count();
  296. }
  297. m_occupation_grid.set_occupied(column_start, column_start + column_span, row_start, row_start + row_span);
  298. m_grid_items.append(GridItem(child_box, row_start, row_span, column_start, column_span));
  299. }
  300. void GridFormattingContext::place_item_with_column_position(Box const& child_box, int& auto_placement_cursor_x, int& auto_placement_cursor_y)
  301. {
  302. int column_start = child_box.computed_values().grid_column_start().raw_value() - 1;
  303. int column_end = child_box.computed_values().grid_column_end().raw_value() - 1;
  304. // https://www.w3.org/TR/css-grid-2/#line-placement
  305. // 8.3. Line-based Placement: the grid-row-start, grid-column-start, grid-row-end, and grid-column-end properties
  306. // https://www.w3.org/TR/css-grid-2/#grid-placement-slot
  307. // First attempt to match the grid area’s edge to a named grid area: if there is a grid line whose
  308. // line name is <custom-ident>-start (for grid-*-start) / <custom-ident>-end (for grid-*-end),
  309. // contributes the first such line to the grid item’s placement.
  310. // Otherwise, treat this as if the integer 1 had been specified along with the <custom-ident>.
  311. // https://www.w3.org/TR/css-grid-2/#grid-placement-int
  312. // Contributes the Nth grid line to the grid item’s placement. If a negative integer is given, it
  313. // instead counts in reverse, starting from the end edge of the explicit grid.
  314. if (column_end < 0)
  315. column_end = m_occupation_grid.column_count() + column_end + 2;
  316. // If a name is given as a <custom-ident>, only lines with that name are counted. If not enough
  317. // lines with that name exist, all implicit grid lines are assumed to have that name for the purpose
  318. // of finding this position.
  319. // https://www.w3.org/TR/css-grid-2/#grid-placement-span-int
  320. // Contributes a grid span to the grid item’s placement such that the corresponding edge of the grid
  321. // item’s grid area is N lines from its opposite edge in the corresponding direction. For example,
  322. // grid-column-end: span 2 indicates the second grid line in the endward direction from the
  323. // grid-column-start line.
  324. int column_span = 1;
  325. auto row_span = child_box.computed_values().grid_row_start().is_span() ? child_box.computed_values().grid_row_start().raw_value() : 1;
  326. if (child_box.computed_values().grid_column_start().is_position() && child_box.computed_values().grid_column_end().is_span())
  327. column_span = child_box.computed_values().grid_column_end().raw_value();
  328. if (child_box.computed_values().grid_column_end().is_position() && child_box.computed_values().grid_column_start().is_span()) {
  329. column_span = child_box.computed_values().grid_column_start().raw_value();
  330. column_start = column_end - column_span;
  331. // FIXME: Remove me once have implemented spans overflowing into negative indexes, e.g., grid-column: span 2 / 1
  332. if (column_start < 0)
  333. column_start = 0;
  334. }
  335. // FIXME: Have yet to find the spec for this.
  336. if (!child_box.computed_values().grid_column_start().is_position() && child_box.computed_values().grid_column_end().is_position() && column_end == 0)
  337. column_start = 0;
  338. // If a name is given as a <custom-ident>, only lines with that name are counted. If not enough
  339. // lines with that name exist, all implicit grid lines on the side of the explicit grid
  340. // corresponding to the search direction are assumed to have that name for the purpose of counting
  341. // this span.
  342. // https://drafts.csswg.org/css-grid/#grid-placement-auto
  343. // auto
  344. // The property contributes nothing to the grid item’s placement, indicating auto-placement or a
  345. // default span of one. (See § 8 Placing Grid Items, above.)
  346. // https://www.w3.org/TR/css-grid-2/#common-uses-named-lines
  347. // 8.1.3. Named Lines and Spans
  348. // Instead of counting lines by number, lines can be referenced by their line name:
  349. if (child_box.computed_values().grid_column_end().has_line_name()) {
  350. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_column_end().line_name()); grid_area_index > -1)
  351. column_end = m_valid_grid_areas[grid_area_index].column_end;
  352. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_column_end().line_name(), grid_container().computed_values().grid_template_columns()); line_name_index > -1)
  353. column_end = line_name_index;
  354. else
  355. column_end = 1;
  356. column_start = column_end - 1;
  357. }
  358. if (child_box.computed_values().grid_column_start().has_line_name()) {
  359. if (auto grid_area_index = find_valid_grid_area(child_box.computed_values().grid_column_end().line_name()); grid_area_index > -1)
  360. column_start = m_valid_grid_areas[grid_area_index].column_start;
  361. else if (auto line_name_index = get_line_index_by_line_name(child_box.computed_values().grid_column_start().line_name(), grid_container().computed_values().grid_template_columns()); line_name_index > -1)
  362. column_start = line_name_index;
  363. else
  364. column_start = 0;
  365. }
  366. // If there are multiple lines of the same name, they effectively establish a named set of grid
  367. // lines, which can be exclusively indexed by filtering the placement by name:
  368. // https://drafts.csswg.org/css-grid/#grid-placement-errors
  369. // 8.3.1. Grid Placement Conflict Handling
  370. // If the placement for a grid item contains two lines, and the start line is further end-ward than
  371. // the end line, swap the two lines. If the start line is equal to the end line, remove the end
  372. // line.
  373. if (child_box.computed_values().grid_column_start().is_position() && child_box.computed_values().grid_column_end().is_position()) {
  374. if (column_start > column_end)
  375. swap(column_start, column_end);
  376. if (column_start != column_end)
  377. column_span = column_end - column_start;
  378. }
  379. // If the placement contains two spans, remove the one contributed by the end grid-placement
  380. // property.
  381. if (child_box.computed_values().grid_column_start().is_span() && child_box.computed_values().grid_column_end().is_span())
  382. column_span = child_box.computed_values().grid_column_start().raw_value();
  383. // FIXME: If the placement contains only a span for a named line, replace it with a span of 1.
  384. // 4.1.1.1. Set the column position of the cursor to the grid item's column-start line. If this is
  385. // less than the previous column position of the cursor, increment the row position by 1.
  386. if (column_start < auto_placement_cursor_x)
  387. auto_placement_cursor_y++;
  388. auto_placement_cursor_x = column_start;
  389. // 4.1.1.2. Increment the cursor's row position until a value is found where the grid item does not
  390. // overlap any occupied grid cells (creating new rows in the implicit grid as necessary).
  391. while (true) {
  392. if (!m_occupation_grid.is_occupied(column_start, auto_placement_cursor_y)) {
  393. break;
  394. }
  395. auto_placement_cursor_y++;
  396. }
  397. // 4.1.1.3. Set the item's row-start line to the cursor's row position, and set the item's row-end
  398. // line according to its span from that position.
  399. m_occupation_grid.set_occupied(column_start, column_start + column_span, auto_placement_cursor_y, auto_placement_cursor_y + row_span);
  400. m_grid_items.append(GridItem(child_box, auto_placement_cursor_y, row_span, column_start, column_span));
  401. }
  402. void GridFormattingContext::place_item_with_no_declared_position(Box const& child_box, int& auto_placement_cursor_x, int& auto_placement_cursor_y)
  403. {
  404. // 4.1.2.1. Increment the column position of the auto-placement cursor until either this item's grid
  405. // area does not overlap any occupied grid cells, or the cursor's column position, plus the item's
  406. // column span, overflow the number of columns in the implicit grid, as determined earlier in this
  407. // algorithm.
  408. auto column_start = 0;
  409. auto column_span = 1;
  410. if (child_box.computed_values().grid_column_start().is_span())
  411. column_span = child_box.computed_values().grid_column_start().raw_value();
  412. else if (child_box.computed_values().grid_column_end().is_span())
  413. column_span = child_box.computed_values().grid_column_end().raw_value();
  414. // https://drafts.csswg.org/css-grid/#auto-placement-algo
  415. // 8.5. Grid Item Placement Algorithm
  416. // 3.3. If the largest column span among all the items without a definite column position is larger
  417. // than the width of the implicit grid, add columns to the end of the implicit grid to accommodate
  418. // that column span.
  419. auto row_start = 0;
  420. auto row_span = 1;
  421. if (child_box.computed_values().grid_row_start().is_span())
  422. row_span = child_box.computed_values().grid_row_start().raw_value();
  423. else if (child_box.computed_values().grid_row_end().is_span())
  424. row_span = child_box.computed_values().grid_row_end().raw_value();
  425. auto found_unoccupied_area = false;
  426. for (size_t row_index = auto_placement_cursor_y; row_index < m_occupation_grid.row_count(); row_index++) {
  427. for (size_t column_index = auto_placement_cursor_x; column_index < m_occupation_grid.column_count(); column_index++) {
  428. if (column_span + column_index <= m_occupation_grid.column_count()) {
  429. auto found_all_available = true;
  430. for (int span_index = 0; span_index < column_span; span_index++) {
  431. if (m_occupation_grid.is_occupied(column_index + span_index, row_index))
  432. found_all_available = false;
  433. }
  434. if (found_all_available) {
  435. found_unoccupied_area = true;
  436. column_start = column_index;
  437. row_start = row_index;
  438. goto finish;
  439. }
  440. }
  441. }
  442. auto_placement_cursor_x = 0;
  443. auto_placement_cursor_y++;
  444. }
  445. finish:
  446. // 4.1.2.2. If a non-overlapping position was found in the previous step, set the item's row-start
  447. // and column-start lines to the cursor's position. Otherwise, increment the auto-placement cursor's
  448. // row position (creating new rows in the implicit grid as necessary), set its column position to the
  449. // start-most column line in the implicit grid, and return to the previous step.
  450. if (!found_unoccupied_area) {
  451. row_start = m_occupation_grid.row_count();
  452. }
  453. m_occupation_grid.set_occupied(column_start, column_start + column_span, row_start, row_start + row_span);
  454. m_grid_items.append(GridItem(child_box, row_start, row_span, column_start, column_span));
  455. }
  456. void GridFormattingContext::initialize_grid_tracks_from_definition(AvailableSpace const& available_space, Vector<CSS::ExplicitGridTrack> const& tracks_definition, Vector<TemporaryTrack>& tracks)
  457. {
  458. auto track_count = get_count_of_tracks(tracks_definition, available_space);
  459. for (auto const& track_definition : tracks_definition) {
  460. auto repeat_count = (track_definition.is_repeat() && track_definition.repeat().is_default()) ? track_definition.repeat().repeat_count() : 1;
  461. if (track_definition.is_repeat()) {
  462. if (track_definition.repeat().is_auto_fill() || track_definition.repeat().is_auto_fit())
  463. repeat_count = track_count;
  464. }
  465. for (auto _ = 0; _ < repeat_count; _++) {
  466. switch (track_definition.type()) {
  467. case CSS::ExplicitGridTrack::Type::MinMax:
  468. tracks.append(TemporaryTrack(track_definition.minmax().min_grid_size(), track_definition.minmax().max_grid_size()));
  469. break;
  470. case CSS::ExplicitGridTrack::Type::Repeat:
  471. for (auto& explicit_grid_track : track_definition.repeat().grid_track_size_list().track_list()) {
  472. auto track_sizing_function = explicit_grid_track;
  473. if (track_sizing_function.is_minmax())
  474. tracks.append(TemporaryTrack(track_sizing_function.minmax().min_grid_size(), track_sizing_function.minmax().max_grid_size()));
  475. else
  476. tracks.append(TemporaryTrack(track_sizing_function.grid_size()));
  477. }
  478. break;
  479. case CSS::ExplicitGridTrack::Type::Default:
  480. tracks.append(TemporaryTrack(track_definition.grid_size()));
  481. break;
  482. default:
  483. VERIFY_NOT_REACHED();
  484. }
  485. }
  486. }
  487. }
  488. void GridFormattingContext::initialize_grid_tracks_for_columns_and_rows(AvailableSpace const& available_space)
  489. {
  490. auto const& grid_computed_values = grid_container().computed_values();
  491. initialize_grid_tracks_from_definition(available_space, grid_computed_values.grid_template_columns().track_list(), m_grid_columns);
  492. initialize_grid_tracks_from_definition(available_space, grid_computed_values.grid_template_rows().track_list(), m_grid_rows);
  493. auto const& grid_auto_columns = grid_computed_values.grid_auto_columns().track_list();
  494. size_t implicit_column_index = 0;
  495. for (size_t column_index = m_grid_columns.size(); column_index < m_occupation_grid.column_count(); column_index++) {
  496. if (grid_auto_columns.size() > 0) {
  497. auto size = grid_auto_columns[implicit_column_index % grid_auto_columns.size()];
  498. m_grid_columns.append(TemporaryTrack(size.grid_size()));
  499. } else {
  500. m_grid_columns.append(TemporaryTrack());
  501. }
  502. implicit_column_index++;
  503. }
  504. auto const& grid_auto_rows = grid_computed_values.grid_auto_rows().track_list();
  505. size_t implicit_row_index = 0;
  506. for (size_t row_index = m_grid_rows.size(); row_index < m_occupation_grid.row_count(); row_index++) {
  507. if (grid_auto_rows.size() > 0) {
  508. auto size = grid_auto_rows[implicit_row_index % grid_auto_rows.size()];
  509. m_grid_rows.append(TemporaryTrack(size.grid_size()));
  510. } else {
  511. m_grid_rows.append(TemporaryTrack());
  512. }
  513. implicit_row_index++;
  514. }
  515. }
  516. void GridFormattingContext::initialize_gap_tracks(AvailableSpace const& available_space)
  517. {
  518. // https://www.w3.org/TR/css-grid-2/#gutters
  519. // 11.1. Gutters: the row-gap, column-gap, and gap properties
  520. // For the purpose of track sizing, each gutter is treated as an extra, empty, fixed-size track of
  521. // the specified size, which is spanned by any grid items that span across its corresponding grid
  522. // line.
  523. if (!grid_container().computed_values().column_gap().is_auto() && m_grid_columns.size() > 0) {
  524. auto column_gap_width = grid_container().computed_values().column_gap().to_px(grid_container(), available_space.width.to_px());
  525. m_column_gap_tracks.ensure_capacity(m_grid_columns.size() - 1);
  526. for (size_t column_index = 0; column_index < m_grid_columns.size(); column_index++) {
  527. m_grid_columns_and_gaps.append(m_grid_columns[column_index]);
  528. if (column_index != m_grid_columns.size() - 1) {
  529. m_column_gap_tracks.append(TemporaryTrack(column_gap_width, true));
  530. m_grid_columns_and_gaps.append(m_column_gap_tracks.last());
  531. }
  532. }
  533. } else {
  534. for (auto& track : m_grid_columns) {
  535. m_grid_columns_and_gaps.append(track);
  536. }
  537. }
  538. if (!grid_container().computed_values().row_gap().is_auto() && m_grid_rows.size() > 0) {
  539. auto row_gap_height = grid_container().computed_values().row_gap().to_px(grid_container(), available_space.height.to_px());
  540. m_row_gap_tracks.ensure_capacity(m_grid_rows.size() - 1);
  541. for (size_t row_index = 0; row_index < m_grid_rows.size(); row_index++) {
  542. m_grid_rows_and_gaps.append(m_grid_rows[row_index]);
  543. if (row_index != m_grid_rows.size() - 1) {
  544. m_row_gap_tracks.append(TemporaryTrack(row_gap_height, true));
  545. m_grid_rows_and_gaps.append(m_row_gap_tracks.last());
  546. }
  547. }
  548. } else {
  549. for (auto& track : m_grid_rows) {
  550. m_grid_rows_and_gaps.append(track);
  551. }
  552. }
  553. }
  554. void GridFormattingContext::initialize_track_sizes(AvailableSpace const& available_space, GridDimension const dimension)
  555. {
  556. // https://www.w3.org/TR/css-grid-2/#algo-init
  557. // 12.4. Initialize Track Sizes
  558. // Initialize each track’s base size and growth limit.
  559. auto& tracks_and_gaps = dimension == GridDimension::Column ? m_grid_columns_and_gaps : m_grid_rows_and_gaps;
  560. auto& available_size = dimension == GridDimension::Column ? available_space.width : available_space.height;
  561. // For each track, if the track’s min track sizing function is:
  562. for (auto& track : tracks_and_gaps) {
  563. if (track.is_gap)
  564. continue;
  565. switch (track.min_track_sizing_function.type()) {
  566. // - A fixed sizing function
  567. // Resolve to an absolute length and use that size as the track’s initial base size.
  568. case CSS::GridSize::Type::LengthPercentage: {
  569. if (!track.min_track_sizing_function.is_auto()) {
  570. track.base_size = track.min_track_sizing_function.css_size().to_px(grid_container(), available_size.to_px());
  571. }
  572. break;
  573. }
  574. // - An intrinsic sizing function
  575. // Use an initial base size of zero.
  576. case CSS::GridSize::Type::FlexibleLength:
  577. case CSS::GridSize::Type::MaxContent:
  578. case CSS::GridSize::Type::MinContent: {
  579. track.base_size = 0;
  580. break;
  581. }
  582. default:
  583. VERIFY_NOT_REACHED();
  584. }
  585. // For each track, if the track’s max track sizing function is:
  586. switch (track.max_track_sizing_function.type()) {
  587. // - A fixed sizing function
  588. // Resolve to an absolute length and use that size as the track’s initial growth limit.
  589. case CSS::GridSize::Type::LengthPercentage: {
  590. if (!track.max_track_sizing_function.is_auto()) {
  591. track.growth_limit = track.max_track_sizing_function.css_size().to_px(grid_container(), available_size.to_px());
  592. } else {
  593. track.growth_limit = INFINITY;
  594. }
  595. break;
  596. }
  597. // - A flexible sizing function
  598. // Use an initial growth limit of infinity.
  599. case CSS::GridSize::Type::FlexibleLength: {
  600. track.growth_limit = INFINITY;
  601. break;
  602. }
  603. // - An intrinsic sizing function
  604. // Use an initial growth limit of infinity.
  605. case CSS::GridSize::Type::MaxContent:
  606. case CSS::GridSize::Type::MinContent: {
  607. track.growth_limit = INFINITY;
  608. break;
  609. }
  610. default:
  611. VERIFY_NOT_REACHED();
  612. }
  613. // In all cases, if the growth limit is less than the base size, increase the growth limit to match
  614. // the base size.
  615. if (track.growth_limit < track.base_size)
  616. track.growth_limit = track.base_size;
  617. }
  618. }
  619. void GridFormattingContext::resolve_intrinsic_track_sizes(AvailableSpace const& available_space, GridDimension const dimension)
  620. {
  621. // https://www.w3.org/TR/css-grid-2/#algo-content
  622. // 12.5. Resolve Intrinsic Track Sizes
  623. // This step resolves intrinsic track sizing functions to absolute lengths. First it resolves those
  624. // sizes based on items that are contained wholly within a single track. Then it gradually adds in
  625. // the space requirements of items that span multiple tracks, evenly distributing the extra space
  626. // across those tracks insofar as possible.
  627. auto& tracks_and_gaps = dimension == GridDimension::Column ? m_grid_columns_and_gaps : m_grid_rows_and_gaps;
  628. // FIXME: 1. Shim baseline-aligned items so their intrinsic size contributions reflect their baseline alignment.
  629. // 2. Size tracks to fit non-spanning items:
  630. increase_sizes_to_accommodate_spanning_items_crossing_content_sized_tracks(available_space, dimension, 1);
  631. // https://www.w3.org/TR/css-grid-2/#auto-repeat
  632. // The auto-fit keyword behaves the same as auto-fill, except that after grid item placement any
  633. // empty repeated tracks are collapsed. An empty track is one with no in-flow grid items placed into
  634. // or spanning across it. (This can result in all tracks being collapsed, if they’re all empty.)
  635. if (dimension == GridDimension::Column // FIXME: Handle for columns
  636. && grid_container().computed_values().grid_template_columns().track_list().size() == 1
  637. && grid_container().computed_values().grid_template_columns().track_list().first().is_repeat()
  638. && grid_container().computed_values().grid_template_columns().track_list().first().repeat().is_auto_fit()) {
  639. for (size_t idx = 0; idx < m_grid_columns.size(); idx++) {
  640. auto column_to_check = grid_container().computed_values().column_gap().is_auto() ? idx : idx / 2;
  641. if (m_occupation_grid.is_occupied(column_to_check, 0))
  642. continue;
  643. if (!grid_container().computed_values().column_gap().is_auto() && idx % 2 != 0)
  644. continue;
  645. // A collapsed track is treated as having a fixed track sizing function of 0px
  646. m_grid_columns[idx].base_size = 0;
  647. m_grid_columns[idx].growth_limit = 0;
  648. // FIXME: And the gutters on either side of it—including any space allotted through distributed
  649. // alignment—collapse.
  650. }
  651. }
  652. // 3. Increase sizes to accommodate spanning items crossing content-sized tracks: Next, consider the
  653. // items with a span of 2 that do not span a track with a flexible sizing function.
  654. // Repeat incrementally for items with greater spans until all items have been considered.
  655. size_t max_item_span = 1;
  656. for (auto& item : m_grid_items)
  657. max_item_span = max(item.span(dimension), max_item_span);
  658. for (size_t span = 2; span <= max_item_span; span++) {
  659. increase_sizes_to_accommodate_spanning_items_crossing_content_sized_tracks(available_space, dimension, 2);
  660. }
  661. // 4. Increase sizes to accommodate spanning items crossing flexible tracks: Next, repeat the previous
  662. // step instead considering (together, rather than grouped by span size) all items that do span a
  663. // track with a flexible sizing function while
  664. increase_sizes_to_accommodate_spanning_items_crossing_flexible_tracks(dimension);
  665. // 5. If any track still has an infinite growth limit (because, for example, it had no items placed in
  666. // it or it is a flexible track), set its growth limit to its base size.
  667. for (auto& track : tracks_and_gaps) {
  668. if (!isfinite(track.growth_limit.value())) {
  669. track.growth_limit = track.base_size;
  670. }
  671. }
  672. }
  673. void GridFormattingContext::distribute_extra_space_across_spanned_tracks_base_size(CSSPixels item_size_contribution, Vector<TemporaryTrack&>& spanned_tracks)
  674. {
  675. for (auto& track : spanned_tracks)
  676. track.item_incurred_increase = 0;
  677. // 1. Find the space to distribute:
  678. CSSPixels spanned_tracks_sizes_sum = 0;
  679. for (auto& track : spanned_tracks)
  680. spanned_tracks_sizes_sum += track.base_size;
  681. // Subtract the corresponding size of every spanned track from the item’s size contribution to find the item’s
  682. // remaining size contribution.
  683. auto extra_space = max(CSSPixels(0), item_size_contribution - spanned_tracks_sizes_sum);
  684. // 2. Distribute space up to limits:
  685. // FIXME: If a fixed-point type were used to represent CSS pixels, it would be possible to compare with 0
  686. // instead of epsilon.
  687. while (extra_space > NumericLimits<double>().epsilon()) {
  688. auto all_frozen = all_of(spanned_tracks, [](auto const& track) { return track.base_size_frozen; });
  689. if (all_frozen)
  690. break;
  691. // Find the item-incurred increase for each spanned track with an affected size by: distributing the space
  692. // equally among such tracks, freezing a track’s item-incurred increase as its affected size + item-incurred
  693. // increase reaches its limit
  694. CSSPixels increase_per_track = extra_space / spanned_tracks.size();
  695. for (auto& track : spanned_tracks) {
  696. if (track.base_size_frozen)
  697. continue;
  698. if (increase_per_track >= track.growth_limit) {
  699. track.base_size_frozen = true;
  700. track.item_incurred_increase = track.growth_limit;
  701. extra_space -= track.growth_limit;
  702. } else {
  703. track.item_incurred_increase += increase_per_track;
  704. extra_space -= increase_per_track;
  705. }
  706. }
  707. }
  708. // FIXME: 3. Distribute space beyond limits
  709. // 4. For each affected track, if the track’s item-incurred increase is larger than the track’s planned increase
  710. // set the track’s planned increase to that value.
  711. for (auto& track : spanned_tracks) {
  712. if (track.item_incurred_increase > track.planned_increase)
  713. track.planned_increase = track.item_incurred_increase;
  714. }
  715. }
  716. void GridFormattingContext::distribute_extra_space_across_spanned_tracks_growth_limit(CSSPixels item_size_contribution, Vector<TemporaryTrack&>& spanned_tracks)
  717. {
  718. for (auto& track : spanned_tracks)
  719. track.item_incurred_increase = 0;
  720. // 1. Find the space to distribute:
  721. CSSPixels spanned_tracks_sizes_sum = 0;
  722. for (auto& track : spanned_tracks) {
  723. if (isfinite(track.growth_limit.value())) {
  724. spanned_tracks_sizes_sum += track.growth_limit;
  725. } else {
  726. spanned_tracks_sizes_sum += track.base_size;
  727. }
  728. }
  729. // Subtract the corresponding size of every spanned track from the item’s size contribution to find the item’s
  730. // remaining size contribution.
  731. auto extra_space = max(CSSPixels(0), item_size_contribution - spanned_tracks_sizes_sum);
  732. // 2. Distribute space up to limits:
  733. // FIXME: If a fixed-point type were used to represent CSS pixels, it would be possible to compare with 0
  734. // instead of epsilon.
  735. while (extra_space > NumericLimits<double>().epsilon()) {
  736. auto all_frozen = all_of(spanned_tracks, [](auto const& track) { return track.growth_limit_frozen; });
  737. if (all_frozen)
  738. break;
  739. // Find the item-incurred increase for each spanned track with an affected size by: distributing the space
  740. // equally among such tracks, freezing a track’s item-incurred increase as its affected size + item-incurred
  741. // increase reaches its limit
  742. CSSPixels increase_per_track = extra_space / spanned_tracks.size();
  743. for (auto& track : spanned_tracks) {
  744. if (track.growth_limit_frozen)
  745. continue;
  746. // For growth limits, the limit is infinity if it is marked as infinitely growable, and equal to the
  747. // growth limit otherwise.
  748. auto limit = track.infinitely_growable ? INFINITY : track.growth_limit;
  749. if (increase_per_track >= limit) {
  750. track.growth_limit_frozen = true;
  751. track.item_incurred_increase = limit;
  752. extra_space -= limit;
  753. } else {
  754. track.item_incurred_increase += increase_per_track;
  755. extra_space -= increase_per_track;
  756. }
  757. }
  758. }
  759. // FIXME: 3. Distribute space beyond limits
  760. // 4. For each affected track, if the track’s item-incurred increase is larger than the track’s planned increase
  761. // set the track’s planned increase to that value.
  762. for (auto& track : spanned_tracks) {
  763. if (track.item_incurred_increase > track.planned_increase)
  764. track.planned_increase = track.item_incurred_increase;
  765. }
  766. }
  767. void GridFormattingContext::increase_sizes_to_accommodate_spanning_items_crossing_content_sized_tracks(AvailableSpace const& available_space, GridDimension const dimension, size_t span)
  768. {
  769. auto& available_size = dimension == GridDimension::Column ? available_space.width : available_space.height;
  770. auto& tracks = dimension == GridDimension::Column ? m_grid_columns : m_grid_rows;
  771. for (auto& item : m_grid_items) {
  772. auto const item_span = item.span(dimension);
  773. if (item_span != span)
  774. continue;
  775. Vector<TemporaryTrack&> spanned_tracks;
  776. for_each_spanned_track_by_item(item, dimension, [&](TemporaryTrack& track) {
  777. spanned_tracks.append(track);
  778. });
  779. auto item_spans_tracks_with_flexible_sizing_function = any_of(spanned_tracks, [](auto& track) {
  780. return track.min_track_sizing_function.is_flexible_length() || track.max_track_sizing_function.is_flexible_length();
  781. });
  782. if (item_spans_tracks_with_flexible_sizing_function)
  783. continue;
  784. // 1. For intrinsic minimums: First increase the base size of tracks with an intrinsic min track sizing
  785. // function by distributing extra space as needed to accommodate these items’ minimum contributions.
  786. Vector<TemporaryTrack&> intrinsic_minimum_spanned_tracks;
  787. for (auto& track : spanned_tracks) {
  788. if (track.min_track_sizing_function.is_intrinsic_track_sizing())
  789. intrinsic_minimum_spanned_tracks.append(track);
  790. }
  791. auto item_size_contribution = [&] {
  792. // If the grid container is being sized under a min- or max-content constraint, use the items’ limited
  793. // min-content contributions in place of their minimum contributions here.
  794. if (available_size.is_intrinsic_sizing_constraint())
  795. return calculate_limited_min_content_contribution(item, dimension);
  796. return calculate_minimum_contribution(item, dimension);
  797. }();
  798. distribute_extra_space_across_spanned_tracks_base_size(item_size_contribution, intrinsic_minimum_spanned_tracks);
  799. for (auto& track : spanned_tracks) {
  800. track.base_size += track.planned_increase;
  801. track.planned_increase = 0;
  802. }
  803. // 2. For content-based minimums: Next continue to increase the base size of tracks with a min track
  804. // sizing function of min-content or max-content by distributing extra space as needed to account for
  805. // these items' min-content contributions.
  806. Vector<TemporaryTrack&> content_based_minimum_tracks;
  807. for (auto& track : spanned_tracks) {
  808. if (track.min_track_sizing_function.is_min_content() || track.min_track_sizing_function.is_max_content()) {
  809. content_based_minimum_tracks.append(track);
  810. }
  811. }
  812. auto item_min_content_contribution = calculate_min_content_contribution(item, dimension);
  813. distribute_extra_space_across_spanned_tracks_base_size(item_min_content_contribution, content_based_minimum_tracks);
  814. for (auto& track : spanned_tracks) {
  815. track.base_size += track.planned_increase;
  816. track.planned_increase = 0;
  817. }
  818. // 3. For max-content minimums: Next, if the grid container is being sized under a max-content constraint,
  819. // continue to increase the base size of tracks with a min track sizing function of auto or max-content by
  820. // distributing extra space as needed to account for these items' limited max-content contributions.
  821. if (available_size.is_max_content()) {
  822. Vector<TemporaryTrack&> max_content_minimum_tracks;
  823. for (auto& track : spanned_tracks) {
  824. if (track.min_track_sizing_function.is_auto() || track.min_track_sizing_function.is_max_content()) {
  825. max_content_minimum_tracks.append(track);
  826. }
  827. }
  828. auto item_limited_max_content_contribution = calculate_limited_max_content_contribution(item, dimension);
  829. distribute_extra_space_across_spanned_tracks_base_size(item_limited_max_content_contribution, max_content_minimum_tracks);
  830. for (auto& track : spanned_tracks) {
  831. track.base_size += track.planned_increase;
  832. track.planned_increase = 0;
  833. }
  834. }
  835. // 4. If at this point any track’s growth limit is now less than its base size, increase its growth limit to
  836. // match its base size.
  837. for (auto& track : tracks) {
  838. if (track.growth_limit < track.base_size)
  839. track.growth_limit = track.base_size;
  840. }
  841. // 5. For intrinsic maximums: Next increase the growth limit of tracks with an intrinsic max track sizing
  842. Vector<TemporaryTrack&> intrinsic_maximum_tracks;
  843. for (auto& track : spanned_tracks) {
  844. if (track.max_track_sizing_function.is_intrinsic_track_sizing()) {
  845. intrinsic_maximum_tracks.append(track);
  846. }
  847. }
  848. distribute_extra_space_across_spanned_tracks_growth_limit(item_min_content_contribution, intrinsic_maximum_tracks);
  849. for (auto& track : spanned_tracks) {
  850. if (!isfinite(track.growth_limit.value())) {
  851. // If the affected size is an infinite growth limit, set it to the track’s base size plus the planned increase.
  852. track.growth_limit = track.base_size + track.planned_increase;
  853. // Mark any tracks whose growth limit changed from infinite to finite in this step as infinitely growable
  854. // for the next step.
  855. track.infinitely_growable = true;
  856. } else {
  857. track.growth_limit += track.planned_increase;
  858. }
  859. track.planned_increase = 0;
  860. }
  861. // 6. For max-content maximums: Lastly continue to increase the growth limit of tracks with a max track
  862. // sizing function of max-content by distributing extra space as needed to account for these items' max-
  863. // content contributions.
  864. Vector<TemporaryTrack&> max_content_maximum_tracks;
  865. for (auto& track : spanned_tracks) {
  866. if (track.max_track_sizing_function.is_max_content() || track.max_track_sizing_function.is_auto()) {
  867. max_content_maximum_tracks.append(track);
  868. }
  869. }
  870. auto item_max_content_contribution = calculate_max_content_contribution(item, dimension);
  871. distribute_extra_space_across_spanned_tracks_growth_limit(item_max_content_contribution, max_content_maximum_tracks);
  872. for (auto& track : spanned_tracks) {
  873. if (!isfinite(track.growth_limit.value())) {
  874. // If the affected size is an infinite growth limit, set it to the track’s base size plus the planned increase.
  875. track.growth_limit = track.base_size + track.planned_increase;
  876. } else {
  877. track.growth_limit += track.planned_increase;
  878. }
  879. track.planned_increase = 0;
  880. }
  881. }
  882. }
  883. void GridFormattingContext::increase_sizes_to_accommodate_spanning_items_crossing_flexible_tracks(GridDimension const dimension)
  884. {
  885. auto& tracks = dimension == GridDimension::Column ? m_grid_columns : m_grid_rows;
  886. for (auto& item : m_grid_items) {
  887. Vector<TemporaryTrack&> spanned_tracks;
  888. for_each_spanned_track_by_item(item, dimension, [&](TemporaryTrack& track) {
  889. spanned_tracks.append(track);
  890. });
  891. auto item_spans_tracks_with_flexible_sizing_function = any_of(spanned_tracks, [](auto& track) {
  892. return track.min_track_sizing_function.is_flexible_length() || track.max_track_sizing_function.is_flexible_length();
  893. });
  894. if (!item_spans_tracks_with_flexible_sizing_function)
  895. continue;
  896. // 1. For intrinsic minimums: First increase the base size of tracks with an intrinsic min track sizing
  897. // function by distributing extra space as needed to accommodate these items’ minimum contributions.
  898. Vector<TemporaryTrack&> spanned_flexible_tracks;
  899. for (auto& track : spanned_tracks) {
  900. if (track.min_track_sizing_function.is_flexible_length())
  901. spanned_flexible_tracks.append(track);
  902. }
  903. auto item_minimum_contribution = automatic_minimum_size(item, dimension);
  904. distribute_extra_space_across_spanned_tracks_base_size(item_minimum_contribution, spanned_flexible_tracks);
  905. for (auto& track : spanned_tracks) {
  906. track.base_size += track.planned_increase;
  907. }
  908. // 4. If at this point any track’s growth limit is now less than its base size, increase its growth limit to
  909. // match its base size.
  910. for (auto& track : tracks) {
  911. if (track.growth_limit < track.base_size)
  912. track.growth_limit = track.base_size;
  913. }
  914. }
  915. }
  916. void GridFormattingContext::maximize_tracks(AvailableSpace const& available_space, GridDimension const dimension)
  917. {
  918. // https://www.w3.org/TR/css-grid-2/#algo-grow-tracks
  919. // 12.6. Maximize Tracks
  920. auto& tracks = dimension == GridDimension::Column ? m_grid_columns : m_grid_rows;
  921. auto get_free_space_px = [&]() -> CSSPixels {
  922. // For the purpose of this step: if sizing the grid container under a max-content constraint, the
  923. // free space is infinite; if sizing under a min-content constraint, the free space is zero.
  924. auto free_space = get_free_space(available_space, dimension);
  925. if (free_space.is_max_content()) {
  926. return INFINITY;
  927. } else if (free_space.is_min_content()) {
  928. return 0;
  929. } else {
  930. return free_space.to_px();
  931. }
  932. };
  933. auto free_space_px = get_free_space_px();
  934. // If the free space is positive, distribute it equally to the base sizes of all tracks, freezing
  935. // tracks as they reach their growth limits (and continuing to grow the unfrozen tracks as needed).
  936. while (free_space_px > 0) {
  937. auto free_space_to_distribute_per_track = free_space_px / tracks.size();
  938. for (auto& track : tracks) {
  939. VERIFY(isfinite(track.growth_limit.value()));
  940. track.base_size = min(track.growth_limit, track.base_size + free_space_to_distribute_per_track);
  941. }
  942. if (get_free_space_px() == free_space_px)
  943. break;
  944. free_space_px = get_free_space_px();
  945. }
  946. // FIXME: If this would cause the grid to be larger than the grid container’s inner size as limited by its
  947. // max-width/height, then redo this step, treating the available grid space as equal to the grid
  948. // container’s inner size when it’s sized to its max-width/height.
  949. }
  950. void GridFormattingContext::expand_flexible_tracks(AvailableSpace const& available_space, GridDimension const dimension)
  951. {
  952. // https://drafts.csswg.org/css-grid/#algo-flex-tracks
  953. // 12.7. Expand Flexible Tracks
  954. // This step sizes flexible tracks using the largest value it can assign to an fr without exceeding
  955. // the available space.
  956. auto& tracks_and_gaps = dimension == GridDimension::Column ? m_grid_columns_and_gaps : m_grid_rows_and_gaps;
  957. auto& tracks = dimension == GridDimension::Column ? m_grid_columns : m_grid_rows;
  958. auto& available_size = dimension == GridDimension::Column ? available_space.width : available_space.height;
  959. auto find_the_size_of_an_fr = [&](Vector<TemporaryTrack&> tracks, CSSPixels space_to_fill) -> CSSPixels {
  960. // https://www.w3.org/TR/css-grid-2/#algo-find-fr-size
  961. // 1. Let leftover space be the space to fill minus the base sizes of the non-flexible grid tracks.
  962. auto leftover_space = space_to_fill;
  963. for (auto& track : tracks) {
  964. if (!track.max_track_sizing_function.is_flexible_length()) {
  965. leftover_space -= track.base_size;
  966. }
  967. }
  968. // 2. Let flex factor sum be the sum of the flex factors of the flexible tracks.
  969. // If this value is less than 1, set it to 1 instead.
  970. auto flex_factor_sum = 0;
  971. for (auto& track : tracks) {
  972. if (track.max_track_sizing_function.is_flexible_length())
  973. flex_factor_sum += track.max_track_sizing_function.flex_factor();
  974. }
  975. if (flex_factor_sum < 1)
  976. flex_factor_sum = 1;
  977. // 3. Let the hypothetical fr size be the leftover space divided by the flex factor sum.
  978. auto hypothetical_fr_size = leftover_space / flex_factor_sum;
  979. // FIXME: 4. If the product of the hypothetical fr size and a flexible track’s flex factor is less than the track’s
  980. // base size, restart this algorithm treating all such tracks as inflexible.
  981. // 5. Return the hypothetical fr size.
  982. return hypothetical_fr_size;
  983. };
  984. // First, find the grid’s used flex fraction:
  985. auto flex_fraction = [&]() {
  986. auto free_space = get_free_space(available_space, dimension);
  987. // If the free space is zero or if sizing the grid container under a min-content constraint:
  988. if (free_space.to_px() == 0 || available_size.is_min_content()) {
  989. // The used flex fraction is zero.
  990. return CSSPixels(0);
  991. // Otherwise, if the free space is a definite length:
  992. } else if (free_space.is_definite()) {
  993. // The used flex fraction is the result of finding the size of an fr using all of the grid tracks and a space
  994. // to fill of the available grid space.
  995. return find_the_size_of_an_fr(tracks_and_gaps, available_size.to_px());
  996. } else {
  997. // Otherwise, if the free space is an indefinite length:
  998. // The used flex fraction is the maximum of:
  999. CSSPixels result = 0;
  1000. // For each flexible track, if the flexible track’s flex factor is greater than one, the result of dividing
  1001. // the track’s base size by its flex factor; otherwise, the track’s base size.
  1002. for (auto& track : tracks) {
  1003. if (track.max_track_sizing_function.is_flexible_length()) {
  1004. if (track.max_track_sizing_function.flex_factor() > 1) {
  1005. result = max(result, track.base_size / track.max_track_sizing_function.flex_factor());
  1006. } else {
  1007. result = max(result, track.base_size);
  1008. }
  1009. }
  1010. }
  1011. // For each grid item that crosses a flexible track, the result of finding the size of an fr using all the
  1012. // grid tracks that the item crosses and a space to fill of the item’s max-content contribution.
  1013. for (auto& item : m_grid_items) {
  1014. Vector<TemporaryTrack&> spanned_tracks;
  1015. bool crosses_flexible_track = false;
  1016. for_each_spanned_track_by_item(item, dimension, [&](TemporaryTrack& track) {
  1017. spanned_tracks.append(track);
  1018. if (track.max_track_sizing_function.is_flexible_length())
  1019. crosses_flexible_track = true;
  1020. });
  1021. if (crosses_flexible_track)
  1022. result = max(result, find_the_size_of_an_fr(spanned_tracks, calculate_max_content_size(item, dimension)));
  1023. }
  1024. return result;
  1025. }
  1026. }();
  1027. // For each flexible track, if the product of the used flex fraction and the track’s flex factor is greater than
  1028. // the track’s base size, set its base size to that product.
  1029. for (auto& track : tracks_and_gaps) {
  1030. if (track.max_track_sizing_function.flex_factor() * flex_fraction > track.base_size) {
  1031. track.base_size = track.max_track_sizing_function.flex_factor() * flex_fraction;
  1032. }
  1033. }
  1034. }
  1035. void GridFormattingContext::stretch_auto_tracks(AvailableSpace const& available_space, GridDimension const dimension)
  1036. {
  1037. // https://drafts.csswg.org/css-grid/#algo-stretch
  1038. // 12.8. Stretch auto Tracks
  1039. auto& tracks_and_gaps = dimension == GridDimension::Column ? m_grid_columns_and_gaps : m_grid_rows_and_gaps;
  1040. auto& available_size = dimension == GridDimension::Column ? available_space.width : available_space.height;
  1041. // When the content-distribution property of the grid container is normal or stretch in this axis,
  1042. // this step expands tracks that have an auto max track sizing function by dividing any remaining
  1043. // positive, definite free space equally amongst them. If the free space is indefinite, but the grid
  1044. // container has a definite min-width/height, use that size to calculate the free space for this
  1045. // step instead.
  1046. CSSPixels used_space = 0;
  1047. for (auto& track : tracks_and_gaps) {
  1048. if (!track.max_track_sizing_function.is_auto())
  1049. used_space += track.base_size;
  1050. }
  1051. CSSPixels remaining_space = available_size.is_definite() ? available_size.to_px() - used_space : 0;
  1052. auto count_of_auto_max_sizing_tracks = 0;
  1053. for (auto& track : tracks_and_gaps) {
  1054. if (track.max_track_sizing_function.is_auto())
  1055. count_of_auto_max_sizing_tracks++;
  1056. }
  1057. for (auto& track : tracks_and_gaps) {
  1058. if (track.max_track_sizing_function.is_auto())
  1059. track.base_size = max(track.base_size, remaining_space / count_of_auto_max_sizing_tracks);
  1060. }
  1061. }
  1062. void GridFormattingContext::run_track_sizing(AvailableSpace const& available_space, GridDimension const dimension)
  1063. {
  1064. // https://www.w3.org/TR/css-grid-2/#algo-track-sizing
  1065. // 12.3. Track Sizing Algorithm
  1066. // 1. Initialize Track Sizes
  1067. initialize_track_sizes(available_space, dimension);
  1068. // 2. Resolve Intrinsic Track Sizes
  1069. resolve_intrinsic_track_sizes(available_space, dimension);
  1070. // 3. Maximize Tracks
  1071. maximize_tracks(available_space, dimension);
  1072. // 4. Expand Flexible Tracks
  1073. expand_flexible_tracks(available_space, dimension);
  1074. // 5. Expand Stretched auto Tracks
  1075. stretch_auto_tracks(available_space, dimension);
  1076. // If calculating the layout of a grid item in this step depends on the available space in the block
  1077. // axis, assume the available space that it would have if any row with a definite max track sizing
  1078. // function had that size and all other rows were infinite. If both the grid container and all
  1079. // tracks have definite sizes, also apply align-content to find the final effective size of any gaps
  1080. // spanned by such items; otherwise ignore the effects of track alignment in this estimation.
  1081. }
  1082. void GridFormattingContext::build_valid_grid_areas()
  1083. {
  1084. Vector<GridArea> found_grid_areas;
  1085. auto get_index_of_found_grid_area = [&](String needle) -> int {
  1086. for (size_t x = 0; x < found_grid_areas.size(); x++) {
  1087. if (found_grid_areas[x].name == needle)
  1088. return static_cast<int>(x);
  1089. }
  1090. return -1;
  1091. };
  1092. // https://www.w3.org/TR/css-grid-2/#grid-template-areas-property
  1093. // If a named grid area spans multiple grid cells, but those cells do not form a single
  1094. // filled-in rectangle, the declaration is invalid.
  1095. for (size_t y = 0; y < grid_container().computed_values().grid_template_areas().size(); y++) {
  1096. for (size_t x = 0; x < grid_container().computed_values().grid_template_areas()[y].size(); x++) {
  1097. auto grid_area_idx = get_index_of_found_grid_area(grid_container().computed_values().grid_template_areas()[y][x]);
  1098. if (grid_area_idx == -1) {
  1099. found_grid_areas.append({ grid_container().computed_values().grid_template_areas()[y][x], y, y + 1, x, x + 1 });
  1100. } else {
  1101. auto& grid_area = found_grid_areas[grid_area_idx];
  1102. if (grid_area.row_start == y) {
  1103. if (grid_area.column_end == x)
  1104. grid_area.column_end = grid_area.column_end + 1;
  1105. else
  1106. return;
  1107. } else {
  1108. if (grid_area.row_end == y) {
  1109. if (grid_area.column_start != x)
  1110. return;
  1111. grid_area.row_end = grid_area.row_end + 1;
  1112. } else if (grid_area.row_end == y + 1) {
  1113. if (grid_area.column_end < x || grid_area.column_end > x + 1)
  1114. return;
  1115. } else {
  1116. return;
  1117. }
  1118. }
  1119. }
  1120. }
  1121. }
  1122. for (auto const& checked_grid_area : found_grid_areas)
  1123. m_valid_grid_areas.append(checked_grid_area);
  1124. }
  1125. int GridFormattingContext::find_valid_grid_area(String const& needle)
  1126. {
  1127. for (size_t x = 0; x < m_valid_grid_areas.size(); x++) {
  1128. if (m_valid_grid_areas[x].name == needle)
  1129. return static_cast<int>(x);
  1130. }
  1131. return -1;
  1132. }
  1133. void GridFormattingContext::place_grid_items(AvailableSpace const& available_space)
  1134. {
  1135. auto grid_template_columns = grid_container().computed_values().grid_template_columns();
  1136. auto grid_template_rows = grid_container().computed_values().grid_template_rows();
  1137. auto column_count = get_count_of_tracks(grid_template_columns.track_list(), available_space);
  1138. auto row_count = get_count_of_tracks(grid_template_rows.track_list(), available_space);
  1139. // https://drafts.csswg.org/css-grid/#overview-placement
  1140. // 2.2. Placing Items
  1141. // The contents of the grid container are organized into individual grid items (analogous to
  1142. // flex items), which are then assigned to predefined areas in the grid. They can be explicitly
  1143. // placed using coordinates through the grid-placement properties or implicitly placed into
  1144. // empty areas using auto-placement.
  1145. grid_container().for_each_child_of_type<Box>([&](Box& child_box) {
  1146. if (can_skip_is_anonymous_text_run(child_box))
  1147. return IterationDecision::Continue;
  1148. m_boxes_to_place.append(child_box);
  1149. return IterationDecision::Continue;
  1150. });
  1151. m_occupation_grid = OccupationGrid(column_count, row_count);
  1152. build_valid_grid_areas();
  1153. // https://drafts.csswg.org/css-grid/#auto-placement-algo
  1154. // 8.5. Grid Item Placement Algorithm
  1155. // FIXME: 0. Generate anonymous grid items
  1156. // 1. Position anything that's not auto-positioned.
  1157. for (size_t i = 0; i < m_boxes_to_place.size(); i++) {
  1158. auto const& child_box = m_boxes_to_place[i];
  1159. if (is_auto_positioned_row(child_box->computed_values().grid_row_start(), child_box->computed_values().grid_row_end())
  1160. || is_auto_positioned_column(child_box->computed_values().grid_column_start(), child_box->computed_values().grid_column_end()))
  1161. continue;
  1162. place_item_with_row_and_column_position(child_box);
  1163. m_boxes_to_place.remove(i);
  1164. i--;
  1165. }
  1166. // 2. Process the items locked to a given row.
  1167. // FIXME: Do "dense" packing
  1168. for (size_t i = 0; i < m_boxes_to_place.size(); i++) {
  1169. auto const& child_box = m_boxes_to_place[i];
  1170. if (is_auto_positioned_row(child_box->computed_values().grid_row_start(), child_box->computed_values().grid_row_end()))
  1171. continue;
  1172. place_item_with_row_position(child_box);
  1173. m_boxes_to_place.remove(i);
  1174. i--;
  1175. }
  1176. // 3. Determine the columns in the implicit grid.
  1177. // NOTE: "implicit grid" here is the same as the m_occupation_grid
  1178. // 3.1. Start with the columns from the explicit grid.
  1179. // NOTE: Done in step 1.
  1180. // 3.2. Among all the items with a definite column position (explicitly positioned items, items
  1181. // positioned in the previous step, and items not yet positioned but with a definite column) add
  1182. // columns to the beginning and end of the implicit grid as necessary to accommodate those items.
  1183. // NOTE: "Explicitly positioned items" and "items positioned in the previous step" done in step 1
  1184. // and 2, respectively. Adding columns for "items not yet positioned but with a definite column"
  1185. // will be done in step 4.
  1186. // 4. Position the remaining grid items.
  1187. // For each grid item that hasn't been positioned by the previous steps, in order-modified document
  1188. // order:
  1189. auto auto_placement_cursor_x = 0;
  1190. auto auto_placement_cursor_y = 0;
  1191. for (size_t i = 0; i < m_boxes_to_place.size(); i++) {
  1192. auto const& child_box = m_boxes_to_place[i];
  1193. // 4.1. For sparse packing:
  1194. // FIXME: no distinction made. See #4.2
  1195. // 4.1.1. If the item has a definite column position:
  1196. if (!is_auto_positioned_column(child_box->computed_values().grid_column_start(), child_box->computed_values().grid_column_end()))
  1197. place_item_with_column_position(child_box, auto_placement_cursor_x, auto_placement_cursor_y);
  1198. // 4.1.2. If the item has an automatic grid position in both axes:
  1199. else
  1200. place_item_with_no_declared_position(child_box, auto_placement_cursor_x, auto_placement_cursor_y);
  1201. m_boxes_to_place.remove(i);
  1202. i--;
  1203. // FIXME: 4.2. For dense packing:
  1204. }
  1205. }
  1206. void GridFormattingContext::determine_grid_container_height()
  1207. {
  1208. CSSPixels total_y = 0;
  1209. for (auto& grid_row : m_grid_rows_and_gaps)
  1210. total_y += grid_row.base_size;
  1211. m_automatic_content_height = total_y;
  1212. }
  1213. void GridFormattingContext::resolve_grid_item_widths()
  1214. {
  1215. for (auto& item : m_grid_items) {
  1216. CSSPixels containing_block_width = containing_block_size_for_item(item, GridDimension::Column);
  1217. auto border_left = item.box().computed_values().border_left().width;
  1218. auto border_right = item.box().computed_values().border_right().width;
  1219. auto& box_state = m_state.get_mutable(item.box());
  1220. box_state.border_left = border_left;
  1221. box_state.border_right = border_right;
  1222. auto const& computed_width = item.box().computed_values().width();
  1223. CSSPixels used_width;
  1224. if (computed_width.is_auto())
  1225. used_width = (containing_block_width - box_state.border_left - box_state.border_right - box_state.padding_left - box_state.padding_right);
  1226. else if (computed_width.is_fit_content())
  1227. used_width = calculate_fit_content_width(item.box(), get_available_space_for_item(item));
  1228. else
  1229. used_width = computed_width.to_px(grid_container(), containing_block_width);
  1230. box_state.set_content_width(used_width);
  1231. }
  1232. }
  1233. void GridFormattingContext::resolve_grid_item_heights()
  1234. {
  1235. for (auto& item : m_grid_items) {
  1236. CSSPixels containing_block_height = containing_block_size_for_item(item, GridDimension::Row);
  1237. auto border_top = item.box().computed_values().border_top().width;
  1238. auto border_bottom = item.box().computed_values().border_bottom().width;
  1239. auto& box_state = m_state.get_mutable(item.box());
  1240. box_state.border_top = border_top;
  1241. box_state.border_bottom = border_bottom;
  1242. auto const& computed_height = item.box().computed_values().height();
  1243. auto used_height = computed_height.is_auto() ? (containing_block_height - box_state.border_top - box_state.border_bottom - box_state.padding_top - box_state.padding_bottom) : computed_height.to_px(grid_container(), containing_block_height);
  1244. box_state.set_content_height(used_height);
  1245. }
  1246. }
  1247. void GridFormattingContext::run(Box const& box, LayoutMode, AvailableSpace const& available_space)
  1248. {
  1249. place_grid_items(available_space);
  1250. initialize_grid_tracks_for_columns_and_rows(available_space);
  1251. initialize_gap_tracks(available_space);
  1252. for (auto& item : m_grid_items) {
  1253. auto& box_state = m_state.get_mutable(item.box());
  1254. auto& computed_values = item.box().computed_values();
  1255. // NOTE: As the containing blocks of grid items are created by implicit grid areas that are not present in the
  1256. // layout tree, the initial value of has_definite_width/height computed by LayoutState::UsedValues::set_node
  1257. // will be incorrect for anything other (auto, percentage, calculated) than fixed lengths.
  1258. // Therefor, it becomes necessary to reset this value to indefinite.
  1259. // TODO: Handle this in LayoutState::UsedValues::set_node
  1260. if (!computed_values.width().is_length())
  1261. box_state.set_indefinite_content_width();
  1262. if (!computed_values.height().is_length())
  1263. box_state.set_indefinite_content_height();
  1264. // NOTE: It is ok to use 0 containing block size to resolve paddings on the first pass when grid areas sizes
  1265. // are not known yet.
  1266. // FIXME: Do second pass of tracks layout to resolve percentage paddings
  1267. box_state.padding_top = computed_values.padding().top().to_px(grid_container(), 0);
  1268. box_state.padding_right = computed_values.padding().right().to_px(grid_container(), 0);
  1269. box_state.padding_bottom = computed_values.padding().bottom().to_px(grid_container(), 0);
  1270. box_state.padding_left = computed_values.padding().left().to_px(grid_container(), 0);
  1271. box_state.border_top = computed_values.border_top().width;
  1272. box_state.border_right = computed_values.border_right().width;
  1273. box_state.border_bottom = computed_values.border_bottom().width;
  1274. box_state.border_left = computed_values.border_left().width;
  1275. }
  1276. run_track_sizing(available_space, GridDimension::Column);
  1277. // Once the sizes of column tracks, which determine the widths of the grid areas forming the containing blocks
  1278. // for grid items, ara calculated, it becomes possible to determine the final widths of the grid items.
  1279. resolve_grid_item_widths();
  1280. run_track_sizing(available_space, GridDimension::Row);
  1281. resolve_grid_item_heights();
  1282. determine_grid_container_height();
  1283. if (available_space.height.is_intrinsic_sizing_constraint() || available_space.width.is_intrinsic_sizing_constraint()) {
  1284. determine_intrinsic_size_of_grid_container(available_space);
  1285. return;
  1286. }
  1287. auto layout_box = [&](int row_start, int row_end, int column_start, int column_end, Box const& child_box) -> void {
  1288. if (column_start < 0 || row_start < 0)
  1289. return;
  1290. auto& child_box_state = m_state.get_mutable(child_box);
  1291. CSSPixels x_start = 0;
  1292. CSSPixels x_end = 0;
  1293. CSSPixels y_start = 0;
  1294. CSSPixels y_end = 0;
  1295. for (int i = 0; i < column_start; i++)
  1296. x_start += m_grid_columns_and_gaps[i].base_size;
  1297. for (int i = 0; i < column_end; i++)
  1298. x_end += m_grid_columns_and_gaps[i].base_size;
  1299. for (int i = 0; i < row_start; i++)
  1300. y_start += m_grid_rows_and_gaps[i].base_size;
  1301. for (int i = 0; i < row_end; i++) {
  1302. y_end += m_grid_rows_and_gaps[i].base_size;
  1303. }
  1304. child_box_state.offset = { x_start + child_box_state.border_left + child_box_state.padding_left, y_start + child_box_state.border_top + child_box_state.padding_top };
  1305. auto available_space_for_children = AvailableSpace(AvailableSize::make_definite(child_box_state.content_width()), AvailableSize::make_definite(child_box_state.content_height()));
  1306. if (auto independent_formatting_context = layout_inside(child_box, LayoutMode::Normal, available_space_for_children))
  1307. independent_formatting_context->parent_context_did_dimension_child_root_box();
  1308. };
  1309. for (auto& grid_item : m_grid_items) {
  1310. auto resolved_row_span = box.computed_values().row_gap().is_auto() ? grid_item.raw_row_span() : grid_item.raw_row_span() * 2;
  1311. if (!box.computed_values().row_gap().is_auto() && grid_item.gap_adjusted_row(box) == 0)
  1312. resolved_row_span -= 1;
  1313. if (grid_item.gap_adjusted_row(box) + resolved_row_span > m_grid_rows.size())
  1314. resolved_row_span = m_grid_rows_and_gaps.size() - grid_item.gap_adjusted_row(box);
  1315. auto resolved_column_span = box.computed_values().column_gap().is_auto() ? grid_item.raw_column_span() : grid_item.raw_column_span() * 2;
  1316. if (!box.computed_values().column_gap().is_auto() && grid_item.gap_adjusted_column(box) == 0)
  1317. resolved_column_span -= 1;
  1318. if (grid_item.gap_adjusted_column(box) + resolved_column_span > m_grid_columns_and_gaps.size())
  1319. resolved_column_span = m_grid_columns_and_gaps.size() - grid_item.gap_adjusted_column(box);
  1320. layout_box(
  1321. grid_item.gap_adjusted_row(box),
  1322. grid_item.gap_adjusted_row(box) + resolved_row_span,
  1323. grid_item.gap_adjusted_column(box),
  1324. grid_item.gap_adjusted_column(box) + resolved_column_span,
  1325. grid_item.box());
  1326. }
  1327. }
  1328. void GridFormattingContext::determine_intrinsic_size_of_grid_container(AvailableSpace const& available_space)
  1329. {
  1330. // https://www.w3.org/TR/css-grid-1/#intrinsic-sizes
  1331. // The max-content size (min-content size) of a grid container is the sum of the grid container’s track sizes
  1332. // (including gutters) in the appropriate axis, when the grid is sized under a max-content constraint (min-content constraint).
  1333. if (available_space.height.is_intrinsic_sizing_constraint()) {
  1334. CSSPixels grid_container_height = 0;
  1335. for (auto& track : m_grid_rows) {
  1336. grid_container_height += track.base_size;
  1337. }
  1338. m_state.get_mutable(grid_container()).set_content_height(grid_container_height);
  1339. }
  1340. if (available_space.width.is_intrinsic_sizing_constraint()) {
  1341. CSSPixels grid_container_width = 0;
  1342. for (auto& track : m_grid_columns) {
  1343. grid_container_width += track.base_size;
  1344. }
  1345. m_state.get_mutable(grid_container()).set_content_width(grid_container_width);
  1346. }
  1347. }
  1348. CSSPixels GridFormattingContext::automatic_content_width() const
  1349. {
  1350. return m_state.get(grid_container()).content_width();
  1351. }
  1352. CSSPixels GridFormattingContext::automatic_content_height() const
  1353. {
  1354. return m_automatic_content_height;
  1355. }
  1356. bool GridFormattingContext::is_auto_positioned_row(CSS::GridTrackPlacement const& grid_row_start, CSS::GridTrackPlacement const& grid_row_end) const
  1357. {
  1358. return is_auto_positioned_track(grid_row_start, grid_row_end);
  1359. }
  1360. bool GridFormattingContext::is_auto_positioned_column(CSS::GridTrackPlacement const& grid_column_start, CSS::GridTrackPlacement const& grid_column_end) const
  1361. {
  1362. return is_auto_positioned_track(grid_column_start, grid_column_end);
  1363. }
  1364. bool GridFormattingContext::is_auto_positioned_track(CSS::GridTrackPlacement const& grid_track_start, CSS::GridTrackPlacement const& grid_track_end) const
  1365. {
  1366. return grid_track_start.is_auto_positioned() && grid_track_end.is_auto_positioned();
  1367. }
  1368. AvailableSize GridFormattingContext::get_free_space(AvailableSpace const& available_space, GridDimension const dimension) const
  1369. {
  1370. // https://www.w3.org/TR/css-grid-2/#algo-terms
  1371. // free space: Equal to the available grid space minus the sum of the base sizes of all the grid
  1372. // tracks (including gutters), floored at zero. If available grid space is indefinite, the free
  1373. // space is indefinite as well.
  1374. auto& available_size = dimension == GridDimension::Column ? available_space.width : available_space.height;
  1375. auto& tracks = dimension == GridDimension::Column ? m_grid_columns_and_gaps : m_grid_rows_and_gaps;
  1376. if (available_size.is_definite()) {
  1377. CSSPixels sum_base_sizes = 0;
  1378. for (auto& track : tracks)
  1379. sum_base_sizes += track.base_size;
  1380. return AvailableSize::make_definite(max(CSSPixels(0), available_size.to_px() - sum_base_sizes));
  1381. }
  1382. return available_size;
  1383. }
  1384. int GridFormattingContext::get_line_index_by_line_name(String const& needle, CSS::GridTrackSizeList grid_track_size_list)
  1385. {
  1386. if (grid_track_size_list.track_list().size() == 0)
  1387. return -1;
  1388. auto repeated_tracks_count = 0;
  1389. for (size_t x = 0; x < grid_track_size_list.track_list().size(); x++) {
  1390. if (grid_track_size_list.track_list()[x].is_repeat()) {
  1391. // FIXME: Calculate amount of columns/rows if auto-fill/fit
  1392. if (!grid_track_size_list.track_list()[x].repeat().is_default())
  1393. return -1;
  1394. auto repeat = grid_track_size_list.track_list()[x].repeat().grid_track_size_list();
  1395. for (size_t y = 0; y < repeat.track_list().size(); y++) {
  1396. for (size_t z = 0; z < repeat.line_names()[y].size(); z++) {
  1397. if (repeat.line_names()[y][z] == needle)
  1398. return x + repeated_tracks_count;
  1399. repeated_tracks_count++;
  1400. }
  1401. }
  1402. } else {
  1403. for (size_t y = 0; y < grid_track_size_list.line_names()[x].size(); y++) {
  1404. if (grid_track_size_list.line_names()[x][y] == needle)
  1405. return x + repeated_tracks_count;
  1406. }
  1407. }
  1408. }
  1409. for (size_t y = 0; y < grid_track_size_list.line_names()[grid_track_size_list.track_list().size()].size(); y++) {
  1410. if (grid_track_size_list.line_names()[grid_track_size_list.track_list().size()][y] == needle)
  1411. return grid_track_size_list.track_list().size() + repeated_tracks_count;
  1412. }
  1413. return -1;
  1414. }
  1415. void OccupationGrid::set_occupied(size_t column_start, size_t column_end, size_t row_start, size_t row_end)
  1416. {
  1417. for (size_t row = row_start; row < row_end; row++) {
  1418. for (size_t column = column_start; column < column_end; column++) {
  1419. set_occupied(column, row);
  1420. }
  1421. }
  1422. }
  1423. void OccupationGrid::set_occupied(size_t column_index, size_t row_index)
  1424. {
  1425. m_columns_count = max(m_columns_count, column_index + 1);
  1426. m_rows_count = max(m_rows_count, row_index + 1);
  1427. m_occupation_grid.try_set(GridPosition { .row = row_index, .column = column_index }).release_value_but_fixme_should_propagate_errors();
  1428. }
  1429. bool OccupationGrid::is_occupied(size_t column_index, size_t row_index) const
  1430. {
  1431. return m_occupation_grid.contains(GridPosition { row_index, column_index });
  1432. }
  1433. size_t GridItem::gap_adjusted_row(Box const& grid_box) const
  1434. {
  1435. return grid_box.computed_values().row_gap().is_auto() ? m_row : m_row * 2;
  1436. }
  1437. size_t GridItem::gap_adjusted_column(Box const& grid_box) const
  1438. {
  1439. return grid_box.computed_values().column_gap().is_auto() ? m_column : m_column * 2;
  1440. }
  1441. CSS::Size const& GridFormattingContext::get_item_preferred_size(GridItem const& item, GridDimension const dimension) const
  1442. {
  1443. if (dimension == GridDimension::Column)
  1444. return item.box().computed_values().width();
  1445. return item.box().computed_values().height();
  1446. }
  1447. CSSPixels GridFormattingContext::calculate_min_content_size(GridItem const& item, GridDimension const dimension) const
  1448. {
  1449. if (dimension == GridDimension::Column) {
  1450. return calculate_min_content_width(item.box());
  1451. } else {
  1452. return calculate_min_content_height(item.box(), get_available_space_for_item(item).width);
  1453. }
  1454. }
  1455. CSSPixels GridFormattingContext::calculate_max_content_size(GridItem const& item, GridDimension const dimension) const
  1456. {
  1457. if (dimension == GridDimension::Column) {
  1458. return calculate_max_content_width(item.box());
  1459. } else {
  1460. return calculate_max_content_height(item.box(), get_available_space_for_item(item).width);
  1461. }
  1462. }
  1463. CSSPixels GridFormattingContext::containing_block_size_for_item(GridItem const& item, GridDimension const dimension) const
  1464. {
  1465. CSSPixels containing_block_size = 0;
  1466. for_each_spanned_track_by_item(item, dimension, [&](TemporaryTrack const& track) {
  1467. containing_block_size += track.base_size;
  1468. });
  1469. return containing_block_size;
  1470. }
  1471. AvailableSpace GridFormattingContext::get_available_space_for_item(GridItem const& item) const
  1472. {
  1473. auto& item_box_state = m_state.get(item.box());
  1474. AvailableSize available_width = item_box_state.has_definite_width() ? AvailableSize::make_definite(item_box_state.content_width()) : AvailableSize::make_indefinite();
  1475. AvailableSize available_height = item_box_state.has_definite_height() ? AvailableSize::make_definite(item_box_state.content_height()) : AvailableSize::make_indefinite();
  1476. return AvailableSpace(available_width, available_height);
  1477. }
  1478. CSSPixels GridFormattingContext::calculate_min_content_contribution(GridItem const& item, GridDimension const dimension) const
  1479. {
  1480. auto available_space_for_item = get_available_space_for_item(item);
  1481. auto should_treat_preferred_size_as_auto = [&] {
  1482. if (dimension == GridDimension::Column)
  1483. return should_treat_width_as_auto(item.box(), available_space_for_item);
  1484. return should_treat_height_as_auto(item.box(), available_space_for_item);
  1485. }();
  1486. if (should_treat_preferred_size_as_auto) {
  1487. return item.add_border_box_sizes(calculate_min_content_size(item, dimension), dimension, m_state);
  1488. }
  1489. auto preferred_size = get_item_preferred_size(item, dimension);
  1490. auto containing_block_size = containing_block_size_for_item(item, dimension);
  1491. return item.add_border_box_sizes(preferred_size.to_px(grid_container(), containing_block_size), dimension, m_state);
  1492. }
  1493. CSSPixels GridFormattingContext::calculate_max_content_contribution(GridItem const& item, GridDimension const dimension) const
  1494. {
  1495. auto available_space_for_item = get_available_space_for_item(item);
  1496. auto should_treat_preferred_size_as_auto = [&] {
  1497. if (dimension == GridDimension::Column)
  1498. return should_treat_width_as_auto(item.box(), available_space_for_item);
  1499. return should_treat_height_as_auto(item.box(), available_space_for_item);
  1500. }();
  1501. if (should_treat_preferred_size_as_auto) {
  1502. return item.add_border_box_sizes(calculate_max_content_size(item, dimension), dimension, m_state);
  1503. }
  1504. auto preferred_size = get_item_preferred_size(item, dimension);
  1505. auto containing_block_size = containing_block_size_for_item(item, dimension);
  1506. return item.add_border_box_sizes(preferred_size.to_px(grid_container(), containing_block_size), dimension, m_state);
  1507. }
  1508. CSSPixels GridFormattingContext::calculate_limited_min_content_contribution(GridItem const& item, GridDimension const dimension) const
  1509. {
  1510. // The limited min-content contribution of an item is its min-content contribution,
  1511. // limited by the max track sizing function (which could be the argument to a fit-content() track
  1512. // sizing function) if that is fixed and ultimately floored by its minimum contribution.
  1513. // FIXME: limit by max track sizing function
  1514. auto min_content_contribution = calculate_min_content_contribution(item, dimension);
  1515. auto minimum_contribution = calculate_minimum_contribution(item, dimension);
  1516. if (min_content_contribution < minimum_contribution)
  1517. return minimum_contribution;
  1518. return min_content_contribution;
  1519. }
  1520. CSSPixels GridFormattingContext::calculate_limited_max_content_contribution(GridItem const& item, GridDimension const dimension) const
  1521. {
  1522. // The limited max-content contribution of an item is its max-content contribution,
  1523. // limited by the max track sizing function (which could be the argument to a fit-content() track
  1524. // sizing function) if that is fixed and ultimately floored by its minimum contribution.
  1525. // FIXME: limit by max track sizing function
  1526. auto max_content_contribution = calculate_max_content_contribution(item, dimension);
  1527. auto minimum_contribution = calculate_minimum_contribution(item, dimension);
  1528. if (max_content_contribution < minimum_contribution)
  1529. return minimum_contribution;
  1530. return max_content_contribution;
  1531. }
  1532. CSS::Size const& GridFormattingContext::get_item_minimum_size(GridItem const& item, GridDimension const dimension) const
  1533. {
  1534. if (dimension == GridDimension::Column)
  1535. return item.box().computed_values().min_width();
  1536. return item.box().computed_values().min_height();
  1537. }
  1538. CSSPixels GridFormattingContext::content_size_suggestion(GridItem const& item, GridDimension const dimension) const
  1539. {
  1540. // The content size suggestion is the min-content size in the relevant axis
  1541. // FIXME: clamped, if it has a preferred aspect ratio, by any definite opposite-axis minimum and maximum sizes
  1542. // converted through the aspect ratio.
  1543. return calculate_min_content_size(item, dimension);
  1544. }
  1545. Optional<CSSPixels> GridFormattingContext::specified_size_suggestion(GridItem const& item, GridDimension const dimension) const
  1546. {
  1547. // https://www.w3.org/TR/css-grid-1/#specified-size-suggestion
  1548. // If the item’s preferred size in the relevant axis is definite, then the specified size suggestion is that size.
  1549. // It is otherwise undefined.
  1550. auto const& used_values = m_state.get(item.box());
  1551. auto has_definite_preferred_size = dimension == GridDimension::Column ? used_values.has_definite_width() : used_values.has_definite_height();
  1552. if (has_definite_preferred_size) {
  1553. // FIXME: consider margins, padding and borders because it is outer size.
  1554. auto containing_block_size = containing_block_size_for_item(item, dimension);
  1555. return get_item_preferred_size(item, dimension).to_px(item.box(), containing_block_size);
  1556. }
  1557. return {};
  1558. }
  1559. CSSPixels GridFormattingContext::content_based_minimum_size(GridItem const& item, GridDimension const dimension) const
  1560. {
  1561. // https://www.w3.org/TR/css-grid-1/#content-based-minimum-size
  1562. // The content-based minimum size for a grid item in a given dimension is its specified size suggestion if it exists
  1563. if (auto specified_size_suggestion = this->specified_size_suggestion(item, dimension); specified_size_suggestion.has_value()) {
  1564. return specified_size_suggestion.value();
  1565. }
  1566. // FIXME: otherwise its transferred size suggestion if that exists
  1567. // else its content size suggestion
  1568. return content_size_suggestion(item, dimension);
  1569. }
  1570. CSSPixels GridFormattingContext::automatic_minimum_size(GridItem const& item, GridDimension const dimension) const
  1571. {
  1572. // To provide a more reasonable default minimum size for grid items, the used value of its automatic minimum size
  1573. // in a given axis is the content-based minimum size if all of the following are true:
  1574. // - it is not a scroll container
  1575. // - it spans at least one track in that axis whose min track sizing function is auto
  1576. // FIXME: - if it spans more than one track in that axis, none of those tracks are flexible
  1577. auto const& tracks = dimension == GridDimension::Column ? m_grid_columns : m_grid_rows;
  1578. auto item_track_index = item.raw_position(dimension);
  1579. // FIXME: Check all tracks spanned by an item
  1580. auto item_spans_auto_tracks = tracks[item_track_index].min_track_sizing_function.is_auto();
  1581. if (item_spans_auto_tracks && !item.box().is_scroll_container()) {
  1582. return item.add_border_box_sizes(content_based_minimum_size(item, dimension), dimension, m_state);
  1583. }
  1584. // Otherwise, the automatic minimum size is zero, as usual.
  1585. return 0;
  1586. }
  1587. CSSPixels GridFormattingContext::calculate_minimum_contribution(GridItem const& item, GridDimension const dimension) const
  1588. {
  1589. // The minimum contribution of an item is the smallest outer size it can have.
  1590. // Specifically, if the item’s computed preferred size behaves as auto or depends on the size of its
  1591. // containing block in the relevant axis, its minimum contribution is the outer size that would
  1592. // result from assuming the item’s used minimum size as its preferred size; else the item’s minimum
  1593. // contribution is its min-content contribution. Because the minimum contribution often depends on
  1594. // the size of the item’s content, it is considered a type of intrinsic size contribution.
  1595. auto preferred_size = get_item_preferred_size(item, dimension);
  1596. auto should_treat_preferred_size_as_auto = [&] {
  1597. if (dimension == GridDimension::Column)
  1598. return should_treat_width_as_auto(item.box(), get_available_space_for_item(item));
  1599. return should_treat_height_as_auto(item.box(), get_available_space_for_item(item));
  1600. }();
  1601. if (should_treat_preferred_size_as_auto) {
  1602. auto minimum_size = get_item_minimum_size(item, dimension);
  1603. if (minimum_size.is_auto())
  1604. return automatic_minimum_size(item, dimension);
  1605. auto containing_block_size = containing_block_size_for_item(item, dimension);
  1606. return item.add_border_box_sizes(minimum_size.to_px(grid_container(), containing_block_size), dimension, m_state);
  1607. }
  1608. return calculate_min_content_contribution(item, dimension);
  1609. }
  1610. }
  1611. namespace AK {
  1612. template<>
  1613. struct Traits<Web::Layout::GridPosition> : public GenericTraits<Web::Layout::GridPosition> {
  1614. static unsigned hash(Web::Layout::GridPosition const& key) { return pair_int_hash(key.row, key.column); }
  1615. };
  1616. }