“列表”微件

“列表”微件用于在自定义列表视图中显示数据记录。 它使用卡片设计作为容器来存储一些相关信息的简短描述，并可以选择包含一个按钮来查看其他详细信息。 可从几个模板中进行选择来构建卡片布局。 模板包含图像、按钮和文本微件。 也可以选择一个空白模板来设计自己的布局。 列表的数据源由要素图层定义。 列表中的每个项目卡片表示一条记录，卡片上的微件可用于显示记录的属性。 要设计列表，可自定义样式设置并修改第一张卡片的布局，以更新列表中的所有卡片。

示例

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

• 您想要构建一个应用程序，允许用户在列表中选择记录并在地图上进行查看。
• 您希望在自定义列表视图中显示数据源中的记录。 要显示的记录必须满足某些条件。
• 您想要向用户提供一个可与之交互的列表，例如过滤列表、使用预定义选项对列表进行排序以及选择列表中的记录。

用法说明

添加“列表”微件时，首先为列表中的项目卡片选择模板设计，然后单击启动。 在画布上，“列表”微件中的第一个项目处于激活状态，您可以修改其中的微件布局，也可以从插入面板将微件拖入第一张卡片中添加更多微件。 目前，“列表”微件仅支持“文本”、“按钮”和“图像”微件。

“列表”微件需要数据源。 可在显示或未显示地图的页面上使用“列表”微件。 如果包含使用同一图层的“地图”微件，单击列表中的要素时，将高亮显示地图中的相应要素。 设计列表中项目卡片的内容时，通过配置第一个项目中的微件并选择相应的动态内容以从连接的数据源填充记录。 （默认情况下，添加到列表的微件将继承列表的数据。）也可以设置操作使“列表”微件与应用程序中的其他微件进行交互，例如在“地图”微件中缩放到地图上的选定要素或在“要素信息”微件中显示选定要素的属性。

如果使用多个状态（默认、悬停和选定）配置“列表”微件，则为自定义布局选择嵌套微件时，将显示链接到按钮 。 该按钮用于指示微件设置是隔离还是跨状态同步。

• 对于同步微件，微件内容和样式设置（背景、边框和阴影）相同，并且不同状态的大小和位置可以不同。
• 对于隔离微件，可以配置属性，而不会影响处于另一种状态的其他微件。
• 要在另一种状态下使用相同微件，或者还要同步微件的大小和位置，选择微件，然后将其应用于目标状态。
• 删除同步微件时，处于不同状态的相同微件也会一并删除，除非先将该微件隔离。

搜索方法

“列表”微件的搜索工具使用不同的方法来检索搜索建议和搜索结果。

该微件的搜索工具将使用全文搜索以检索搜索建议。 全文搜索是一种有效的搜索方法，该搜索将使用全文字段索引，此索引可将记录分割为较小的单元，例如单个单词。 例如，假设您拥有一个美国邮局位置图层，其中的名称字段包含每个邮局位置的名称。 该索引将名称 Highland Station Baltimore Post Office 分割为 5 个可单独搜索的单词：Highland、Station、Baltimore、Post 和 Office。 如果输入由这些单词的任意组合（或仅其中任何单词的第一部分）组成的搜索短语，例如 Baltimore Office、Highland Baltimore 或 Stat Balt Office，则可在搜索建议中找到该邮局。

如果您是托管要素图层的所有者或者组织管理员，则当选择托管要素图层作为“搜索”、“列表”或“表格”微件的搜索字段时，将自动生成托管要素图层的全文字段索引。您还可以在图层的项目详细信息页面上手动向属性字段添加索引。 如果您的图层没有索引，并且您没有编辑图层的权限，则“列表”微件将使用 START WITH abc% 查找建议，这意味着该微件将查找以搜索短语开头的记录。 这是一种效率较低的搜索方法。

为了检索搜索结果，该微件将使用 CONTAIN %abc%，这意味着搜索短语可以位于记录中的任何位置。 例如，可以搜索 alt 以在搜索结果中得到 Baltimore、Salt Lake City 和 Alton。

警告：

全文搜索是 Experience Builder 2023 年 10 月版本中的新增功能，是一项重大更改。 在此版本之前，该微件使用了 CONTAIN %abc% 以同时检索建议和结果。 与 CONTAIN %abc% 查询不同，全文搜索无法找到位于单词中间的搜索短语。 在以上示例中，搜索 altimor 或 ighlan 将不会在搜索建议中返回预期邮局。 了解有关在地图和应用程序中搜索要素的详细信息。

设置

“列表”微件包含以下设置：

• 选择模板 - 从预定义列表设计中进行选择，或者从空白列表模板开始。 （如果选择模板，可稍后自定义其外观。）
• 数据 - 指定要包含在列表中的数据。
  • 选择数据 - 为具有要在微件中显示的要素的要素图层选择数据源。 您只能为一个要素图层选择一个数据视图。 在数据视图设置中，您可以过滤数据以限制窗口微件中显示的内容，对数据进行排序以按特定顺序显示列表项，或指定记录限制。
  • 无数据消息 - 确定当微件不包含数据时（例如当用户应用过滤器时）显示的消息。
  • 上次更新文本 -（可选）当数据源打开自动刷新时，可选择排除指示数据在应用程序中刷新时间的上次更新标注。
