Using TiledRowsLayout in Feathers containers (Starling version)
The TiledRowsLayout
class may be used by components that support layout, such as List
, LayoutGroup
and ScrollContainer
, to display items from left to right in multiple rows. It supports paging horizontally or vertically, and a number of useful options for the spacing and alignment may be modified.
The Basics
Let's create a tiled rows layout and add it to a LayoutGroup
:
var layout:TiledRowsLayout = new TiledRowsLayout();
var container:LayoutGroup = new LayoutGroup();
container.layout = layout;
this.addChild( container );
There are a number of simple properties that may be used to affect positioning and sizing of items in the layout. Let's look at some of the most common.
Tile size
If we want rectangular tiles instead of square, we can set the useSquareTiles
property to false
.
Spacing
The padding is the space around the edges of the container. Let's set the padding
property to 12
pixels:
layout.padding = 12;
If needed, the padding on each side of the container may be set separately. Below, we set the paddingTop
and paddingBottom
to 10
pixels, and we set the paddingLeft
and paddingRight
to 15
pixels:
layout.paddingTop = 10;
layout.paddingRight = 15;
layout.paddingBottom = 10;
layout.paddingLeft = 15;
The gap is the space between items, both horizontally or vertically. Let's set the gap
property to 5
pixels:
layout.gap = 5;
If needed, the horizontal and vertical gaps may be set separately. We'll set the horizontalGap
property to 4
pixels and the verticalGap
property to 6
pixels:
layout.horizontalGap = 4;
layout.verticalGap = 6;
Alignment
We can align the items in the layout using the horizontalLayout
and verticalLayout
properties. Vertical alignment may be used in two cases. In the first case, it will always apply when the tiles are divided into pages. Second, it will apply when the total height of the content (including padding and gap values) is less than or equal to the height of the container that uses the layout, regardless of whether the layout uses paging. Let's adjust the alignments so that the content will be aligned to the top left:
layout.horizontalAlign = HorizontalAlign.LEFT;
layout.verticalAlign = VerticalAlign.TOP;
Since items may be smaller than the tile dimensions, we can align items within their tiles separately from the alignment of the rows. We'll align the items in the horizontal center and the vertical middle of their tiles:
layout.tileHorizontalAlign = HorizontalAlign.CENTER;
layout.tileVerticalAlign = VerticalAlign.MIDDLE;
Rows and columns
It's possible to request a specific number of columns for the layout to display. The layout may not always be able to accomodate this value because the container may be too small, but if there is enough room for the requested number of columns, that's the number it will display. Let's tell the layout to use three columns by setting the requestedColumnCount
property:
layout.requestedColumnCount = 3;
Now, the layout will always display three columns, even if the container can fit four or more. However, if only one or two columns can be fit into the container, the layout will display the maximum number that will fit.
If the width of the container is not set, the layout will automatically calculate a width that accomodates the
requestedColumnCount
.
Paging
Pages can organize the content of the layout into more manageable pieces. We can enable paging
in either the horizontal direction or the vertical direction. In the example below, we'll enable horizontal paging:
layout.paging = Direction.HORIZONTAL;
If we set padding values on a layout that has paging enabled, each page will use those padding values around its edges. Similarly, vertical alignment will apply to all pages because a page will never display more content than is visible before breaking to the next page.
On our ScrollContainer
or List
, we should also enable page snapping:
container.snapToPages = true;
We can combine the component with a PageIndicator
to navigate between pages and to visually display which page is currently visible.
Virtual Tiled Rows Layout
In a List
, Tree
, or GroupedList
, the layout may be virtualized, meaning that some items in the layout will not actually exist if they are not visible. This helps to improve performance of a scrolling list because only a limited number of item renderers will be created at any given moment. If the list's data provider is very large, a virtual layout is essential, even on desktop computers that have incredible processing power compared to mobile devices.
A virtualized layout will need as estimate about how big a "virtual" item renderer should be. We should set the typicalItem
property of the list to have it determine the typical width and height of an item renderer to use as this estimated value. If we don't pass in a typical item, the first item in the data provider is used for this estimate.
By default useVirtualLayout
is true
for containers that support it. We can disable virtual layouts by setting it to false
. When a layout is not virtualized, every single item renderer must be created by the component. If a list has thousands of items, this means that thousands of item renderers need to be created. This can lead to significant performance issues, especially on mobile. In general, useVirtualLayout
should rarely be disabled.
layout.useVirtualLayout = false;
The LayoutGroup
and ScrollContainer
components never use virtual layouts.