Skip to main content

ADF 11g Skinning: Three ways to change look and feel

On the JDeveloper ADF forum there are many questions on how to change the look and feel of components. In this post I'll explain three ways to do that.

Setting skin Selector property

For this we need to define a custom skin.
<?xml version="1.0" encoding="ISO-8859-1"?>
<skins xmlns="http://myfaces.apache.org/trinidad/skin">
  <skin>
    <id>mySkin.desktop</id>
    <family>MySkin</family>
    <extends>blafplus-rich.desktop</extends>
    <render-kit-id>org.apache.myfaces.trinidad.desktop</render-kit-id>
    <style-sheet-name>skins/MySkin.css</style-sheet-name>
   </skin>
 </skins>

In the style sheet we will add an entry that will hide the columnheaders.
af|column::column-header-cell{display: none;}

This entry in the styleSheet will apply to ALL columns in your application.


Using and appending styleClasses

Now we create a StyleClass that is exactly the same as the style in the previous example.
.TableNoHeader af|column::column-header-cell{display: none;}

When we apply this styleClass to only one of the tables in our application, we will see the effect.
<af:table value="#{bindings.Departments1.collectionModel}" 
                  var="row"
                  rows="#{bindings.Departments1.rangeSize}" 
                  styleClass="TableNoHeader"
                  emptyText="#{bindings.Departments1.viewable ? 'No data to display.' : 'Access Denied.'}"
                  fetchSize="#{bindings.Departments1.rangeSize}"
                  rowBandingInterval="0"
                  filterModel="#{bindings.Departments1Query.queryDescriptor}"
                  queryListener="#{bindings.Departments1Query.processQuery}"
                  filterVisible="true" 
                  varStatus="vs"
                  selectedRowKeys="#{bindings.Departments1.collectionModel.selectedRow}"
                  selectionListener="#{bindings.Departments1.collectionModel.makeCurrent}"
                  rowSelection="single" 
                  id="t1">

Only one table has no columnheaders now.


Use Skins to change labels.

Using styleClasses you can adjust a lot of the components look and feel. However, you cannot change the labels and hint texts that are shown in the application. To do that you will have to use a skin resource bundle. See in the example below the bundle-name tag.
<?xml version="1.0" encoding="ISO-8859-1"?>
<skins xmlns="http://myfaces.apache.org/trinidad/skin">
  <skin>
    <id>mySkin.desktop</id>
    <family>MySkin</family>
    <extends>blafplus-rich.desktop</extends>
    <render-kit-id>org.apache.myfaces.trinidad.desktop</render-kit-id>
    <style-sheet-name>skins/MySkin.css</style-sheet-name>
    <bundle-name>com.blogspot.lucbors.view.bundles.MySkinBundle </bundle-name>
  </skin>
 </skins>

Create the class that will hold the entries for the bundle.

Lets asume that we want a different text for the pannelsplitter.

Add entries for all labels and hints that you need to change.
package com.blogspot.lucbors.view.bundles;

import java.util.ListResourceBundle;

public class MySkinBundle extends ListResourceBundle {
  public MySkinBundle() {
    super();
  }
 @Override
  public Object[][] getContents() {
    return _CONTENTS;
  }
 
 static private final Object[][] _CONTENTS = {
     {"af_column.TIP_SORT_ASCENDING","first things first"}
    ,{"af_panelCollection.LABEL_MENUITEM_QBE","the text that you want"}
    ,{"af_panelSplitter.TIP_COLLAPSE", "hide all of this this"}
    ,{"af_panelSplitter.TIP_RESTORE", show all again"}"
   };
}

When you run the application now, you will see changed texts.


Online overview with all skin selectors can be found here;
The workspace for this blogpost can be downloaded here.
Labels:

Comments

Ashish Mishra said…
Nice post. It was very helpful.
12:46 AM
sivanagakrishna said…
Hi Luc,


Thanks for sharing the post.i have one doubt,When i am trying to change af_messages.TIP_ERROR with custom text i am not able to see the changes in UI. Any suggestion would be helpful.
7:32 AM
Post a Comment

Popular posts from this blog

ADF 12.1.3 : Implementing Default Table Filter Values

In one of my projects I ran into a requirement where the end user needs to be presented with default values in the table filters. This sounds like it is a common requirement, which is easy to implement. However it proved to be not so common, as it is not in the documentation nor are there any Blogpost to be found that talk about this feature. In this blogpost I describe how to implement this. The Use Case Explained Users of the application would typically enter today's date in a table filter in order to get all data that is valid for today. They do this each and every time. In order to facilitate them I want to have the table filter pre-filled with today's date (at the moment of writing July 31st 2015). So whenever the page is displayed, it should display 'today' in the table filter and execute the query accordingly. The problem is to get the value in the filter without the user typing it. Lets first take a look at how the ADF Search and Filters are implemented by...
6 comments
Read more

ADF 11g Quicky 3 : Adding Error, Info and Warning messages

How can we add a message programatically ? Last week I got this question for the second time in a months time. I decided to write a short blogpost on how this works. Adding messages is very easy, you just need to know how it works. You can add a message to your faces context by creating a new FacesMessage. Set the severity (ERROR, WARNING, INFO or FATAL ), set the message text, and if nessecary a message detail. The fragment below shows the code for an ERROR message. 1: public void setMessagesErr(ActionEvent actionEvent) { 2: String msg = "This is a message"; 3: AdfFacesContext adfFacesContext = null; 4: adfFacesContext = AdfFacesContext.getCurrentInstance(); 5: FacesContext ctx = FacesContext.getCurrentInstance(); 6: FacesMessage fm = 7: new FacesMessage(FacesMessage.SEVERITY_ERROR, msg, ""); 8: ctx.addMessage(null, fm); 9: } I created a simple page with a couple of buttons to show the result of setting the message. When the but...
2 comments
Read more

ADF 12c : Using Jasper Reports en JasperSoft Studio 6.1; What Libraries do you need?

Over the last couple of years, or better in the last decade I have implemented several reporting solutions with Jasper Reports in ADF. I did that in ADF 10g, ADF 11.1.1.x, ADF 11.1.2.x and ADF 12.1.x I also used several version of Jasper Reports. There is a whole lot of documentation, blogposts and presentations available. So when today I got a request from one of my customers to make a setup for the implementation of Jasper Reports 6.1 in ADF 12.1.3 I did not expect any problems. Boy was I wrong. Here is the Story With all the knowledge from the past, I decided to follow the known steps. 1) Download iReport Designer, 2) Build a report in iReport 3) Create an ADF application 4) Add the necessary libraries to use the report 5) Call the report from a button via a Managed Bean Step 1 In the past I used iReport designer to build the reports. When you go to the download site of iReport designer you now see an interesting message. So I took this serious and decided not to u...
2 comments
Read more