You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 25 Next »

New Feature

This is a new feature in Joget DX 8.

Introduction

Component Events enables interactions between page components with event triggering and event listening.

Example - Meeting Date Management

Expected Outcome

When a user clicks on the "Edit" button, a "Edit Meeting Details" form appears below the table without reloading the entire webpage.

Figure 1: The expected outcome through the proper implementation of a component event.


You may learn more about Component Events by visiting the Joget DX Showcase application in the App Center, then clicking on New In DX 8 > Component Events.

Figure 2: How to get to the Component Events showcase in the Joget DX Showcase application.


Note

The Joget DX Showcase app is a default app that can be found in every fresh installation of Joget DX 8.

Required Components

No.ComponentNameImage (For Reference)
1FormCalendar - Meeting

Figure 3: The Form component relevant to the Meeting Date Management example from the App Composer.


Figure 4: The Form component relevant to the Meeting Date Management example from the Form Builder.

2ListList - Calendar - Meeting

Figure 5: The List component relevant to the Meeting Date Management example from the App Composer.


Figure 6: The List component relevant to the Meeting Date Management example from the List Builder.

3UIJoget DX 8 Showcase

Figure 7: The UI component relevant to the Meeting Date Management example from the App Composer.


Figure 8: The UI component relevant to the Meeting Date Management example from the UI Builder.

Steps

  1. Make sure all the required components exist within an application.
  2. (From component 3) Click "Edit Page Components".

    Figure 9: The location to find the "Edit Page Component" button.

  3. Add a CRUD component to the Design.

    Figure 10: The location to find and add the CRUD component in the Design page.

  4. Configure the CRUD component's properties as such:
    1. Under Configure CRUD:

      Form LabelValue
      Label *Manage Meeting
      List *List - Calendar - Meeting
      Form (Edit)Calendar - Meeting


      Figure 11: The required configuration in the Configure CRUD property.

    2. Under AJAX & Events:

      Form LabelValue
      Handle Component with AJAX?(Checked) - Checking this label will enable the following sub-properties.
      Event Listening
      Row 1Component ObjectForm
      Event Name *reload_table
      Matched ActionShow and Reload Component

      Explanation

      The application listens for a 'reload_table' event. When the event is triggered, it shows and reloads the Form component object.

      Event Triggering
      Row 1
      Event Name *load_form
      Trigger Method *Link Clicked

      Parameters Changed Rules

      RowParameter Name *OperatorValue
      1_modeEquals Toedit

      These parameters are required to trigger the "Link Clicked" Trigger Method.

      For instance, in this context, when the parameter name "_mode" is equals to "edit", then the "Link Clicked" Trigger Method is triggered.

      Explanation

      When the "Link Clicked" trigger method is activated, it initiates the "load_form" event.


      When Not Match Trigger Event Namehide_form


      Figure 12: The required configuration in the AJAX & Events property.

  5. Result (with added data) after completing step 4 as shown in the below figure 13.

    Figure 13: The outcome after properly configuring the CRUD component.

  6. Save the new configuration.
  7. Add a Form component to the Design.

    Figure 14: The outcome after properly configuring the CRUD component.

  8. Configure the Form component's properties as such:
    1. Under Configure Form:

      Form LabelValue
      Label *Form
      Form *Calendar - Meeting
      Display Field as Label When Readonly?(unchecked)


      Figure 15: The required configuration in the Configure Form property.

    2. Under Redirection:

      Form LabelValue
      URL Redirect on Cancellation?close=true


      Figure 16: The required configuration in the Redirection property.

    3. Under AJAX & Events:

      Form LabelValue
      Handle Component with AJAX?(Checked) - Checking this label will enable the following sub-properties.
      Event Listening
      Row 1Component ObjectManage Meeting
      Event Name *hide_form
      Matched ActionHide Component

      Explanation

      The application listens for a 'hide_form' event. When the event is triggered, it hides the "Manage Meeting" component object.

      Row 2Component ObjectManage Meeting
      Event Name *load_form
      Matched ActionShow and Change Component URL Parameters

      Parameters *

      RowParameter Name *Parameter Value
      1id(id)
      2closefalse
      3_actionedit
      4_modeedit

      Explanation

      The application listens for a 'load_form' event. When the event is triggered, it shows and changes component URL parameters in the "Manage Meeting" component object.

      Row 3Component ObjectMain Menu Component
      Event Name *page_loaded
      Matched ActionHide Component

      Explanation

      The application listens for a 'page_loaded' event. When the event is triggered, it hides the Main Menu Component component object.

      Row 4Component ObjectForm
      Event Name *hide_form
      Matched ActionHide Component

      Explanation

      The application listens for a 'hide_form' event. When the event is triggered, it hides the Form component object.

      Event Triggering
      Row 1
      Event Name *hide_form
      Trigger Method *GET Request

      Parameters Changed Rules

      RowParameter Name *OperatorValue
      1closeEquals Totrue

      Note

      These parameters are required to trigger the "GET Request" Trigger Method.

      For instance, in this context, when the parameter name "close" is equals to "true", then the "GET Request" Trigger Method is triggered.

      Explanation

      When the "GET Request" trigger method is activated, it initiates the "hide_form" event.


      Row 2Event Name *reload_table
      Trigger Method *POST Request

      Explanation

      When the "Link Clicked" trigger method is activated, it initiates the "reload_table" event.


      Figure 17:
      The required configuration in the AJAX & Events property (partial).


      Figure 18:
      The required configuration in the AJAX & Events property (partial).


      Figure 19:
      The required configuration in the AJAX & Events property (partial).

  9. Result from completing step 8 as shown in the below figure 20.

    Figure 20: The outcome after properly configuring the Form component.

  10. Save the new configuration.
  11. You have completed all the required steps to achieve the expected outcome.
  • No labels