Class: WidgetGroup

WidgetGroup

A widget group is a layout owner that can position its children according to the layout given to it.

new PUXI.WidgetGroup ()

Example
```
const group = new PUXI.InteractiveGroup();

group.useLayout(new PUXI.AnchorLayout());

group.addChild(new PUXI.Button({ text: "Hey" })
 .setLayoutOptions(
     new PUXI.AnchorLayoutOptions({
            anchorLeft: 100,
            anchorTop: 300,
            anchorRight: .4,
            anchorBottom: 500,
            horizontalAlign: PUXI.ALIGN.CENTER
     })
 )
)
```

Extends

Members

alpha number inherited

Alpha of this widget & its contents.

contentContainer PIXI.Container readonly inherited

This container holds the content of this widget. Subclasses should add renderable display-objects to this container.

contentHeight number readonly inherited

Layout height of this widget's content, which is the height minus vertical padding.

contentWidth number readonly inherited

Layout width of this widget's content, which is the width minus horizontal padding.

height number readonly inherited

Layout height of this widget.

insetContainer PIXI.Container readonly inherited

This container owns the background + content of this widget.

interactive boolean inherited

Whether this widget is interactive in the PixiJS scene graph.

layoutMeasure PUXI.Insets readonly inherited

Layout insets of this widget. In normal state, the widget should be in this rectangle inside the parent reference frame.

measuredHeight number inherited

The measured height that is used by the parent's layout manager to place this widget.

measuredWidth number inherited

The measured width that is used by the parent's layout manager to place this widget.

paddingBottom number inherited

Padding on bottom side.

paddingHorizontal number readonly inherited

Sum of left & right padding.

paddingLeft number inherited

Padding on left side.

paddingRight number inherited

Padding on right side.

paddingTop number inherited

Padding on top side.

paddingVertical number readonly inherited

Sum of top & bottom padding.

stage PUXI.Stage readonly inherited

Stage whose scene graph holds this widget. Once set, this cannot be changed.

widgetChildren Array.<PUXI.Widget> readonly inherited

Children of this widget. Use WidgetGroup to position children.

width number readonly inherited

Layout width of this widget.

Methods

addChild (widgets)Widget inherited

Adds the widgets as children of this one.

Name Type Description
widgets Array.<PUXI.Widget> repeatable
Returns:
Type Description
Widget
  • this widget

clearDraggable () inherited

Makes this widget not draggable.

clearDroppable () inherited

Makes this widget not droppable.

getBackground ()PIXI.Container inherited

Returns:
Type Description
PIXI.Container
  • the background display-object

getBackgroundAlpha ()number inherited

Returns:
Type Description
number the alpha on the background display-object.

getElevation ()number inherited

Returns:
Type Description
number the elevation set on this widget

getMeasuredHeight ()number inherited

Alias for Widget.measuredHeight.

Returns:
Type Description
number the measured height

getMeasuredWidth ()number inherited

Alias for Widget.measuredWidth.

Returns:
Type Description
number the measured width

initialize () protected inherited

Widget initialization related to the stage. This method should always call super.initialize().

This method expects stage to be set before calling it. This is handled by the Stage itself.

This will set initialized to true. If it was already set to true, it should do nothing.

makeDraggable () inherited

Makes this widget draggable.

makeDroppable () inherited

Makes this widget droppable.

measure (width, height, widthMode, heightMode) inherited

This method calls Widget.onMeasure and should not be overriden. It does internal bookkeeping.

Name Type Description
width number
height number
widthMode PUXI.MeasureMode
heightMode PUXI.MeasureMode

onLayout (l, t, r, b, dirty) protected inherited overrides

This method should set the frame in which rendering will occur and lay out child widgets in that frame.

Name Type Default Description
l
t
r
b
dirty true

onMeasure (width, height, widthMode, heightMode) inherited overrides

Override this method to measure the dimensions for your widget. By default, it will use the natural width/height of this widget's content (contentContainer) plus any padding.

Name Type Description
width number

width of region provided by parent

height number

height of region provided by parent

widthMode PUXI.MeasureMode

mode in which provided width is to be used

heightMode PUXI.MeasureMode

mode in which provided height is to be used

removeChild (widgets)Widget inherited

Orphans the widgets that are children of this one.

Name Type Description
widgets Array.<PUXI.Widget> repeatable
Returns:
Type Description
Widget
  • this widget

requestLayout () inherited

Will trigger a full layout pass next animation frame.

setBackground (bg) inherited

The background of a widget is a PIXI.DisplayObject that is rendered before all of its children.

Name Type Description
bg PIXI.Container | number | string

the background display-object or a color that will be used to generate a PIXI.Graphics as the background.

setBackgroundAlpha (val) inherited

This can be used to set the alpha on the background of this widget. This does not affect the widget's contents nor individual components of the background display-object.

Name Type Description
val number

background alpha

setElevation (val) inherited

This can be used add a drop-shadow that will appear to raise this widget by the given elevation against its parent.

Name Type Description
val number

elevation to use. 2px is good for most widgets.

setLayoutOptions (lopt)Widget inherited

Use this to specify how you want to layout this widget w.r.t its parent. The specific layout options class depends on which layout you are using in the parent widget.

Name Type Description
lopt PUXI.LayoutOptions
Returns:
Type Description
Widget this

setPadding (l, t, r, b) inherited

Sets the padding values.

To set all paddings to one value:

widget.setPadding(8);

To set horizontal & vertical padding separately:

widget.setPadding(4, 12);
Name Type Default Description
l number 0 optional

left padding

t number l optional

top padding (default is equal to left padding)

r number l optional

right padding (default is equal to right padding)

b number t optional

bottom padding (default is equal to top padding)

useDefaultLayout ()

Sets the widget-recommended layout manager. By default (if not overriden by widget group class), this is a fast-layout.

useLayout (layoutMgr)

Will set the given layout-manager to be used for positioning child widgets.

Name Type Description
layoutMgr PUXI.ILayoutManager