package toffee

  1. Overview
  2. Docs
On This Page
  1. Performance
CSS layout engine for OCaml (Flexbox, Grid, Block)

Install 

dune-project
 Dependency

github.com Readme Changelog Edit opam file Versions (1)

Authors

  1. Thibaut Mattio

Maintainers

  1. Thibaut Mattio

Sources

mosaic-0.1.0.tbz
sha256=9e4e90d17f9b2af1b07071fe425bc2c519c849c4f1d1ab73cde512be2d874849
sha512=06e9c4a741590942e81a27738d0b5c0413fafec8cf3b7dae047ad69f155e7b718aa4223818dc161b7d028efffcfd3365905e264d6fd31d453910ddfa91dcf9b9

doc/toffee.tree/Tree/Run_mode/index.html

Module Tree.Run_modeSource

Layout computation mode.

Run mode determines how layout algorithms execute: computing full layouts for all nodes, computing only container sizes, or handling hidden nodes. This affects which layout steps are performed and whether child layouts are computed.

Performance

Compute_size enables early exits in layout algorithms when only the container's dimensions are needed. Layout implementations check run mode and return immediately once container size is determined, skipping child positioning and final layout steps. This optimization is critical for intrinsic size queries (e.g., computing min-content or max-content widths) where only dimensions matter, not child positions.

Sourcetype t =
  1. | Perform_layout
    (*

    Compute full layout for this node and all children.

    All layout steps are performed, including child layout computation, positioning, and size determination. This is the standard mode for visible nodes requiring complete layout information.

    *)
  2. | Compute_size
    (*

    Compute only the container size for this node.

    Layout steps unnecessary for determining the node's container size may be skipped. This mode optimizes layout computation when only the node's dimensions are needed, not the full layout tree.

    *)
  3. | Perform_hidden_layout
    (*

    Set null layout for this hidden node.

    Applied to nodes with Display.None. The node receives a zero-sized layout and its children are not computed.

    *)
Sourceval to_string : t -> string

to_string mode returns the string representation of mode.

Returns "PerformLayout", "ComputeSize", or "PerformHiddenLayout".

Sourceval compare : t -> t -> int

compare a b compares run modes a and b.

Ordering: Perform_layout < Compute_size < Perform_hidden_layout.

Sourceval equal : t -> t -> bool

equal a b tests whether a and b are the same run mode.

Sourceval pp : Format.formatter -> t -> unit

pp fmt mode prints mode to formatter fmt using to_string.