Power Apps 中的 附件 控件
一个控件,允许用户将文件下载到他们的设备,以及从使用 Microsoft Lists 创建的列表或 Microsoft Dataverse 表上传和删除文件。
说明
使用 附件 控件,可从列表和 Dataverse 表打开、添加和删除文件。
限制
Attachment 控件具有以下限制:
Attachment 控件仅支持列表和 Dataverse 表作为数据源。 不支持将这些数据源转换为表的表达式,例如使用 ForAll 函数。
上传和删除功能仅在窗体内部有效。 在编辑模式下,如果不在窗体内部,附件 控件会显示禁用。 若要保存文件的添加和删除,应用用户必须保存窗体。 由于此限制,附件 控件在插入选项卡中不可用,但在 SharePoint 或 Dataverse 窗体中启用了附件窗体字段时,会显示在该窗体中。
Web 浏览器上的 附件 控件允许您选择多个文件,并允许使用拖放功能。 但是,在 Power Apps Mobile 上使用 附件 控件时,一次只能添加一个文件。
键属性
Items – 列表或 Dataverse 表的 Attachment 列。 不支持集合和表。
MaxAttachments – 控件将接受的文件数上限。
MaxAttachmentSize - 每个新附件的文件大小上限(以 MB 为单位)。 1 MB 在这里是 1,000,000 字节 (106 B) 或 1,000 KB。
OnAddFile - 用户添加新文件附件时要执行的操作。
OnRemoveFile – 用户删除现有附件时要执行的操作。
OnUndoRemoveFile – 当用户恢复已删除的附件时要执行的操作。
其他属性
AccessibleLabel – 屏幕阅读器标签。 应描述附件的用途。
AddAttachmentText - 用于添加新附件的链接的标签文本。
BorderColor – 控件边框的颜色。
BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。
BorderThickness – 控件边框的粗细。
Color – 控件文本的颜色。
DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。
DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。
DisplayMode – 控件是允许添加和删除文件(编辑)、仅显示数据(查看),还是已禁用(禁用)。
[DropTargetBackgroundColor] – 控件拖放目标背景的颜色。
[DropTargetBorderColor] – 控件拖放目标边框的颜色。
[DropTargetBorderStyle] – 控件的拖放目标边框是实线、虚线、点线还是无。
[DropTargetBorderThickness] – 控件拖放目标边框的粗细。
[DropTargetTextColor] – 控件拖放目标文本的颜色。
Fill – 控件的背景色。
FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。
FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。
Height – 控件上边缘和下边缘之间的距离。
Font – 文本中所显示的字体系列的名称。
FontWeight – 控件中文本的粗细:Bold、Semibold、Normal 或 Lighter。
HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。
HoverColor – 用户将鼠标指针停留在控件上时,该控件中的文本颜色。
HoverFill – 用户将鼠标指针停留在控件上时,该控件的背景色。
Italic – 控件中的文本是否为斜体。
MaxAttachmentsText – 当控件中的文件数达到上限时,用于替换“附加文件”链接的文本。
NoAttachmentsText – 在未附加任何文件时向用户显示的说明文本。
Padding – 导入或导出按钮上的文本和该按钮边缘之间的距离。
PressedBorderColor – 用户选择控件时,该控件边框的颜色。
PressedColor – 用户选择控件时,该控件中文本的颜色。
PressedFill – 用户选择控件时,该控件的背景色。
Reset – 将对 附件 控件的所有更改还原回之前保存的状态。
Size – 控件上显示的文本的字号。
Strikethrough – 通过文本显示的线是否在控件上显示。
TabIndex – 相对于其他控件的键盘导航顺序。
Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。
Underline – 在文本下方显示的线是否在控件上显示。
Visible – 控件可见还是隐藏。
Width – 控件左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
示例
在您的应用中添加一个窗体,并设置列表作为其数据源。
在左侧树视图中选择 显示窗体 控件。 您也可以改用编辑窗体。
在右侧选项面板的“属性”选项卡中选择 Data Source,然后选择您连接到的列表。
在字段部分选择编辑字段,然后选择添加字段。
选择附件字段,然后选择添加。
与列表相关联的“附件”字段将显示在窗体中。
辅助功能准则
颜色对比度
在以下项之间必须有足够的颜色对比度:
- ItemColor 和 ItemFill
- ItemHoverColor 和 ItemHoverFill
- ItemPressedColor 和 ItemPressedFill
- AddedItemColor 和 AddedItemFill
- RemovedItemColor 和 RemovedItemFill
- ItemErrorColor 和 ItemErrorFill
- AddAttachmentColor 和 Fill
- MaxAttachmentsColor 和 Fill
- NoAttachmentsColor 和 Fill
这是除标准颜色对比度以外的要求。
屏幕阅读器支持
必须存在以下属性:
- AccessibleLabel
- AddAttachmentsText
- MaxAttachmentsText
- NoAttachmentsText
键盘支持
- TabIndex 必须为零或更大,以便键盘用户可以导航到它。
- 焦点指示器必须清晰可见。 可以使用 FocusedBorderColor 和 FocusedBorderThickness 来实现这一清晰度。