Power Apps 中的 库 控件
包含其他控件并显示一组数据的控件。
描述
库 控件可以显示来自数据源的多个记录，并且每个记录可以包含多种类型的数据。 例如，使用 库 控件可以显示多个联系人，其中每一项都用于显示联系人信息，包括每个联系人的姓名、地址和电话号码。
每个数据字段都显示在 库 控件内的单独控件中。 您可以在控件模板中配置这些控件。 模板在库中显示为第一项：
- 在水平/横向的 库 控件的左边缘。
- 在垂直/纵向的 库 控件的顶部。
在模板中执行的任何更改都会反映在整个 库 控件中。
提供用于在库中显示图像和文本的预定义模板，以及高度可变项的库。
限制
库控件具有以下限制：
- 如果用户在加载所有项之前滚动高度灵活 库 控件，在数据加载完成后，当前在视图中的项可能会被下推，移出视图。 要避免此问题，请使用标准 库 控件，而不是高度灵活变体。
- 库中不支持以下控件：
- 只能在另一个库中添加一个库。
- 最小 TemplateSize 为一。 如果不考虑模板大小，这可能会导致库中的控件偏离其预期的 X 或 Y 值。
- 通过数据自动生成应用，保存应用，然后将其重新打开，浏览库时可能不会立即显示数据。 若要解决此问题，请在搜索框中至少键入一个字符，然后删除键入的文本。 随后库就会按预期方式显示数据。
- 如果库包含 ComboBox、DatePicker、Slider 或 Toggle 控件，其
OnChange规则修补与库相同的数据源或集合，则可能会导致意外或性能降低。 这是因为OnChange修补库数据源的规则可能会创建永无止境的修补和重新加载周期。 为避免此问题，建议在将这些控件放置在库中时不要使用OnChange规则。
键属性
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 – 控件上边缘与其父容器或屏幕上边缘之间的距离。
相关函数
Reset( Control ) - 将库重置为初始状态。 初始状态包括滚动到第一项和选择第一项或默认项（如果存在）。
备注
Reset控件不会递归重置库的所有子级。
示例
显示和筛选数据
从用户获取数据
辅助功能准则
颜色对比度
如果在库项中单击任何位置都是要选择它，那么在以下项之间必须有足够的颜色对比度：
- BorderColor 和库外的颜色（如果没有边框）。
- Fill 和库外的颜色（如果没有边框）。
屏幕阅读器支持
AccessibleLabel 必须存在。
备注
库中的项更改时，屏幕阅读器将公布。 还将提到 AccessibleLabel。 这为公布提供上下文，甚至在同一个屏幕上有多个库的情况下更为重要。
当库项包含多个控件时，请使用 ItemAccessibleLabel 显示库项的内容。
如果希望用户选择库项，请将 Selectable 的值设置为 true。 否则，请将该值设置为 false。
当库项包含多个控件时，请使用 ItemAccessibleLabel 提供库项内容的摘要。
Selectable 应该适当设置，具体取决于是否打算让用户选择库项。
键盘支持
请考虑将 ShowScrollbar 设置为 true。 在大多数触摸屏设备上，在开始滚动之前，不会显示滚动条。
如果在库项中单击任何位置都是要选择它，还必须为键盘用户提供选择库项的方法。 例如，添加一个 按钮，并将其 OnSelect 属性设置为 Select(Parent)。