Sidebar 模板基于 Instant Apps 中的 Sidebar Web 应用程序模板。 该模板可为显示在地图旁边的侧面板中的一组工具和选项提供原生应用程序体验。 您可以添加用于浏览地图和书签的基本地图工具，以缩放到特定区域。 提供编辑工具，使用户可以添加和更新地图中的要素。 配置可用于获取关于数据的更多信息的过滤器。
要求
Sidebar 模板使用要求如下：
- 提供一个或多个 Sidebar web 应用程序。 此类应用程序可以是单个有效项目 ID、包含多个 Sidebar web 应用程序的群组的 ID 或包含多个项目 ID 的搜索查询。
- Sidebar web 应用程序可以为公共应用程序或受保护应用程序。 要通过 OAuth2 访问 ArcGIS Online 组织或 ArcGIS Enterprise 门户中的受保护 Web 应用程序，请注册应用程序并提供一个客户端 ID。 有关详细信息，请参阅为应用程序签名。默认情况下，Sidebar 库中仅显示公共 Sidebar web 应用程序。 要访问受保护 Sidebar web 应用程序，请单击设置 > 许可 > 库，然后提供一个客户端 ID。
应用程序功能
以下列表中包含了一些关键设置和功能；如果在 Web 应用程序中进行了配置，则原生应用程序中将支持这些设置和功能：
- 图层列表 - 显示图层列表，包含用于在地图中打开或关闭可见性的图标。 可以选择要在运行时包含在工具中的图层。
- 书签 - 可将地图缩放并平移到保存在地图中的一组预设范围。
- 弹出窗口 - 点击要素时系统将显示配置后的弹出窗口内容。
- 编辑工具 - 提供用于在可编辑图层中添加和更新要素的工具。
- 详细信息 - 在应用程序侧面板中显示源地图的项目详细信息中的说明内容。
- 过滤器 - 基于预定义选项过滤地图中的数据。
- 底图切换 - 通过切换到其他底图来更改地图外观。
使用 Sidebar 模板创建的应用程序中还包括了在启用图层和地图以供离线使用时对离线地图的支持。
自定义应用程序
创建应用程序后，可以通过更改应用程序设置对其进行自定义。
启动 AppStudio，然后在侧面板中，单击设置 > 属性。 下表列出了 Sidebar 属性选项卡中各个选项卡的内容，并按照它们在选项卡中的显示位置及其用途进行排序。 也可以在应用程序的 appinfo.json 文件中直接修改这些属性。 如果对上述属性做出了任何更改，再次启动应用程序之前请单击应用对其进行保存。
“启动画面”选项卡内容
| 属性 | JSON 名称 | 类型 | 描述 |
|---|---|---|---|
背景图像 | startBackground | 字符串（图像 URL） | 用于开始页面背景的图像。 |
标识颜色 | brandColor | 字符串（颜色值） | 用作原色的颜色。 |
标题字体文件 | mediumFontTTF | 字符串（字体文件 URL） | 设置在整个应用程序中使用的自定义标题字体。该字体将用于标题、页面标题等。 |
文本字体文件 | regularFontTTF | 字符串（字体文件 URL） | 设置在整个应用程序中使用的自定义标题字体。该字体将用于照片、应用程序文本等的描述。 |
反馈电子邮件 | feedbackEmail | 字符串（电子邮件 ID） | 用于接收用户反馈的电子邮件地址。 |
显示免责声明 | showDisclaimer | 布尔值 (true|false) | 将免责声明文本显示为应用程序中的弹出窗口。此文本内容节选自详细信息选项卡的访问和使用约束部分。 |
“库”选项卡内容
| 属性 | JSON 名称 | 类型 | 描述 |
|---|---|---|---|
Sidebar web 应用程序 | galleryMapsQuery | 字符串 | 输入 ArcGIS 查询以在图库中列出有效的 Sidebar web 应用程序。 这可以是 Web 应用程序的单个有效项目 ID（例如 id: 87e4ea0800d64d4cb0e9d2e3784a5519）、包含多个 Web 应用程序的群组 ID（例如 group:47597bdf4b6d49fd85c0f4175a6e7b60）或具有多个 Web 应用程序项目 ID 的搜索查询（例如 id:87e4ea0800d64d4cb0e9d2e3784a5519 或 id:5a2cff5558704870bd5dbe36fbb94183）。 |
将显示在库中的结果总数 | maxNumberOfQueryResults | 数值 | 输入应从门户查询中返回的最大 Web 应用程序数。 |
Portal URL | portalUrl | 字符串 | 用于查询 Sidebar web 应用程序的 Portal URL。 |
支持受保护的 Web 应用程序 | supportSecuredMaps | 布尔值 (true|false) | 提供根据查询参数登录组织以访问受保护 Web 应用程序的功能。 |
跳过登录 | enableAnonymousAccess | 布尔值 (true|false) | 如果将支持受保护 Web 应用程序设置为 true，则将此选项设置为 true 可以提供绕过登录并且仅显示库中公开提供的 Web 应用程序的功能。 |
门户排序字段 | portalSortField | 字符串 | 用于对库中显示的 Web 应用程序进行排序。 可能的值包括：title、created、type、owner、modified、avgRating、numRatings、numComments、numViews。 |
门户排序顺序 | portalSortOrder | 字符串 | 与库排序字段结合使用，以按升序或降序对 Web 应用程序进行排序。 可能的值是 asc 或 desc。 |