ArcGIS API For JavaScript官方文档Tutotials之Search widget（搜索小部件）

Search Widget

    Search wdiget（搜索小部件）通过添加一个搜索框提供了简单的地图导航。这个搜索框使用户能够比标准的panning/zooming更快、更容易地移动到一个位置。它提供了基于给定locator service（定位器服务）和/或feature layers（要素图层）的搜索功能。搜索小部件类似于Geocoder小部件。它们之间主要的区别在于Search widget提供了额外的功能，允许从多个来源搜索和提供建议。

    

var search = new Search({
  map: map
},"search");
search.startup();

    这个小部件直接封装了预先构建的搜索功能，所以您需要做的就是在应用程序中引用它。如果没有指定任何内容，小部件默认为ArcGIS Online World Geocoding service。它还可以自定义以与另一个定义的locator一起工作。除了定位器之外，Search widget还能够在map和/或feature service中搜索图层。您通过使用locator、feature layer(S)或两者来指定Search widget如何工作。这些都被视为小部件的来源，并且可以设置在属性sources中。

    sources属性指示搜索框中可搜索的内容。如果使用一个带有geocoding service（地理编码服务）的locator，则findAddressCandidates操作被使用，否则查询被用于feature layers。

    

    一旦结果被选定，则将显示与结果相关联的infoTemplate。所有这些都是可自定义的。这里可以找到一个示例。

    此小部件提供属性，例如是否希望将结果自动导航到搜索结果，从而为可能的搜索结果enable suggestions，以及是否希望从map中自动搜索图层。有关可用选项的完整列表，请参阅the API reference。

    注意：只有使用10.3的 地理编码服务，才能使用suggestions，而该服务必须具有suggest capability loaded或支持分页的10.3要素图层，i.e.supportsPagination = true。

    这里提供的信息只是小部件功能的示例。有关此信息的其他信息参见Search widget API reference。此外，请参阅下面使用此小部件的web应用程序示例。

    ①Search basic

    ②Search multiple sources

    ③Search with customization

    ④Search using a suggestion template