Power Apps 中的 库 控件

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

描述

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

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

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

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

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

限制

库控件具有以下限制:

  1. 如果用户在加载所有项之前滚动高度灵活 库 控件,在数据加载完成后,当前在视图中的项可能会被下推,移出视图。 要避免此问题,请使用标准 控件,而不是高度灵活变体。
  2. 库中不支持以下控件:
  3. 只能在另一个库中添加一个库。
  4. 最小 TemplateSize 为一。 如果不考虑模板大小,这可能会导致中的控件偏离其预期的 XY 值。
  5. 通过数据自动生成应用,保存应用,然后将其重新打开,浏览库时可能不会立即显示数据。 若要解决此问题,请在搜索框中至少键入一个字符,然后删除键入的文本。 随后库就会按预期方式显示数据。
  6. 如果库包含 ComboBox、DatePicker、Slider 或 Toggle 控件,其 OnChange 规则修补与库相同的数据源或集合,则可能会导致意外或性能降低。 这是因为 OnChange 修补库数据源的规则可能会创建永无止境的修补和重新加载周期。 为避免此问题,建议在将这些控件放置在库中时不要使用 OnChange 规则。

键属性

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

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

Selected – 选定项。

其他属性

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

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

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

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

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

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

Fill – 控件的背景色。

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

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

LoadingSpinnerNoneControlsData)- 如果没有,将不显示微调。 当为 Controls | Data 时,微调将在导致可见空行的呈现传递发生时显示。

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

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

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

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

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

TemplateFill – 库的背景色。

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

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

Transition – 当用户将鼠标悬停在库中一项之上时的视觉效果(PopPushNone)。

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 微调提高库的性能

备注

您能告诉我们您的文档语言首选项吗? 进行简短调查。(请注意,此调查是英文版调查)

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