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( Number, "FormatCodes" )

示例

显示文本字符串

  • 添加一个标签，然后将**Text** 属性设置为 "Hello, world"（含双引号）。

    不知道如何添加和配置控件？

显示公式的结果

  • 添加一个标签，然后将**Text** 属性设置为如下公式：
    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 行为，将Label作为按钮或链接使用。 以此方式使用时，要考虑与按钮相类似的辅助功能注意事项。

颜色对比度

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

屏幕阅读器支持

  • Text 必须存在。

  • 如果屏幕阅读器应该公布对 Text 属性的值的更改，Live 应该设置为 Polite 或 Assertive。

    备注

    当 TabIndex 为零或更大，屏幕阅读器会将Label视为按钮。

弱视支持

  • 如果Label作为链接使用，则应采用链接的形式。

键盘支持

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

备注

您能告诉我们您的文档语言首选项吗？ 进行简短调查。（请注意，此调查是英文版调查）

此调查大约需要七分钟。 不会收集个人数据（隐私声明）。