3.0 to 4.0

Using the link attribute of <tc:link>, <tc:button>, <tc:treeCommand> or <tc:event> in Tobago 3 has three cases:

1. External link to an URL e. g. link="http://www.apache.com"

   Here is nothing to do.

2. Internal link to a resource e. g. link="image/alps.png"

   Here you need to add the contextPath which might not be an empty string: link="#{request.contextPath}/image/alps.png". So, this is now the same like resources used over other attributes.

3. Internal link to a viewId e. g. link="/intro.xhtml"

   In this case you need to use the new attribute outcome="/intro.xhtml". Please use only full pathes here! This this, the GET parameter will be respected. This is needed e. g. for the windowId of DeltaSpike.

The content of <tc:bar> needs to be checked. The layout inside of the bar has been changed by CSS.

There is a new after-facet for right side content. Old code which uses <tc:flowLayout align=right> probably doesn't work correctly.

Replace the following code...

<tc:bar>
  <tc:flowLayout textAlign="right">
    // right side content
  </tc:flowLayout>
</tc:bar>

... with this:

<tc:bar>
  <f:facet name="after">
    <tc:flexLayout columns="1fr auto">
      // right side content
    </tc:flexLayout>
  </f:facet>
</tc:bar>

Also new markups are added to change collapse/expand behavior and color scheme. For more information have a look at tc:bar

Column/row attribute values are now space separated. The '*' character is replaced by 'fr'.

Instead of <tc:flexLayout column="200px;auto;1*;2*;10rem"> you can write <tc:flexLayout column="200px auto 1fr 2fr 10rem">.

The old syntax is deprecated but still possible.

Attribute values are now space seperated. Integer values now have the unit 'seg'.

The old syntax is deprecated but still possible.

The 12 columns of a segment layout are no longer filled up.

Explained on the example medium="3seg 4seg":

• Result in Tobago3: The first child of the segment layout spans 3 columns, the second 4 columns, the third 5 columns (filled up) and the fourth 3 columns again.
• Result in Tobago4: The first child spans 3 columns, the second 4 columns, the third 3 columns again and the fourth 4 columns.

There are also two new 'auto' and '1fr' attribute values. For more information see tc:segmentLayout.

The attribute syntax for columns and rows has also been changed. See script below.

The attribute syntax for columns has also been changed. See script below.

Here is a simple migration script, that may help you to change the layout attributes in the facelets XHTML files.