class VerticalListLayout
package feathers.layout
extends EventDispatcher
implements IVirtualLayout
A simple list layout that positions items from top to bottom, in a single column, where every item fills the entire width of the container.
If all items in the container should have the same height, consider using
VerticalListFixedRowLayout
instead. When a fixed height for items is
known, that layout offers better performance optimization.
Events:
openfl.events.Event.CHANGE |
---|
1.0.0
.Constructor
Variables
contentJustify:Bool
When contentJustify
is true
, the width of the items is set to
either the explicit width of the container, or the maximum width of
all items, whichever is larger. When false
, the width of the items
is set to the explicit width of the container, even if the items are
measured to be larger.
1.0.0
.gap:Float
The space, in pixels, between each two adjacent items in the layout.
In the following example, the layout's gap is set to 20 pixels:
layout.gap = 20.0;
1.0.0
.paddingBottom:Float
The space, in pixels, between the parent container's bottom edge and its content.
In the following example, the layout's bottom padding is set to 20 pixels:
layout.paddingBottom = 20.0;
1.0.0
.paddingLeft:Float
The space, in pixels, between the parent container's left edge and its content.
In the following example, the layout's left padding is set to 20 pixels:
layout.paddingLeft = 20.0;
1.0.0
.paddingRight:Float
The space, in pixels, between the parent container's right edge and its content.
In the following example, the layout's right padding is set to 20 pixels:
layout.paddingRight = 20.0;
1.0.0
.paddingTop:Float
The space, in pixels, between the parent container's top edge and its content.
In the following example, the layout's top padding is set to 20 pixels:
layout.paddingTop = 20.0;
1.0.0
.requestedMaxRowCount:Null<Float>
The maximum number of rows to render, if the height of the container has
not been set explicitly. If null
, the maximum number of rows is the
total number of items displayed by the layout.
If requestedRowCount
is also set, this property is ignored.
In the following example, the layout's requested maximum row count is set to 5 complete items:
layout.requestedMaxRowCount = 5.0;
1.0.0
.requestedMinRowCount:Null<Float>
The minimum number of rows to render, if the height of the container has
not been set explicitly. If null
, this property is ignored.
If requestedRowCount
is also set, this property is ignored.
In the following example, the layout's requested minimum row count is set to 2 complete items:
layout.requestedMinRowCount = 2.0;
1.0.0
.requestedRowCount:Null<Float>
The exact number of rows to render, if the height of the container has
not been set explicitly. If null
, falls back to requestedMinRowCount
and requestedMaxRowCount
.
In the following example, the layout's requested row count is set to 2 complete items:
layout.requestedRowCount = 2.0;
1.0.0
.verticalAlign:VerticalAlign
How the content is positioned vertically (along the y-axis) within the container.
Note: The VerticalAlign.JUSTIFY
constant is not supported by this
layout.
The following example aligns the container's content to the bottom:
layout.verticalAlign = BOTTOM;
1.0.0
.See also:
Methods
getNearestScrollPositionForIndex(index:Int, itemCount:Int, width:Float, height:Float, ?result:Point):Point
getVisibleIndices(itemCount:Int, width:Float, height:Float, ?result:VirtualLayoutRange):VirtualLayoutRange
layout(items:Array<DisplayObject>, measurements:Measurements, ?result:LayoutBoundsResult):LayoutBoundsResult
See also:
setPadding(value:Float):Void
Sets all four padding properties to the same value.
1.0.0
.See also: