“登录”微件

“登录”微件用于向应用程序添加登录体验。 该微件是一个按钮，用户可使用该按钮登录和登出 ArcGIS 账户。 单击该按钮会执行不同的操作，具体取决于用户是否已登录以及在微件设置中配置的行为。

• 当用户单击该微件登录时，微件可以打开弹出登录窗口或重定向到 ArcGIS 登录页面。
• 如果用户在登录后单击该微件，则该微件可能直接将用户登出或打开一个包含诸多选项的下拉菜单。

可以设置重定向，以在登录或登出后将用户发送到特定应用程序页面、视图、窗口或外部 URL。 还可以自定义微件和下拉菜单的外观。

示例

使用此微件可支持以下应用程序设计要求：

• 您希望用户在访问应用程序之前进行登录。
• 您希望创建一个包含登录按钮的主页并在用户登录账户后将其重定向到另一个页面。
• 您希望允许用户切换账户。

用法说明

当将“登录”微件添加至页面时，将显示快速样式窗口。 您可以从与应用程序主题风格一致的预设设计中进行选择。 （要稍后再次访问此窗口，请单击微件工具栏上的快速样式按钮 。）可以在外观设置中进一步自定义微件外观。

“登录”微件工具栏包括切换登录预览按钮 。 可以使用此按钮在已登录和已登出状态下预览微件之间进行切换。

提示：

由于您必须登录才能编辑应用程序，因此该微件不允许登录、登出或在构建器中切换账户。 要完整测试登录和登出体验，请在新选项卡中预览应用程序。

设置

“登录”微件包含以下设置：

• 登录页面显示 - 选择用户在未登录的情况下单击该微件按钮时的行为。
  • 弹出窗口 - 将显示一个窗口，提示用户登录。
  • 重定向到登录页面 - 该微件会将用户重定向到 ArcGIS 登录页面。 在用户使用有效账户登录后，将返回到应用程序。

  注：

  如果在另一个应用程序或网站中嵌入 Experience Builder 应用程序，则当用户在嵌入应用程序中单击该微件时，将始终通过弹出窗口进行登录，无论在此选择的选项为何。

• 登录后设置 - 配置与用户登录后的微件行为相关的以下设置：
  • 登录后重定向 - 可选择添加链接，以在成功登录后立即将用户发送到应用程序中的特定页面、视图或窗口，或转至 Web 地址。 如果您链接到网址，请输入一个 URL（以 https:// 为开头）。 可选择是让重定向在与应用程序相同的窗口中、顶部窗口中还是新窗口中打开。
  • 登出后重定向 - 可选择添加链接，以在成功登出后立即将用户发送到应用程序中的特定页面、视图或窗口，或转至 Web 地址。 如果您链接到网址，请输入一个 URL（以 https:// 为开头）。 可选择是让重定向在与应用程序相同的窗口中、顶部窗口中还是新窗口中打开。
  • 单击登录按钮时 - 选择用户在登录后单击该微件时的行为。
    • 直接登出 - 该微件会将用户从账户登出。
    • 启用用户菜单 - 当用户单击按钮时将显示一个下拉菜单。 该菜单始终包含切换账户和登出选项。 可以选择包含以下附加元素和选项：
      • 显示用户名 - 在菜单中包含账户个人资料名称。
      • 显示用户头像 - 在菜单中包含账户头像图像。
      • 显示“我的个人资料”- 包含指向账户个人资料页面的链接。
      • 显示“我的设置”- 包含指向账户设置页面的链接。
      • 显示受限资源（如有）- 包含应用程序中当前账户无法访问的资源列表。
      • 添加链接 - 向下拉菜单添加链接。 对于每个链接，可以输入标注和 https:// URL。
• 外观 - 更改“登录”微件的外观。
  • 图标 - 将图标添加至登录按钮。 此图标将在用户登出后显示。 用户头像将在用户登录账户时显示。 可以从默认图库中选择图标或从文件上传专用图标。
  • 可以覆盖从应用程序主题继承的字体和颜色，以设置该微件的两种状态的样式。 默认是没有用户交互时的微件状态，悬停是用户在指向或单击微件时启动的状态。 可以调整以下设置：
    • 文本 - 更改字体大小（以像素为单位）和字体颜色，并使用粗体、斜体、删除线和下划线格式设置微件文本的样式。
    • 图标 - 更改微件图标的大小（以像素为单位）和颜色。
    • 背景 - 选择填充颜色或图像以设置为微件背景。 如果选择图像，则可以使用适合、填充、居中、平铺或拉伸将其放置在微件中。 如果选择适合，则该微件将在图像周围显示背景填充颜色。
    • 边框 - 选择边框的颜色、样式（例如虚线或点划线）和宽度（以像素为单位）。 可以一次性设置边框所有边的样式，也可以分别设置每个边的样式。
    • 边框半径 - 更改半径大小（以像素或百分比为单位）以设置微件拐角的形状。
    • 阴影 - 使用以下设置在微件周围添加阴影效果：
      • 偏移 X - 设置阴影的水平距离。 负值将阴影置于按钮的左侧，正值将阴影置于按钮的右侧。
      • 偏移 Y - 设置阴影的垂直距离。 负值将阴影置于按钮上方，正值将阴影置于按钮下方。
      • 模糊半径 - 向阴影应用模糊效果。
      • 传播半径 - 调整阴影的大小。
      • 颜色 - 选择阴影颜色。
    • 下拉菜单 - 更改打开启用用户菜单设置时显示的下拉菜单的外观。
      • 文本 - 更改字体大小（以像素为单位）和字体颜色，并使用粗体、斜体、删除线和下划线格式设置菜单文本的样式。
      • 背景 - 选择填充颜色或图像以设置为菜单背景。 如果选择图像，则可以使用适合、填充、居中、平铺或拉伸将其放置在菜单中。 如果选择适合，则该菜单将在图像周围显示背景填充颜色。
      • 边框 - 选择边框的颜色、样式（例如虚线或点划线）和宽度（以像素为单位）。 可以一次性设置边框所有边的样式，也可以分别设置每个边的样式。
      • 阴影 - 使用以下设置在菜单周围添加阴影效果：
        • 偏移 X - 设置阴影的水平距离。 负值将阴影置于按钮的左侧，正值将阴影置于按钮的右侧。
        • 偏移 Y - 设置阴影的垂直距离。 负值将阴影置于按钮上方，正值将阴影置于按钮下方。
        • 模糊半径 - 向阴影应用模糊效果。
        • 传播半径 - 调整阴影的大小。
        • 颜色 - 选择阴影颜色。