Button

Buttons are primarily regular button components for performing actions.

Property

No	Item	Input Value	Default Value	Action Property	Type	Action Default Value	Description
1	ID	String	Auto-generated	id	string	Auto-generated	The [id] property cannot be set by action.
2	Label	String	Button	label	string	Button	Button label
3	Width	String	90	width	string	90	Component width
4	Height	String	40	height	string	40	Component height
5	X	String		x	string		X coordinate position
6	Y	String		y	string		Y coordinate position
7	Style	Selection 1. Filled 2. Outlined 3. Text	Filled	variant	string	contained	Button style
8	Size	Selection 1. Small 2. Medium 3. Large 4. None	None	size	string	none	Button size specification Added in "v3.3.0"
9	Font Size	Number	14	fontSize	number	14	Button font size specification Added in "v3.3.0"
10	Color	String Color Picker		color	string		Button color
11	Disabled	Boolean	OFF	disabled	boolean	false	Component disabled/enabled state
12	Visibility	Boolean	ON	visibility	boolean	true	Component visibility state
13	Start Icon	Selection	None	startIcon	string		Icon displayed before the button
14	End Icon	Selection	None	endIcon	string		Icon displayed after the button
15	Alert Dialog	Selection 1. ON 2. OFF	OFF				Alert dialog visibility state
16	Alert Value	Table [Detail 1]	[Detail 1]	alertValues	[Detail 1]		Alert dialog content
17	Tooltip	String		tooltip	string		Tooltip text
18	Click Event	Selection 1. None 2. NEXT UI 3. URL 4. WINDOW 5. Action 6. Upload	Action				Click event setting
19	NEXT UI	Selection 1. None 2. [UI Label]		nextUi	string		Destination UI
20	URL	String		url	string		Destination URL
21	DIALOG UI	Selection 1.None 2.[Dialog UI Label]		dialogUi	string		Destination Dialog UI Added in "v3.3.0"
22	Tab Focus	Selection 1.[UI ID]		tabFocus	string		Next focus component specification Added in "v3.3.0"

Note

• If "Upload" is selected for [Click Event], the following behavior will occur.
  • Clicking the button launches the OS file selection dialog.
  • Mobile devices can activate the camera when adding files and upload photographic images
    • For iOS devices, all images that are photographed are registered as "image.jpg". Therefore, please note that if a file with the same name already exists, it will be overwritten.
    • For Android devices, the photographed image will be registered as "unique-key.jpg".
    • Regardless of the OS, only jpg extension is available for image data upload from camera startup.
• If "Upload" is selected for "Click Event", unlike "NextUI" and "URL", an action can be defined. The built-in function "$fn.getUploadFiles" can be used in an action to obtain uploaded files as an object array. Note that the built-in function "$fn.getUploadFiles" cannot be used when "Action" is selected for "Click Event".
• Do not set the authentication UI to "NEXT UI". Note that setting the authentication UI to "NEXT UI" may result in incorrect operation.
• When setting the "Size" property from an action, you can choose from the following values:
  1. small
  2. medium
  3. large
  4. none
• If you select none for the "Size" property, you can configure the "Height" and "Font Size" properties.
• The following can be entered for the "Width" and "Height" property values. If you want to display in px, specify only numerical values; if you want to display in %, specify % as the unit. Operation will not be supported if you enter anything other than the following.
  • number
  • number%
  • calc() function
• The following can be entered for the "X" and "Y" property values. If you want to display in px, specify only numerical values. Operation will not be supported if you enter anything other than the following.
  • number
  • calc() function
• The calc() function is a CSS function that enables calculations. (e.g. calc(100% - 30px)) The units that can be used with the calc() function are "%" and "px" . Other units (e.g., em, rem, etc.) are not supported.
• When the calc() function is used to specify the size, the appearance in the editor may differ from the appearance in the application. Please confirm using the preview.
• The "Alert Value" property is displayed when the "Alert Dialog" is turned on.
• Alert dialog-related properties cannot be set or retrieved from actions.
• If "WINDOW" is selected for "Click Event", "Window Action" will appear in the context menu, and "Open" and "Close" actions can be defined. For details, see "[Details 2] External Service Site Integration" below.

[Details 1] Alert Value

The default status is registered as follows Edit the value columns for the items "Title","Contents", "Cancel", and "Submit".

Item	Value
Title	Are you sure?
Contents	Once you execute, all the previous changes will be lost and existing users will not be able to view the last changes. This cannot be reverted.
Cancel	Cancel
Submit	Submit

[Details 2] External Service Site Integration

External Service Site Integration with WebPerformer-NX is possible with the following specifications

• If a callback URL is specified, the user will be redirected to that URL after processing the external service site.
• When migrating to a callback URL, pass data to the callback URL using query parameters

The definition procedure for External Service Site Integration that conforms to the above specifications is as follows

1. Select "WINDOW" in "Click Event"
2. Set the URL for the transition to the external service site in the URL field displayed.

URLs can also be set within an action. For dynamic URLs, leave the URL field empty and set it in the action described in step 3. :::

3. Define window action "Open".
   • Dynamically create the URL to open the window.
   • Specify the following for the callback URL parameter. If you are not using a custom domain: {Parameter}=https://{envid}.webperformer.jp/callback.html If you are using a custom domain: {Parameter}=https://{customdomain}/callback.html
   • The created URL is set in the url property. Example) $ui.button_id.url
4. Define the window action "Close".
   • Receive a parameter of the transition destination URL with $param.{query parameter name}.
   • Bind the obtained value to the UI if necessary.

External Service Site Integration works as follows.

1. Click on the settings component to open the external service site with the specified URL in a new tab.
2. Complete the external service site processing.
3. Navigate to the callback URL.
4. Close the external service site with the process from the callback page.
5. The action defined in the window action "Close" is executed.

Note

• If the value of the URL property is empty, the user will be directed to the WebPerformer-NX application being release deployed.
• If an error occurs when executing the action of window action "Open", the external service site cannot be displayed.

Event

Event name	Description
onclick	For the click event "Action": Execute an action when clicked. For the click event "Upload": The action is executed when the "Open (O)"button is clicked after the file is selected. For the click event "WINDOW": The operation is described in "[Detail 2] External Service Site Integration".