author Brad Werth <>
Tue, 23 Oct 2018 16:23:37 +0000
changeset 490949 19472cba78cc8439d0b1007ce1d4a8b3f2fcd592
parent 490305 082aaca611f9f0e13cd82d6cc708b687cfd35b7c
child 491244 24b46ea119a07030f321c71007d158277d919e1a
permissions -rw-r--r--
Bug 1501109 Part 1: Change Flex API growth state to match layout algorithm, and use enums from webidl. r=dholbert Differential Revision:

/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at

 * These objects support visualization of flex containers by the
 * dev tools.

 * A flex container's main and cross axes are either horizontal or
 * vertical, each with two possible directions.
enum FlexPhysicalDirection {

interface Flex
  sequence<FlexLineValues> getLines();

   * The physical direction in which successive flex items are placed,
   * within a flex line in this flex container.
  readonly attribute FlexPhysicalDirection mainAxisDirection;

   * The physical direction in which successive flex lines are placed
   * in this flex container (if it is or were multi-line).
  readonly attribute FlexPhysicalDirection crossAxisDirection;

 * This indicates which flex factor (flex-grow vs. flex-shrink) the
 * flex layout algorithm uses internally when resolving flexible sizes
 * in a given flex line, per flexbox spec section 9.7 step 1. Note that
 * this value doesn't necessarily mean that any items on this line
 * are *actually* growing (or shrinking).  This simply indicates what
 * the layout algorithm "wants" to do, based on the free space -- 
 * and items will stretch from their flex base size in the corresponding
 * direction, if permitted by their min/max constraints and their
 * corresponding flex factor.
enum FlexLineGrowthState { "shrinking", "growing" };

interface FlexLineValues
  readonly attribute FlexLineGrowthState growthState;
  readonly attribute double crossStart;
  readonly attribute double crossSize;

  // firstBaselineOffset measures from flex-start edge.
  readonly attribute double firstBaselineOffset;

  // lastBaselineOffset measures from flex-end edge.
  readonly attribute double lastBaselineOffset;

   * getItems() returns FlexItemValues only for the Elements in
   * this Flex container -- ignoring struts and abs-pos Elements.
  sequence<FlexItemValues> getItems();

interface FlexItemValues
  readonly attribute Node? node;
  readonly attribute double mainBaseSize;
  readonly attribute double mainDeltaSize;
  readonly attribute double mainMinSize;
  readonly attribute double mainMaxSize;
  readonly attribute double crossMinSize;
  readonly attribute double crossMaxSize;