添加窗口

窗口是您可以设置在加载应用程序或页面或在用户单击微件时打开的面板。 窗口适合为您的 Web 体验添加启动画面、确认消息、教程和警报。

要将窗口添加到 Web 体验中，请转到页面面板，单击窗口选项卡，然后单击添加窗口按钮，然后选择一个模板。 与页面不同，窗口仅包含正文内容。 将微件添加至窗口时，会将其列在窗口选项卡的轮廓部分以及构建器窗口底部的快速导航菜单中。

窗口可分为两个类别，固定和锚定。 如果未连接窗口以使其随页面打开，您可以指向面板中的窗口，然后单击设置为启动。 要更改窗口的名称、复制它或删除它，请单击窗口的更多按钮，然后选择重命名、复制或删除。 添加新窗口时，其标注遵循连续编号规则。 例如，复制 Window 1 现在会生成 Window 2，如果 Window 2 已经存在，则生成 Window 3。 对于固定窗口（启动窗口除外），窗口的名称也将用于体验的 URL。 （如果您在发布后更改了窗口的名称，则先前使用的 URL 仍然有效。）

使用以下选项管理应用程序中的窗口：

• 可在窗口面板中设置随 web 体验一同打开的启动窗口。 指向固定窗口（不包括已连接为随页面一同打开的窗口）下的一个窗口，然后单击设置为启动按钮。 Web 体验可以有一个启动窗口。
• 对于与页面一同打开的窗口，转到页面设置，然后从随窗口打开菜单中选择一个固定窗口。 设置为启动的窗口将不会出现在选项中。 将窗口设置为随页面一同打开后，随页面打开图标将出现在窗口面板中。 指向带有所连接页面名称的工具提示图标。 页面窗口在 Web 体验中仅会出现一次，除非用户刷新浏览器。
• 配置设置链接以使用微件设置打开窗口。 在微件的设置链接窗口，对于链接，选择窗口，然后选择锚定或固定窗口（启动窗口除外）。 每次用户单击此微件时，都会显示由微件触发的窗口。

设置

窗口包括以下配置选项：

• 模式
  • 固定 - 显示在固定位置。
  • 锚定 - 显示在链接的微件旁边。

  注：

  您可以在其设置中更改窗口模式。但是，由于设置为启动窗口或连接以随页面一同打开的固定窗口的激活机制不同，因此无法将其更改为锚定模式（反之亦然）。

• 位置和大小
  • 位置 - 对于固定窗口，您可以使用格网将窗口固定在页面的九个锚点之一。 （锚定窗口显示在关联的微件旁，且位置是自动设置的。）
  • 大小 - 可以为锚定窗口指定宽度和高度的像素值 (px)，并为固定窗口指定像素值或画布百分比 (%)。 您也可以拖动窗口边缘，调整窗口的大小。 对于固定窗口，自定义模式允许您设置具体值并添加偏移量，拉伸模式允许您指定窗口边距的值。
    • 偏移 X - 设置窗口的水平偏移。 负值将窗口向左移动，正值将窗口向右移动。
    • 偏移 Y - 设置窗口的垂直距离。 负值将窗口向上移动，正值将窗口向下移动。
    • 边距 - 定义窗口边缘与画布相应边缘之间的间距。 如果将窗口宽度设置为拉伸，可以为左边距和右边距指定值。 如果将窗口高度设置为拉伸，可以为上边距和下边距指定值。

  注：

  如果在中等或小屏幕设备中窗口使用自定义布局，则可自定义窗口位置、大小和布局。 位置和大小设置中的图标将指示该配置适用的屏幕大小（大、中等和小）。

• 阻止页面 - 防止用户在窗口处于活动状态时单击应用程序的其他部分或以其他方式与应用程序的其他部分进行交互。 此设置仅适用于固定窗口。
  • 掩膜颜色- 为掩膜选择一种颜色，以填充窗口周围的空间。
