Power Apps 中的标签控件

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

Description

标签显示指定为文本文本字符串的数据,该字符串的显示方式与键入方式完全相同,或者作为计算结果为文本字符串的公式。 标签通常出现在任何其他控件之外(例如标识屏幕的横幅),作为标识其他控件(如分级或音频控件)的标签,或在库中显示有关项目的特定类型信息。

键属性

AutoHeight – 设置为 true 以允许标签自动增长其高度以显示所有文本。 设置为 false,将文本截断为分配的高度。

颜色 – 控件中的文本颜色。

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

文本 - 显示在控件上或用户键入控件的文本。

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

其他属性

对齐 - 文本相对于其控件的水平中心的位置。

AutoHeight – 如果标签的 Text 属性包含的字符多于控件一次可以显示的字符,则标签是否自动增加其 Height 属性。 如果控件不可见,则当文本更改时,输出属性 Height 将不会更新。

BorderColor – 控件边框的颜色。

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

BorderThickness – 控件边框的粗细。

DisplayMode – 控件是否允许用户输入(编辑)、仅显示数据(视图)或已禁用(已禁用)。

DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled,则控件边框的颜色。

DisabledColor – 控件中的文本颜色(如果控件的 DisplayMode 属性设置为 Disabled)。

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

填充 – 控件的背景色。

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

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

FontWeight – 控件中文本的粗细: 粗体半曲普通较轻

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

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

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

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

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

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

实时 – 屏幕阅读器如何读出对标签的 Text 属性值的更改。

  • 设置为 “关闭”时,屏幕阅读器不会报出更改。
  • 设置为 “礼貌”时,屏幕阅读器在宣布屏幕阅读器说话时发生的任何更改之前,将完成朗读。
  • 设置为 Assertive 时,屏幕阅读器会中断自身,以宣布屏幕阅读器说话时发生的任何更改。

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

Overflow – 如果滚动条的 Wrap 属性设置为 true ,并且控件的 Text 属性的值包含的字符数超过控件一次可以显示的字符数,则是否显示在标签中。

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

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

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

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

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

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

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

角色 - 标签文本的语义角色,如标题 1。 不会更改标签的样式,而是使输出语义正确,供屏幕阅读器解释。

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

删除线 – 是否通过控件上显示的文本显示线条。

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

工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。

下划线 – 是否在控件上显示的文本下显示一行。

VerticalAlign – 控件上与该控件的垂直中心相关的文本位置。

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

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

换行 – 文本是否应换行到多行。

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

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

Text数字、“FormatCodes”)

例子

显示文本字符串

  • 添加标签,并将其 Text 属性设置为 “Hello, world” (包括双引号)。

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

显示公式的结果

  • 添加标签,并将其 Text 属性设置为公式,如以下公式:
    今天()

    注释

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

    想要了解有关 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:“Germany”:1494000}, {City:“米兰”, 国家:“意大利”, 人口:1344000})

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

  3. 添加文本库,并将其 Items 属性设置为 CityPopulations

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

  4. “库 1 ”窗格中,将顶部列表设置为 “人口”,将中间列表设置为 “城市”,并将底部列表设置为 “国家/地区”。

辅助功能指南

尽管名称如此, 标签控件不必用作另一个控件的标签。 它可用于显示任何文本片段。

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

颜色对比度

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

屏幕阅读器支持

  • 文本 必须存在。

  • 如果屏幕阅读器应读出对 Text 属性值的更改,则直播应设置为“礼貌”或“断言”。

    注释

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

低视力支持

键盘支持

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