12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066 |
- /*
- * Copyright (c) 2021-2022, Andreas Kling <kling@serenityos.org>
- * Copyright (c) 2021, Tobias Christiansen <tobyase@serenityos.org>
- *
- * SPDX-License-Identifier: BSD-2-Clause
- */
- #include "InlineFormattingContext.h"
- #include <AK/Function.h>
- #include <AK/QuickSort.h>
- #include <AK/StdLibExtras.h>
- #include <LibWeb/Layout/BlockContainer.h>
- #include <LibWeb/Layout/BlockFormattingContext.h>
- #include <LibWeb/Layout/Box.h>
- #include <LibWeb/Layout/FlexFormattingContext.h>
- #include <LibWeb/Layout/InitialContainingBlock.h>
- #include <LibWeb/Layout/ReplacedBox.h>
- #include <LibWeb/Layout/TextNode.h>
- namespace Web::Layout {
- // NOTE: We use a custom clamping function here instead of AK::clamp(), since the AK version
- // will VERIFY(max >= min) and CSS explicitly allows that (see css-values-4.)
- template<typename T>
- [[nodiscard]] constexpr T css_clamp(T const& value, T const& min, T const& max)
- {
- return ::max(min, ::min(value, max));
- }
- // FIXME: This is a hack helper, remove it when no longer needed.
- static CSS::Size to_css_size(CSS::LengthPercentage const& length_percentage)
- {
- if (length_percentage.is_auto())
- return CSS::Size::make_auto();
- if (length_percentage.is_length())
- return CSS::Size::make_length(length_percentage.length());
- return CSS::Size::make_percentage(length_percentage.percentage());
- }
- CSSPixels FlexFormattingContext::get_pixel_width(Box const& box, Optional<CSS::Size> const& size) const
- {
- if (!size.has_value())
- return 0;
- auto inner_width = CSS::Length::make_px(containing_block_width_for(box));
- float border_left = box.computed_values().border_left().width;
- float border_right = box.computed_values().border_right().width;
- float padding_left = box.computed_values().padding().left().resolved(box, inner_width).to_px(box);
- float padding_right = box.computed_values().padding().right().resolved(box, inner_width).to_px(box);
- if (box.computed_values().box_sizing() == CSS::BoxSizing::BorderBox) {
- return size->resolved(box, inner_width).to_px(box) - border_left - border_right - padding_left - padding_right;
- }
- return size->resolved(box, inner_width).to_px(box);
- }
- CSSPixels FlexFormattingContext::get_pixel_height(Box const& box, Optional<CSS::Size> const& length_percentage) const
- {
- if (!length_percentage.has_value())
- return 0;
- auto inner_height = CSS::Length::make_px(containing_block_height_for(box));
- float border_top = box.computed_values().border_top().width;
- float border_bottom = box.computed_values().border_bottom().width;
- float padding_top = box.computed_values().padding().top().resolved(box, inner_height).to_px(box);
- float padding_bottom = box.computed_values().padding().bottom().resolved(box, inner_height).to_px(box);
- if (box.computed_values().box_sizing() == CSS::BoxSizing::BorderBox) {
- return length_percentage->resolved(box, inner_height).to_px(box) - border_top - border_bottom - padding_top - padding_bottom;
- }
- return length_percentage->resolved(box, inner_height).to_px(box);
- }
- FlexFormattingContext::FlexFormattingContext(LayoutState& state, Box const& flex_container, FormattingContext* parent)
- : FormattingContext(Type::Flex, state, flex_container, parent)
- , m_flex_container_state(m_state.get_mutable(flex_container))
- , m_flex_direction(flex_container.computed_values().flex_direction())
- {
- }
- FlexFormattingContext::~FlexFormattingContext() = default;
- CSSPixels FlexFormattingContext::automatic_content_height() const
- {
- return m_state.get(flex_container()).content_height();
- }
- void FlexFormattingContext::run(Box const& run_box, LayoutMode, AvailableSpace const& available_content_space)
- {
- VERIFY(&run_box == &flex_container());
- // NOTE: The available space provided by the parent context is basically our *content box*.
- // FFC is currently written in a way that expects that to include padding and border as well,
- // so we pad out the available space here to accommodate that.
- // FIXME: Refactor the necessary parts of FFC so we don't need this hack!
- auto available_width = available_content_space.width;
- if (available_width.is_definite())
- available_width = AvailableSize::make_definite(available_width.to_px() + m_flex_container_state.border_box_left() + m_flex_container_state.border_box_right());
- auto available_height = available_content_space.height;
- if (available_height.is_definite())
- available_height = AvailableSize::make_definite(available_height.to_px() + m_flex_container_state.border_box_top() + m_flex_container_state.border_box_bottom());
- m_available_space_for_flex_container = AxisAgnosticAvailableSpace {
- .main = is_row_layout() ? available_width : available_height,
- .cross = !is_row_layout() ? available_width : available_height,
- .space = { available_width, available_height },
- };
- // This implements https://www.w3.org/TR/css-flexbox-1/#layout-algorithm
- // 1. Generate anonymous flex items
- generate_anonymous_flex_items();
- // 2. Determine the available main and cross space for the flex items
- determine_available_space_for_items(AvailableSpace(available_width, available_height));
- {
- // https://drafts.csswg.org/css-flexbox-1/#definite-sizes
- // 3. If a single-line flex container has a definite cross size,
- // the automatic preferred outer cross size of any stretched flex items is the flex container’s inner cross size
- // (clamped to the flex item’s min and max cross size) and is considered definite.
- if (is_single_line() && has_definite_cross_size(flex_container())) {
- auto flex_container_inner_cross_size = specified_cross_size(flex_container());
- for (auto& item : m_flex_items) {
- if (!flex_item_is_stretched(item))
- continue;
- auto item_min_cross_size = has_cross_min_size(item.box) ? specified_cross_min_size(item.box) : automatic_minimum_size(item);
- auto item_max_cross_size = has_cross_max_size(item.box) ? specified_cross_max_size(item.box) : INFINITY;
- auto item_preferred_outer_cross_size = css_clamp(flex_container_inner_cross_size, item_min_cross_size, item_max_cross_size);
- auto item_inner_cross_size = item_preferred_outer_cross_size - item.margins.cross_before - item.margins.cross_after - item.padding.cross_before - item.padding.cross_after - item.borders.cross_before - item.borders.cross_after;
- set_cross_size(item.box, item_inner_cross_size);
- }
- }
- }
- // 3. Determine the flex base size and hypothetical main size of each item
- for (auto& flex_item : m_flex_items) {
- if (flex_item.box.is_replaced_box()) {
- // FIXME: Get rid of prepare_for_replaced_layout() and make replaced elements figure out their intrinsic size lazily.
- static_cast<ReplacedBox&>(flex_item.box).prepare_for_replaced_layout();
- }
- determine_flex_base_size_and_hypothetical_main_size(flex_item);
- }
- if (available_width.is_intrinsic_sizing_constraint() || available_height.is_intrinsic_sizing_constraint()) {
- // We're computing intrinsic size for the flex container.
- determine_intrinsic_size_of_flex_container();
- // Our caller is only interested in the content-width and content-height results,
- // which have now been set on m_flex_container_state, so there's no need to continue
- // the main layout algorithm after this point.
- return;
- }
- // 4. Determine the main size of the flex container
- determine_main_size_of_flex_container();
- // 5. Collect flex items into flex lines:
- // After this step no additional items are to be added to flex_lines or any of its items!
- collect_flex_items_into_flex_lines();
- // 6. Resolve the flexible lengths
- resolve_flexible_lengths();
- // Cross Size Determination
- // 7. Determine the hypothetical cross size of each item
- for (auto& flex_item : m_flex_items) {
- determine_hypothetical_cross_size_of_item(flex_item, false);
- }
- // 8. Calculate the cross size of each flex line.
- calculate_cross_size_of_each_flex_line();
- // 9. Handle 'align-content: stretch'.
- handle_align_content_stretch();
- // 10. Collapse visibility:collapse items.
- // FIXME: This
- // 11. Determine the used cross size of each flex item.
- determine_used_cross_size_of_each_flex_item();
- // 12. Distribute any remaining free space.
- distribute_any_remaining_free_space();
- // 13. Resolve cross-axis auto margins.
- resolve_cross_axis_auto_margins();
- // 14. Align all flex items along the cross-axis
- align_all_flex_items_along_the_cross_axis();
- // 15. Determine the flex container’s used cross size:
- determine_flex_container_used_cross_size();
- {
- // https://drafts.csswg.org/css-flexbox-1/#definite-sizes
- // 4. Once the cross size of a flex line has been determined,
- // the cross sizes of items in auto-sized flex containers are also considered definite for the purpose of layout.
- auto const& flex_container_computed_cross_size = is_row_layout() ? flex_container().computed_values().height() : flex_container().computed_values().width();
- if (flex_container_computed_cross_size.is_auto()) {
- for (auto& item : m_flex_items) {
- set_cross_size(item.box, item.cross_size);
- }
- }
- }
- {
- // NOTE: We re-resolve cross sizes here, now that we can resolve percentages.
- // 7. Determine the hypothetical cross size of each item
- for (auto& flex_item : m_flex_items) {
- determine_hypothetical_cross_size_of_item(flex_item, true);
- }
- // 11. Determine the used cross size of each flex item.
- determine_used_cross_size_of_each_flex_item();
- }
- // 16. Align all flex lines (per align-content)
- align_all_flex_lines();
- // AD-HOC: Layout the inside of all flex items.
- copy_dimensions_from_flex_items_to_boxes();
- for (auto& flex_item : m_flex_items) {
- auto& box_state = m_state.get(flex_item.box);
- if (auto independent_formatting_context = layout_inside(flex_item.box, LayoutMode::Normal, box_state.available_inner_space_or_constraints_from(m_available_space_for_flex_container->space)))
- independent_formatting_context->parent_context_did_dimension_child_root_box();
- }
- // FIXME: We run the "copy dimensions" step *again* here, in order to override any sizes
- // assigned to the flex item by the "layout inside" step above. This is definitely not
- // part of the spec, and simply covering up the fact that our inside layout currently
- // mutates the height of BFC roots.
- copy_dimensions_from_flex_items_to_boxes();
- }
- void FlexFormattingContext::parent_context_did_dimension_child_root_box()
- {
- flex_container().for_each_child_of_type<Box>([&](Layout::Box& box) {
- if (box.is_absolutely_positioned()) {
- auto& cb_state = m_state.get(*box.containing_block());
- auto available_width = AvailableSize::make_definite(cb_state.content_width() + cb_state.padding_left + cb_state.padding_right);
- auto available_height = AvailableSize::make_definite(cb_state.content_height() + cb_state.padding_top + cb_state.padding_bottom);
- layout_absolutely_positioned_element(box, AvailableSpace(available_width, available_height));
- }
- });
- }
- void FlexFormattingContext::populate_specified_margins(FlexItem& item, CSS::FlexDirection flex_direction) const
- {
- auto width_of_containing_block = m_state.get(*item.box.containing_block()).content_width();
- auto width_of_containing_block_as_length = CSS::Length::make_px(width_of_containing_block);
- // FIXME: This should also take reverse-ness into account
- if (flex_direction == CSS::FlexDirection::Row || flex_direction == CSS::FlexDirection::RowReverse) {
- item.borders.main_before = item.box.computed_values().border_left().width;
- item.borders.main_after = item.box.computed_values().border_right().width;
- item.borders.cross_before = item.box.computed_values().border_top().width;
- item.borders.cross_after = item.box.computed_values().border_bottom().width;
- item.padding.main_before = item.box.computed_values().padding().left().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.padding.main_after = item.box.computed_values().padding().right().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.padding.cross_before = item.box.computed_values().padding().top().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.padding.cross_after = item.box.computed_values().padding().bottom().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.main_before = item.box.computed_values().margin().left().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.main_after = item.box.computed_values().margin().right().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.cross_before = item.box.computed_values().margin().top().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.cross_after = item.box.computed_values().margin().bottom().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.main_before_is_auto = item.box.computed_values().margin().left().is_auto();
- item.margins.main_after_is_auto = item.box.computed_values().margin().right().is_auto();
- item.margins.cross_before_is_auto = item.box.computed_values().margin().top().is_auto();
- item.margins.cross_after_is_auto = item.box.computed_values().margin().bottom().is_auto();
- } else {
- item.borders.main_before = item.box.computed_values().border_top().width;
- item.borders.main_after = item.box.computed_values().border_bottom().width;
- item.borders.cross_before = item.box.computed_values().border_left().width;
- item.borders.cross_after = item.box.computed_values().border_right().width;
- item.padding.main_before = item.box.computed_values().padding().top().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.padding.main_after = item.box.computed_values().padding().bottom().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.padding.cross_before = item.box.computed_values().padding().left().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.padding.cross_after = item.box.computed_values().padding().right().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.main_before = item.box.computed_values().margin().top().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.main_after = item.box.computed_values().margin().bottom().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.cross_before = item.box.computed_values().margin().left().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.cross_after = item.box.computed_values().margin().right().resolved(item.box, width_of_containing_block_as_length).to_px(item.box);
- item.margins.main_before_is_auto = item.box.computed_values().margin().top().is_auto();
- item.margins.main_after_is_auto = item.box.computed_values().margin().bottom().is_auto();
- item.margins.cross_before_is_auto = item.box.computed_values().margin().left().is_auto();
- item.margins.cross_after_is_auto = item.box.computed_values().margin().right().is_auto();
- }
- };
- // https://www.w3.org/TR/css-flexbox-1/#flex-items
- void FlexFormattingContext::generate_anonymous_flex_items()
- {
- // More like, sift through the already generated items.
- // After this step no items are to be added or removed from flex_items!
- // It holds every item we need to consider and there should be nothing in the following
- // calculations that could change that.
- // This is particularly important since we take references to the items stored in flex_items
- // later, whose addresses won't be stable if we added or removed any items.
- HashMap<int, Vector<FlexItem>> order_item_bucket;
- flex_container().for_each_child_of_type<Box>([&](Box& child_box) {
- if (can_skip_is_anonymous_text_run(child_box))
- return IterationDecision::Continue;
- // Skip any "out-of-flow" children
- if (child_box.is_out_of_flow(*this))
- return IterationDecision::Continue;
- child_box.set_flex_item(true);
- FlexItem flex_item = { child_box };
- populate_specified_margins(flex_item, m_flex_direction);
- auto& order_bucket = order_item_bucket.ensure(child_box.computed_values().order());
- order_bucket.append(move(flex_item));
- return IterationDecision::Continue;
- });
- auto keys = order_item_bucket.keys();
- if (is_direction_reverse()) {
- quick_sort(keys, [](auto& a, auto& b) { return a > b; });
- } else {
- quick_sort(keys, [](auto& a, auto& b) { return a < b; });
- }
- for (auto key : keys) {
- auto order_bucket = order_item_bucket.get(key);
- if (order_bucket.has_value()) {
- auto items = order_bucket.value();
- if (is_direction_reverse()) {
- for (auto flex_item : items.in_reverse()) {
- m_flex_items.append(move(flex_item));
- }
- } else {
- for (auto flex_item : items) {
- m_flex_items.append(move(flex_item));
- }
- }
- }
- }
- }
- bool FlexFormattingContext::has_definite_main_size(Box const& box) const
- {
- auto const& used_values = m_state.get(box);
- return is_row_layout() ? used_values.has_definite_width() : used_values.has_definite_height();
- }
- CSSPixels FlexFormattingContext::specified_main_size(Box const& box) const
- {
- auto const& box_state = m_state.get(box);
- return is_row_layout() ? box_state.content_width() : box_state.content_height();
- }
- CSSPixels FlexFormattingContext::specified_cross_size(Box const& box) const
- {
- auto const& box_state = m_state.get(box);
- return is_row_layout() ? box_state.content_height() : box_state.content_width();
- }
- CSSPixels FlexFormattingContext::resolved_definite_cross_size(FlexItem const& item) const
- {
- return !is_row_layout() ? m_state.resolved_definite_width(item.box) : m_state.resolved_definite_height(item.box);
- }
- CSSPixels FlexFormattingContext::resolved_definite_main_size(FlexItem const& item) const
- {
- return is_row_layout() ? m_state.resolved_definite_width(item.box) : m_state.resolved_definite_height(item.box);
- }
- bool FlexFormattingContext::has_main_min_size(Box const& box) const
- {
- auto const& value = is_row_layout() ? box.computed_values().min_width() : box.computed_values().min_height();
- return !value.is_auto();
- }
- bool FlexFormattingContext::has_cross_min_size(Box const& box) const
- {
- auto const& value = is_row_layout() ? box.computed_values().min_height() : box.computed_values().min_width();
- return !value.is_auto();
- }
- bool FlexFormattingContext::has_definite_cross_size(Box const& box) const
- {
- auto const& used_values = m_state.get(box);
- return is_row_layout() ? used_values.has_definite_height() : used_values.has_definite_width();
- }
- CSSPixels FlexFormattingContext::specified_main_min_size(Box const& box) const
- {
- return is_row_layout()
- ? get_pixel_width(box, box.computed_values().min_width())
- : get_pixel_height(box, box.computed_values().min_height());
- }
- CSSPixels FlexFormattingContext::specified_cross_min_size(Box const& box) const
- {
- return is_row_layout()
- ? get_pixel_height(box, box.computed_values().min_height())
- : get_pixel_width(box, box.computed_values().min_width());
- }
- bool FlexFormattingContext::has_main_max_size(Box const& box) const
- {
- auto const& value = is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
- return !value.is_none();
- }
- bool FlexFormattingContext::has_cross_max_size(Box const& box) const
- {
- auto const& value = !is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
- return !value.is_none();
- }
- CSSPixels FlexFormattingContext::specified_main_max_size(Box const& box) const
- {
- return is_row_layout()
- ? get_pixel_width(box, box.computed_values().max_width())
- : get_pixel_height(box, box.computed_values().max_height());
- }
- CSSPixels FlexFormattingContext::specified_cross_max_size(Box const& box) const
- {
- return is_row_layout()
- ? get_pixel_height(box, box.computed_values().max_height())
- : get_pixel_width(box, box.computed_values().max_width());
- }
- bool FlexFormattingContext::is_cross_auto(Box const& box) const
- {
- auto& cross_length = is_row_layout() ? box.computed_values().height() : box.computed_values().width();
- return cross_length.is_auto();
- }
- void FlexFormattingContext::set_main_size(Box const& box, CSSPixels size)
- {
- if (is_row_layout())
- m_state.get_mutable(box).set_content_width(size);
- else
- m_state.get_mutable(box).set_content_height(size);
- }
- void FlexFormattingContext::set_cross_size(Box const& box, CSSPixels size)
- {
- if (is_row_layout())
- m_state.get_mutable(box).set_content_height(size);
- else
- m_state.get_mutable(box).set_content_width(size);
- }
- void FlexFormattingContext::set_offset(Box const& box, CSSPixels main_offset, CSSPixels cross_offset)
- {
- if (is_row_layout())
- m_state.get_mutable(box).offset = CSSPixelPoint { main_offset, cross_offset };
- else
- m_state.get_mutable(box).offset = CSSPixelPoint { cross_offset, main_offset };
- }
- void FlexFormattingContext::set_main_axis_first_margin(FlexItem& item, CSSPixels margin)
- {
- item.margins.main_before = margin;
- if (is_row_layout())
- m_state.get_mutable(item.box).margin_left = margin;
- else
- m_state.get_mutable(item.box).margin_top = margin;
- }
- void FlexFormattingContext::set_main_axis_second_margin(FlexItem& item, CSSPixels margin)
- {
- item.margins.main_after = margin;
- if (is_row_layout())
- m_state.get_mutable(item.box).margin_right = margin;
- else
- m_state.get_mutable(item.box).margin_bottom = margin;
- }
- // https://drafts.csswg.org/css-flexbox-1/#algo-available
- void FlexFormattingContext::determine_available_space_for_items(AvailableSpace const& available_space)
- {
- // For each dimension, if that dimension of the flex container’s content box is a definite size, use that;
- // if that dimension of the flex container is being sized under a min or max-content constraint, the available space in that dimension is that constraint;
- // otherwise, subtract the flex container’s margin, border, and padding from the space available to the flex container in that dimension and use that value.
- // This might result in an infinite value.
- Optional<AvailableSize> available_width_for_items;
- if (m_flex_container_state.has_definite_width()) {
- available_width_for_items = AvailableSize::make_definite(m_state.resolved_definite_width(flex_container()));
- } else {
- if (available_space.width.is_intrinsic_sizing_constraint()) {
- available_width_for_items = available_space.width;
- } else {
- if (available_space.width.is_definite()) {
- auto remaining = available_space.width.to_px()
- - m_flex_container_state.margin_left
- - m_flex_container_state.margin_right
- - m_flex_container_state.border_left
- - m_flex_container_state.padding_right
- - m_flex_container_state.padding_left
- - m_flex_container_state.padding_right;
- available_width_for_items = AvailableSize::make_definite(remaining);
- } else {
- available_width_for_items = AvailableSize::make_indefinite();
- }
- }
- }
- Optional<AvailableSize> available_height_for_items;
- if (m_flex_container_state.has_definite_height()) {
- available_height_for_items = AvailableSize::make_definite(m_state.resolved_definite_height(flex_container()));
- } else {
- if (available_space.height.is_intrinsic_sizing_constraint()) {
- available_height_for_items = available_space.height;
- } else {
- if (available_space.height.is_definite()) {
- auto remaining = available_space.height.to_px()
- - m_flex_container_state.margin_top
- - m_flex_container_state.margin_bottom
- - m_flex_container_state.border_top
- - m_flex_container_state.padding_bottom
- - m_flex_container_state.padding_top
- - m_flex_container_state.padding_bottom;
- available_height_for_items = AvailableSize::make_definite(remaining);
- } else {
- available_height_for_items = AvailableSize::make_indefinite();
- }
- }
- }
- if (is_row_layout()) {
- m_available_space_for_items = AxisAgnosticAvailableSpace {
- .main = *available_width_for_items,
- .cross = *available_height_for_items,
- .space = { *available_width_for_items, *available_height_for_items },
- };
- } else {
- m_available_space_for_items = AxisAgnosticAvailableSpace {
- .main = *available_height_for_items,
- .cross = *available_width_for_items,
- .space = { *available_width_for_items, *available_height_for_items },
- };
- }
- }
- CSSPixels FlexFormattingContext::calculate_indefinite_main_size(FlexItem const& item)
- {
- VERIFY(!has_definite_main_size(item.box));
- // Otherwise, size the item into the available space using its used flex basis in place of its main size,
- // treating a value of content as max-content.
- if (item.used_flex_basis.type == CSS::FlexBasis::Content)
- return calculate_max_content_main_size(item);
- // If a cross size is needed to determine the main size
- // (e.g. when the flex item’s main size is in its block axis, or when it has a preferred aspect ratio)
- // and the flex item’s cross size is auto and not definite,
- // in this calculation use fit-content as the flex item’s cross size.
- // The flex base size is the item’s resulting main size.
- bool main_size_is_in_block_axis = !is_row_layout();
- // FIXME: Figure out if we have a preferred aspect ratio.
- bool has_preferred_aspect_ratio = false;
- bool cross_size_needed_to_determine_main_size = main_size_is_in_block_axis || has_preferred_aspect_ratio;
- if (cross_size_needed_to_determine_main_size) {
- // Figure out the fit-content cross size, then layout with that and see what height comes out of it.
- CSSPixels fit_content_cross_size = calculate_fit_content_cross_size(item);
- LayoutState throwaway_state(&m_state);
- auto& box_state = throwaway_state.get_mutable(item.box);
- // Item has definite cross size, layout with that as the used cross size.
- auto independent_formatting_context = create_independent_formatting_context_if_needed(throwaway_state, item.box);
- // NOTE: Flex items should always create an independent formatting context!
- VERIFY(independent_formatting_context);
- box_state.set_content_width(fit_content_cross_size);
- independent_formatting_context->run(item.box, LayoutMode::Normal, m_available_space_for_items->space);
- return independent_formatting_context->automatic_content_height();
- }
- return calculate_fit_content_main_size(item);
- }
- // https://drafts.csswg.org/css-flexbox-1/#propdef-flex-basis
- CSS::FlexBasisData FlexFormattingContext::used_flex_basis_for_item(FlexItem const& item) const
- {
- auto flex_basis = item.box.computed_values().flex_basis();
- if (flex_basis.type == CSS::FlexBasis::Auto) {
- // https://drafts.csswg.org/css-flexbox-1/#valdef-flex-basis-auto
- // When specified on a flex item, the auto keyword retrieves the value of the main size property as the used flex-basis.
- // If that value is itself auto, then the used value is content.
- auto const& main_size = is_row_layout() ? item.box.computed_values().width() : item.box.computed_values().height();
- if (main_size.is_auto()) {
- flex_basis.type = CSS::FlexBasis::Content;
- } else {
- flex_basis.type = CSS::FlexBasis::LengthPercentage;
- if (main_size.is_length()) {
- flex_basis.length_percentage = main_size.length();
- } else if (main_size.is_percentage()) {
- flex_basis.length_percentage = main_size.percentage();
- } else {
- // FIXME: Support other size values!
- dbgln("FIXME: Unsupported main size for flex-basis!");
- flex_basis.type = CSS::FlexBasis::Content;
- }
- }
- }
- return flex_basis;
- }
- // https://www.w3.org/TR/css-flexbox-1/#algo-main-item
- void FlexFormattingContext::determine_flex_base_size_and_hypothetical_main_size(FlexItem& flex_item)
- {
- auto& child_box = flex_item.box;
- flex_item.flex_base_size = [&] {
- flex_item.used_flex_basis = used_flex_basis_for_item(flex_item);
- flex_item.used_flex_basis_is_definite = [&](CSS::FlexBasisData const& flex_basis) -> bool {
- if (flex_basis.type != CSS::FlexBasis::LengthPercentage)
- return false;
- if (flex_basis.length_percentage->is_auto())
- return false;
- if (flex_basis.length_percentage->is_length())
- return true;
- if (flex_basis.length_percentage->is_calculated()) {
- // FIXME: Handle calc() in used flex basis.
- return false;
- }
- if (is_row_layout())
- return m_flex_container_state.has_definite_width();
- return m_flex_container_state.has_definite_height();
- }(flex_item.used_flex_basis);
- // A. If the item has a definite used flex basis, that’s the flex base size.
- if (flex_item.used_flex_basis_is_definite) {
- if (is_row_layout())
- return get_pixel_width(child_box, to_css_size(flex_item.used_flex_basis.length_percentage.value()));
- return get_pixel_height(child_box, to_css_size(flex_item.used_flex_basis.length_percentage.value()));
- }
- // B. If the flex item has ...
- // - an intrinsic aspect ratio,
- // - a used flex basis of content, and
- // - a definite cross size,
- if (flex_item.box.has_intrinsic_aspect_ratio()
- && flex_item.used_flex_basis.type == CSS::FlexBasis::Content
- && has_definite_cross_size(flex_item.box)) {
- // flex_base_size is calculated from definite cross size and intrinsic aspect ratio
- return resolved_definite_cross_size(flex_item) * flex_item.box.intrinsic_aspect_ratio().value();
- }
- // C. If the used flex basis is content or depends on its available space,
- // and the flex container is being sized under a min-content or max-content constraint
- // (e.g. when performing automatic table layout [CSS21]), size the item under that constraint.
- // The flex base size is the item’s resulting main size.
- if (flex_item.used_flex_basis.type == CSS::FlexBasis::Content && m_available_space_for_items->main.is_intrinsic_sizing_constraint()) {
- if (m_available_space_for_items->main.is_min_content())
- return calculate_min_content_main_size(flex_item);
- return calculate_max_content_main_size(flex_item);
- }
- // D. Otherwise, if the used flex basis is content or depends on its available space,
- // the available main size is infinite, and the flex item’s inline axis is parallel to the main axis,
- // lay the item out using the rules for a box in an orthogonal flow [CSS3-WRITING-MODES].
- // The flex base size is the item’s max-content main size.
- if (flex_item.used_flex_basis.type == CSS::FlexBasis::Content
- // FIXME: && main_size is infinite && inline axis is parallel to the main axis
- && false && false) {
- TODO();
- // Use rules for a flex_container in orthogonal flow
- }
- // E. Otherwise, size the item into the available space using its used flex basis in place of its main size,
- // treating a value of content as max-content. If a cross size is needed to determine the main size
- // (e.g. when the flex item’s main size is in its block axis) and the flex item’s cross size is auto and not definite,
- // in this calculation use fit-content as the flex item’s cross size.
- // The flex base size is the item’s resulting main size.
- // FIXME: This is probably too naive.
- // FIXME: Care about FlexBasis::Auto
- if (has_definite_main_size(child_box))
- return resolved_definite_main_size(flex_item);
- return calculate_indefinite_main_size(flex_item);
- }();
- // The hypothetical main size is the item’s flex base size clamped according to its used min and max main sizes (and flooring the content box size at zero).
- auto clamp_min = has_main_min_size(child_box) ? specified_main_min_size(child_box) : automatic_minimum_size(flex_item);
- auto clamp_max = has_main_max_size(child_box) ? specified_main_max_size(child_box) : NumericLimits<float>::max();
- flex_item.hypothetical_main_size = max(CSSPixels(0.0f), css_clamp(flex_item.flex_base_size, clamp_min, clamp_max));
- // NOTE: At this point, we set the hypothetical main size as the flex item's *temporary* main size.
- // The size may change again when we resolve flexible lengths, but this is necessary in order for
- // descendants of this flex item to resolve percentage sizes against something.
- //
- // The spec just barely hand-waves about this, but it seems to *roughly* match what other engines do.
- // See "Note" section here: https://drafts.csswg.org/css-flexbox-1/#definite-sizes
- if (is_row_layout())
- m_state.get_mutable(flex_item.box).set_temporary_content_width(flex_item.hypothetical_main_size);
- else
- m_state.get_mutable(flex_item.box).set_temporary_content_height(flex_item.hypothetical_main_size);
- }
- // https://drafts.csswg.org/css-flexbox-1/#min-size-auto
- CSSPixels FlexFormattingContext::automatic_minimum_size(FlexItem const& item) const
- {
- // FIXME: Deal with scroll containers.
- return content_based_minimum_size(item);
- }
- // https://drafts.csswg.org/css-flexbox-1/#specified-size-suggestion
- Optional<CSSPixels> FlexFormattingContext::specified_size_suggestion(FlexItem const& item) const
- {
- // If the item’s preferred main size is definite and not automatic,
- // then the specified size suggestion is that size. It is otherwise undefined.
- if (has_definite_main_size(item.box))
- return specified_main_size(item.box);
- return {};
- }
- // https://drafts.csswg.org/css-flexbox-1/#content-size-suggestion
- CSSPixels FlexFormattingContext::content_size_suggestion(FlexItem const& item) const
- {
- // FIXME: Apply clamps
- return calculate_min_content_main_size(item);
- }
- // https://drafts.csswg.org/css-flexbox-1/#transferred-size-suggestion
- Optional<CSSPixels> FlexFormattingContext::transferred_size_suggestion(FlexItem const& item) const
- {
- // If the item has a preferred aspect ratio and its preferred cross size is definite,
- // then the transferred size suggestion is that size
- // (clamped by its minimum and maximum cross sizes if they are definite), converted through the aspect ratio.
- if (item.box.has_intrinsic_aspect_ratio() && has_definite_cross_size(item.box)) {
- auto aspect_ratio = item.box.intrinsic_aspect_ratio().value();
- // FIXME: Clamp cross size to min/max cross size before this conversion.
- return resolved_definite_cross_size(item) * aspect_ratio;
- }
- // It is otherwise undefined.
- return {};
- }
- // https://drafts.csswg.org/css-flexbox-1/#content-based-minimum-size
- CSSPixels FlexFormattingContext::content_based_minimum_size(FlexItem const& item) const
- {
- auto unclamped_size = [&] {
- // The content-based minimum size of a flex item is the smaller of its specified size suggestion
- // and its content size suggestion if its specified size suggestion exists;
- if (auto specified_size_suggestion = this->specified_size_suggestion(item); specified_size_suggestion.has_value()) {
- return min(specified_size_suggestion.value(), content_size_suggestion(item));
- }
- // otherwise, the smaller of its transferred size suggestion and its content size suggestion
- // if the element is replaced and its transferred size suggestion exists;
- if (item.box.is_replaced_box()) {
- if (auto transferred_size_suggestion = this->transferred_size_suggestion(item); transferred_size_suggestion.has_value()) {
- return min(transferred_size_suggestion.value(), content_size_suggestion(item));
- }
- }
- // otherwise its content size suggestion.
- return content_size_suggestion(item);
- }();
- // In all cases, the size is clamped by the maximum main size if it’s definite.
- if (has_main_max_size(item.box)) {
- return min(unclamped_size, specified_main_max_size(item.box));
- }
- return unclamped_size;
- }
- bool FlexFormattingContext::can_determine_size_of_child() const
- {
- return true;
- }
- void FlexFormattingContext::determine_width_of_child(Box const&, AvailableSpace const&)
- {
- // NOTE: For now, we simply do nothing here. If a child context is calling up to us
- // and asking us to determine its width, we've already done so as part of the
- // flex layout algorithm.
- }
- void FlexFormattingContext::determine_height_of_child(Box const&, AvailableSpace const&)
- {
- // NOTE: For now, we simply do nothing here. If a child context is calling up to us
- // and asking us to determine its height, we've already done so as part of the
- // flex layout algorithm.
- }
- // https://drafts.csswg.org/css-flexbox-1/#algo-main-container
- void FlexFormattingContext::determine_main_size_of_flex_container()
- {
- // Determine the main size of the flex container using the rules of the formatting context in which it participates.
- // NOTE: The automatic block size of a block-level flex container is its max-content size.
- // FIXME: The code below doesn't know how to size absolutely positioned flex containers at all.
- // We just leave it alone for now and let the parent context deal with it.
- if (flex_container().is_absolutely_positioned())
- return;
- // FIXME: Once all parent contexts now how to size a given child, we can remove
- // `can_determine_size_of_child()`.
- if (parent()->can_determine_size_of_child()) {
- if (is_row_layout()) {
- parent()->determine_width_of_child(flex_container(), m_available_space_for_flex_container->space);
- } else {
- parent()->determine_height_of_child(flex_container(), m_available_space_for_flex_container->space);
- }
- return;
- }
- if (is_row_layout()) {
- if (!flex_container().is_out_of_flow(*parent()) && m_state.get(*flex_container().containing_block()).has_definite_width()) {
- set_main_size(flex_container(), calculate_stretch_fit_width(flex_container(), m_available_space_for_flex_container->space.width));
- } else {
- set_main_size(flex_container(), calculate_max_content_width(flex_container()));
- }
- } else {
- if (!has_definite_main_size(flex_container()))
- set_main_size(flex_container(), calculate_max_content_height(flex_container(), m_available_space_for_flex_container->space.width));
- }
- }
- // https://www.w3.org/TR/css-flexbox-1/#algo-line-break
- void FlexFormattingContext::collect_flex_items_into_flex_lines()
- {
- // FIXME: Also support wrap-reverse
- // If the flex container is single-line, collect all the flex items into a single flex line.
- if (is_single_line()) {
- FlexLine line;
- for (auto& flex_item : m_flex_items) {
- line.items.append(&flex_item);
- }
- m_flex_lines.append(move(line));
- return;
- }
- // Otherwise, starting from the first uncollected item, collect consecutive items one by one
- // until the first time that the next collected item would not fit into the flex container’s inner main size
- // (or until a forced break is encountered, see §10 Fragmenting Flex Layout).
- // If the very first uncollected item wouldn't fit, collect just it into the line.
- // For this step, the size of a flex item is its outer hypothetical main size. (Note: This can be negative.)
- // Repeat until all flex items have been collected into flex lines.
- FlexLine line;
- CSSPixels line_main_size = 0;
- for (auto& flex_item : m_flex_items) {
- auto outer_hypothetical_main_size = flex_item.hypothetical_main_size + flex_item.margins.main_before + flex_item.margins.main_after + flex_item.borders.main_before + flex_item.borders.main_after + flex_item.padding.main_before + flex_item.padding.main_after;
- if (!line.items.is_empty() && (line_main_size + outer_hypothetical_main_size) > specified_main_size(flex_container())) {
- m_flex_lines.append(move(line));
- line = {};
- line_main_size = 0;
- }
- line.items.append(&flex_item);
- line_main_size += outer_hypothetical_main_size;
- }
- m_flex_lines.append(move(line));
- }
- // https://www.w3.org/TR/css-flexbox-1/#resolve-flexible-lengths
- void FlexFormattingContext::resolve_flexible_lengths()
- {
- enum FlexFactor {
- FlexGrowFactor,
- FlexShrinkFactor
- };
- FlexFactor used_flex_factor;
- // 6.1. Determine used flex factor
- for (auto& flex_line : m_flex_lines) {
- size_t number_of_unfrozen_items_on_line = flex_line.items.size();
- CSSPixels sum_of_hypothetical_main_sizes = 0;
- for (auto& flex_item : flex_line.items) {
- sum_of_hypothetical_main_sizes += (flex_item->hypothetical_main_size + flex_item->margins.main_before + flex_item->margins.main_after + flex_item->borders.main_before + flex_item->borders.main_after + flex_item->padding.main_before + flex_item->padding.main_after);
- }
- if (sum_of_hypothetical_main_sizes < specified_main_size(flex_container()))
- used_flex_factor = FlexFactor::FlexGrowFactor;
- else
- used_flex_factor = FlexFactor::FlexShrinkFactor;
- for (auto& flex_item : flex_line.items) {
- if (used_flex_factor == FlexFactor::FlexGrowFactor)
- flex_item->flex_factor = flex_item->box.computed_values().flex_grow();
- else if (used_flex_factor == FlexFactor::FlexShrinkFactor)
- flex_item->flex_factor = flex_item->box.computed_values().flex_shrink();
- }
- // 6.2. Size inflexible items
- auto freeze_item_setting_target_main_size_to_hypothetical_main_size = [&number_of_unfrozen_items_on_line](FlexItem& item) {
- item.target_main_size = item.hypothetical_main_size;
- number_of_unfrozen_items_on_line--;
- item.frozen = true;
- };
- for (auto& flex_item : flex_line.items) {
- if (flex_item->flex_factor.has_value() && flex_item->flex_factor.value() == 0) {
- freeze_item_setting_target_main_size_to_hypothetical_main_size(*flex_item);
- } else if (used_flex_factor == FlexFactor::FlexGrowFactor) {
- // FIXME: Spec doesn't include the == case, but we take a too basic approach to calculating the values used so this is appropriate
- if (flex_item->flex_base_size > flex_item->hypothetical_main_size) {
- freeze_item_setting_target_main_size_to_hypothetical_main_size(*flex_item);
- }
- } else if (used_flex_factor == FlexFactor::FlexShrinkFactor) {
- if (flex_item->flex_base_size < flex_item->hypothetical_main_size) {
- freeze_item_setting_target_main_size_to_hypothetical_main_size(*flex_item);
- }
- }
- }
- // 6.3. Calculate initial free space
- auto calculate_free_space = [&]() {
- CSSPixels sum_of_items_on_line = 0;
- for (auto& flex_item : flex_line.items) {
- if (flex_item->frozen)
- sum_of_items_on_line += flex_item->target_main_size + flex_item->margins.main_before + flex_item->margins.main_after + flex_item->borders.main_before + flex_item->borders.main_after + flex_item->padding.main_before + flex_item->padding.main_after;
- else
- sum_of_items_on_line += flex_item->flex_base_size + flex_item->margins.main_before + flex_item->margins.main_after + flex_item->borders.main_before + flex_item->borders.main_after + flex_item->padding.main_before + flex_item->padding.main_after;
- }
- return specified_main_size(flex_container()) - sum_of_items_on_line;
- };
- CSSPixels initial_free_space = calculate_free_space();
- flex_line.remaining_free_space = initial_free_space;
- // 6.4 Loop
- auto for_each_unfrozen_item = [&flex_line](auto callback) {
- for (auto& flex_item : flex_line.items) {
- if (!flex_item->frozen)
- callback(flex_item);
- }
- };
- while (number_of_unfrozen_items_on_line > 0) {
- // b Calculate the remaining free space
- flex_line.remaining_free_space = calculate_free_space();
- float sum_of_unfrozen_flex_items_flex_factors = 0;
- for_each_unfrozen_item([&](FlexItem* item) {
- sum_of_unfrozen_flex_items_flex_factors += item->flex_factor.value_or(1);
- });
- if (sum_of_unfrozen_flex_items_flex_factors < 1) {
- auto intermediate_free_space = initial_free_space * sum_of_unfrozen_flex_items_flex_factors;
- if (abs(intermediate_free_space) < abs(flex_line.remaining_free_space))
- flex_line.remaining_free_space = intermediate_free_space;
- }
- // c Distribute free space proportional to the flex factors
- if (flex_line.remaining_free_space != 0) {
- if (used_flex_factor == FlexFactor::FlexGrowFactor) {
- float sum_of_flex_grow_factor_of_unfrozen_items = sum_of_unfrozen_flex_items_flex_factors;
- for_each_unfrozen_item([&](FlexItem* flex_item) {
- float ratio = flex_item->flex_factor.value_or(1) / sum_of_flex_grow_factor_of_unfrozen_items;
- flex_item->target_main_size = flex_item->flex_base_size + (flex_line.remaining_free_space * ratio);
- });
- } else if (used_flex_factor == FlexFactor::FlexShrinkFactor) {
- float sum_of_scaled_flex_shrink_factor_of_unfrozen_items = 0;
- for_each_unfrozen_item([&](FlexItem* flex_item) {
- flex_item->scaled_flex_shrink_factor = flex_item->flex_factor.value_or(1) * flex_item->flex_base_size.value();
- sum_of_scaled_flex_shrink_factor_of_unfrozen_items += flex_item->scaled_flex_shrink_factor;
- });
- for_each_unfrozen_item([&](FlexItem* flex_item) {
- float ratio = 1.0f;
- if (sum_of_scaled_flex_shrink_factor_of_unfrozen_items != 0.0f)
- ratio = flex_item->scaled_flex_shrink_factor / sum_of_scaled_flex_shrink_factor_of_unfrozen_items;
- flex_item->target_main_size = flex_item->flex_base_size - (abs(flex_line.remaining_free_space) * ratio);
- });
- }
- } else {
- // This isn't spec but makes sense.
- for_each_unfrozen_item([&](FlexItem* flex_item) {
- flex_item->target_main_size = flex_item->flex_base_size;
- });
- }
- // d Fix min/max violations.
- CSSPixels adjustments = 0.0f;
- for_each_unfrozen_item([&](FlexItem* item) {
- auto min_main = has_main_min_size(item->box)
- ? specified_main_min_size(item->box)
- : automatic_minimum_size(*item);
- auto max_main = has_main_max_size(item->box)
- ? specified_main_max_size(item->box)
- : NumericLimits<float>::max();
- CSSPixels original_target_size = item->target_main_size;
- if (item->target_main_size < min_main) {
- item->target_main_size = min_main;
- item->is_min_violation = true;
- }
- if (item->target_main_size > max_main) {
- item->target_main_size = max_main;
- item->is_max_violation = true;
- }
- CSSPixels delta = item->target_main_size - original_target_size;
- adjustments += delta;
- });
- // e Freeze over-flexed items
- CSSPixels total_violation = adjustments;
- if (total_violation == 0) {
- for_each_unfrozen_item([&](FlexItem* item) {
- --number_of_unfrozen_items_on_line;
- item->frozen = true;
- });
- } else if (total_violation > 0) {
- for_each_unfrozen_item([&](FlexItem* item) {
- if (item->is_min_violation) {
- --number_of_unfrozen_items_on_line;
- item->frozen = true;
- }
- });
- } else if (total_violation < 0) {
- for_each_unfrozen_item([&](FlexItem* item) {
- if (item->is_max_violation) {
- --number_of_unfrozen_items_on_line;
- item->frozen = true;
- }
- });
- }
- }
- // 6.5.
- for (auto& flex_item : flex_line.items) {
- flex_item->main_size = flex_item->target_main_size;
- set_main_size(flex_item->box, flex_item->main_size);
- }
- flex_line.remaining_free_space = calculate_free_space();
- }
- }
- // https://drafts.csswg.org/css-flexbox-1/#algo-cross-item
- void FlexFormattingContext::determine_hypothetical_cross_size_of_item(FlexItem& item, bool resolve_percentage_min_max_sizes)
- {
- // Determine the hypothetical cross size of each item by performing layout
- // as if it were an in-flow block-level box with the used main size
- // and the given available space, treating auto as fit-content.
- auto const& computed_min_size = this->computed_cross_min_size(item.box);
- auto const& computed_max_size = this->computed_cross_max_size(item.box);
- auto clamp_min = (!computed_min_size.is_auto() && (resolve_percentage_min_max_sizes || !computed_min_size.contains_percentage())) ? specified_cross_min_size(item.box) : 0;
- auto clamp_max = (!computed_max_size.is_none() && (resolve_percentage_min_max_sizes || !computed_max_size.contains_percentage())) ? specified_cross_max_size(item.box) : NumericLimits<float>::max();
- // If we have a definite cross size, this is easy! No need to perform layout, we can just use it as-is.
- if (has_definite_cross_size(item.box)) {
- // To avoid subtracting padding and border twice for `box-sizing: border-box` only min and max clamp should happen on a second pass
- if (resolve_percentage_min_max_sizes) {
- item.hypothetical_cross_size = css_clamp(item.hypothetical_cross_size, clamp_min, clamp_max);
- return;
- }
- auto cross_size = [&]() {
- if (item.box.computed_values().box_sizing() == CSS::BoxSizing::BorderBox) {
- return max(CSSPixels(0.0f), resolved_definite_cross_size(item) - item.padding.cross_before - item.padding.cross_after - item.borders.cross_before - item.borders.cross_after);
- }
- return resolved_definite_cross_size(item);
- }();
- item.hypothetical_cross_size = css_clamp(cross_size, clamp_min, clamp_max);
- return;
- }
- if (computed_cross_size(item.box).is_auto()) {
- // Item has automatic cross size, layout with "fit-content"
- item.hypothetical_cross_size = css_clamp(calculate_fit_content_cross_size(item), clamp_min, clamp_max);
- return;
- }
- // For indefinite cross sizes, we perform a throwaway layout and then measure it.
- LayoutState throwaway_state(&m_state);
- auto& containing_block_state = throwaway_state.get_mutable(flex_container());
- if (is_row_layout()) {
- containing_block_state.set_content_width(item.main_size);
- } else {
- containing_block_state.set_content_height(item.main_size);
- }
- auto& box_state = throwaway_state.get_mutable(item.box);
- // Item has definite main size, layout with that as the used main size.
- auto independent_formatting_context = create_independent_formatting_context_if_needed(throwaway_state, item.box);
- // NOTE: Flex items should always create an independent formatting context!
- VERIFY(independent_formatting_context);
- independent_formatting_context->run(item.box, LayoutMode::Normal, m_available_space_for_items->space);
- auto automatic_cross_size = is_row_layout() ? independent_formatting_context->automatic_content_height()
- : box_state.content_width();
- item.hypothetical_cross_size = css_clamp(automatic_cross_size, clamp_min, clamp_max);
- }
- // https://www.w3.org/TR/css-flexbox-1/#algo-cross-line
- void FlexFormattingContext::calculate_cross_size_of_each_flex_line()
- {
- // If the flex container is single-line and has a definite cross size, the cross size of the flex line is the flex container’s inner cross size.
- if (is_single_line() && has_definite_cross_size(flex_container())) {
- m_flex_lines[0].cross_size = specified_cross_size(flex_container());
- return;
- }
- // Otherwise, for each flex line:
- for (auto& flex_line : m_flex_lines) {
- // FIXME: 1. Collect all the flex items whose inline-axis is parallel to the main-axis, whose align-self is baseline,
- // and whose cross-axis margins are both non-auto. Find the largest of the distances between each item’s baseline
- // and its hypothetical outer cross-start edge, and the largest of the distances between each item’s baseline
- // and its hypothetical outer cross-end edge, and sum these two values.
- // 2. Among all the items not collected by the previous step, find the largest outer hypothetical cross size.
- CSSPixels largest_hypothetical_cross_size = 0;
- for (auto& flex_item : flex_line.items) {
- if (largest_hypothetical_cross_size < flex_item->hypothetical_cross_size_with_margins())
- largest_hypothetical_cross_size = flex_item->hypothetical_cross_size_with_margins();
- }
- // 3. The used cross-size of the flex line is the largest of the numbers found in the previous two steps and zero.
- flex_line.cross_size = max(CSSPixels(0.0f), largest_hypothetical_cross_size);
- }
- // If the flex container is single-line, then clamp the line’s cross-size to be within the container’s computed min and max cross sizes.
- // Note that if CSS 2.1’s definition of min/max-width/height applied more generally, this behavior would fall out automatically.
- if (is_single_line()) {
- auto const& computed_min_size = this->computed_cross_min_size(flex_container());
- auto const& computed_max_size = this->computed_cross_max_size(flex_container());
- auto cross_min_size = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_cross_min_size(flex_container()) : 0;
- auto cross_max_size = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_cross_max_size(flex_container()) : INFINITY;
- m_flex_lines[0].cross_size = css_clamp(m_flex_lines[0].cross_size, cross_min_size, cross_max_size);
- }
- }
- // https://www.w3.org/TR/css-flexbox-1/#algo-stretch
- void FlexFormattingContext::determine_used_cross_size_of_each_flex_item()
- {
- for (auto& flex_line : m_flex_lines) {
- for (auto& flex_item : flex_line.items) {
- // If a flex item has align-self: stretch, its computed cross size property is auto,
- // and neither of its cross-axis margins are auto, the used outer cross size is the used cross size of its flex line,
- // clamped according to the item’s used min and max cross sizes.
- if (alignment_for_item(flex_item->box) == CSS::AlignItems::Stretch
- && is_cross_auto(flex_item->box)
- && !flex_item->margins.cross_before_is_auto
- && !flex_item->margins.cross_after_is_auto) {
- auto unclamped_cross_size = flex_line.cross_size
- - flex_item->margins.cross_before - flex_item->margins.cross_after
- - flex_item->padding.cross_before - flex_item->padding.cross_after
- - flex_item->borders.cross_before - flex_item->borders.cross_after;
- auto const& computed_min_size = computed_cross_min_size(flex_item->box);
- auto const& computed_max_size = computed_cross_max_size(flex_item->box);
- auto cross_min_size = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_cross_min_size(flex_item->box) : 0;
- auto cross_max_size = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_cross_max_size(flex_item->box) : INFINITY;
- flex_item->cross_size = css_clamp(unclamped_cross_size, cross_min_size, cross_max_size);
- } else {
- // Otherwise, the used cross size is the item’s hypothetical cross size.
- flex_item->cross_size = flex_item->hypothetical_cross_size;
- }
- }
- }
- }
- // https://www.w3.org/TR/css-flexbox-1/#algo-main-align
- void FlexFormattingContext::distribute_any_remaining_free_space()
- {
- for (auto& flex_line : m_flex_lines) {
- // 12.1.
- CSSPixels used_main_space = 0;
- size_t auto_margins = 0;
- for (auto& flex_item : flex_line.items) {
- used_main_space += flex_item->main_size;
- if (flex_item->margins.main_before_is_auto)
- ++auto_margins;
- if (flex_item->margins.main_after_is_auto)
- ++auto_margins;
- used_main_space += flex_item->margins.main_before + flex_item->margins.main_after
- + flex_item->borders.main_before + flex_item->borders.main_after
- + flex_item->padding.main_before + flex_item->padding.main_after;
- }
- if (flex_line.remaining_free_space > 0) {
- CSSPixels size_per_auto_margin = flex_line.remaining_free_space / (float)auto_margins;
- for (auto& flex_item : flex_line.items) {
- if (flex_item->margins.main_before_is_auto)
- set_main_axis_first_margin(*flex_item, size_per_auto_margin);
- if (flex_item->margins.main_after_is_auto)
- set_main_axis_second_margin(*flex_item, size_per_auto_margin);
- }
- } else {
- for (auto& flex_item : flex_line.items) {
- if (flex_item->margins.main_before_is_auto)
- set_main_axis_first_margin(*flex_item, 0);
- if (flex_item->margins.main_after_is_auto)
- set_main_axis_second_margin(*flex_item, 0);
- }
- }
- // 12.2.
- CSSPixels space_between_items = 0;
- CSSPixels initial_offset = 0;
- auto number_of_items = flex_line.items.size();
- enum class FlexRegionRenderCursor {
- Left,
- Right
- };
- auto flex_region_render_cursor = FlexRegionRenderCursor::Left;
- bool justification_is_centered = false;
- switch (flex_container().computed_values().justify_content()) {
- case CSS::JustifyContent::Start:
- case CSS::JustifyContent::FlexStart:
- if (is_direction_reverse()) {
- flex_region_render_cursor = FlexRegionRenderCursor::Right;
- initial_offset = specified_main_size(flex_container());
- } else {
- initial_offset = 0;
- }
- break;
- case CSS::JustifyContent::End:
- case CSS::JustifyContent::FlexEnd:
- if (is_direction_reverse()) {
- initial_offset = 0;
- } else {
- flex_region_render_cursor = FlexRegionRenderCursor::Right;
- initial_offset = specified_main_size(flex_container());
- }
- break;
- case CSS::JustifyContent::Center:
- initial_offset = (specified_main_size(flex_container()) - used_main_space) / 2.0f;
- justification_is_centered = true;
- break;
- case CSS::JustifyContent::SpaceBetween:
- space_between_items = flex_line.remaining_free_space / (number_of_items - 1);
- break;
- case CSS::JustifyContent::SpaceAround:
- space_between_items = flex_line.remaining_free_space / number_of_items;
- initial_offset = space_between_items / 2.0f;
- justification_is_centered = true;
- break;
- }
- // For reverse, we use FlexRegionRenderCursor::Right
- // to indicate the cursor offset is the end and render backwards
- // Otherwise the cursor offset is the 'start' of the region or initial offset
- CSSPixels cursor_offset = initial_offset;
- auto place_item = [&](FlexItem& item, bool is_first_item, bool is_last_item) {
- // NOTE: For centered justifications (`center` and `space-around`) we ignore any margin
- // before the first item, and after the last item.
- auto item_margin_before = item.margins.main_before;
- auto item_margin_after = item.margins.main_after;
- if (justification_is_centered) {
- if (is_first_item)
- item_margin_before = 0;
- if (is_last_item)
- item_margin_after = 0;
- }
- auto amount_of_main_size_used = item.main_size
- + item_margin_before
- + item.borders.main_before
- + item.padding.main_before
- + item_margin_after
- + item.borders.main_after
- + item.padding.main_after
- + space_between_items;
- if (is_direction_reverse()) {
- item.main_offset = cursor_offset - item.main_size - item_margin_after - item.borders.main_after - item.padding.main_after;
- cursor_offset -= amount_of_main_size_used;
- } else if (flex_region_render_cursor == FlexRegionRenderCursor::Right) {
- cursor_offset -= amount_of_main_size_used;
- item.main_offset = cursor_offset + item_margin_before + item.borders.main_before + item.padding.main_before;
- } else {
- item.main_offset = cursor_offset + item_margin_before + item.borders.main_before + item.padding.main_before;
- cursor_offset += amount_of_main_size_used;
- }
- };
- if (is_direction_reverse() || flex_region_render_cursor == FlexRegionRenderCursor::Right) {
- for (ssize_t i = flex_line.items.size() - 1; i >= 0; --i) {
- auto& item = flex_line.items[i];
- place_item(*item, i == static_cast<ssize_t>(flex_line.items.size()) - 1, i == 0);
- }
- } else {
- for (size_t i = 0; i < flex_line.items.size(); ++i) {
- auto& item = flex_line.items[i];
- place_item(*item, i == 0, i == flex_line.items.size() - 1);
- }
- }
- }
- }
- void FlexFormattingContext::dump_items() const
- {
- dbgln("\033[34;1mflex-container\033[0m {}, direction: {}, current-size: {}x{}", flex_container().debug_description(), is_row_layout() ? "row" : "column", m_flex_container_state.content_width(), m_flex_container_state.content_height());
- for (size_t i = 0; i < m_flex_lines.size(); ++i) {
- dbgln("{} flex-line #{}:", flex_container().debug_description(), i);
- for (size_t j = 0; j < m_flex_lines[i].items.size(); ++j) {
- auto& item = *m_flex_lines[i].items[j];
- dbgln("{} flex-item #{}: {} (main:{}, cross:{})", flex_container().debug_description(), j, item.box.debug_description(), item.main_size, item.cross_size);
- }
- }
- }
- CSS::AlignItems FlexFormattingContext::alignment_for_item(Box const& box) const
- {
- switch (box.computed_values().align_self()) {
- case CSS::AlignSelf::Auto:
- return flex_container().computed_values().align_items();
- case CSS::AlignSelf::Normal:
- return CSS::AlignItems::Normal;
- case CSS::AlignSelf::SelfStart:
- return CSS::AlignItems::SelfStart;
- case CSS::AlignSelf::SelfEnd:
- return CSS::AlignItems::SelfEnd;
- case CSS::AlignSelf::FlexStart:
- return CSS::AlignItems::FlexStart;
- case CSS::AlignSelf::FlexEnd:
- return CSS::AlignItems::FlexEnd;
- case CSS::AlignSelf::Center:
- return CSS::AlignItems::Center;
- case CSS::AlignSelf::Baseline:
- return CSS::AlignItems::Baseline;
- case CSS::AlignSelf::Stretch:
- return CSS::AlignItems::Stretch;
- case CSS::AlignSelf::Safe:
- return CSS::AlignItems::Safe;
- case CSS::AlignSelf::Unsafe:
- return CSS::AlignItems::Unsafe;
- default:
- VERIFY_NOT_REACHED();
- }
- }
- void FlexFormattingContext::align_all_flex_items_along_the_cross_axis()
- {
- // FIXME: Take better care of margins
- for (auto& flex_line : m_flex_lines) {
- for (auto* flex_item : flex_line.items) {
- CSSPixels half_line_size = flex_line.cross_size / 2.0f;
- switch (alignment_for_item(flex_item->box)) {
- case CSS::AlignItems::Baseline:
- // FIXME: Implement this
- // Fallthrough
- case CSS::AlignItems::FlexStart:
- case CSS::AlignItems::Stretch:
- flex_item->cross_offset = -half_line_size + flex_item->margins.cross_before + flex_item->borders.cross_before + flex_item->padding.cross_before;
- break;
- case CSS::AlignItems::FlexEnd:
- flex_item->cross_offset = half_line_size - flex_item->cross_size - flex_item->margins.cross_after - flex_item->borders.cross_after - flex_item->padding.cross_after;
- break;
- case CSS::AlignItems::Center:
- flex_item->cross_offset = -(flex_item->cross_size / 2.0f);
- break;
- default:
- break;
- }
- }
- }
- }
- // https://www.w3.org/TR/css-flexbox-1/#algo-cross-container
- void FlexFormattingContext::determine_flex_container_used_cross_size()
- {
- CSSPixels cross_size = 0;
- if (has_definite_cross_size(flex_container())) {
- // Flex container has definite cross size: easy-peasy.
- cross_size = specified_cross_size(flex_container());
- } else {
- // Flex container has indefinite cross size.
- auto cross_size_value = is_row_layout() ? flex_container().computed_values().height() : flex_container().computed_values().width();
- if (cross_size_value.is_auto() || cross_size_value.contains_percentage()) {
- // If a content-based cross size is needed, use the sum of the flex lines' cross sizes.
- CSSPixels sum_of_flex_lines_cross_sizes = 0;
- for (auto& flex_line : m_flex_lines) {
- sum_of_flex_lines_cross_sizes += flex_line.cross_size;
- }
- cross_size = sum_of_flex_lines_cross_sizes;
- if (cross_size_value.contains_percentage()) {
- // FIXME: Handle percentage values here! Right now we're just treating them as "auto"
- }
- } else {
- // Otherwise, resolve the indefinite size at this point.
- cross_size = cross_size_value.resolved(flex_container(), CSS::Length::make_px(specified_cross_size(*flex_container().containing_block()))).to_px(flex_container());
- }
- }
- auto const& computed_min_size = this->computed_cross_min_size(flex_container());
- auto const& computed_max_size = this->computed_cross_max_size(flex_container());
- auto cross_min_size = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_cross_min_size(flex_container()) : 0;
- auto cross_max_size = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_cross_max_size(flex_container()) : INFINITY;
- set_cross_size(flex_container(), css_clamp(cross_size, cross_min_size, cross_max_size));
- }
- // https://www.w3.org/TR/css-flexbox-1/#algo-line-align
- void FlexFormattingContext::align_all_flex_lines()
- {
- if (m_flex_lines.is_empty())
- return;
- // FIXME: Support reverse
- CSSPixels cross_size_of_flex_container = specified_cross_size(flex_container());
- if (is_single_line()) {
- // For single-line flex containers, we only need to center the line along the cross axis.
- auto& flex_line = m_flex_lines[0];
- CSSPixels center_of_line = cross_size_of_flex_container / 2.0f;
- for (auto* flex_item : flex_line.items) {
- flex_item->cross_offset += center_of_line;
- }
- } else {
- CSSPixels sum_of_flex_line_cross_sizes = 0;
- for (auto& line : m_flex_lines)
- sum_of_flex_line_cross_sizes += line.cross_size;
- CSSPixels start_of_current_line = 0;
- CSSPixels gap_size = 0;
- switch (flex_container().computed_values().align_content()) {
- case CSS::AlignContent::FlexStart:
- start_of_current_line = 0;
- break;
- case CSS::AlignContent::FlexEnd:
- start_of_current_line = cross_size_of_flex_container - sum_of_flex_line_cross_sizes;
- break;
- case CSS::AlignContent::Center:
- start_of_current_line = (cross_size_of_flex_container / 2) - (sum_of_flex_line_cross_sizes / 2);
- break;
- case CSS::AlignContent::SpaceBetween: {
- start_of_current_line = 0;
- auto leftover_free_space = cross_size_of_flex_container - sum_of_flex_line_cross_sizes;
- if (leftover_free_space >= 0) {
- int gap_count = m_flex_lines.size() - 1;
- gap_size = leftover_free_space / gap_count;
- }
- break;
- }
- case CSS::AlignContent::SpaceAround: {
- auto leftover_free_space = cross_size_of_flex_container - sum_of_flex_line_cross_sizes;
- if (leftover_free_space < 0) {
- // If the leftover free-space is negative this value is identical to center.
- start_of_current_line = (cross_size_of_flex_container / 2) - (sum_of_flex_line_cross_sizes / 2);
- break;
- }
- gap_size = leftover_free_space / m_flex_lines.size();
- // The spacing between the first/last lines and the flex container edges is half the size of the spacing between flex lines.
- start_of_current_line = gap_size / 2;
- break;
- }
- case CSS::AlignContent::Stretch:
- start_of_current_line = 0;
- break;
- }
- for (auto& flex_line : m_flex_lines) {
- CSSPixels center_of_current_line = start_of_current_line + (flex_line.cross_size / 2);
- for (auto* flex_item : flex_line.items) {
- flex_item->cross_offset += center_of_current_line;
- }
- start_of_current_line += flex_line.cross_size + gap_size;
- }
- }
- }
- void FlexFormattingContext::copy_dimensions_from_flex_items_to_boxes()
- {
- for (auto& flex_item : m_flex_items) {
- auto const& box = flex_item.box;
- auto& box_state = m_state.get_mutable(box);
- box_state.padding_left = box.computed_values().padding().left().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.padding_right = box.computed_values().padding().right().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.padding_top = box.computed_values().padding().top().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.padding_bottom = box.computed_values().padding().bottom().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.margin_left = box.computed_values().margin().left().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.margin_right = box.computed_values().margin().right().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.margin_top = box.computed_values().margin().top().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.margin_bottom = box.computed_values().margin().bottom().resolved(box, CSS::Length::make_px(m_flex_container_state.content_width())).to_px(box);
- box_state.border_left = box.computed_values().border_left().width;
- box_state.border_right = box.computed_values().border_right().width;
- box_state.border_top = box.computed_values().border_top().width;
- box_state.border_bottom = box.computed_values().border_bottom().width;
- set_main_size(box, flex_item.main_size);
- set_cross_size(box, flex_item.cross_size);
- set_offset(box, flex_item.main_offset, flex_item.cross_offset);
- }
- }
- // https://drafts.csswg.org/css-flexbox-1/#intrinsic-sizes
- void FlexFormattingContext::determine_intrinsic_size_of_flex_container()
- {
- if (m_available_space_for_flex_container->main.is_intrinsic_sizing_constraint()) {
- CSSPixels main_size = calculate_intrinsic_main_size_of_flex_container();
- set_main_size(flex_container(), main_size);
- }
- if (m_available_space_for_items->cross.is_intrinsic_sizing_constraint()) {
- CSSPixels cross_size = calculate_intrinsic_cross_size_of_flex_container();
- set_cross_size(flex_container(), cross_size);
- }
- }
- // https://drafts.csswg.org/css-flexbox-1/#intrinsic-main-sizes
- CSSPixels FlexFormattingContext::calculate_intrinsic_main_size_of_flex_container()
- {
- // The min-content main size of a single-line flex container is calculated identically to the max-content main size,
- // except that the flex items’ min-content contributions are used instead of their max-content contributions.
- // However, for a multi-line container, it is simply the largest min-content contribution of all the non-collapsed flex items in the flex container.
- if (!is_single_line() && m_available_space_for_items->main.is_min_content()) {
- CSSPixels largest_contribution = 0;
- for (auto const& flex_item : m_flex_items) {
- // FIXME: Skip collapsed flex items.
- largest_contribution = max(largest_contribution, calculate_main_min_content_contribution(flex_item));
- }
- return largest_contribution;
- }
- // The max-content main size of a flex container is, fundamentally, the smallest size the flex container
- // can take such that when flex layout is run with that container size, each flex item ends up at least
- // as large as its max-content contribution, to the extent allowed by the items’ flexibility.
- // It is calculated, considering only non-collapsed flex items, by:
- // 1. For each flex item, subtract its outer flex base size from its max-content contribution size.
- // If that result is positive, divide it by the item’s flex grow factor if the flex grow factor is ≥ 1,
- // or multiply it by the flex grow factor if the flex grow factor is < 1; if the result is negative,
- // divide it by the item’s scaled flex shrink factor (if dividing by zero, treat the result as negative infinity).
- // This is the item’s desired flex fraction.
- for (auto& flex_item : m_flex_items) {
- CSSPixels contribution = 0;
- if (m_available_space_for_items->main.is_min_content())
- contribution = calculate_main_min_content_contribution(flex_item);
- else if (m_available_space_for_items->main.is_max_content())
- contribution = calculate_main_max_content_contribution(flex_item);
- CSSPixels outer_flex_base_size = flex_item.flex_base_size + flex_item.margins.main_before + flex_item.margins.main_after + flex_item.borders.main_before + flex_item.borders.main_after + flex_item.padding.main_before + flex_item.padding.main_after;
- CSSPixels result = contribution - outer_flex_base_size;
- if (result > 0) {
- if (flex_item.box.computed_values().flex_grow() >= 1) {
- result /= flex_item.box.computed_values().flex_grow();
- } else {
- result *= flex_item.box.computed_values().flex_grow();
- }
- } else if (result < 0) {
- if (flex_item.scaled_flex_shrink_factor == 0)
- result = -INFINITY;
- else
- result /= flex_item.scaled_flex_shrink_factor;
- }
- flex_item.desired_flex_fraction = result.value();
- }
- // 2. Place all flex items into lines of infinite length.
- m_flex_lines.clear();
- if (!m_flex_items.is_empty())
- m_flex_lines.append(FlexLine {});
- for (auto& flex_item : m_flex_items) {
- // FIXME: Honor breaking requests.
- m_flex_lines.last().items.append(&flex_item);
- }
- // Within each line, find the greatest (most positive) desired flex fraction among all the flex items.
- // This is the line’s chosen flex fraction.
- for (auto& flex_line : m_flex_lines) {
- float greatest_desired_flex_fraction = 0;
- float sum_of_flex_grow_factors = 0;
- float sum_of_flex_shrink_factors = 0;
- for (auto& flex_item : flex_line.items) {
- greatest_desired_flex_fraction = max(greatest_desired_flex_fraction, flex_item->desired_flex_fraction);
- sum_of_flex_grow_factors += flex_item->box.computed_values().flex_grow();
- sum_of_flex_shrink_factors += flex_item->box.computed_values().flex_shrink();
- }
- float chosen_flex_fraction = greatest_desired_flex_fraction;
- // 3. If the chosen flex fraction is positive, and the sum of the line’s flex grow factors is less than 1,
- // divide the chosen flex fraction by that sum.
- if (chosen_flex_fraction > 0 && sum_of_flex_grow_factors < 1)
- chosen_flex_fraction /= sum_of_flex_grow_factors;
- // If the chosen flex fraction is negative, and the sum of the line’s flex shrink factors is less than 1,
- // multiply the chosen flex fraction by that sum.
- if (chosen_flex_fraction < 0 && sum_of_flex_shrink_factors < 1)
- chosen_flex_fraction *= sum_of_flex_shrink_factors;
- flex_line.chosen_flex_fraction = chosen_flex_fraction;
- }
- auto determine_main_size = [&]() -> CSSPixels {
- CSSPixels largest_sum = 0;
- for (auto& flex_line : m_flex_lines) {
- // 4. Add each item’s flex base size to the product of its flex grow factor (scaled flex shrink factor, if shrinking)
- // and the chosen flex fraction, then clamp that result by the max main size floored by the min main size.
- CSSPixels sum = 0;
- for (auto& flex_item : flex_line.items) {
- float product = 0;
- if (flex_item->desired_flex_fraction > 0)
- product = flex_line.chosen_flex_fraction * flex_item->box.computed_values().flex_grow();
- else if (flex_item->desired_flex_fraction < 0)
- product = flex_line.chosen_flex_fraction * flex_item->scaled_flex_shrink_factor;
- auto result = flex_item->flex_base_size + product;
- auto const& computed_min_size = this->computed_main_min_size(flex_item->box);
- auto const& computed_max_size = this->computed_main_max_size(flex_item->box);
- auto clamp_min = (!computed_min_size.is_auto() && !computed_min_size.contains_percentage()) ? specified_main_min_size(flex_item->box) : automatic_minimum_size(*flex_item);
- auto clamp_max = (!computed_max_size.is_none() && !computed_max_size.contains_percentage()) ? specified_main_max_size(flex_item->box) : NumericLimits<float>::max();
- result = css_clamp(result, clamp_min, clamp_max);
- // NOTE: The spec doesn't mention anything about the *outer* size here, but if we don't add the margin box,
- // flex items with non-zero padding/border/margin in the main axis end up overflowing the container.
- result = flex_item->add_main_margin_box_sizes(result);
- sum += result;
- }
- largest_sum = max(largest_sum, sum);
- }
- // 5. The flex container’s max-content size is the largest sum (among all the lines) of the afore-calculated sizes of all items within a single line.
- return largest_sum;
- };
- auto main_size = determine_main_size();
- set_main_size(flex_container(), main_size);
- return main_size;
- }
- // https://drafts.csswg.org/css-flexbox-1/#intrinsic-cross-sizes
- CSSPixels FlexFormattingContext::calculate_intrinsic_cross_size_of_flex_container()
- {
- // The min-content/max-content cross size of a single-line flex container
- // is the largest min-content contribution/max-content contribution (respectively) of its flex items.
- if (is_single_line()) {
- auto calculate_largest_contribution = [&](bool resolve_percentage_min_max_sizes) {
- CSSPixels largest_contribution = 0;
- for (auto& flex_item : m_flex_items) {
- CSSPixels contribution = 0;
- if (m_available_space_for_items->cross.is_min_content())
- contribution = calculate_cross_min_content_contribution(flex_item, resolve_percentage_min_max_sizes);
- else if (m_available_space_for_items->cross.is_max_content())
- contribution = calculate_cross_max_content_contribution(flex_item, resolve_percentage_min_max_sizes);
- largest_contribution = max(largest_contribution, contribution);
- }
- return largest_contribution;
- };
- auto first_pass_largest_contribution = calculate_largest_contribution(false);
- set_cross_size(flex_container(), first_pass_largest_contribution);
- auto second_pass_largest_contribution = calculate_largest_contribution(true);
- return second_pass_largest_contribution;
- }
- if (is_row_layout()) {
- // row multi-line flex container cross-size
- // The min-content/max-content cross size is the sum of the flex line cross sizes resulting from
- // sizing the flex container under a cross-axis min-content constraint/max-content constraint (respectively).
- // NOTE: We fall through to the ad-hoc section below.
- } else {
- // column multi-line flex container cross-size
- // The min-content cross size is the largest min-content contribution among all of its flex items.
- if (m_available_space_for_items->cross.is_min_content()) {
- auto calculate_largest_contribution = [&](bool resolve_percentage_min_max_sizes) {
- CSSPixels largest_contribution = 0;
- for (auto& flex_item : m_flex_items) {
- CSSPixels contribution = calculate_cross_min_content_contribution(flex_item, resolve_percentage_min_max_sizes);
- largest_contribution = max(largest_contribution, contribution);
- }
- return largest_contribution;
- };
- auto first_pass_largest_contribution = calculate_largest_contribution(false);
- set_cross_size(flex_container(), first_pass_largest_contribution);
- auto second_pass_largest_contribution = calculate_largest_contribution(true);
- return second_pass_largest_contribution;
- }
- // The max-content cross size is the sum of the flex line cross sizes resulting from
- // sizing the flex container under a cross-axis max-content constraint,
- // using the largest max-content cross-size contribution among the flex items
- // as the available space in the cross axis for each of the flex items during layout.
- // NOTE: We fall through to the ad-hoc section below.
- }
- // HACK: We run steps 5, 7, 9 and 11 from the main algorithm. This gives us *some* cross size information to work with.
- m_flex_lines.clear();
- collect_flex_items_into_flex_lines();
- for (auto& flex_item : m_flex_items) {
- determine_hypothetical_cross_size_of_item(flex_item, false);
- }
- calculate_cross_size_of_each_flex_line();
- determine_used_cross_size_of_each_flex_item();
- CSSPixels sum_of_flex_line_cross_sizes = 0;
- for (auto& flex_line : m_flex_lines) {
- sum_of_flex_line_cross_sizes += flex_line.cross_size;
- }
- return sum_of_flex_line_cross_sizes;
- }
- // https://drafts.csswg.org/css-flexbox-1/#intrinsic-item-contributions
- CSSPixels FlexFormattingContext::calculate_main_min_content_contribution(FlexItem const& item) const
- {
- // The main-size min-content contribution of a flex item is
- // the larger of its outer min-content size and outer preferred size if that is not auto,
- // clamped by its min/max main size.
- auto larger_size = [&] {
- auto inner_min_content_size = calculate_min_content_main_size(item);
- if (computed_main_size(item.box).is_auto())
- return inner_min_content_size;
- auto inner_preferred_size = is_row_layout() ? get_pixel_width(item.box, computed_main_size(item.box)) : get_pixel_height(item.box, computed_main_size(item.box));
- return max(inner_min_content_size, inner_preferred_size);
- }();
- auto clamp_min = has_main_min_size(item.box) ? specified_main_min_size(item.box) : automatic_minimum_size(item);
- auto clamp_max = has_main_max_size(item.box) ? specified_main_max_size(item.box) : NumericLimits<float>::max();
- auto clamped_inner_size = css_clamp(larger_size, clamp_min, clamp_max);
- return item.add_main_margin_box_sizes(clamped_inner_size);
- }
- // https://drafts.csswg.org/css-flexbox-1/#intrinsic-item-contributions
- CSSPixels FlexFormattingContext::calculate_main_max_content_contribution(FlexItem const& item) const
- {
- // The main-size max-content contribution of a flex item is
- // the larger of its outer max-content size and outer preferred size if that is not auto,
- // clamped by its min/max main size.
- auto larger_size = [&] {
- auto inner_max_content_size = calculate_max_content_main_size(item);
- if (computed_main_size(item.box).is_auto())
- return inner_max_content_size;
- auto inner_preferred_size = is_row_layout() ? get_pixel_width(item.box, computed_main_size(item.box)) : get_pixel_height(item.box, computed_main_size(item.box));
- return max(inner_max_content_size, inner_preferred_size);
- }();
- auto clamp_min = has_main_min_size(item.box) ? specified_main_min_size(item.box) : automatic_minimum_size(item);
- auto clamp_max = has_main_max_size(item.box) ? specified_main_max_size(item.box) : NumericLimits<float>::max();
- auto clamped_inner_size = css_clamp(larger_size, clamp_min, clamp_max);
- return item.add_main_margin_box_sizes(clamped_inner_size);
- }
- bool FlexFormattingContext::should_treat_main_size_as_auto(Box const& box) const
- {
- if (is_row_layout())
- return should_treat_width_as_auto(box, m_available_space_for_items->space);
- return should_treat_height_as_auto(box, m_available_space_for_items->space);
- }
- bool FlexFormattingContext::should_treat_cross_size_as_auto(Box const& box) const
- {
- if (is_row_layout())
- return should_treat_height_as_auto(box, m_available_space_for_items->space);
- return should_treat_width_as_auto(box, m_available_space_for_items->space);
- }
- CSSPixels FlexFormattingContext::calculate_cross_min_content_contribution(FlexItem const& item, bool resolve_percentage_min_max_sizes) const
- {
- auto size = [&] {
- if (should_treat_cross_size_as_auto(item.box))
- return calculate_min_content_cross_size(item);
- return !is_row_layout() ? get_pixel_width(item.box, computed_cross_size(item.box)) : get_pixel_height(item.box, computed_cross_size(item.box));
- }();
- auto const& computed_min_size = this->computed_cross_min_size(item.box);
- auto const& computed_max_size = this->computed_cross_max_size(item.box);
- auto clamp_min = (!computed_min_size.is_auto() && (resolve_percentage_min_max_sizes || !computed_min_size.contains_percentage())) ? specified_cross_min_size(item.box) : 0;
- auto clamp_max = (!computed_max_size.is_none() && (resolve_percentage_min_max_sizes || !computed_max_size.contains_percentage())) ? specified_cross_max_size(item.box) : NumericLimits<float>::max();
- auto clamped_inner_size = css_clamp(size, clamp_min, clamp_max);
- return item.add_cross_margin_box_sizes(clamped_inner_size);
- }
- CSSPixels FlexFormattingContext::calculate_cross_max_content_contribution(FlexItem const& item, bool resolve_percentage_min_max_sizes) const
- {
- auto size = [&] {
- if (should_treat_cross_size_as_auto(item.box))
- return calculate_max_content_cross_size(item);
- return !is_row_layout() ? get_pixel_width(item.box, computed_cross_size(item.box)) : get_pixel_height(item.box, computed_cross_size(item.box));
- }();
- auto const& computed_min_size = this->computed_cross_min_size(item.box);
- auto const& computed_max_size = this->computed_cross_max_size(item.box);
- auto clamp_min = (!computed_min_size.is_auto() && (resolve_percentage_min_max_sizes || !computed_min_size.contains_percentage())) ? specified_cross_min_size(item.box) : 0;
- auto clamp_max = (!computed_max_size.is_none() && (resolve_percentage_min_max_sizes || !computed_max_size.contains_percentage())) ? specified_cross_max_size(item.box) : NumericLimits<float>::max();
- auto clamped_inner_size = css_clamp(size, clamp_min, clamp_max);
- return item.add_cross_margin_box_sizes(clamped_inner_size);
- }
- CSSPixels FlexFormattingContext::calculate_min_content_main_size(FlexItem const& item) const
- {
- return is_row_layout() ? calculate_min_content_width(item.box) : calculate_min_content_height(item.box, m_available_space_for_items->space.width);
- }
- CSSPixels FlexFormattingContext::calculate_fit_content_main_size(FlexItem const& item) const
- {
- return is_row_layout() ? calculate_fit_content_width(item.box, m_available_space_for_items->space)
- : calculate_fit_content_height(item.box, m_available_space_for_items->space);
- }
- CSSPixels FlexFormattingContext::calculate_fit_content_cross_size(FlexItem const& item) const
- {
- return !is_row_layout() ? calculate_fit_content_width(item.box, m_available_space_for_items->space)
- : calculate_fit_content_height(item.box, m_available_space_for_items->space);
- }
- CSSPixels FlexFormattingContext::calculate_max_content_main_size(FlexItem const& item) const
- {
- return is_row_layout() ? calculate_max_content_width(item.box) : calculate_max_content_height(item.box, m_available_space_for_items->space.width);
- }
- CSSPixels FlexFormattingContext::calculate_min_content_cross_size(FlexItem const& item) const
- {
- return is_row_layout() ? calculate_min_content_height(item.box, m_available_space_for_items->space.width) : calculate_min_content_width(item.box);
- }
- CSSPixels FlexFormattingContext::calculate_max_content_cross_size(FlexItem const& item) const
- {
- return is_row_layout() ? calculate_max_content_height(item.box, m_available_space_for_items->space.width) : calculate_max_content_width(item.box);
- }
- // https://drafts.csswg.org/css-flexbox-1/#stretched
- bool FlexFormattingContext::flex_item_is_stretched(FlexItem const& item) const
- {
- auto alignment = alignment_for_item(item.box);
- if (alignment != CSS::AlignItems::Stretch)
- return false;
- // If the cross size property of the flex item computes to auto, and neither of the cross-axis margins are auto, the flex item is stretched.
- auto const& computed_cross_size = is_row_layout() ? item.box.computed_values().height() : item.box.computed_values().width();
- return computed_cross_size.is_auto() && !item.margins.cross_before_is_auto && !item.margins.cross_after_is_auto;
- }
- CSS::Size const& FlexFormattingContext::computed_main_size(Box const& box) const
- {
- return is_row_layout() ? box.computed_values().width() : box.computed_values().height();
- }
- CSS::Size const& FlexFormattingContext::computed_main_min_size(Box const& box) const
- {
- return is_row_layout() ? box.computed_values().min_width() : box.computed_values().min_height();
- }
- CSS::Size const& FlexFormattingContext::computed_main_max_size(Box const& box) const
- {
- return is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
- }
- CSS::Size const& FlexFormattingContext::computed_cross_size(Box const& box) const
- {
- return !is_row_layout() ? box.computed_values().width() : box.computed_values().height();
- }
- CSS::Size const& FlexFormattingContext::computed_cross_min_size(Box const& box) const
- {
- return !is_row_layout() ? box.computed_values().min_width() : box.computed_values().min_height();
- }
- CSS::Size const& FlexFormattingContext::computed_cross_max_size(Box const& box) const
- {
- return !is_row_layout() ? box.computed_values().max_width() : box.computed_values().max_height();
- }
- // https://drafts.csswg.org/css-flexbox-1/#algo-cross-margins
- void FlexFormattingContext::resolve_cross_axis_auto_margins()
- {
- for (auto& line : m_flex_lines) {
- for (auto& item : line.items) {
- // If a flex item has auto cross-axis margins:
- if (!item->margins.cross_before_is_auto && !item->margins.cross_after_is_auto)
- continue;
- // If its outer cross size (treating those auto margins as zero) is less than the cross size of its flex line,
- // distribute the difference in those sizes equally to the auto margins.
- auto outer_cross_size = item->cross_size + item->padding.cross_before + item->padding.cross_after + item->borders.cross_before + item->borders.cross_after;
- if (outer_cross_size < line.cross_size) {
- CSSPixels remainder = line.cross_size - outer_cross_size;
- if (item->margins.cross_before_is_auto && item->margins.cross_after_is_auto) {
- item->margins.cross_before = remainder / 2.0f;
- item->margins.cross_after = remainder / 2.0f;
- } else if (item->margins.cross_before_is_auto) {
- item->margins.cross_before = remainder;
- } else {
- item->margins.cross_after = remainder;
- }
- } else {
- // FIXME: Otherwise, if the block-start or inline-start margin (whichever is in the cross axis) is auto, set it to zero.
- // Set the opposite margin so that the outer cross size of the item equals the cross size of its flex line.
- }
- }
- }
- }
- // https://drafts.csswg.org/css-flexbox-1/#algo-line-stretch
- void FlexFormattingContext::handle_align_content_stretch()
- {
- // If the flex container has a definite cross size,
- if (!has_definite_cross_size(flex_container()))
- return;
- // align-content is stretch,
- if (flex_container().computed_values().align_content() != CSS::AlignContent::Stretch)
- return;
- // and the sum of the flex lines' cross sizes is less than the flex container’s inner cross size,
- CSSPixels sum_of_flex_line_cross_sizes = 0;
- for (auto& line : m_flex_lines)
- sum_of_flex_line_cross_sizes += line.cross_size;
- if (sum_of_flex_line_cross_sizes >= specified_cross_size(flex_container()))
- return;
- // increase the cross size of each flex line by equal amounts
- // such that the sum of their cross sizes exactly equals the flex container’s inner cross size.
- CSSPixels remainder = specified_cross_size(flex_container()) - sum_of_flex_line_cross_sizes;
- CSSPixels extra_per_line = remainder / m_flex_lines.size();
- for (auto& line : m_flex_lines)
- line.cross_size += extra_per_line;
- }
- // https://drafts.csswg.org/css-flexbox-1/#abspos-items
- CSSPixelPoint FlexFormattingContext::calculate_static_position(Box const& box) const
- {
- // The cross-axis edges of the static-position rectangle of an absolutely-positioned child
- // of a flex container are the content edges of the flex container.
- CSSPixels cross_offset = 0;
- CSSPixels half_line_size = specified_cross_size(flex_container()) / 2;
- auto const& box_state = m_state.get(box);
- CSSPixels cross_margin_before = is_row_layout() ? box_state.margin_top : box_state.margin_left;
- CSSPixels cross_margin_after = is_row_layout() ? box_state.margin_bottom : box_state.margin_right;
- CSSPixels cross_border_before = is_row_layout() ? box_state.border_top : box_state.border_left;
- CSSPixels cross_border_after = is_row_layout() ? box_state.border_bottom : box_state.border_right;
- CSSPixels cross_padding_before = is_row_layout() ? box_state.padding_top : box_state.padding_left;
- CSSPixels cross_padding_after = is_row_layout() ? box_state.padding_bottom : box_state.padding_right;
- switch (alignment_for_item(box)) {
- case CSS::AlignItems::Baseline:
- // FIXME: Implement this
- // Fallthrough
- case CSS::AlignItems::FlexStart:
- case CSS::AlignItems::Stretch:
- cross_offset = -half_line_size + cross_margin_before + cross_border_before + cross_padding_before;
- break;
- case CSS::AlignItems::FlexEnd:
- cross_offset = half_line_size - specified_cross_size(box) - cross_margin_after - cross_border_after - cross_padding_after;
- break;
- case CSS::AlignItems::Center:
- cross_offset = -(specified_cross_size(box) / 2.0f);
- break;
- default:
- break;
- }
- cross_offset += specified_cross_size(flex_container()) / 2.0f;
- // The main-axis edges of the static-position rectangle are where the margin edges of the child
- // would be positioned if it were the sole flex item in the flex container,
- // assuming both the child and the flex container were fixed-size boxes of their used size.
- // (For this purpose, auto margins are treated as zero.
- bool pack_from_end = true;
- CSSPixels main_offset = 0;
- switch (flex_container().computed_values().justify_content()) {
- case CSS::JustifyContent::Start:
- if (is_direction_reverse()) {
- main_offset = specified_main_size(flex_container());
- } else {
- main_offset = 0;
- }
- break;
- case CSS::JustifyContent::End:
- if (is_direction_reverse()) {
- main_offset = 0;
- } else {
- main_offset = specified_main_size(flex_container());
- }
- break;
- case CSS::JustifyContent::FlexStart:
- if (is_direction_reverse()) {
- pack_from_end = false;
- main_offset = specified_main_size(flex_container());
- } else {
- main_offset = 0;
- }
- break;
- case CSS::JustifyContent::FlexEnd:
- if (is_direction_reverse()) {
- main_offset = 0;
- } else {
- pack_from_end = false;
- main_offset = specified_main_size(flex_container());
- }
- break;
- case CSS::JustifyContent::SpaceBetween:
- main_offset = 0;
- break;
- case CSS::JustifyContent::Center:
- case CSS::JustifyContent::SpaceAround:
- main_offset = specified_main_size(flex_container()) / 2.0f - specified_main_size(box) / 2.0f;
- break;
- }
- // NOTE: Next, we add the flex container's padding since abspos boxes are placed relative to the padding edge
- // of their abspos containing block.
- if (pack_from_end) {
- main_offset += is_row_layout() ? m_flex_container_state.padding_left : m_flex_container_state.padding_top;
- } else {
- main_offset += is_row_layout() ? m_flex_container_state.padding_right : m_flex_container_state.padding_bottom;
- }
- if (!pack_from_end)
- main_offset += specified_main_size(flex_container()) - specified_main_size(box);
- auto static_position_offset = is_row_layout() ? CSSPixelPoint { main_offset, cross_offset } : CSSPixelPoint { cross_offset, main_offset };
- auto absolute_position_of_flex_container = absolute_content_rect(flex_container(), m_state).location();
- auto absolute_position_of_abspos_containing_block = absolute_content_rect(*box.containing_block(), m_state).location();
- auto diff = absolute_position_of_flex_container - absolute_position_of_abspos_containing_block;
- return static_position_offset + diff;
- }
- }
|