Power Apps 中的卡片控件

为显示窗体或编辑窗体控件的单个字段提供显示和编辑体验。

Description

显示窗体编辑窗体 控件充当用于显示和查看整个记录的容器。 每个容器可以保存一组 卡片 控件,这些控件显示单个字段或提供更新这些字段的方法。 每个卡片都有一个 DataField 属性,该属性指定其工作记录的字段。

预定义卡片是为不同的数据类型和用户体验定义的。 例如,可能有一张卡片可以使用 文本输入 控件编辑数字字段,这非常适合用于键盘。 另一张卡片可能支持改用 滑块 控件编辑数字。 选中窗体控件后,可以在右侧窗格中轻松基于字段选择卡片。

卡片本身包含控件。 卡片的控件构成了显示和编辑单个字段的体验。 例如,数字卡可能包含 一个标签 控件,以提供字段的显示名称,以及 一个文本输入 控件,以便为字段的值提供编辑器。 该卡片可能还有一个 标签 控件,该控件显示发生的任何验证错误,以及公共星号的 Label 控件,以指示字段是必需的。

可以通过调整预定义卡的大小、移动卡片、隐藏卡片、向其添加控件以及进行其他更改来自定义预定义卡片的控件。 也可以从完全空白的卡片(即“自定义卡片”)开始,从头开始添加控件。

预定义卡片默认 处于锁定状态 。 在锁定的卡片中,只能修改卡片的某些属性或卡片中的控件,并且不能删除锁定的卡片。 可以在高级视图的“视图”选项卡上显示卡片锁并解锁它。 如果属性已锁定且无法修改,则它会显示在其名称旁边的锁图标。 解锁卡片是一项高级活动,应谨慎完成,因为卡的自动公式生成将不再发生,并且无法重新锁定卡。

在窗体的容器中, ThisItem 记录可用,并包含记录的所有字段。 例如, 卡片的默认属性 通常设置为 ThisItemFieldName

可以使用 Parent 引用来配置控件以引用卡片的属性。 例如,控件应使用 Parent.Default 从数据源中读取字段的初始状态。 通过使用 Parent 而不是直接访问所需的信息,卡片可以更好地封装,并且无需中断内部公式即可将其更改为其他字段。

有关如何自定义、解锁和创建卡片的示例,请参阅 “了解数据卡 ”。

键属性

DataField – 此卡片显示和编辑的记录中的字段的名称。

  • 将名称指定为用双引号(例如 ,“Name”)括起来的单个静态字符串,而不是公式。
  • 通过将 卡片的 DataField 属性设置为 空白来取消绑定。 对于未绑定的卡片, 将忽略“有效 ”和 “更新 ”属性。

默认值 – 用户更改控件之前控件的初始值。

  • 对于卡片中的每个控件,请将此属性设置为 Parent.Default ,以根据数据源引用字段的默认值。 例如,将 滑块的默认属性 设置为 Parent.Default ,以确保用户以该滑块的泛型值开头。

DisplayMode – 值可以是 “编辑”、“视图 ”或 “禁用”。 配置卡片内的控件是否允许用户输入(编辑)、仅显示数据(视图)还是禁用(已禁用)。

  • 通过配置此属性(默认绑定到窗体的行为),允许在编辑窗体和视图窗体中使用单个卡片。
  • 视图 模式下,子控件(如 文本输入下拉列表日期选取器 )将仅显示文本值,并且不会呈现任何交互式元素或修饰。

DisplayName – 数据源中字段的用户友好名称。

  • DataSourceInfo 函数从数据源提供此元数据。
  • 卡片中的控件应使用 Parent.DisplayName 来引用字段的名称。

错误 – 验证失败时要为此字段显示的用户友好错误消息。

  • 调用 SubmitForm 时设置此属性。
  • 该消息根据数据源的元数据和检查卡的 Required 属性描述验证问题。

必需 – 卡片是否编辑数据源的字段必须包含值。

  • DataSourceInfo 函数提供数据源中所需的元数据。
  • 卡片中的控件应使用 Parent.Required 来确定该卡片的字段是否是必需的。

更新 – 要写回字段数据源的值。

  • 使用此属性的公式从卡片的编辑控件中提取值,以便写回数据源。 例如,将卡片的 Update 属性设置为 Slider.Value ,以使用该卡片中的滑块中的值更新数据源。

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

WidthFit – 控件是否自动水平增长以填充容器控件(如 编辑窗体 控件)中的任何空白空间。 如果多个卡的此属性设置为 true,则空间将划分为两者。 有关详细信息,请参阅 “了解数据窗体布局”。

其他属性

BorderColor – 控件边框的颜色。

BorderStyle – 控件的边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

填充 – 控件的背景色。

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

有效卡片编辑表单 控件是否包含有效的条目,准备提交到数据源。

可见 – 控件是显示还是隐藏。

X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。 对于包含多个列的容器中的 Card 控件,此属性确定卡片所在的列。

Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。 对于包含多行的容器中的 卡片 控件,此属性确定卡片所在的行。

例子

有关示例,请参阅 “了解数据卡 ”和 “了解数据表单”布局

辅助功能指南

颜色对比度

在以下两者之间必须有足够的颜色对比度:

  • 填充 和任何子控件。 例如,如果卡片包含 标签 且标签具有透明填充,则卡片的 填充 实际上将成为标签的背景色。 因此,卡片的 填充 和标签 的颜色之间应该有足够的对比度。

屏幕阅读器支持

  • DisplayName 必须存在。