列表微件

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

示例

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

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

用法说明

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

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

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

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

设置

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

• 选择模板 - 从预定义列表设计中进行选择，或者从空白列表模板开始。 （如果选择模板，可稍后自定义其外观。）
• 数据 - 指定要包含在列表中的数据。
  • 选择数据 - 为具有要在微件中显示的要素的要素图层选择数据源。 您只能为一个要素图层选择一个数据视图。 在数据视图设置中，您可以过滤数据以限制窗口微件中显示的内容，对数据进行排序以按特定顺序显示列表项，或指定记录限制。
• 排列 - 定义如何在列表中显示项目。
  • 方向 - 在水平或垂直列表中显示项目。
  • 项目宽度或高度 - 以像素为单位指定列表项目的大小。
    • 对于水平列表，通过在此设置中输入精确的像素数或拖动画布上的大小调整栏来定义列表项目的宽度。 项目的高度由微件的高度定义。
    • 对于垂直列表，通过在此设置中输入精确的像素数或拖动画布上的大小调整栏来定义列表项目的高度。 项目的宽度由微件的宽度定义。

    注：

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

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

  提示：

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

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

  注：

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