Power Apps 中的 标签 控件
一个框,显示文本、数字、日期或货币等数据。
描述
标签按键入时原封不动地显示指定为文本字符串的数据,或显示指定为公式(计算结果为文本字符串)的数据。 标签通常作为标识另一控件(如 评分 或 音频 控件)的标签出现在其他任何控件(如标识屏幕的横幅)之外,或出现在库中以显示项的特定类型信息。
关键属性
AutoHeight – 设置为 true 后,标签会自动调高高度,以显示所有文本。 设置为 false 将文本截断至分配的高度。
Color – 控件中文本的颜色。
Font – 文本中所显示的字体系列的名称。
Text – 在控件上显示或用户键入到控件中的文本。
DelayOutput – 设置为 true,可在文本输入期间延迟操作。
其他属性
Align – 文本相对于其控件的水平居中的位置。
AutoHeight – 标签是否会在**Text** 属性包含的字符数超过控件一次可显示的字符数时自动增加 Height 属性值。
BorderColor – 控件边框的颜色。
BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。
BorderThickness – 控件边框的粗细。
DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。
DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。
DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。
Fill – 控件的背景色。
FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。
FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。
FontWeight – 控件中文本的粗细:Bold、Semibold、Normal 或 Lighter。
Height – 控件上边缘和下边缘之间的距离。
HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。
HoverColor – 用户将鼠标指针停留在控件上时,该控件中的文本颜色。
HoverFill – 用户将鼠标指针停留在控件上时,该控件的背景色。
Italic – 控件中的文本是否为斜体。
LineHeight – 诸如文本行之间或列表中各项之间的距离。
Live – 屏幕阅读器如何公布对标签的 Text 属性值的更改。
- 设置为 Off 时,屏幕阅读器不会公布更改。
- 设置为 Polite 时,屏幕阅读器会先完成讲话,然后再公布屏幕阅读器讲话时进行的所有更改。
- 设置为 Assertive 时,屏幕阅读器会自行中断,公布屏幕阅读器讲话时进行的所有更改。
OnSelect – 当用户点击或单击控件时要执行的操作。
Overflow – 标签是否会在 Wrap 属性设置为 true 且**Text** 属性值包含的字符数超过控件一次可显示的字符数时显示滚动条。
PaddingBottom – 控件中的文本与该控件下边缘之间的距离。
PaddingLeft – 控件中的文本与该控件左边缘之间的距离。
PaddingRight – 控件中的文本与该控件右边缘之间的距离。
PaddingTop – 控件中的文本与该控件上边缘之间的距离。
PressedBorderColor – 用户在点击或单击控件时,该控件边框的颜色。
PressedColor – 用户在点击或单击控件时,该控件中的文本的颜色。
PressedFill – 用户在点击或单击控件时,该控件的背景色。
Role - 标签文本的语义角色,如 Heading 1。 不更改标签的样式,但会使输出在语义上正确,以供屏幕阅读器进行解释。
Size – 控件上显示的文本的字号。
Strikethrough – 通过文本显示的线是否在控件上显示。
TabIndex – 相对于其他控件的键盘导航顺序。
Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。
Underline – 在文本下方显示的线是否在控件上显示。
VerticalAlign – 控件上的文本相对于该控件垂直居中的位置。
Visible – 控件显示还是隐藏。
Width – 控件左边缘和右边缘之间的距离。
Wrap – 文本是否应换行为多行。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
相关函数
示例
显示文本字符串
显示公式的结果
添加一个标签,然后将**Text** 属性设置为如下公式:
Today()备注
指定公式时,请勿使用引号,除非公式的参数是文本字符串。 在这种情况下,用双引号将参数(而不是公式)括住。
在库中显示数据
在此过程中,需创建一个名为 CityPopulations 的集合,其中包含欧洲各个城市人口的相关数据。 接下来,在包含三个标签的库中显示数据,然后指定每个标签将显示的数据类型。
添加一个按钮,然后将其 OnSelect 属性设置为以下公式:
ClearCollect(CityPopulations, {City:"London", Country:"United Kingdom", Population:8615000}, {City:"Berlin", Country:"Germany", Population:3562000}, {City:"Madrid", Country:"Spain", Population:3165000}, {City:"Rome", Country:"Italy", Population:2874000}, {City:"Paris", Country:"France", Population:2273000}, {City:"Hamburg", Country:"Germany", Population:1760000}, {City:"Barcelona", Country:"Spain", Population:1602000}, {City:"Munich", Country:"Germany", Population:1494000}, {City:"Milan", Country:"Italy", Population:1344000})按 F5,选择该按钮,然后按 Esc。
添加一个文本库,然后将其 Items 属性设置为 CityPopulations。
选择库后,右侧窗格显示该库的选项。
在 Gallery1 窗格中,将顶部列表设置为 Population,中间列表设置为 City,底部列表设置为 Country。
辅助功能准则
尽管其名称如此,标签 控件不一定要用作另一个控件的标签。 它可以用于显示文本的任何部分。
可以通过指定 OnSelect 行为,将Label作为按钮或链接使用。 以此方式使用时,要考虑与按钮相类似的辅助功能注意事项。
颜色对比度
在以下项之间必须有足够的颜色对比度:
屏幕阅读器支持
Text 必须存在。
如果屏幕阅读器应该公布对 Text 属性的值的更改,Live 应该设置为 Polite 或 Assertive。
备注
当 TabIndex 为零或更大,屏幕阅读器会将Label视为按钮。
弱视支持
- 如果Label作为链接使用,则应采用链接的形式。
- 将 Underline 设置为 true
- HoverColor 应不同于 Color
键盘支持
- 如果文本用作按钮或链接,TabIndex 必须为零或更大。 这允许键盘用户导航到它。
- 如果文本用作按钮或链接,焦点指示器必须清楚显示。 可以使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。