Skip to Content
Author's profile photo Wouter Lemaire

UI5 Custom Controls with aggregation

Hi all,

A few months ago I’ve posted a blog about a SAP WebIDE Plugin that I’ve created to generate custom UI5 controls. In that blog I also showed how to create a custom control using this plugin. You can find the blog here:

The plugin is also in the SAPStore and can be used free of charge!–sap-web-ide-plugin–flexso-nv

At the moment the plugin is very basic and can only be used for creating basic controls. Building advanced UI5 controls is not yet foreseen in this plugin. But still, it can boost your developments.

In this blog I’ll show you how to create UI5 controls that can be used together and how my plugin can help you with it.

As an example I started from an HTML snippet that I’ve found on the web:

More HTML snippets on

I’m going to convert this HTML snippet into a UI5 control. Therefore I have to split the HTML in two parts:

  • One control for the list item: An item can be used zero to multiple times in a list. This is something that should be generic and so it requires a separate UI5 control
  • One control for the list: This is the place where items will be added. This is a separate control with a specific css class for the design

First I’ll start with creating the controls, then I’ll connect the two controls and last but not least I’ll use them in my view with bindings.

UI5 List Item Control

Okay, let’s start with the item and create a file “CustomListItem.js” in the folder “control” (you have to create this folder)


I copy the HTML for one item of the list out of the snippet, which looks like this:

<li><a href="#"><img src="" /></a></li>

Put it in the Generator plugin:

Hit the convert button ,use the WebIDE beautify function and change the namespace regarding to your project namespace and filename.

UI5 List Control

Now create a javascript file for the list in the control folder.

Now I take the outer tags of the list from the snippet:

<div class="customlist">

Again put it in the generator:

Let the converter do his job, then run the beautifier in the WebIDE and change the namespace and control name.

Connect the two controls

I want to use the List Item control in my List control. I’ll need to add some code manually. This part is not (yet) foreseen in the control generator. In the metadata of the list control I’m going to add an aggregation “items”. The definition of the aggregation contains following attributes:

  • Type: This is the type of the controls that you can use in the aggregation. We want to use our CustomListItem control in this CustomList. We use the namespace + the name of the custom list item to define the type of the aggregation.
  • Multiple: Defines how many times the childe control can be used in the CustomList
  • singularName: a reference to one item of the aggregation

Next step is to integrate the aggregation “items” in the renderer function of the list control. Therefore I’ve added a loop ($.each) to render all items in the aggregations.

I also include the css in my project. Just by pasting it in the “style.css”.

Use the control

First step to use the control in the view is by adding a reference to the  folder where the control is located and add a namespace to it (cust):

With the namespace (cust) I can now use my two controls together. First I open the tag for the “CustomList”. Between the “CustomList” tags I open the aggregation tags “items”. There I can then add the “CustomListItem” control. In the “CustomListItem” tags I add the attributes for the hyperlink (href1) and the image (src1).

This is the result:

Use the control with bindings

This step is similar to the previous one but now I’m going to use bindings to show images and hyperlinks.

In the Controller I’ve created a JSONModel with multiple images and hyperlinks which I bind to the view.

In the view I add the binding for the items in the “CustomList”. “grid” is a reference to the array in the JSONModel.

“hyperlink” and “image” are references to the properties in the objects of the array “grid”.

This will look like this.

You can find all the code on github:

Preview of the result:


You can do make some real cool stuff with custom controls!


Kind regards,


Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Hao Jia
      Hao Jia


      i have a question regarding this, assume your custom list item renders Input control as a child instead of image. Will the Input - Model a two way binding?

      I've done similar thing but when I change the model,  the Inout value didn't change. Also when I changed the Input value, the model didn't get updated too.


      Author's profile photo Wouter Lemaire
      Wouter Lemaire
      Blog Post Author

      Hi Jia,

      It should support two way binding. Did you configured your model as two way binding? This is not always activated by default.

      Kind regards,


      Author's profile photo Karthik Arjun
      Karthik Arjun

      I'm facing the same model binding error. I have changed the mode to two way binding, but still no luck

      Author's profile photo Stefano Cataldo
      Stefano Cataldo

      Hi there,

      great blog … I get it. At least, so far, the first part (it is w/o binding). I would like to share two points with you

      1. I did not found the plugin ? therefore, I write the Controls by hand (it’s okay, do not forget the setSrc1 method (not shown in the screenshot)).
      2. I have had trouble with the aggregations. I overcome, by putting a default aggregation. Please take care, if you want to rebuild this.

      Regards, Stefano

      	return Control.extend("MyNameSpace.CustomList", { 
      		 "metadata": {
      		 	"properties": {},
      		 	"events": {},
      		 	"aggregations": {
      		 		"items": {
      		 			"type": "MyNameSpace.CustomListItem",
      		 			"multiple": true,
      		 			"singularName": "item"
      		 			defaultAggregation: "items"
      Author's profile photo Wouter Lemaire
      Wouter Lemaire
      Blog Post Author

      Thanks for the feedback!