Power Apps 中的 文本输入 控件
用户可在其中键入文本、数字和其他数据的框。
描述
用户可通过将数据键入文本输入控件来进行指定。 根据配置应用的方式,该数据可能会被添加到某个数据源、用于计算临时值或以其他某种方式合并。
关键属性
Default – 用户更改控件前的初始值。
Text – 在控件上显示或用户键入到控件中的文本。
其他属性
AccessibleLabel – 屏幕阅读器标签。
Align – 文本相对于其控件的水平居中的位置。
BorderColor – 控件边框的颜色。
BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。
BorderThickness – 控件边框的粗细。
Clear – 文本输入控件是否显示“X”,用户可点击或单击该符号以清除该控件的内容。 仅在 SingleLine 模式下工作。
Color – 控件中文本的颜色。
DelayOutput – 如果设置为 true,用户输入会延迟半秒后注册。 可帮助延迟成本高昂的操作,直到用户完成输入文本(例如,输入用在其他公式中时有益于筛选)。
DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。
DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。
DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。
EnableSpellCheck – 文本输入控件是否应使用浏览器拼写检查功能。 适用于 Windows 的 Power Apps 不支持此属性。
Fill – 控件的背景色。
FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。
FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。
Font – 文本中所显示的字体系列的名称。
FontWeight – 控件中文本的粗细:Bold、Semibold、Normal 或 Lighter。
Format – 用户输入是仅在数量上进行限制,还是限制所有文本。 当设置为数字时,只能输入数字和某些数字符号。 支持的符号和格式取决于浏览器语言,不能在单个控件上设置。
Height – 控件上边缘和下边缘之间的距离。
HintText – 输入文本控件为空时其中显示的浅灰色文本。
HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。
HoverColor – 用户将鼠标指针停留在控件上时,该控件中的文本颜色。
HoverFill – 用户将鼠标指针停留在控件上时,该控件的背景色。
Italic – 控件中的文本是否为斜体。
LineHeight – 诸如文本行之间或列表中各项之间的距离。
MaxLength – 用户可键入文本输入控件中的字符数。
Mode – 控件处于 SingleLine、MultiLine 或 Password 模式。
OnChange - 用户更改控件的值(例如,通过调整滑块)时要执行的操作。
OnSelect – 当用户点击或单击控件时要执行的操作。
PaddingBottom – 控件中的文本与该控件下边缘之间的距离。
PaddingLeft – 控件中的文本与该控件左边缘之间的距离。
PaddingRight – 控件中的文本与该控件右边缘之间的距离。
PaddingTop – 控件中的文本与该控件上边缘之间的距离。
PressedBorderColor – 用户在点击或单击控件时,该控件边框的颜色。
PressedColor – 用户在点击或单击控件时,该控件中的文本的颜色。
PressedFill – 用户在点击或单击控件时,该控件的背景色。
RadiusBottomLeft – 控件左下角圆角的程度。
RadiusBottomRight – 控件右下角圆角的程度。
RadiusTopLeft – 控件左上角圆角的程度。
RadiusTopRight – 控件右上角圆角的程度。
Reset – 控件是否还原为其默认值。
Size – 控件上显示的文本的字号。
Strikethrough – 通过文本显示的线是否在控件上显示。
TabIndex – 相对于其他控件的键盘导航顺序。
Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。
Underline – 在文本下方显示的线是否在控件上显示。
VirtualKeyboardMode – 应用用户的触摸屏上显示的虚拟键盘的类型,文本或数字。 Format 属性确定默认值。 设备支持会有所不同。 运行 iOS 的设备必须至少有版本 12.2。 推荐的 Android 版本是 9.0,数字键盘的功能因 Android 设备而异。 Windows 10 不支持此属性。
Visible – 控件显示还是隐藏。
Width – 控件左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
相关函数
示例
收集数据
添加两个文本输入控件,并将它们命名为 inputFirst 和 inputLast。
不知道如何添加、命名和配置控件?
添加一个按钮,将其**Text** 属性设置为 Add,并将其 OnSelect 属性设置为以下公式:
Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})以纵向/垂直方向添加文本库,将其 Items 属性设置为 Names,并将 Subtitle1 的**Text** 属性设置为 ThisItem.FirstName。
(可选)在模板库中,删除底部名称 Body1 的标签,然后将库的 TemplateSize 属性设置为 80。
按 F5,将一个文本字符串键入 inputFirst 和 inputLast,然后单击或点击添加按钮。
(可选)向集合添加更多名称,然后按 Esc 返回到默认工作区。
提示输入密码
添加文本输入控件,将其命名为 inputPassword,并将其 Mode 属性设置为 Password。
添加一个标签,然后将其**Text** 属性设置为以下公式:
If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")按 F5,然后在 inputPassword 中键入 P@ssw0rd。
密码键入完毕后,标签不再显示拒绝访问,而会显示已授予访问权限。
要返回默认工作区,按 Esc。
(可选)添加一个控件(如箭头),配置它以导航到另一个屏幕,且仅在用户键入密码后才显示。
(可选)添加一个按钮,配置其**Text** 属性,使其显示登录,添加一个计时器,如果用户键入错误的密码,则禁用输入文本控件一段时间,然后单击或点击登录按钮。
辅助功能准则
颜色对比度
- 适用标准颜色对比度要求。
屏幕阅读器支持
- AccessibleLabel 必须存在。
键盘支持
- TabIndex 必须为零或更大,以便键盘用户可以导航到它。
- 焦点指示器必须清晰可见。 可以使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。