Power Apps 中的 库 控件

  • 项目

包含其他控件并显示一组数据的控件。

描述

库 控件可以显示来自数据源的多个记录，并且每个记录可以包含多种类型的数据。 例如，使用 库 控件可以显示多个联系人，其中每一项都用于显示联系人信息，包括每个联系人的姓名、地址和电话号码。

每个数据字段都显示在 库 控件内的单独控件中。 您可以在控件模板中配置这些控件。 模板在库中显示为第一项：

  • 在水平/横向的 库 控件的左边缘。
  • 在垂直/纵向的 库 控件的顶部。

在模板中执行的任何更改都会反映在整个 库 控件中。

提供用于在库中显示图像和文本的预定义模板，以及高度可变项的库。

限制

库控件具有以下限制：

  1. 如果用户在加载所有项之前滚动高度灵活 库 控件，在数据加载完成后，当前在视图中的项可能会被下推，移出视图。 要避免此问题，请使用标准 库 控件，而不是高度灵活变体。
  2. 库中不支持以下控件：
  3. 只能在另一个库中添加一个库。
  4. 最小 TemplateSize 为一。 如果不考虑模板大小，这可能会导致库中的控件偏离其预期的 X 或 Y 值。
  5. 通过数据自动生成应用，保存应用，然后将其重新打开，浏览库时可能不会立即显示数据。 若要解决此问题，请在搜索框中至少键入一个字符，然后删除键入的文本。 随后库就会按预期方式显示数据。

键属性

Default – 应用启动时，要在库中选择的数据源项或记录。

Items – 在库、列表或图表等控件中显示的数据的源。

Selected – 选定项。

其他属性

AccessibleLabel – 屏幕阅读器的库（不是其中包含的项）的标签。 应描述项列表是什么。

AllItems - 库中加载的项。 这可能小于数据源的实际项数。 在滚动库时，可能会加载更多项。 AllItems 还包含每个库项中所使用的控件。

AllItemsCount - 加载到库中的项目数。 这可能小于数据源的实际项数。 在滚动库时，可能会加载更多项。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。

BorderThickness – 控件边框的粗细。

DelayItemLoading - 将项（行）的加载延迟到屏幕首次加载之后。

DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View)，还是已禁用 (Disabled)。

Fill – 控件的背景色。

Height – 控件上边缘和下边缘之间的距离。

ItemAccessibleLabel – 屏幕阅读器的每个库项的标签。 应该描述每个项是什么。

LoadingSpinner（None、Controls 或 Data）- 如果没有，将不显示微调。 当为 Controls | Data 时，微调将在导致可见空行的呈现传递发生时显示。

LoadingSpinnerColor - 加载微调的填充颜色。 默认设置为 BorderColor。

NavigationStep – 当库的 ShowNavigation 属性设为 true，且用户选择库任意一端的导航箭头时，库的滚动距离。

Selectable – 库项是否可以选择。 当设置为 true 时，屏幕阅读器会将库识别为可选列表。 您通过选择它选择项。 当设置为 false 时，屏幕阅读器会将库识别为常规列表，选择项时不会选择它。

ShowNavigation – 是否在库的每一端显示一个箭头，以便用户可以通过选择箭头滚动浏览库中的项。

ShowScrollbar – 当用户将鼠标悬停在库之上时，是否显示滚动条。

TemplateFill – 库的背景色。

TemplatePadding – 库中各项之间的距离。

TemplateSize – 垂直/纵向的库的模板高度。 或水平/横向的库的模板宽度。 最小大小为一。

Transition – 当用户将鼠标悬停在库中一项之上时的视觉效果（Pop、Push 或 None）。

Visible – 控件显示还是隐藏。

Width – 控件左边缘和右边缘之间的距离。

WrapCount – 每行或每列（具体取决于是水平布局还是垂直布局）显示的项数。

X – 控件左边缘与其父容器或屏幕左边缘之间的距离。

Y – 控件上边缘与其父容器或屏幕上边缘之间的距离。

Filter( DataSource, Formula )

Reset( Control ) - 将库重置为初始状态。 初始状态包括滚动到第一项和选择第一项或默认项（如果存在）。

备注

Reset控件不会递归重置库的所有子级。

示例

显示和筛选数据

从用户获取数据

辅助功能准则

颜色对比度

如果在库项中单击任何位置都是要选择它，那么在以下项之间必须有足够的颜色对比度：

  • BorderColor 和库外的颜色（如果没有边框）。
  • Fill 和库外的颜色（如果没有边框）。

屏幕阅读器支持

  • AccessibleLabel 必须存在。

    备注

    库中的项更改时，屏幕阅读器将公布。 还将提到 AccessibleLabel。 这为公布提供上下文，甚至在同一个屏幕上有多个库的情况下更为重要。

  • 当库项包含多个控件时，请使用 ItemAccessibleLabel 显示库项的内容。

  • 如果希望用户选择库项，请将 Selectable 的值设置为 true。 否则，请将该值设置为 false。

  • 当库项包含多个控件时，请使用 ItemAccessibleLabel 提供库项内容的摘要。

  • Selectable 应该适当设置，具体取决于是否打算让用户选择库项。

键盘支持

  • 请考虑将 ShowScrollbar 设置为 true。 在大多数触摸屏设备上，在开始滚动之前，不会显示滚动条。

  • 如果在库项中单击任何位置都是要选择它，还必须为键盘用户提供选择库项的方法。 例如，添加一个 按钮，并将其 OnSelect 属性设置为 Select(Parent)。

    备注

    库内的键盘导航顺序不考虑库外控件。 图库内的 TabIndex 控件具有范围限制。 请参阅辅助功能属性了解详细信息。

另请参阅

使用 DelayItemLoading 和 Loading 微调提高库的性能

备注

您能告诉我们您的文档语言首选项吗？ 进行简短调查。（请注意，此调查是英文版调查）

此调查大约需要七分钟。 不会收集个人数据（隐私声明）。