Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Defining Events

To capture any action on the rows in the grid, such as click or double-click, you must define events in the Row Template.

Note

You must define the events for the Row Template in the template file and capture the related actions in the JavaScript file for your application.

The Row Template supports the following events:

...


The Cell Click event occurs when a cell is clicked once. The Cell Click event also raises the Row Click event.

...

Note

Whether you define a cell click, row click, cell double click, row double click, change or a context click event, the data that is returned will be:

  • Column ID
  • Template configuration (cell value)
  • Current row data


Anchor
RowTemplate_CellClickRowClick
RowTemplate_CellClickRowClick
Cell Click and Row Click Events

The Cell Click event occurs when a row cell is clicked once. The Cell Click event also raises the Row Click event.

The Row Click event occurs when a row is clicked once.

Note

For the Cell Click and Row Click events to function, the attribute data-single-click = "true" must be defined. As we are configuring the template for a row, we need to define the attributes data-item-id = "ct-tpl-record" and data-row-index = "{{index}}" as well.

...

On a Row Click event, the column ID is returned followed by the row details and the template configuration (value) as shown in the following screen shot:

To capture actions through the Cell Click and Row Click events, use the event handler functions. For the Deposit Summary app, you need to capture the actions as follows:

  • Cell Click event

    Code Block
    languagejs
    CWEH.registerHandler('WGT_DEPOSIT_SUMMARY’, CWEC.CELL_CLICK, function(columnId, value, record)
    {
    	LOGGER.info('The CELL_CLICK event is captured.', [columnId, value, record]);
    });
    
    // Here, 'WGT_DEPOSIT_SUMMARY' is the widget ID.


  • Row Click event

    Code Block
    languagejs
    CWEH.registerHandler('WGT_DEPOSIT_SUMMARY’, CWEC.CELLROW_DBLCLICKCLICK, function(columnId, valuerecord, recordvalue)
    {
    	LOGGER.info('The CELLROW_DBLCLICKCLICK event is captured.', [columnId, valuerecord, recordvalue]);
    });
    
    // Here, 'WGT_DEPOSIT_SUMMARY' is the widget ID.


...

Note

The Change event is applicable only for checkboxes and radio buttons.

For the Change the Change event to function, the attribute data-input = "true" must be defined. As we are configuring the template for a row, we need to define the attributes data-item-id = "ct-tpl-record" and data-row-index = "{{index}}" as well.

For example, when you select and clear the checkbox on a cell of the Deposit Summary widget, the Change event is triggered.

Image Added

To achieve this, you can configure the template as follows:

Code Block
languagexml
<div 
	class = 'col-lg-6'
	style = 'border: 1px solid #ccc;'>

    {{ #each record }}

    <div 
		class = "{{ this.cssClass }} text-center"
		data-item-id = "ct-tpl-record"
		data-item-data = "{{ this.COL_INDEX }}"
		data-input = 'true'
		data-row-index = "{{ this.rowIndex }}"
		data-single-click = 'true'
		data-column-id = '{{ this.COL_ID }}'
		data-context-click = 'true' >

       <b> <input type = "checkbox"/> {{{ this.VALUE }}} </b>

    </div>
    
	{{ /each }}

</div>

When you select the checkbox the Change event triggers and the column ID followed by the template configuration (value) and the row details are returned. An additional attribute data-checked = ”checked” is added to the template configuration. When the checkbox is cleared this attribute gets removed from the template configuration as shown in the following screen shots:

After selecting the checkbox:

Image Added

After clearing the checkbox:

Image Added

To capture actions through the Change event, use the event handler functions. For the Deposit Summary app, you need to capture the actions as follows:

Code Block
languagejs
CWEH.registerHandler('WGT_DEPOSIT_SUMMARY’, CWEC.CELL_DATA_CHANGE, function(columnId, value, record)
{
	LOGGER.info('The CELL_DATA_CHANGE event is captured.’, [columnId, value, record]);
});

// Here, 'WGT_DEPOSIT_SUMMARY' is the widget ID.

Anchor
RowTemplate_ContextClick
RowTemplate_ContextClick
Context Click Event

A Context Click event is raised when you right-click on a cell or row in the widget. For example, when you right-click on a cell of the Deposit Summary widget, a context menu (Initiate Payment) appears.

Note

For the Context Click event to function, the attribute data-context-input click = "true"”true” must be defined. As we are configuring the template for a row, we need to define the attributes data-item-id = "ct-tpl-record" and data-row-index = "{{index}}" as well.

For example, when you select and clear the checkbox on a cell The following is a screen shot of the Deposit Summary widget , the Change event is triggered.

Image Removed

To achieve this, you can configure the template with the context menu enabled:

Image Added

A sample Context Click event code is as follows:

Code Block
languagexmljs
<div 
	class = 'col-lg-6'
	style = 'border: 1px solid #ccc;'>

    {{ #each record }}

    <div 
		class = "{{ this.cssClass }} text-center"
		data-item-id = "ct-tpl-record"
		data-item-data = "{{ this.COL_INDEX }}"
		data-input = 'true'
		data-row-index = "{{ this.rowIndex }}"
		data-single-click = 'true'
		data-column-id = '{{ this.COL_ID }}'
		data-context-click = 'true' >

       <b> <input type = "checkbox"/> {{{ this.VALUE }}} </b>

    </div>
    
	{{ /each }}

</div>

When you select the checkbox the Change event triggers and On a Context Click, the column ID followed by the template configuration (value) and the row details are returned. An additional attribute data-checked = ”checked” is added to the template configuration. When the checkbox is cleared this attribute gets removed from the template configuration is returned followed by the template configuration (value) and the row details as shown in the following screen shotsimage:

After selecting the checkbox:

Image Removed

After clearing the checkbox:

Image Removed

Image Added

To capture actions through the Change Context Click event, use the event handler functions. For the Deposit Summary app, you need to capture the actions as follows:

Code Block
languagejs
CWEHCMHR.registerHandler('WGT_DEPOSIT_SUMMARY’SUMMARY', CWEC.CELLCONTEXT_DATA_CHANGECLICK, function(columnId, value, record)
{
	LOGGER.info('The CELLCONTEXT_DATA_CHANGECLICK event is captured.', [columnId, value, record]);
});

// Here, 'WGT_DEPOSIT_SUMMARY'SUMMARY’ is the widget ID.

...