Styling (and Layout) with CSS

There are different techniques and technologies available to determine the size (width and height) of a rendered widget.

The browser uses CSS (Cascading Style Sheets) as a technology for defining visual aspects, such as fonts, colors, border styles, but also for geometry.
Layout Managers
Whereas CSS (and browsers) were originally designed for the markup of documents, the requirements for web applications are in many ways different. Layout Managers are a common technique in desktop applications to lay out a UI, and this is also available in JWt.
CSS Grids
A practical alternative to plain CSS, and to overcome some of its deficiencies which, are CSS frameworks which allow one to place widgets using a generic tag system. These typically divide the page in a virtual grid. When using JWt with the Bootstrap theme, such a CSS grid framework is included.

Introduction to CSS

Cascading Style Sheets (CSS) group rules that specify both markup and layout properties of widgets. These rules are linked to certain widgets (or more correctly, DOM nodes in the browser that render these widgets) using selectors. Selectors may match widgets based on the style class or widget id of the widget or one of its ancestors, or even more advanced combinations.

Primer + reference here.

Three ways to use CSS in JWt.

Inline CSS
A single widget's style properties can be modified directly using Java API
Internal StyleSheet
The internal stylesheet allows to use a Java API to create, modify and remove CSS style rules that typically impact multiple widgets.
External StyleSheets
By far the most practical approach is to use external CSS stylesheets that define styling rules, and apply them to JWt widgets using style classes.

API for inline CSS style

A subset of CSS properties are available in the JWt API, and thus allow to influence the layout or visual appearance of a widget directly, from Java. This is useful if you want programmatic control over these properties; for other situations we recommend to use an external CSS stylesheet.

CSS properties that impact layout aspects are made available directly in the WWidget API, whereas decorative aspects are available from WWidget.cssDecorationStyle(), which returns a reference to a WCssDecorationStyle class.

The following table gives an overview of properties that can be directly modified from Java.

Class Property Description
WWidget setPositionScheme() CSS position property.
WWidget setOffsets() CSS top, right, bottom, left properties.
WWidget resize() CSS width, height properties.
WWidget setMinimumSize() CSS min-width, min-height properties.
WWidget setMaximumSize() CSS max-width, max-height properties.
WWidget setLineHeight() CSS line-height property.
WWidget setFloatSide() CSS float property.
WWidget setClearSides() CSS clear property.
WWidget setMargin() CSS margin property.
WWidget setVerticalAlignment() CSS vertical-align property.
WWidget setInline(), setHidden() CSS display property.
WCssDecorationStyle setCursor() CSS cursor property.
WCssDecorationStyle setBackgroundColor(), setBackgroundImage() CSS background property.
WCssDecorationStyle setForegroundColor() CSS color property.
WCssDecorationStyle setBorder() CSS border property.
WCssDecorationStyle setFont() CSS font property.
WCssDecorationStyle setTextDecoration() CSS text-decoration property.

The Internal Style Sheet

The method WApplication.styleSheet() returns a reference to the embedded stylesheet (an instance of WCssStyleSheet), which can be manipulated dynamically to add, modify or removing rules. This is used primarily in some advanced composite widgets within JWt (such as WTableView, WTreeView) since it allows to modify certain properties of a group of widgets using a minimum of DOM manipulations.

Using External Style Sheets

Widgets may allow configuration of their look and feel through style classes. These may be defined in an embedded stylesheet or in external style sheets. Preferably use external stylesheets because of the strict separation between style and widget. It provides the broadest application of style as it allows you to manage the presentational aspects of all widgets from a handful of style sheets.

These are API classes and methods for working with CSS external stylesheets:

Class Method Description
WApplication useStyleSheet() Adds an external style sheet
WWidget setStyleClass() Sets (one or more) CSS style classes
WWidget styleClass() Returns the CSS style class
WWidget addStyleClass() Adds a CSS style class
WWidget removeStyleClass Removes a CSS style class
WWidget toggleStyleClass Toggles a CSS style class

The following example shows how to refer to add an external style sheet to the application and how to add/remove classes to a widget like WTable.


These are the most import API classes and methods for working with CSS:

WApplication::useStyleSheet()Adds an external style sheet
WWidget::setStyleClass()Sets (one or more) CSS style classes
WWidget::removeStyleClass()Removes a CSS style class
WWidget::toggleStyleClass()Toggles a CSS style class
  void CSS() {
    WApplication.getInstance().useStyleSheet(new WLink("style/CSSexample.css"));
    WContainerWidget container = new WContainerWidget();
    WPushButton allB = new WPushButton("Set all classes", (WContainerWidget) container);
    final WPushButton removeB = new WPushButton("Remove info class", (WContainerWidget) container);
    removeB.setMargin(new WLength(10), EnumSet.of(Side.Left, Side.Right));
    final WPushButton toggleB = new WPushButton("Toggle compact", (WContainerWidget) container);
    WText text = new WText((WContainerWidget) container);
    text.setText("<p>These are the most import API classes and methods for working with CSS:</p>");
    final WTable table = new WTable((WContainerWidget) container);
    new WText("Method", (WContainerWidget) table.getElementAt(0, 0));
    new WText("Description", (WContainerWidget) table.getElementAt(0, 1));
    new WText("WApplication::useStyleSheet()", (WContainerWidget) table.getElementAt(1, 0));
    new WText("Adds an external style sheet", (WContainerWidget) table.getElementAt(1, 1));
    new WText("WWidget::setStyleClass()", (WContainerWidget) table.getElementAt(2, 0));
    new WText("Sets (one or more) CSS style classes", (WContainerWidget) table.getElementAt(2, 1));
    new WText("WWidget::removeStyleClass()", (WContainerWidget) table.getElementAt(3, 0));
    new WText("Removes a CSS style class", (WContainerWidget) table.getElementAt(3, 1));
    new WText("WWidget::toggleStyleClass()", (WContainerWidget) table.getElementAt(4, 0));
    new WText("Toggles a CSS style class", (WContainerWidget) table.getElementAt(4, 1));
            () -> {
              table.setStyleClass("table table-bordered");
              for (int i = 1; i < table.getRowCount(); i++) {
                table.getElementAt(i, 0).setStyleClass("code");
            () -> {
            () -> {
              if ((toggleB.getText().toString().equals("Toggle compact".toString()))) {
                table.toggleStyleClass("table-sm", true);
                toggleB.setText("Toggle expanded");
              } else {
                table.toggleStyleClass("table-sm", false);
                toggleB.setText("Toggle compact");

Here is the corresponding style sheet (CSSexample.css).

.CSS-example table {
  width: 0%;
  margin-top: 20px;
  margin-bottom: 20px;

.CSS-example .table-bordered {
  border: 1px solid #DDD;
  border-left: 0;
  border-radius: 4px;

.CSS-example .table-sm th,
.CSS-example .table-sm td {
  padding: 4px 5px;

.CSS-example .code {
  font-family: andale mono;
  color: #570;
  font-size: 97%;

.CSS-example .info {
  background-color: #D9EDF7;