• 排列 - 定义如何在列表中显示项目。
  • 布局 - 在行、列或格网列表中显示项目。
  • 项目宽度或高度 - 指定列表项目的大小。
    • 对于行列表，通过在此设置中输入精确的像素数或拖动画布上的大小调整栏来定义列表项目的宽度。 项目的高度由微件的高度定义。
    • 对于列列表，通过在此设置中输入精确的像素数或拖动画布上的大小调整栏来定义列表项目的高度。 项目的宽度由微件的宽度定义。
    • 对于格网列表，通过在各个设置中输入精确的像素数或拖动画布上的大小调整栏来定义列表项目的宽度和高度。 您也可以按照微件宽度的百分比定义列表项目的宽度。

    注：

    如果在中等或小屏幕设备中列表使用自定义布局，则可自定义列表项的大小。 此设置中的图标表示配置应用于的屏幕大小（大、中等或小）。

  • 锁定宽/高比 - 调整微件大小时，锁定列表项目的宽/高比。
  • 对齐（适用于格网列表）- 将列表项目左对齐、居中对齐或右对齐。
  • 水平或垂直间距 - 以像素为单位定义列表项目之间的间距。 对于格网列表，可以定义两者。
  • 分页样式 - 定义如何加载无法在第一页中显示的列表项目：
    • 滚动 - 当用户在列表中向下滚动时加载更多项目。
      • 滚动条 - 显示滚动条。
      • 导航器 - 包含用于滚动列表的向上和向下或从左至右的导航控件。 对于步进，定义每次单击导航器控件时要滚动的项目或行数。
    • 多页 - 使用分页将长列表分成几页。 对于每页项目数，定义要在页面上显示的项目数。
• 状态 - 提供视觉表示以传达列表项目的三种状态：默认（无用户交互的项目的默认状态）、悬停（用户通过指向列表项目启动此状态）和选定（用户选择列表项目）。

  提示：

  要更改嵌套微件的相应状态，则可以隔离这些更改，以防这些更改应用于所有状态。 选择“列表”微件，然后单击要更改的状态的按钮。 对于布局设置，选择自定义。 单击嵌套微件，单击随即显示的链接到按钮 ，选择隔离，然后配置嵌套微件的设置。 （如果先配置设置，然后单击隔离，则更改一定会应用于其他状态。）

  • 背景 - 为处于默认状态（当前无用户交互）的列表项目设置背景。 选择填充颜色或图像。 如果选择图像，则可以使用 适合、 填充、 居中、 平铺或 拉伸将其放置在列表项目的边框内。 如果选择 适合，背景填充颜色将出现在图像周围。
  • 边框 - 通过选择边框颜色、样式（如虚线或点划线）和宽度（以像素为单位），为处于默认状态的列表项目设置边框。
  • 边框半径 - 更改半径大小（按像素或百分比），以使处于默认状态的列表项目形成角。 锁定设置可同步所有四个角的半径。
  • 悬停 - 指定用户将光标悬停在列表项目上时其外观是否发生变化。 在启用悬停状态后，其设置会显示在配置面板中，可在其中选择更改悬停列表项目的背景、边框和边框半径。
    • 悬停选项卡在画布中的第一个列表项目旁边显示，当用户将光标悬停在项目上时，该选项卡会更新以显示该项目的外观。 也可以仅针对悬停状态添加微件，或删除和重新定位现有微件以及调整其大小。
  • 选定 - 指定是否可以选择列表中的项目卡片，以及当用户单击以选中该项目卡片时其外观如何变化。 在启用选定状态后，其设置会显示在配置面板中，可在其中选择对选定项目列表进行多选，并更改其背景、边框和边框半径。 在选择模式下，可将选择限制为一次仅一个项目（单击另一个项目时，将清除当前选择），也可以允许用户同时选择多个项目（单击另一个项目时，会将其添加到当前选择集中）。
    • 选定选项卡在画布中的第一个列表项目旁边显示，当用户选择项目时，该选项卡会更新以显示该项目的外观。 也可以仅针对选定状态添加微件，或删除和重新定位现有微件以及调整其大小。
• 工具 - 可以在运行时在微件面板中包含以下工具：
  • 搜索 - 允许用户搜索列表中的记录。
    • 选择搜索字段 - 选择一个或多个字段进行搜索。
    • 完全匹配 - 将搜索结果限制为仅与搜索短语匹配的记录。
    • 提示 - 在搜索框中提供显示为占位符文本的提示，以帮助用户搜索相关值。
  • 排序 - 为用户提供一个菜单，以按特定字段和顺序对列表进行排序。 为每个菜单选项输入一个自定义名称。
  • 过滤器 - 添加过滤器以供用户与列表进行交互。 当您设置过滤器时，微件包含一个重置按钮，用于将过滤器重置为其原始状态。
  • 刷新 - 允许用户刷新列表显示最新数据。 如果您将列表连接到定期更新的数据源，此设置非常有用。
  • 显示选择 - 允许用户更新列表，仅显示选定的项目。
  • 清除选择 - 允许用户清除所有选定项目的选择。
  • 显示记录计数 - 显示总记录数和所选记录数。

  注：

  仅在启用选定状态时，显示选择和清除选择工具才会显示。

交互选项

此微件支持操作，可在微件设置的操作选项卡上配置这些操作。

可将消息操作配置为在微件之间创建自动交互。 例如，要使地图微件在用户使用列表微件选择要素时自动缩放至该要素，可添加记录选择范围触发器，选择地图微件作为目标以及添加缩放至操作。

打开数据操作以将按钮添加至列表微件的用户界面，以用于执行数据处理任务，例如导出、缩放至和设置过滤器。 用户可以对列表中的所有数据或选定要素运行数据操作。

注：

当用户使用导出数据操作导出数据时，将仅在导出中包含列表微件当前使用的字段。 这包括正在用于动态文本、动态图像等的字段。