“日期过滤器”微件

“日期过滤器”微件允许您使用日历工具选择特定日期或日期范围来过滤要素。

可以使用“日期过滤器”微件来过滤至少包含一个有效日期字段或仅日期字段的图层。

示例

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

• 您拥有与日期相关的数据，其中每条记录都与特定日期相关联，您希望过滤“表格”微件或“列表”微件以仅显示所选日期的要素。
• 您拥有一个活动列表，其中每个活动均持续多天，您希望选择一个日期并查看在该日期举行的活动。
• 您拥有包含多个图层的 web 地图，其中这些图层包含日期字段，您希望应用过滤器并查看所选日期或日期范围内的数据。

用法说明

此微件需要连接到其中至少一个属性字段包含日期信息的数据源。 已连接数据源必须包含以下字段类型的字段：

• 日期
• 仅日期

在微件的设置中，您可以允许用户选择单个日期或者日期范围。 在单个日期选择模式下，该微件包含一个今天按钮，用于将日历切换回当前月份。 单击日历中的某一天以选择单个日期。 单击开始日期和结束日期以选择日期范围。

当您在应用程序中包括此微件时，此微件将为用户提供基于日历的日期选取器工具。 在微件设置中，可以从以下用户界面样式中进行选择：

• 内联 - 该微件为包含日历工具的面板。
• 图标 - 该微件为按钮。 单击按钮将打开包含日历工具的窗口。 可以通过更改“日期过滤器”微件设置面板顶部的图标来更改按钮图标。
• 输入 - 该微件为一个或两个文本框。 可以直接键入日期，或者单击每个文本框以使用日历工具来选择日期。 此样式不支持今天按钮。

设置

“日期过滤器”微件包含以下设置：

• 源 - 通过以下方式之一将微件连接到数据：
  • 选择图层 - 将单个图层连接到微件。 单击选择数据以打开选择数据面板。 您可以在此处从已添加至应用程序且至少包含一个日期字段的受支持图层中进行选择，或者添加新数据。 连接到微件的图层将显示在微件设置面板中源下方的列表中。 单击图层以打开其设置面板，可以在其中配置以下设置：
    • 数据 - 已连接数据源将显示在此处。
    • 字段 - 指定用于开始日期和（可选）结束日期的字段。

      注：

      对于每个图层，必须指定开始日期字段。 如果数据包含用于开始日期和结束日期的字段，您也可以指定结束日期字段。 开始日期和结束日期共同指示某个要素存在于特定时间段内，这意味着在此时间段内的任何一天，该要素都会显示在过滤结果中。

      注：

      对于包含一个日期字段的图层以及包含多个日期字段的时间感知型图层，将自动填充开始日期和结束日期字段。 对于包含多个日期字段的非时间感知型图层数据，必须手动指定开始日期和结束日期字段。

  • 与“地图”微件进行交互 - 将“日期过滤器”微件连接到“地图”微件。 “地图”微件必须至少包含一个 web 地图或 web 场景，且其中的图层包含有效日期字段。 “日期过滤器”微件将自动连接到当前页面上的第一个“地图”微件。
    • 连接的“地图”微件中的任何 Web 地图或 Web 场景都将显示在列表中。 可以单击每个 web 地图或场景以打开其配置面板，可以在该面板中打开自定义图层。
      • 自定义图层 - 已连接地图或场景中所有包含有效日期字段的受支持图层均会自动同步至“日期过滤器”微件。 如果打开此设置，则这些图层将显示在列表中，您可以选择要连接至该微件的图层。
      • 在自定义图层下开启的任何图层都会显示在关联地图或场景的下拉菜单中。 单击图层以打开其设置面板，可以在其中配置以下设置：
        • 数据 - 已连接图层的名称将显示在此处。
        • 字段 - 指定用于开始日期和（可选）结束日期的字段。
• 样式 - 选择微件的用户界面样式：内联、图标或输入。
• 选项 - 配置以下工具和功能：
  • 日期选择模式 - 选择用户是能够选择单个日期还是日期范围。
  • 默认日期 - 或者，提供默认日期（用于单个日期）或者默认开始日期和结束日期（用于日期范围）。 可以通过以下方式定义默认日期：
    • 空 - 不设置默认日期。
    • 今天 - 将默认日期锚定为用户访问应用程序时的当前日期。
    • 昨天 - 将默认日期锚定为当前日期的前一天。
    • 明天 - 将默认日期锚定为当前日期的后一天。
    • 自定义 - 使用日历工具选择特定日期。
  • 自动应用过滤器 - 当用户选择日期或日期范围时自动应用日期过滤器，无需用户单击应用按钮。 如果启用此设置并提供默认日期，则微件首次加载时将应用默认过滤器。

    注：

    当选择输入样式时，自动应用过滤器设置将始终开启。