LayoutDetails.cpp 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556
  1. /*
  2. * This source file is part of RmlUi, the HTML/CSS Interface Middleware
  3. *
  4. * For the latest information, see http://github.com/mikke89/RmlUi
  5. *
  6. * Copyright (c) 2008-2010 CodePoint Ltd, Shift Technology Ltd
  7. * Copyright (c) 2019-2023 The RmlUi Team, and contributors
  8. *
  9. * Permission is hereby granted, free of charge, to any person obtaining a copy
  10. * of this software and associated documentation files (the "Software"), to deal
  11. * in the Software without restriction, including without limitation the rights
  12. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  13. * copies of the Software, and to permit persons to whom the Software is
  14. * furnished to do so, subject to the following conditions:
  15. *
  16. * The above copyright notice and this permission notice shall be included in
  17. * all copies or substantial portions of the Software.
  18. *
  19. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  22. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  23. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  24. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  25. * THE SOFTWARE.
  26. *
  27. */
  28. #include "LayoutDetails.h"
  29. #include "../../../Include/RmlUi/Core/ComputedValues.h"
  30. #include "../../../Include/RmlUi/Core/Element.h"
  31. #include "../../../Include/RmlUi/Core/ElementScroll.h"
  32. #include "../../../Include/RmlUi/Core/ElementText.h"
  33. #include "../../../Include/RmlUi/Core/Math.h"
  34. #include "../../../Include/RmlUi/Core/Profiling.h"
  35. #include "ContainerBox.h"
  36. #include "FormattingContext.h"
  37. #include "LayoutEngine.h"
  38. #include <float.h>
  39. namespace Rml {
  40. // Convert width or height of a border box to the width or height of its corresponding content box.
  41. static inline float BorderSizeToContentSize(float border_size, float border_padding_edges_size)
  42. {
  43. if (border_size < 0.0f || border_size >= FLT_MAX)
  44. return border_size;
  45. return Math::Max(0.0f, border_size - border_padding_edges_size);
  46. }
  47. void LayoutDetails::BuildBox(Box& box, Vector2f containing_block, Element* element, BuildBoxMode box_mode, const FormattingMode* formatting_mode)
  48. {
  49. // A shrinkable block may start formatting, thus the current formatting mode must be provided.
  50. RMLUI_ASSERT(box_mode != BuildBoxMode::ShrinkableBlock || formatting_mode != nullptr);
  51. if (!element)
  52. {
  53. box.SetContent(containing_block);
  54. return;
  55. }
  56. const ComputedValues& computed = element->GetComputedValues();
  57. // Calculate the padding area.
  58. box.SetEdge(BoxArea::Padding, BoxEdge::Top, Math::Max(0.0f, ResolveValue(computed.padding_top(), containing_block.x)));
  59. box.SetEdge(BoxArea::Padding, BoxEdge::Right, Math::Max(0.0f, ResolveValue(computed.padding_right(), containing_block.x)));
  60. box.SetEdge(BoxArea::Padding, BoxEdge::Bottom, Math::Max(0.0f, ResolveValue(computed.padding_bottom(), containing_block.x)));
  61. box.SetEdge(BoxArea::Padding, BoxEdge::Left, Math::Max(0.0f, ResolveValue(computed.padding_left(), containing_block.x)));
  62. // Calculate the border area.
  63. box.SetEdge(BoxArea::Border, BoxEdge::Top, Math::Max(0.0f, computed.border_top_width()));
  64. box.SetEdge(BoxArea::Border, BoxEdge::Right, Math::Max(0.0f, computed.border_right_width()));
  65. box.SetEdge(BoxArea::Border, BoxEdge::Bottom, Math::Max(0.0f, computed.border_bottom_width()));
  66. box.SetEdge(BoxArea::Border, BoxEdge::Left, Math::Max(0.0f, computed.border_left_width()));
  67. // Prepare sizing of the content area.
  68. Vector2f content_area(-1, -1);
  69. Vector2f min_size = Vector2f(0, 0);
  70. Vector2f max_size = Vector2f(FLT_MAX, FLT_MAX);
  71. // Intrinsic size for replaced elements.
  72. Vector2f intrinsic_size(-1, -1);
  73. float intrinsic_ratio = -1;
  74. const bool replaced_element = element->GetIntrinsicDimensions(intrinsic_size, intrinsic_ratio);
  75. // Calculate the content area and constraints. 'auto' width and height are handled later.
  76. // For inline non-replaced elements, width and height are ignored, so we can skip the calculations.
  77. if (box_mode == BuildBoxMode::Block || box_mode == BuildBoxMode::ShrinkableBlock || box_mode == BuildBoxMode::UnalignedBlock || replaced_element)
  78. {
  79. content_area.x = ResolveValueOr(computed.width(), containing_block.x, -1.f);
  80. content_area.y = ResolveValueOr(computed.height(), containing_block.y, -1.f);
  81. min_size = Vector2f{
  82. ResolveValueOr(computed.min_width(), containing_block.x, 0.f),
  83. ResolveValueOr(computed.min_height(), containing_block.y, 0.f),
  84. };
  85. max_size = Vector2f{
  86. ResolveValueOr(computed.max_width(), containing_block.x, FLT_MAX),
  87. ResolveValueOr(computed.max_height(), containing_block.y, FLT_MAX),
  88. };
  89. // Adjust sizes for the given box sizing model.
  90. if (computed.box_sizing() == Style::BoxSizing::BorderBox)
  91. {
  92. const float border_padding_width = box.GetSizeAcross(BoxDirection::Horizontal, BoxArea::Border, BoxArea::Padding);
  93. const float border_padding_height = box.GetSizeAcross(BoxDirection::Vertical, BoxArea::Border, BoxArea::Padding);
  94. min_size.x = BorderSizeToContentSize(min_size.x, border_padding_width);
  95. max_size.x = BorderSizeToContentSize(max_size.x, border_padding_width);
  96. content_area.x = BorderSizeToContentSize(content_area.x, border_padding_width);
  97. min_size.y = BorderSizeToContentSize(min_size.y, border_padding_height);
  98. max_size.y = BorderSizeToContentSize(max_size.y, border_padding_height);
  99. content_area.y = BorderSizeToContentSize(content_area.y, border_padding_height);
  100. }
  101. if (content_area.x >= 0)
  102. content_area.x = Math::Clamp(content_area.x, min_size.x, max_size.x);
  103. if (content_area.y >= 0)
  104. content_area.y = Math::Clamp(content_area.y, min_size.y, max_size.y);
  105. if (replaced_element)
  106. content_area = CalculateSizeForReplacedElement(content_area, min_size, max_size, intrinsic_size, intrinsic_ratio);
  107. }
  108. box.SetContent(content_area);
  109. // Evaluate the margins, and width and height if they are auto.
  110. BuildBoxSizeAndMargins(box, min_size, max_size, containing_block, element, box_mode, replaced_element,
  111. (box_mode == BuildBoxMode::ShrinkableBlock ? formatting_mode : nullptr));
  112. }
  113. void LayoutDetails::GetMinMaxWidth(float& min_width, float& max_width, const ComputedValues& computed, const Box& box, float containing_block_width)
  114. {
  115. min_width = ResolveValueOr(computed.min_width(), containing_block_width, 0.f);
  116. max_width = ResolveValueOr(computed.max_width(), containing_block_width, FLT_MAX);
  117. if (computed.box_sizing() == Style::BoxSizing::BorderBox)
  118. {
  119. const float border_padding_width = box.GetSizeAcross(BoxDirection::Horizontal, BoxArea::Border, BoxArea::Padding);
  120. min_width = BorderSizeToContentSize(min_width, border_padding_width);
  121. max_width = BorderSizeToContentSize(max_width, border_padding_width);
  122. }
  123. }
  124. void LayoutDetails::GetMinMaxHeight(float& min_height, float& max_height, const ComputedValues& computed, const Box& box,
  125. float containing_block_height)
  126. {
  127. min_height = ResolveValueOr(computed.min_height(), containing_block_height, 0.f);
  128. max_height = ResolveValueOr(computed.max_height(), containing_block_height, FLT_MAX);
  129. if (computed.box_sizing() == Style::BoxSizing::BorderBox)
  130. {
  131. const float border_padding_height = box.GetSizeAcross(BoxDirection::Vertical, BoxArea::Border, BoxArea::Padding);
  132. min_height = BorderSizeToContentSize(min_height, border_padding_height);
  133. max_height = BorderSizeToContentSize(max_height, border_padding_height);
  134. }
  135. }
  136. void LayoutDetails::GetDefiniteMinMaxHeight(float& min_height, float& max_height, const ComputedValues& computed, const Box& box,
  137. float containing_block_height)
  138. {
  139. const float box_height = box.GetSize().y;
  140. if (box_height < 0)
  141. {
  142. GetMinMaxHeight(min_height, max_height, computed, box, containing_block_height);
  143. }
  144. else
  145. {
  146. min_height = box_height;
  147. max_height = box_height;
  148. }
  149. }
  150. void LayoutDetails::BuildAutoMarginsForBlockBox(Box& box, Vector2f containing_block, Element* element)
  151. {
  152. RMLUI_ASSERT(box.GetSize().x >= 0.f && box.GetSize().y >= 0.f);
  153. const Vector2f initial_content_size = box.GetSize();
  154. const Vector2f min_size = {0, 0};
  155. const Vector2f max_size = {FLT_MAX, FLT_MAX};
  156. BuildBoxSizeAndMargins(box, min_size, max_size, containing_block, element, BuildBoxMode::Block, true, nullptr);
  157. RMLUI_ASSERT(box.GetSize() == initial_content_size);
  158. }
  159. void LayoutDetails::BuildBoxSizeAndMargins(Box& box, Vector2f min_size, Vector2f max_size, Vector2f containing_block, Element* element,
  160. BuildBoxMode box_mode, bool replaced_element, const FormattingMode* formatting_mode)
  161. {
  162. const ComputedValues& computed = element->GetComputedValues();
  163. if (box_mode == BuildBoxMode::Inline || box_mode == BuildBoxMode::UnalignedBlock)
  164. {
  165. // For inline elements, their calculations are straightforward. No worrying about auto margins and dimensions, etc.
  166. // Evaluate the margins. Any declared as 'auto' will resolve to 0.
  167. box.SetEdge(BoxArea::Margin, BoxEdge::Top, ResolveValue(computed.margin_top(), containing_block.x));
  168. box.SetEdge(BoxArea::Margin, BoxEdge::Right, ResolveValue(computed.margin_right(), containing_block.x));
  169. box.SetEdge(BoxArea::Margin, BoxEdge::Bottom, ResolveValue(computed.margin_bottom(), containing_block.x));
  170. box.SetEdge(BoxArea::Margin, BoxEdge::Left, ResolveValue(computed.margin_left(), containing_block.x));
  171. }
  172. else
  173. {
  174. // The element is block, so we need to run the box through the ringer to potentially evaluate auto margins and dimensions.
  175. BuildBoxWidth(box, computed, min_size.x, max_size.x, containing_block, element, replaced_element, formatting_mode);
  176. BuildBoxHeight(box, computed, min_size.y, max_size.y, containing_block.y);
  177. }
  178. }
  179. float LayoutDetails::GetShrinkToFitWidth(Element* element, Vector2f containing_block, const FormattingMode& current_formatting_mode)
  180. {
  181. RMLUI_ASSERT(element);
  182. // @performance Can we lay out the elements directly using a fit-content size mode, instead of fetching the
  183. // shrink-to-fit width first? Use a non-definite placeholder for the box content width, and available width as a
  184. // maximum constraint.
  185. Box box;
  186. float min_height, max_height;
  187. LayoutDetails::BuildBox(box, containing_block, element, BuildBoxMode::UnalignedBlock);
  188. LayoutDetails::GetDefiniteMinMaxHeight(min_height, max_height, element->GetComputedValues(), box, containing_block.y);
  189. if (box.GetSize().x >= 0.f)
  190. {
  191. return box.GetSize().x;
  192. }
  193. // Currently we don't support shrink-to-fit width for tables. Just return a zero-sized width.
  194. const Style::Display display = element->GetDisplay();
  195. if (display == Style::Display::Table || display == Style::Display::InlineTable)
  196. {
  197. return 0.f;
  198. }
  199. // Use a large size for the box content width, so that it is practically unconstrained. This makes the formatting
  200. // procedure act as if under a maximum content constraint. Children with percentage sizing values may be scaled
  201. // based on this width (such as 'width' or 'margin'), if so, the layout is considered undefined like in CSS 2.
  202. const float max_content_constraint_width = containing_block.x + 10'000.f;
  203. box.SetContent({max_content_constraint_width, box.GetSize().y});
  204. FormattingMode formatting_mode = current_formatting_mode;
  205. formatting_mode.constraint = FormattingMode::Constraint::MaxContent;
  206. // First, format the element under the above-generated box. Then we ask the resulting box for its shrink-to-fit
  207. // width. For block containers, this is essentially its largest line or child box.
  208. // @performance. Some formatting can be simplified, e.g. absolute elements do not contribute to the shrink-to-fit
  209. // width. Also, children of elements with a fixed width and height don't need to be formatted further.
  210. RootBox root(Box(Math::Max(containing_block, Vector2f(0.f))), formatting_mode);
  211. UniquePtr<LayoutBox> layout_box = FormattingContext::FormatIndependent(&root, element, &box, FormattingContextType::Block);
  212. float shrink_to_fit_width = layout_box->GetShrinkToFitWidth();
  213. if (containing_block.x >= 0)
  214. {
  215. const float available_width =
  216. Math::Max(0.f, containing_block.x - box.GetSizeAcross(BoxDirection::Horizontal, BoxArea::Margin, BoxArea::Padding));
  217. shrink_to_fit_width = Math::Min(shrink_to_fit_width, available_width);
  218. }
  219. return shrink_to_fit_width;
  220. }
  221. ComputedAxisSize LayoutDetails::BuildComputedHorizontalSize(const ComputedValues& computed)
  222. {
  223. return ComputedAxisSize{computed.width(), computed.min_width(), computed.max_width(), computed.padding_left(), computed.padding_right(),
  224. computed.margin_left(), computed.margin_right(), computed.border_left_width(), computed.border_right_width(), computed.box_sizing()};
  225. }
  226. ComputedAxisSize LayoutDetails::BuildComputedVerticalSize(const ComputedValues& computed)
  227. {
  228. return ComputedAxisSize{computed.height(), computed.min_height(), computed.max_height(), computed.padding_top(), computed.padding_bottom(),
  229. computed.margin_top(), computed.margin_bottom(), computed.border_top_width(), computed.border_bottom_width(), computed.box_sizing()};
  230. }
  231. void LayoutDetails::GetEdgeSizes(float& margin_a, float& margin_b, float& padding_border_a, float& padding_border_b,
  232. const ComputedAxisSize& computed_size, const float base_value)
  233. {
  234. margin_a = ResolveValue(computed_size.margin_a, base_value);
  235. margin_b = ResolveValue(computed_size.margin_b, base_value);
  236. padding_border_a = Math::Max(0.0f, ResolveValue(computed_size.padding_a, base_value)) + Math::Max(0.0f, computed_size.border_a);
  237. padding_border_b = Math::Max(0.0f, ResolveValue(computed_size.padding_b, base_value)) + Math::Max(0.0f, computed_size.border_b);
  238. }
  239. String LayoutDetails::GetDebugElementName(Element* element)
  240. {
  241. if (!element)
  242. return "nullptr";
  243. if (!element->GetId().empty())
  244. return '#' + element->GetId();
  245. if (auto element_text = rmlui_dynamic_cast<ElementText*>(element))
  246. return '\"' + StringUtilities::StripWhitespace(element_text->GetText()).substr(0, 20) + '\"';
  247. return element->GetAddress(false, false);
  248. }
  249. Vector2f LayoutDetails::CalculateSizeForReplacedElement(const Vector2f specified_content_size, const Vector2f min_size, const Vector2f max_size,
  250. const Vector2f intrinsic_size, const float intrinsic_ratio)
  251. {
  252. // Start with the element's specified width and height. If any of them are auto, use the element's intrinsic
  253. // dimensions and ratio to find a suitable content size.
  254. Vector2f content_size = specified_content_size;
  255. const bool auto_width = (content_size.x < 0);
  256. const bool auto_height = (content_size.y < 0);
  257. if (auto_width)
  258. content_size.x = intrinsic_size.x;
  259. if (auto_height)
  260. content_size.y = intrinsic_size.y;
  261. // Use a fallback size if we still couldn't determine the size.
  262. if (content_size.x < 0)
  263. content_size.x = 300;
  264. if (content_size.y < 0)
  265. content_size.y = 150;
  266. // Resolve the size constraints.
  267. const float min_width = min_size.x;
  268. const float max_width = max_size.x;
  269. const float min_height = min_size.y;
  270. const float max_height = max_size.y;
  271. // If we have an intrinsic ratio and one of the dimensions is 'auto', then scale it such that the ratio is preserved.
  272. if (intrinsic_ratio > 0)
  273. {
  274. if (auto_width && !auto_height)
  275. {
  276. content_size.x = content_size.y * intrinsic_ratio;
  277. }
  278. else if (auto_height && !auto_width)
  279. {
  280. content_size.y = content_size.x / intrinsic_ratio;
  281. }
  282. else if (auto_width && auto_height)
  283. {
  284. // If both width and height are auto, try to preserve the ratio under the respective min/max constraints.
  285. const float w = content_size.x;
  286. const float h = content_size.y;
  287. if ((w < min_width && h > max_height) || (w > max_width && h < min_height))
  288. {
  289. // Cannot preserve aspect ratio, let it be clamped.
  290. }
  291. else if (w < min_width && h < min_height)
  292. {
  293. // Increase the size such that both min-constraints are respected. The non-scaled axis will
  294. // be clamped below, preserving the aspect ratio.
  295. if (min_width <= min_height * intrinsic_ratio)
  296. content_size.x = min_height * intrinsic_ratio;
  297. else
  298. content_size.y = min_width / intrinsic_ratio;
  299. }
  300. else if (w > max_width && h > max_height)
  301. {
  302. // Shrink the size such that both max-constraints are respected. The non-scaled axis will
  303. // be clamped below, preserving the aspect ratio.
  304. if (max_width <= max_height * intrinsic_ratio)
  305. content_size.y = max_width / intrinsic_ratio;
  306. else
  307. content_size.x = max_height * intrinsic_ratio;
  308. }
  309. else
  310. {
  311. // Single constraint violations.
  312. if (w < min_width)
  313. content_size.y = min_width / intrinsic_ratio;
  314. else if (w > max_width)
  315. content_size.y = max_width / intrinsic_ratio;
  316. else if (h < min_height)
  317. content_size.x = min_height * intrinsic_ratio;
  318. else if (h > max_height)
  319. content_size.x = max_height * intrinsic_ratio;
  320. }
  321. }
  322. }
  323. content_size.x = Math::Clamp(content_size.x, min_width, max_width);
  324. content_size.y = Math::Clamp(content_size.y, min_height, max_height);
  325. return content_size;
  326. }
  327. void LayoutDetails::BuildBoxWidth(Box& box, const ComputedValues& computed, float min_width, float max_width, Vector2f containing_block,
  328. Element* element, bool replaced_element, const FormattingMode* formatting_mode, float override_shrink_to_fit_width)
  329. {
  330. RMLUI_ZoneScoped;
  331. Vector2f content_area = box.GetSize();
  332. // Determine if the element has automatic margins.
  333. bool margins_auto[2];
  334. int num_auto_margins = 0;
  335. for (int i = 0; i < 2; ++i)
  336. {
  337. const Style::Margin margin_value = (i == 0 ? computed.margin_left() : computed.margin_right());
  338. if (margin_value.type == Style::Margin::Auto)
  339. {
  340. margins_auto[i] = true;
  341. num_auto_margins++;
  342. box.SetEdge(BoxArea::Margin, i == 0 ? BoxEdge::Left : BoxEdge::Right, 0);
  343. }
  344. else
  345. {
  346. margins_auto[i] = false;
  347. box.SetEdge(BoxArea::Margin, i == 0 ? BoxEdge::Left : BoxEdge::Right, ResolveValue(margin_value, containing_block.x));
  348. }
  349. }
  350. const bool absolutely_positioned = (computed.position() == Style::Position::Absolute || computed.position() == Style::Position::Fixed);
  351. const bool inset_auto = (computed.left().type == Style::Left::Auto || computed.right().type == Style::Right::Auto);
  352. const bool width_auto = (content_area.x < 0);
  353. auto GetInsetWidth = [&] {
  354. // For absolutely positioned elements (and only those), the 'left' and 'right' values are part of the box's width constraint.
  355. if (absolutely_positioned)
  356. return ResolveValue(computed.left(), containing_block.x) + ResolveValue(computed.right(), containing_block.x);
  357. return 0.f;
  358. };
  359. // If the width is set to auto, we need to calculate the width.
  360. if (width_auto)
  361. {
  362. // Apply the shrink-to-fit algorithm here to find the width of the element.
  363. // See CSS 2.1 section 10.3.7 for when this should be applied.
  364. const bool shrink_to_fit = formatting_mode != nullptr && !replaced_element &&
  365. ((computed.float_() != Style::Float::None) || (absolutely_positioned && inset_auto) ||
  366. (computed.display() == Style::Display::InlineBlock || computed.display() == Style::Display::InlineFlex));
  367. if (!shrink_to_fit)
  368. {
  369. // The width is set to whatever remains of the containing block.
  370. const float accumulated_edges = GetInsetWidth() + box.GetSizeAcross(BoxDirection::Horizontal, BoxArea::Margin, BoxArea::Padding);
  371. content_area.x = Math::Max(containing_block.x - accumulated_edges, 0.f);
  372. }
  373. else if (override_shrink_to_fit_width >= 0)
  374. {
  375. content_area.x = override_shrink_to_fit_width;
  376. }
  377. else
  378. {
  379. content_area.x = GetShrinkToFitWidth(element, containing_block, *formatting_mode);
  380. override_shrink_to_fit_width = content_area.x;
  381. }
  382. }
  383. // Otherwise, the margins that are set to auto will pick up the remaining width of the containing block.
  384. else if (num_auto_margins > 0)
  385. {
  386. const float margin =
  387. (containing_block.x - (GetInsetWidth() + box.GetSizeAcross(BoxDirection::Horizontal, BoxArea::Margin))) / float(num_auto_margins);
  388. if (margins_auto[0])
  389. box.SetEdge(BoxArea::Margin, BoxEdge::Left, margin);
  390. if (margins_auto[1])
  391. box.SetEdge(BoxArea::Margin, BoxEdge::Right, margin);
  392. }
  393. // Clamp the calculated width; if the width is changed by the clamp, then the margins need to be recalculated if
  394. // they were set to auto.
  395. const float clamped_width = Math::Clamp(content_area.x, min_width, max_width);
  396. if (clamped_width != content_area.x)
  397. {
  398. content_area.x = clamped_width;
  399. box.SetContent(content_area);
  400. if (num_auto_margins > 0)
  401. BuildBoxWidth(box, computed, min_width, max_width, containing_block, element, replaced_element, formatting_mode, clamped_width);
  402. }
  403. else
  404. box.SetContent(content_area);
  405. }
  406. void LayoutDetails::BuildBoxHeight(Box& box, const ComputedValues& computed, float min_height, float max_height, float containing_block_height)
  407. {
  408. RMLUI_ZoneScoped;
  409. Vector2f content_area = box.GetSize();
  410. // Determine if the element has automatic margins.
  411. bool margins_auto[2];
  412. int num_auto_margins = 0;
  413. for (int i = 0; i < 2; ++i)
  414. {
  415. const Style::Margin margin_value = (i == 0 ? computed.margin_top() : computed.margin_bottom());
  416. if (margin_value.type == Style::Margin::Auto)
  417. {
  418. margins_auto[i] = true;
  419. num_auto_margins++;
  420. box.SetEdge(BoxArea::Margin, i == 0 ? BoxEdge::Top : BoxEdge::Bottom, 0);
  421. }
  422. else
  423. {
  424. margins_auto[i] = false;
  425. box.SetEdge(BoxArea::Margin, i == 0 ? BoxEdge::Top : BoxEdge::Bottom, ResolveValue(margin_value, containing_block_height));
  426. }
  427. }
  428. const bool absolutely_positioned = (computed.position() == Style::Position::Absolute || computed.position() == Style::Position::Fixed);
  429. const bool inset_auto = (computed.top().type == Style::Top::Auto || computed.bottom().type == Style::Bottom::Auto);
  430. const bool height_auto = (content_area.y < 0);
  431. auto GetInsetHeight = [&] {
  432. // For absolutely positioned elements (and only those), the 'top' and 'bottom' values are part of the box's height constraint.
  433. if (absolutely_positioned)
  434. return ResolveValue(computed.top(), containing_block_height) + ResolveValue(computed.bottom(), containing_block_height);
  435. return 0.f;
  436. };
  437. // If the height is set to auto, we need to calculate the height.
  438. if (height_auto)
  439. {
  440. // If the height is set to auto for a box in normal flow, the height is set to -1, representing indefinite height.
  441. content_area.y = -1;
  442. // But if we are dealing with an absolutely positioned element we need to consider if the top and bottom
  443. // properties are set, since the height can be affected.
  444. if (absolutely_positioned && !inset_auto)
  445. {
  446. // The height is set to whatever remains of the containing block.
  447. content_area.y =
  448. containing_block_height - (GetInsetHeight() + box.GetSizeAcross(BoxDirection::Vertical, BoxArea::Margin, BoxArea::Padding));
  449. content_area.y = Math::Max(0.0f, content_area.y);
  450. }
  451. }
  452. // Otherwise, the margins that are set to auto will pick up the remaining height of the containing block.
  453. else if (num_auto_margins > 0)
  454. {
  455. const float margin =
  456. (containing_block_height - (GetInsetHeight() + box.GetSizeAcross(BoxDirection::Vertical, BoxArea::Margin))) / float(num_auto_margins);
  457. if (margins_auto[0])
  458. box.SetEdge(BoxArea::Margin, BoxEdge::Top, margin);
  459. if (margins_auto[1])
  460. box.SetEdge(BoxArea::Margin, BoxEdge::Bottom, margin);
  461. }
  462. if (content_area.y >= 0)
  463. {
  464. // Clamp the calculated height; if the height is changed by the clamp, then the margins need to be recalculated if
  465. // they were set to auto.
  466. float clamped_height = Math::Clamp(content_area.y, min_height, max_height);
  467. if (clamped_height != content_area.y)
  468. {
  469. content_area.y = clamped_height;
  470. box.SetContent(content_area);
  471. if (num_auto_margins > 0)
  472. BuildBoxHeight(box, computed, min_height, max_height, containing_block_height);
  473. return;
  474. }
  475. }
  476. box.SetContent(content_area);
  477. }
  478. } // namespace Rml