An object used in any container component type to define how the collection of child components is presented.
- Apple News Format 1.7+
collection for this object.
A string that defines how components are aligned within their rows. This is especially visible when
distribution is set to
left(default). The group of components is left-aligned within the available space. Remaining space is added at the right of the row.
center. The group of components is centered within the available space. Remaining space is added at both sides of the row.
right. The group of components is right-aligned within the available space. Remaining space is added at the left of the row.
A string that defines how components should be distributed horizontally in a row.
wide(default). Components are spread across the full width of the component. Whitespace is equally distributed into the space between components.
narrow. Components are placed next to each other as closely as possible, separated by the width defined in the
gutterproperty. Any remaining whitespace is applied to the left and right of the collection.
A number in points or a string referring to a supported unit of measure defining the maximum width of each child component inside the collection.
maximum is smaller than the
minimum is used.
maximum is provided, a default of
100cw is used.
A number in points or a string referring to a supported unit of measure defining the minimum width of each child component inside the collection.
minimum should not exceed the
maximum value. A child component will never be larger than the width of its parent. If no
minimum has been provided, News attempts to decide the optimal size for each child component based on its contents. See Specifying Measurements for Components.
This value cannot be negative.
A Boolean value that defines whether the components’ area is allowed to be sized differently per row.
true, individual rows might have different widths for their components to make use of the entire available width.
false, all components in the collection will have the same width.
A string that defines the approach to prevent the collection from having component widows.
equalize. Every row contains an equal amount of components. When provided with an uneven amount of components, each row consists of 1 component.
optimize(default). Looks for the most optimal distribution of components, but allows each row to have a different amount of components.