Examples

Use this widget to support app design requirements such as the following:

• You want to configure a search option in your app that provides more flexibility than the search tool included in the Map, List, and Table widgets. In particular, you want to search limited fields for specific layers in the map, provide unique hint text in the search box, and display values for certain data fields in the results panel.
• You want users to find information from multiple sources when performing a search.
• You want to display search results in other widgets on a different page in your app.

Usage notes

The Search widget supports two types of search sources—layers and locators. To use a locator source, add a locator service. You can use locators specified in your organization settings or added by you in the Select utility panel. To search layers, select from feature layers and scene layers that are added as data to your app.

If you configure multiple search sources, at run time users can use the drop-down menu to turn individual sources on and off, or use the All check box to turn every source on or off.

With locator sources, you can enter the following types of search terms:

• Place-names
• Points of interest
• Addresses
• UTM coordinates
• Coordinates in a coordinate system that you specify with a well-known ID (WKID).

  The format for this is x, y: WKID. An example is -13046165.52, 4036389.847: 102100

If you connect a Search widget and Map widget to the same feature layer, and turn on Show pop-up upon feature selection in the Map widget's settings, pop-ups appear when you select records from search results.

Settings

The Search widget includes the following settings:

• New search source—Add sources for searching content. Choose Layer source or Locator source and specify the following settings for each:
  • Data—If applicable, select the data source for the feature layer that you want users to search. In the data view settings, you can filter the data to limit the search scope or sort the data to display search results in a particular order.
  • Locator URL—Connect a locator utility service. The Select utility panel shows the locators specified in your organization settings or added by you in the Utility service panel.
  • Label—Type a name for the search source. This name appears in the search menu, the suggestion list, and the results panel.
  • Icon—Select an icon for the source. This icon shows in the suggestion list and the search results panel. You can choose icons from the General and Arrows galleries, or add your own icon from a file. Click the Delete button to remove unused uploaded icons.

    Note:

    You can upload the following image formats: PNG, GIF, JPG, JPEG, and BMP. To preserve optimal performance, there is a 10MB size limit for each upload.

  • Search options—You can set the following additional options:
    • Select searching fields (Layer sources only)—Choose one or more fields to search in the layer.
    • Exact match (Layer sources only)—Limit search results to only records that match the search phrase.
    • Display fields—Choose one or more fields to display in the search result panel. You can drag selected fields to reorder them.
    • Hint—Customize the hint text that appears in the search box when users choose to search only this source.
• Enable filtering for layer source search—If this setting is turned on, when the user performs a search, the widget filters the connected layer sources by the search criteria.
• General search options—You can set the following general search options:
  • Hint for multiple search sources—Customize the hint text that appears in the search box when users choose to search multiple sources.
  • Search suggestion—Define the maximum number of suggestions that appear for each search source. You can also configure the following options:
    • Use current location—Include a suggestion option to search based on the user’s current location.
    • Recent searches—Display the search history in the suggestion box based on a specified maximum number of recent searches. (Users can clear the search history.)

    Tip:

    Set Maximum suggestions per source to 0 to disable search source suggestions.

• Search result—Choose to display a search results panel or link to a page in your app to show results in another widget.
  • Result panel—Display the search results in a panel that appears under the search box. You can define the maximum number of results to display per search source and choose to automatically select the first result.
  • Set link—Add a link to open a specific page, window, or section view in your app, or scroll to a specific block or the top of the page to show relevant search results in a corresponding widget. This setting appears when Result panel is turned off.
  • Style—Choose an interface style for the result panel, either Classic or Compact. Compact has a smaller collapse button that appears at the bottom of the panel.
• Arrangement style—Choose a user interface for the widget, either Square, Curve, or Linear.

Interaction options

When you configure message actions for the Search widget, you can choose from the following triggers depending on the search source:

Trigger	Layer source	Locator source
Record selection changes
Records created
Data filtering changes

When configured with a locator source, the Search widget generates an output data source that can be used in other widgets. The interaction with additional widgets using the same output data source is achieved through adding actions. For example, the map can automatically display the search results and zoom to the features. In the Search widget settings, on the Action tab, add the Records created trigger, select the target map, and add actions for Show on map and Zoom to.

To select a feature on a map that corresponds with a selected search result, add the Record selection changes trigger for the Search widget (when configured to use the results panel). Select the target framework, add the Select data records action, and configure it with the feature layer for the map and the fields that bind the connection between the trigger and action data. Additionally, you can add the Zoom to action to zoom the map to the feature.

When configured with a layer source, if you want the map to zoom or pan to the selected search result, add the Data filtering changes trigger, select the target map, and add the Pan to and Zoom to actions.

To adjust the level of zoom for the Zoom to action, switch the Zoom scale to Custom and provide the desired scale.

URL parameters

The subsections below describe search-related URL parameters. You can use the settings under Manage URL status to make these parameters appear in the URL when the user performs a search. Search widget parameters follow hashmarks (#).

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%7D

{
	"searchText": "<text>",
	"status":{
		"configId": "<SourceID>",
		"magicKey": "<key>"
	}
}

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%2C"status"%3A%7B"configId"%3A"<SourceID>"%2C"magicKey"%3A"<key>"%7D%7D