Button Settings

You can change the following button settings:

• Main Settings

• Behavior

• Visibility Filters

• Layout

Main Settings

• Title: Type a title to display for the component. This title is used both in Web and Designer.

• Icon: To select an icon to represent the component, click Select Icon, click the desired icon and click OK. To remove the icon, click Clear Icon.

• Command: The command to run when a user clicks the button. A command is an action the app should perform.

  To select the command you want, click the box that contains the current command followed by . The list of available commands depends on the context of the component.

  Some commands have additional settings you can configure.

  To turn your command into a custom command, click . A code box appears in which you can manually edit the JSON code for the command. Turning your command into a custom command is a one-way operation. While editing the custom command in the code box, press CTRL+Space to access code suggestions. You can specify a sequence of multiple commands.

  To convert commands into a workflow, first click to customize the commands, and then click . Converting commands into a workflow cannot be reversed. This option is not available for on-premises Workflow installations that are not installed in the default installation folder.

  For example, the following custom command switches from the Results List to the Results Table.

  [
    {
      "name": "ui.deactivate",
      "arguments": "results-list"
    },
    {
      "name": "ui.activate",
      "arguments": "results-table"
    }
  ]

Behavior

• Hide when Disabled: Whether to hide the button when the command cannot be executed.

• Can be Toggled: Whether the button can be toggled between two states. If the button can be toggled, you can specify the behavior of the button for both states as well as whether the button is toggled by default.

Visibility Filters

Visible To

The Visible To settings determine which users and groups can access this component. If no users or groups are specified, all users can access this component by default.

The Hidden From setting overrides this setting.

To add a user:

1. In the menu on the right, select Users.

2. In the menu on the left, select the name of the user you want to add.

   To quickly find a user, click the menu on the left and start typing the name of the user.

To add a group:

1. In the menu on the right, select Groups.

2. In the menu on the left, select the name of the group you want to add.

   To quickly find a group, click the menu on the left and start typing the name of the group.

   There are three special groups that are always available even if no Esri groups have been configured:

   • All Users: Any user regardless of whether they are signed in or not.

   • Anonymous Users: Users who are not signed in.

   • Authenticated Users: Users who are signed in.

To remove a user or group:

1. Click the X beside the name of the user or group.

Hidden From

The Hidden From setting determines which users and groups are explicitly forbidden to access this component.

This setting overrides the Visible To setting.

To add a user:

1. In the menu on the right, select Users.

2. In the menu on the left, select the name of the user you want to add.

   To quickly find a user, click the menu on the left and start typing the name of the user.

To add a group:

1. In the menu on the right, select Groups.

2. In the menu on the left, select the name of the group you want to add.

   To quickly find a group, click the menu on the left and start typing the name of the group.

   There are three special groups that are always available even if no Esri groups have been configured:

   • All Users: Any user regardless of whether they are signed in or not.

   • Anonymous Users: Users who are not signed in.

   • Authenticated Users: Users who are signed in.

To remove a user or group:

1. Click the X beside the name of the user or group.

Layout

• Slot: Select the slot to position the component within the Map component. In addition to the various positions on the map such as Top Left and Bottom Center, you can position the component within the map context menu, which appears when the user right-clicks the map. You can also position the component within the Popup slot, which appears at the mouse cursor.

  This setting only appears when the component is within the Map component.

• Margin (px): The margin space around the component in pixels.

• Initially Hidden: Specifies whether or not the component is initially hidden when the app loads. If selected, the component remains hidden unless activated, for example, by the Show command.

• Button Style: The style of the button. Choose either Rounded or Square.

• Show Title: Whether or not to display the title of the component.