Learning Qooxdoo 3

The basic steps to create a qooxdoo application is as follows:

1. Select a layout (VBox, HBox, Grid, Dock….)
2. Create a container from the layout. (Usually Composite)
3. Add the container to the application root (Document).
4. Add as many widgets as you can to container.

Following is an example to create three button to a VBox container.

var layout = new qx.ui.layout.VBox();
var container = new qx.ui.container.Composite(layout);
this.getRoot().add(container);

container.add(new qx.ui.form.Button('This is a button 1'));
container.add(new qx.ui.form.Button('This is a button 2'));
container.add(new qx.ui.form.Button('This is a button 3'));

There is an convenient way to run qooxdoo code is the playground. Just copy the code and paste it into the source code editor, click run button.

Next, we want the button fill all the width of the Viewport

var layout = new qx.ui.layout.VBox();
var container = new qx.ui.container.Composite(layout);
container.setWidth(qx.bom.Viewport.getWidth());
container.setHeight(qx.bom.Viewport.getHeight());
this.getRoot().add(container);

container.add(new qx.ui.form.Button('This is a button 1'));
container.add(new qx.ui.form.Button('This is a button 2')); 

container.add(new qx.ui.form.Button('This is a button 3'));

We have many ways to set width and height of the container:
like this:

container.set({ 
     qx.bom.Viewport.getWidth(), 
    height: qx.bom.Viewport.getHeight()
});

and this:

container.set('width', qx.bom.Viewport.getWidth());
container.set('height', qx.bom.Viewport.getHeight());

There is also an easy way to do this, set the edge to 0px:

var layout = new qx.ui.layout.VBox();
var container = new qx.ui.container.Composite(layout);
this.getRoot().add(container, { edge: 0 }); 

container.add(new qx.ui.form.Button('This is a button 1'));
container.add(new qx.ui.form.Button('This is a button 2'));
container.add(new qx.ui.form.Button('This is a button 3'));

You can modify the edge value to see the result in action.

Finally, we want the button to fill the height of the container:

var layout = new qx.ui.layout.VBox();
var container = new qx.ui.container.Composite(layout);
this.getRoot().add(container, { edge: 0 });

container.add(new qx.ui.form.Button('This is a button 1'), { flex: 0 });
container.add(new qx.ui.form.Button('This is a button 2'), { flex: 1 });
container.add(new qx.ui.form.Button('This is a button 3'), { flex: 1 });

The Flex is an importent option to control the vertical behavior, just as this article say:

Flex property determines how the extra space2 is distributed between children. By default it is set to 0, which means that the widget will not grow vertically. Any other (integer) value for flex will cause growing to occupy the extra space. Growing is proportional to flex value.