Widget General Use

Example 1: If the obtained widget object is defined as widget, get the actual value of the widget

widget.getValue();

Example 2: Get the actual value of the text0 widget on the parameter pane

_g().getParameterContainer().getWidgetByName("text0").getValue();

Example 3: Obtain the actual value of the text0 widget in the data entry cell in a general report

_g().getWidgetByName("ext0").getValue();

Example 4: Get the actual value of the text0 widget in the body in the dashboard

_g().getWidgetByName("text0").getValue();

For detailed implementation methods, please refer to: JS implements date widget query days control

Example 1: If the obtained widget object is defined as widget, get the display value of the widget

widget.getText();

Example 2: Get the display value of the text0 widget on the parameter pane

_g().getParameterContainer().getWidgetByName("text0").getText();

Example 3: Obtain the display value of the text0 widget in the data entry cell in a general report

_g().getWidgetByName("text0").getText();

Example 4: Obtain the display value of the text0 widget in the body in the dashboard

_g().getWidgetByName("text0").getText();

Click to download the template: 

Obtain widget displayed value.cpt

Example 1: If the obtained widget object is defined as widget, set the value of the widget to "text"

widget.setValue('text');

Example 2: Get the widget text0 on the parameter pane and set its widget value to "text"

_g().getParameterContainer().getWidgetByName("text0").setValue('text');

Example 3: Get the text0 widget in the data entry cell in a general report, and set its widget value to "text"

_g().getWidgetByName("text0").setValue('text');

Example 4: Get the text0 widget in the body in the dashboard, and set its widget value to "text"

_g().getWidgetByName("text0").setValue('text');

For detailed implementation methods, please refer to: JS Custom Buttons Assign Specified Range Values

Example 1: If the obtained widget object is defined as widget, set it to be visible

widget.visible();

Example 2: Get the widget text0 on the parameter pane and set it to be visible

_g().getParameterContainer().getWidgetByName("text0").visible();

Example 3: Get the text0 widget in the data entry cell in a general report and set it to be visible

_g().getWidgetByName("text0").visible();

Example 4: Get the text0 widget in the body in the dashboard and set it to be visible

_g().getWidgetByName("text0").visible();

Click to download the template: 

Set widget visible.cpt

Example 1: If the obtained widget object is defined as widget, set it to be invisible

widget.visible();

Example 2: Get the widget text0 on the parameter pane and set it to be invisible

_g().getParameterContainer().getWidgetByName("text0").visible();

Example 3: Get the text0 widget in the data entry cell in a general report and set it to be invisible

_g().getWidgetByName("text0").visible();

Example 4: Get the text0 widget in the body in the dashboard and set it to be invisible

_g().getWidgetByName("text0").visible();

Click to download the template: 

Set widget invisible.cpt

Whether visible，boolean

• true：visible

• false：invisible

Example 1: If the obtained widget object is defined as widget, set it to be invisible

widget.setVisible(false);

Example 2: Get the widget text0 on the parameter pane and set it to be invisible

_g().getParameterContainer().getWidgetByName("text0").setVisible(false);

Example 3: Get the text0 widget in the data entry cell in a general report and set it to be invisible

_g().getWidgetByName("text0").setVisible(false);

Example 4: Get the text0 widget in the body in the dashboard and set it to be invisible

_g().getWidgetByName("text0").setVisible(false);

Only after the content of the previous drop-down box is selected, the next layer of drop-down box widget is displayed:

For detailed implementation methods, please refer to: JS Control whether the Parameter Widget is Displayed

-

Whether visible, boolean

• true：visible

• false：invisible

Example 1: If the obtained widget object is defined as widget, return whether it is visible

widget.isVisible();

Example 2: Get the cwidget text0 on the parameter pane and return whether it is visible

_g().getParameterContainer().getWidgetByName("text0").isVisible();

Example 3: Get the text0 widget in the data entry cell in a general report, and return whether it is visible

_g().getWidgetByName("text0").isVisible();

Example 4: Get the text0 widget in the body in the dashboard and return whether it is visible

_g().getWidgetByName("text0").isVisible();

After the province widget selects the value, the query button is visible; otherwise, the query button is invisible:

Click to download the template: 

Whether widget visible.cpt

Whether enabled, boolean

true：enabled

false：disabled

Example 1: If the obtained widget object is defined as widget, set it to be disabled

widget.setEnable(false);

Example 2: Get the widget text0 on the parameter pane and set it to be disabled

_g().getParameterContainer().getWidgetByName("text0").setEnable(false);

Example 3: Get the text0 widget in the data entry cell in a general report and set it to be disabled

_g().getWidgetByName("text0").setEnable(false);

Example 4: Get the text0 widget in the body in the dashboard and set it to be disabled

_g().getWidgetByName("text0").setEnable(false);

For the detailed implementation method, please refer to: JS implements the data entry widget can only fill in once

-

Whether enabled, boolean

• true：enbaled

• false：disabled

Example 1: If the obtained widget object is defined as widget, return whether it is enabled

widget.isVisible();

Example 2: Get the cwidget text0 on the parameter pane and return whether it is enabled

_g().getParameterContainer().getWidgetByName("text0").isVisible();

Example 3: Get the text0 widget in the data entry cell in a general report, and return whether it is enabled

