Building Tag Cloud Declarative ADF Component
- by Arunkumar Ramamoorthy
When building a website, there could a requirement to add a tag cloud to let the users know the popular tags (or terms) used in the site. In this blog, we would build a simple declarative component to be used as tag cloud in the page.
To start with, we would first create the declarative component, which could display the tag cloud. We will do that by creating a new custom application from the new gallery.
Give a name for the app and the project and from the new gallery, let us create a new ADF Declarative Component
We need to specify the name for the declarative component, attributes in it etc. as follows
For displaying the tags as cloud, we need to pass the content to this component. So, we will create an attribute to hold the values for the tag. Let us name it as "value" and make it as java.lang.String type.
Once after this, to hold the component, we need to create a tag library. This can be done by clicking on the Add Tag Library button.
Clicking on OK buttons in all the open dialogs would create a declarative component for us. Now, we need to display the tag cloud based on the value passed to the component. To do that, we assume that the value is a Tree Binding and has two attributes in it, say "Name" and "Weight". To make a tag cloud, we would put together the "Name" in a loop and set it's font size based on the "Weight". After putting our logic to work, here is how the source look
Attributes added to the declarative components can be retrieved by using #{attrs.<attribute_name>}. Now, we need to deploy this project as ADF Library Jar file, so that this can be distributed to the consuming applications.
We'll select ADF Library Jar as type and create the profile.
We would be getting the jar file after deployment.
To test the functionality, we could create a simple Fusion Web Application.
To add our custom component to the consuming application, we can create a file system connection pointing to the location where the jar file is and add it or, add through the project properties of the ViewController project.
Now, our custom component has been added to the consuming application. We could test that by creating a VO in the model project with a query like,
select 'Faces' as Name,25 as Weight from dual union all select 'ADF', 15 from dual union all select 'ADFdi', 30 from dual union all select 'BC4J', 20 from dual union all select 'EJB', 40 from dual union all select 'WS', 35 from dual
Add this VO to the AppModule, so that it would be exposed to the data control. Then, we could create a jspx page, and add a tree binding to the VO created.
We can now see our Tag Cloud declarative component is available in the component palette.
It can be inserted from the component palette to our page and set it's value property to CollectionModel of the tree binding created.
Now that we've created the Declarative component and added that to our page successfully, we can run the page to see how it looks.
As per the query, the Tags are displayed in different fonts, based on their weight.
