卡片中的控件和属性

通过设置控件的属性之一配置该控件的外观和行为。 每种类型的控件都有一组不同的属性。 某些属性(例如 HeightWidth)是几乎每种类型的控件共有的,但其他属性(例如 OnSelect)特定于某种类型的控件。

控制

按钮 - 单击时执行 Power Fx 的按钮元素。

按钮集 - 一组按钮元素的容器。

复选框 - 一个允许用户通过选择或清除在两个选项之间进行选择的复选框。

- 充当其他元素的容器的单个列。

列集 - 列的集合,每个列都是容器。

容器 - 其他元素的集合。

日期选取器 - 供用户选择日期的字段。

下拉 - 一个允许用户从可扩展项列表中选择一个项的菜单。

事实集 - 事实的容器元素。

图像 - 一个具有用于控制图像外观的属性的图像。

图像集 - 充当照片库的图像容器。

媒体 - 由其 Url 和 MimeType 指定的视频或图像。

数字输入 - 供用户键入数字的字段。

– 显示表格数据或任何结构化信息,最好以行和列的形式显示。

文本输入 - 供用户键入文本的字段。

文本标签 - 一个具有用于控制文本外观的属性的文本块。

时间选取器 - 供用户选择时间的字段。

所有属性

A

Alt text - 描述图像、音频或视频的替代文本。

相关输入 - 控制哪些输入与操作相关联。

B

Background color - 将背景应用于透明图像。 此属性将采用图像样式。

Background image - 指定背景图像。 可接受的格式包括 PNG、JPEG 和 GIF。

Bleed - 确定控件是否应当通过其父项填充进行加宽。

C

Choices - 用户可以从中选择的项列表。

颜色 - 控制文本的颜色。

Content alignment - 定义内容在列中的垂直对齐方式。

D

Default value - 属性的初始值。

Divider - 当为 true 时,在控件顶部画一条分隔线。

E

Error message - 输入信息无效时要显示的错误消息。

F

Facts - 要在事实集中显示的事实。

Font type - 用于呈现的字体的类型

H

Height - 指定属性的高度。

Horizontal alignment - 控制水平对齐方式。

I

IconUrl - 显示在标题旁边的按钮上的可选图标。 支持 1.2+ 版本中的数据 URI。

图像 size - 控制每个图像的近似大小。 物理尺寸因主机而异。 图像集不支持自动和拉伸。 如果设置了这些值,则大小默认为“中”。

InlineAction - 输入的内联操作。 通常显示在输入的右侧。 建议在操作上提供一个图标(显示该图标而不是操作的标题)。

最初可见 – 如果为 "false",则将从可视化树中删除此项。

L

Label - 此输入的标签。

M

Max length - 要收集的最大长度字符数的提示(可能会被某些客户端忽略)。

Maximum lines - 指定要显示的最大行数。

Maximum value - 最大值的提示(可能会被某些客户端忽略)。

Minimum height - 以像素为单位指定列集的最小高度,如“80 像素”。

Minimum value - 最小值的提示(可能会被某些客户端忽略)。

模式 – 可将模式定义为主模式或辅助模式,以在卡元素之间建立层次结构。

Multiline - 如果为 true,则允许多行输入。

Multiple selection - 允许选择多个项。

O

OnSelect - 当用户点击或单击按钮时要执行的操作。

P

Placeholder - 所需输入的描述。 未进行选择时显示。

Poster - 播放前要显示的图像的 URL。 支持 1.2+ 版本中的数据 URI

从右到左显示 – 启用时,容器中的内容应该从右到左显示。 禁用时,此容器中的内容应该从左到右显示。 未设置时,布局方向将从父容器或列继承。 如果在所有上级中未设置,则应用默认平台行为。

R

Regex - 用于指示此文本输入所需格式的正则表达式。

Repeat for every - Repeat for every 用于根据数据源多次显示控件。 Repeat for every 属性设置为集合或数据源,然后相关属性可以使用 ThisItem 来引用集合或数据源中的特定项。

通过使用 Dataverse 客户表和文本标签的对每个重复属性,制作者可以创建显示客户表中每个客户帐户名称的卡片。

  1. 使用 Dataverse 连接添加帐户表。
  2. 添加 文本标签 控件。
  3. 将文本标签 Repeat for every 属性设置为 Accounts
  4. 将文本标签的 Text 属性设置为 ThisItem.'Account Name'
  5. 播放这张卡片,可显示一个客户表长度的文本标签列表,每个标签显示一个帐户名称。

Required field - 指明此输入是否必填。

S

Screen - 当用户点击或单击“显示屏幕”类型的按钮时,当前卡片下方显示的屏幕。

显示网格线 – 指定是否应显示网格线。

Show when - 条件布局表达式。

Size - 控制图像或文本的近似大小。

Sources - 要播放的媒体内容。 播放默认指定的第一个媒体内容。

Spacing - 控制此控件与前一个控件之间的间距量。

Style - 确定控件的样式。

Subtle - 如果为 true,则将文本显示为略微淡化以显得不那么突出。

T

Target Elements - 当用户点击或单击“切换可见性”类型的按钮时更改可见性的元素。

Text - 要显示的文本。 支持 Markdown 的子集 (https://aka.ms/ACTextFeatures)。

Title - 此按钮的标签。

工具提示 - 定义在最终用户将鼠标悬停在操作上方时应向最终用户显示的文本,并在使用旁白软件时阅读。

Type - 选择按钮时按钮应执行的操作 - 可以是显示屏幕、运行 Power Fx、打开 Url 或切换可见性。

U

Url - 图像的 URL 或在选择按钮时要打开的 URL。 支持 1.2+ 版本中的数据 URI。

V

Value - 应选择的初始项(或项集)。 对于多选,请指定以逗号分隔的值字符串。

W

Weight - 控制文本的粗细。

Width - 属性的所需宽度。

Wrap - 如果为 true,则允许文本换行。 否则,文本将被剪裁。