_g().getWidgetByName("text0").isVisible();

Example 4: Get the text0 widget in the body in the dashboard and return whether it is enabled

_g().getWidgetByName("text0").isVisible();

After the province widget selects the value, the query button is enbaled; otherwise, the query button is not enabled:

Click to download the template: 

Whether widget enabled.cpt

-

Example 1: If the obtained widget object is defined as widget, clear the content of the widget:

widget.reset();

Example 2: Get the widget text0 on the parameter pane and clear the content of the widget:

_g().getParameterContainer().getWidgetByName("text0").reset();

Example 3: Get the text0 widget in the data entry cell in a general report, and clear the content of the widget:

_g().getWidgetByName("text0").reset();

Example 4: Get the text0 widget in the body in the dashboard, and clear the content of the widget:

_g().getWidgetByName("text0").reset();

Click the button to clear all widget values:

For the detailed implementation method, please refer to: JS Reset the Widget Value

-

Example 1: If the obtained widget object is defined as widget, return its type

widget.getType();

Example 2: Get the cwidget text0 on the parameter pane and return its type

_g().getParameterContainer().getWidgetByName("text0").getType();

Example 3: Get the text0 widget in the data entry cell in a general report and return its type

_g().getWidgetByName("text0").getType(); 

Example 4: Get the text0 widget in the body in the dashboard and return its type

_g().getWidgetByName("text0").getType();

Click the button to get the widget type:

Click to download the template: 

View widget type.cpt

Watermark text, string

Example 1: If the obtained widget object is defined as widget, add a watermark of "Please enter your name" to it

widget.setWaterMark('Please enter your name');

Example 2: Get the widget text0 on the parameter pane and add a watermark of "Please enter your name" to it

_g().getParameterContainer().getWidgetByName("text0").setWaterMark('Please
enter your name');

Example 3: Obtain the text0 widget in the data entry cell in a general report, and add a watermark of "Please enter your name" to it

_g().getWidgetByName("text0").setWaterMark('Please enter your name');

Example 4: Obtain the text0 widget in the body of the dashboard, and add a watermark of "Please enter your name" to it

_g().getWidgetByName("text0").setWaterMark('Please enter your name');

Note: After adding an event, after an error is reported because the report block object is not completely created, you can add a delay function to delay execution, such as:

setTimeout(function(){
    _g().getParameterContainer().getWidgetByName("text0").
    setWaterMark('Please enter your name');
}, 500);

Add a watermark to the textbox widget:

Click to download the template: 

Widget watermark.cpt

Event type, string, value can refer to: widget event, such as "after initialization" event is afterinit

Example 1: If the obtained widget object is defined as widget, trigger the "after initialization" event of the widget

widget.fireEvent('afterinit');

Example 2: Get the widget text0 on the parameter pane and trigger its "after initialization" event

_g().getParameterContainer().getWidgetByName("text0").fireEvent('afterinit');

Example 3: Obtain the text0 widget in the data entry cell in a general report, and trigger its "after initialization" event

_g().getWidgetByName("text0").fireEvent('afterinit');

Example 4: Get the text0 widget in the body in the dashboard and trigger its "after initialization" event

_g().getWidgetByName("text0").fireEvent('afterinit');

For detailed implementation methods, please refer to: Dashboard button queries the data of the latest date

PopupStyle:{

    itemHeight: string;
    fontSize: string;
}

PopupStyle: Popup style, json format

• itemHeight: the height of the options in the popup

• fontSize: The font size of the popup box

Example 1: If the obtained drop-down box widget object is defined as widget, set its pop-up box option height to 30px and font size to 20px

widget.setPopupStyle({
    itemHeight:"30px",
    fontSize:"20px"
});

Example 2: Get the drop-down box widget comboBox0 on the parameter pane, and set its pop-up box option height to 30px and font size to 20px

widget.setPopupStyle({
    itemHeight:"30px",
    fontSize:"20px"
});

Example 3: Obtain the drop-down box widget comboBox0 in the data entry cell in a general report, and set its pop-up box option height to 30px and font size to 20px

_g().getWidgetByName("comboBox0").setPopupStyle({
    itemHeight:"10px",
    fontSize:"10px"
});

Example 4: Obtain the drop-down box widget comboBox0 in the body in the dashboard, and set its pop-up box option height to 30px and font size to 20px

_g().getWidgetByName("comboBox0").setPopupStyle({
    itemHeight:"30px",
    fontSize:"20px"
});

Note: After adding an event, after an error is reported because the report block object is not completely created, you can add a delay function to delay execution, such as:

setTimeout(function(){
_g().getParameterContainer().getWidgetByName("comboBox0").setPopupStyle({
    itemHeight: "10px",
    fontSize: "10px"
});
}, 500);

Set the drop-down box option height to 30px and font size to 20px:

Click to download the template:

Widget style.cpt

-

Add a "After Edit" event to the drop-down checkbox widget of the dashboard, the content of the event is:

return false;

The widget added in the dashboard body will trigger the query action immediately after entering the value:

If you want to click the button to start the query after entering the value, you can add an event to the drop-down box widget to not trigger the query:

Click to download the template: 

Query is not triggered after selecting a value from the drop-down box.frm