Power Apps 中的标签控件

一个框,显示文本、数字、日期或货币等数据。

描述

标签按键入时原封不动地显示指定为文本字符串的数据,或显示指定为公式(计算结果为文本字符串)的数据。 标签通常作为标识另一控件(如评分或音频控件)的标签出现在其他任何控件(如标识屏幕的横幅)之外,或出现在库中以显示项的特定类型信息。

关键属性

AutoHeight – 设置为 true 后,标签会自动调高高度,以显示所有文本。 设置为 false 将文本截断至分配的高度。

Color – 控件中文本的颜色。

Font – 文本中所显示的字体系列的名称。

文本 – 在控件上显示或用户键入到控件中的文本。

DelayOutput – 设置为 true,可在文本输入期间延迟操作。

其他属性

Align – 文本相对于其控件的水平居中的位置。

AutoHeight – 标签是否会在 文本 属性包含的字符数超过控件一次可显示的字符数时自动增加 Height 属性值。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。

DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。

DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。

DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。

Fill – 控件的背景色。

FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。

FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。

FontWeight – 控件中文本的粗细:BoldSemiboldNormalLighter

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

HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。

HoverColor – 用户将鼠标指针停留在控件上时,该控件中的文本颜色。

HoverFill – 用户将鼠标指针停留在控件上时,该控件的背景色。

Italic – 控件中的文本是否为斜体。

LineHeight – 诸如文本行之间或列表中各项之间的距离。

Live – 屏幕阅读器如何公布对标签的 文本 属性值的更改。

  • 设置为 Off 时,屏幕阅读器不会公布更改。
  • 设置为 Polite 时,屏幕阅读器会先完成讲话,然后再公布屏幕阅读器讲话时进行的所有更改。
  • 设置为 Assertive 时,屏幕阅读器会自行中断,公布屏幕阅读器讲话时进行的所有更改。

OnSelect – 当用户点击或单击控件时要执行的操作。

Overflow – 标签是否会在 Wrap 属性设置为 true文本 属性值包含的字符数超过控件一次可显示的字符数时显示滚动条。

PaddingBottom – 控件中的文本与该控件下边缘之间的距离。

PaddingLeft – 控件中的文本与该控件左边缘之间的距离。

PaddingRight – 控件中的文本与该控件右边缘之间的距离。

PaddingTop – 控件中的文本与该控件上边缘之间的距离。

PressedBorderColor – 用户在点击或单击控件时,该控件边框的颜色。

PressedColor – 用户在点击或单击控件时,该控件中的文本的颜色。

PressedFill – 用户在点击或单击控件时,该控件的背景色。

Role - 标签文本的语义角色,如 Heading 1。 不更改标签的样式,但会使输出在语义上正确,以供屏幕阅读器进行解释。

Size – 控件上显示的文本的字号。

Strikethrough – 通过文本显示的线是否在控件上显示。

TabIndex – 相对于其他控件的键盘导航顺序。

Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。

Underline – 在文本下方显示的线是否在控件上显示。

VerticalAlign – 控件上的文本相对于该控件垂直居中的位置。

Visible – 控件显示还是隐藏。

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

Wrap – 太长而无法容纳在标签中的文本是否换到下一行。

X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。

Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。

Text( Number, "FormatCodes" )

示例

显示文本字符串

显示公式的结果

  • 添加一个标签,然后将 文本 属性设置为如下公式:
    Today()

    备注

    指定公式时,请勿使用引号,除非公式的参数是文本字符串。 在这种情况下,用双引号将参数(而不是公式)括住。

    想要了解有关 Today 函数或其他函数的详细信息?

在此过程中,需创建一个名为 CityPopulations 的集合,其中包含欧洲各个城市人口的相关数据。 接下来,在包含三个标签的库中显示数据,然后指定每个标签将显示的数据类型。

  1. 添加一个按钮,然后将其 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})

  2. 按 F5,选择该按钮,然后按 Esc。

  3. 添加一个文本库,然后将其 Items 属性设置为 CityPopulations

    选择库后,右侧窗格显示该库的选项。

  4. Gallery1 窗格中,将顶部列表设置为 Population,中间列表设置为 City,底部列表设置为 Country

辅助功能准则

尽管其名称如此,标签 控件不一定要用作另一个控件的标签。 它可以用于显示文本的任何部分。

可以通过指定 OnSelect 行为,将 标签 作为按钮或链接使用。 以此方式使用时,要考虑与按钮相类似的辅助功能注意事项。

颜色对比度

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

屏幕阅读器支持

  • 文本 必须存在。

  • 如果屏幕阅读器应该公布对 文本 属性的值的更改,Live 应该设置为 PoliteAssertive

    备注

    TabIndex 为零或更大,屏幕阅读器会将 标签 视为按钮。

弱视支持

  • 如果 标签 作为链接使用,则应采用链接的形式。

键盘支持

  • 如果文本用作按钮或链接,TabIndex 必须为零或更大。 这允许键盘用户导航到它。
  • 如果文本用作按钮或链接,焦点指示器必须清楚显示。 可以使用 FocusedBorderColorFocusedBorderThickness 来实现此目的。