tobago-example/tobago-example-demo/src/main/webapp/content/10-intro/50-migration/95-migration/4.0_to_5.0.xhtml

<?xml version="1.0" encoding="UTF-8"?>

<!--
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
-->

<ui:composition template="/main.xhtml"
                xmlns="http://www.w3.org/1999/xhtml"
                xmlns:tc="http://myfaces.apache.org/tobago/component"
                xmlns:ui="http://xmlns.jcp.org/jsf/facelets">

  <tc:section label="Migration from Tobago 4.0 to 5.0">
    <p>
      There are some migration steps to do, dependent on the application
      you want to migrate. The steps can be classified by
    </p>

    <ul>
      <li><tc:link link="" fragment="page:mainForm:themeBuilding" label="Theme Building"/></li>
      <li><tc:link link="" fragment="page:mainForm:resourceBundles" label="Resource Bundles"/></li>
    </ul>

    <tc:section id="themeBuilding" label="Theme Building">
    </tc:section>

    <tc:section id="resourceBundles" label="Resource Bundles">

      <tc:section id="migration-program" label="Java Class to Migrate from XML to properties">
        <p>Here is a simple <tc:link label="Java Class" link="ConvertXmlToProperties.java"/>,
          that may help you to change the layout attributes in the
          facelets XHTML files.</p>
        <demo-highlight language="java"><tc:out value="#{migration5Controller.javaSource}" escape="true" keepLineBreaks="false"/></demo-highlight>
      </tc:section>

      <tc:section>
        TobagoContext.getResourceBundle() returns now ResourceBundle
        TobagoContext.getMessageBundle() returns now ResourceBundle
      </tc:section>

    </tc:section>

    <tc:section id="components" label="UI Components">

      <tc:section id="suggest" label="Suggest">
        For local menu for the suggest box use <code class="language-markup">localMenu="true"</code> in <code class="language-markup">&lt;tc:suggest></code> instead of <code class="language-markup">markup="localMenu"</code> in the
        <code class="language-markup">&lt;tc:in></code>.
      </tc:section>

      <tc:section label="File Upload">
        The attribute <code class="language-markup">placehoder</code> in <code class="language-markup">&lt;tc:file></code>
        has been removed, because its not supported with Bootstrap 5.
      </tc:section>

    </tc:section>

    <tc:section id="java" label="Java API">

      <tc:section id="icons" label="Icons">
        Class <code class="language-java">org.apache.myfaces.tobago.renderkit.css.Icons</code>
        was renamed to <code class="language-java">org.apache.myfaces.tobago.renderkit.css.FaIcons</code>,
        because of possible futures changes to icon libraries.
      </tc:section>

    </tc:section>

    <tc:section id="javascript-api" label="JavaScript API">

      <tc:section id="listener" label="Listener Registration (work in progress)">

        <demo-highlight language="java">Tobago.registerListener(Demo.init, Tobago.Phase.DOCUMENT_READY);
Tobago.registerListener(Demo.init, Tobago.Phase.AFTER_UPDATE);
</demo-highlight>

        <demo-highlight language="java">Listener.register(Demo.init, Phase.DOCUMENT_READY);
Listener.register(Demo.init, Phase.AFTER_UPDATE);
</demo-highlight>

      </tc:section>

    </tc:section>

  </tc:section>

</ui:composition>