• 关闭选项
  • 单击外部以关闭窗口 - 允许用户通过单击窗口外部任意位置来关闭窗口。

    注：

    如果关闭固定窗口的阻止页面，则此设置不可用。

  • 交互（仅限固定模式）- 将交互添加到窗口底部。
    • 样式 - 选择复选框和按钮的布局。
    • 类型 - 选择窗口的交互类型。
      • 确认 - 需要最终用户选中复选框以关闭窗口。 此约束适用于所有关闭方法。 默认情况下，此交互类型只显示一次窗口，除非您启用始终显示此窗口。
      • “不再显示”选项 - 最终用户在窗口中选中此复选框以防止其再次打开。 无论是否选中此框，他们都可以关闭窗口。

        提示：

        要在选中此框后再次显示窗口，请再次保存体验并进行预览，或者重新发布体验并查看已发布的项目。

    • 复选框文本 - 提供要显示在复选框旁边的文本，并更改字体大小（以像素或 rem 为单位）。
    • 按钮文本 - 提供显示在按钮上的文本（如果适用），并更改字体大小（以像素或 rem 为单位）。
  • 您也可以在窗口中添加按钮微件以将其关闭。 可以使用按钮设置中的设置链接，并将按钮链接到页面以将其关闭。 如果您需要设置多个页面随一个窗口打开，或者将不同页面上的按钮链接到一个窗口，在这些情况下链接到一个特定页面并不实际，因此您可以将链接设置为当前页面以返回到激活窗口的页面。

    注：

    尽管您可以在窗口上设置按钮以链接到应用程序中的另一个窗口，但这不是建议的配置。

• 动画 - 为窗口及其包含的微件添加动画。
• 背景 - 为窗口背景选择填充颜色或图像。 可以使用快速样式按钮以从与应用程序主题风格一致的预设设计中进行选择。
• 边框 - 为窗口边框选择颜色、样式和宽度。 您可以更改半径大小以设置窗口角的形状。 可以使用快速样式按钮以从与应用程序主题风格一致的预设设计中进行选择。
• 框阴影 - 在窗口周围添加阴影效果。 可以使用快速样式按钮以从预设设计中进行选择，或使用以下设置：
  • 偏移 X - 设置阴影的水平距离。 负值将阴影放置在窗口的左侧，正值将阴影放置在微件的右侧。
  • 偏移 Y - 设置阴影的垂直距离。 负值将阴影放在窗口上方，正值将阴影放在微件下方。
  • 模糊半径 - 向阴影应用模糊效果。
  • 传播半径 - 调整阴影的大小。
  • 颜色 - 选择颜色。

模板

Experience Builder 包含以下窗口模板：

• 如果您想要在用户关闭窗口前阻止与应用程序其余部分的交互，则固定拦截器模板是合适的。
  • 空白窗口是一个空模板。
  • 确认是预先设置为具有关闭确认的模板，适用于需要验证或接受以继续的内容。
  • 警报是允许用户接受或拒绝消息的模板。
  • 简单和流行模板是两种不同的布局，用于显示或介绍信息。
  • 小说提供在核心内容之外带有关闭按钮的布局。
  • 侧边栏是默认情况下位于右侧的模板，用于显示冗长的文本时支持垂直滚动。
  • 转盘是一个更大窗口的模板，用于在循环视图中显示多个图像和内容。
  • 细节是一个更大窗口的模板，它使用图表、表格、列表、图像和按钮以及社交共享选项提供更多信息。
• 如果您希望用户与窗口与应用程序的其他部分并行交互，则固定直通模板是合适的。
  • 脚注显示在应用程序布局的底部，并带有浮动动画。
  • 项目信息显示在应用程序布局的右侧，并带有飞入动画。
• 如果您想将窗口链接到微件，则锚定模板是合适的。
  • 工具提示适合提供有关链接微件的详细信息，该微件可以是按钮或图像微件。
  • 步骤旨在通过多个视图显示或介绍信息。

URL 参数

以下是可用于控制窗口行为的 URL 参数列表。

打开窗口

要定向至特定活动窗口，使用 dlg 加窗口 ID 或标注。

https://experience.arcgis.com/experience/<AppId>/?dlg=Window-1

控制窗口焦点

要嵌入带有启动窗口或页面窗口的 Experience Builder 应用程序，而该应用程序不会自动移动至这些窗口，请使用 disable_window_focus 参数来控制该行为。 将以下 URL 添加至托管 web 页面以防止移动行为。 默认情况下，disable_window_focus 为 false。

https://experience.arcgis.com/experience/<AppId>/?disable_window_focus=true

要控制特定窗口的窗口焦点，请使用 dlg，后跟窗口 ID 或标注以及 disable_window_focus 参数，如下例所示：

https://experience.arcgis.com/experience/<AppId>/?dlg=Window-1&disable_window_focus=true