文本输入脚本组件

文本输入组件提示代理输入文本并可以验证文本。您可以将文本输入组件的值绑定到变量。

点击输入图标在组件工具栏上。
在属性面板中，使用 占位符 框在控件中预填充一个提示，告诉读者要键入的内容。变量永远不会存储占位符文本。占位符文本是指示代理的临时文本，它会被用户输入自动替换。例如：

您可以使用变量的值预填充字段。为此，请从组件属性的 “值” 列表中选择一个变量。该值在运行时自动向用户显示。变量的值会自动使用用户键入的文本进行更新，但需要进行可选的验证。
要验证用户输入，请展开常用组。然后单击验证列表。

选择 “选择” 或 “ 自定义” 以选择验证方法。

选择：选择允许您选择预设的验证模式。验证预设包括：

电子邮件	输入必须符合电子邮件地址语法。
字母	只允许按字母顺序输入（不允许输入数字）。
字母 - 带空格	只允许按字母顺序输入并且要求单词之间有空格。例如，“酷豆” 是可以接受的，但 “cool_beans” 不可以接受。
字母 - 带下划线	只需要字母输入（无数字）和单词之间的下划线。例如，“cool_beans” 是可以接受的，但 “酷豆” 不可以接受。
字母数字	文本输入必须同时包含字母和数字。
字母数字 - 带空格	文本输入必须同时包含字母和数字，单词之间用空格分隔。
字母数字 - 带下划线	文本输入必须同时包含字母和数字，单词用下划线分隔。

自定义：如果预打包的验证还不够，则可以使用正则表达式来验证文本输入。从验证列表 中选择 自定义。然后，在文本框中输入正则表达式。正则表达式超出了本主题的讨论范围。但是，例如，假设您希望用户在文本输入中的某处输入短语 “dog”。 在自定义验证属性中键入 dog 会设置一个简单的正则表达式，该正则表达式接受 dog、sundog、热狗、我的好狗 Penny 或包含该区分大小写的字符串的其他字符组合，但不能接受 DOG Doggie 等。

另一个例子是 ^ [a-z] +$ 仅 接受小写字母字符。

提示：互联网提供了许多学习正则表达式的资源。例如 http://www.regular-expressions.info/ 和 https://en.wikipedia.org/?title=Regular_expression。

当焦点离开文本框时，将验证文本输入组件的值，以确保其符合选定的验证规则。如果用户输入未通过验证，则边框将变为红色以表示存在验证问题。您可以在编辑器的预览模式下测试自定义验证和预打包验证。

如果用户必须在组件中键入值，则将 “需要值” 开关设置为 “是”。默认情况下，此设置为 “否”，这意味着用户输入是可选的。
1. 如果用户必须在组件中键入值，则将 “需要值” 开关设置为 True。默认情况下，此设置为 False，这意味着用户输入是可选的。
要设置操作，请单击高级属性组中 更改操作 下方的未选择任何操作。
要选择操作，请单击列表中的某一行。您可以分配先前定义的操作或创建新操作。
关闭 “选择操作” 列表。

或者，设置此组件的其他属性。例如，您可以使用边距设置调整此组件周围的间距。

通用

值

Value 将组件绑定到选定的变量。例如，如果将文本输入组件绑定到变量，则输入框将始终显示该变量的值，而忽略指定的任何占位符文本。变量会自动使用用户键入的文本进行更新，但需要进行验证处理。

其他控件（例如单选按钮）使用带有选定值文本设置的值。在运行时选择单选按钮时，其 “所选值文本” 将成为变量的新值。这样，每个单选按钮都可以为同一个变量分配不同的值。

当日历控件绑定到变量时，其值将设置为控件选择的日期。由于变量可以预设视觉控件的值，也可以由它们设置，因此绑定是一种功能强大且经常使用的技术。

占位符

占位符文本向用户显示提示。

对于文本输入，在用户键入输入之前，将显示占位符文本。如果用户清除了输入框的内容，则会重新显示占位符文本。

对于下拉菜单，占位符文本会提示用户进行选择。

用户选择项目后，占位符将被替换。

提示： 如果组件绑定到变量，则会忽略手动键入的占位符文本。如果选择了变量，则始终显示其值。

验证

验证可确保座席输入格式正确的文本。当焦点离开文本输入框时，Genesys Cloud 会测试文本值以确保其符合选定的验证规则。如果文本未能通过验证，边框将变为红色，表示文本存在验证问题。

使用下拉列表选择验证方法：

选择— 允许您选择预设的验证模式：

电子邮件	输入必须符合电子邮件地址语法。
字母	只允许按字母顺序输入（没有数字）
字母 - 带空格	只允许按字母顺序输入并且要求单词之间有空格。例如，“酷豆” 是可以接受的，但 “cool_beans” 不可以接受。
字母 - 带下划线	只需要字母输入（无数字）和单词之间的下划线。例如，“cool_beans” 是可以接受的，但 “酷豆” 不可以接受。
字母数字	文本输入必须同时包含字母和数字。
字母数字 - 带空格	文本输入必须同时包含字母和数字，单词之间用空格分隔。
字母数字 - 带下划线	文本输入必须同时包含字母和数字，单词用下划线分隔。

Custom— 允许您选择字符串变量。例如，你可以让字符串变量作为正则表达式，然后在多个页面上使用该变量来保持验证不变。有关自定义验证方法的更多信息，请参阅文本输入脚本组件。

需要值

确定是否要求用户键入或选择一个值。默认值为 False，这意味着用户交互是可选的。

用户界面直观地指示用户输入是否为可选输入。

可选输入由组件下方的标签表示：

多行

默认情况下，文本输入框支持单行。当 Multiline 设置为 No（默认情况下）时，文本输入不会换行文本或垂直调整自身大小。

当 “多行” 设置为 “否” 时，您可以通过单击此图标清除以前键入的任何文本：

如果将 “多行” 设置为 “是”，则文本输入接受多行文本。

密码

要为密码配置输入组件，请将 “密码” 设置为 “是”。密码文本已隐藏。密码的默认设置为 “否”。

显示密码切换

要显示显示密码的开关，请将 “显示密码切换” 设置为 “是”。 “显示密码切换” 的默认设置为 “否”。

布局

宽度

使用权重来影响大小调整，将宽度配置为固定大小，根据需要增大以显示内容，或者相对于其他组件消耗尽可能多的空间。

設置	描述
	自动调整大小可将组件配置为根据其内容进行缩小或增长。例如，标签的宽度可能会随其包含的文本量而增大。
	拉伸允许组件相对于其他组件消耗尽可能多的空间，使用权重来影响大小调整。如果两个组件都设置为伸展，则默认情况下它们都被分配剩余空间的 50％。可以通过更改权重值来调整此比例。例如，如果将一个组件的权重设置为 200，将另一个组件的权重设置为 100，则第一个组件占用剩余空间的三分之二，而另一个组件只占三分之一。第一个组件的大小是另一个组件的两倍，因为它的重量是第二个组件权重的两倍。
	以像素为单位设置固定大小。您可以在框中键入整数值，或使用向上或向下箭头来增大或减小大小。当组件获得焦点时，这些箭头可见。

高度

使用权重来影响大小调整，将高度配置为固定大小，以便根据需要增大以显示内容，或者相对于其他组件消耗尽可能多的空间。

設置	描述
	自动调整大小可将组件配置为根据其内容进行缩小或增长。
	以像素为单位设置固定大小。您可以在框中键入整数值，或使用向上或向下箭头来增大或减小大小。当组件获得焦点时，这些箭头可见。
	拉伸允许组件相对于其他组件消耗尽可能多的空间，使用权重来影响大小调整。如果两个组件都设置为伸展，则默认情况下它们都被分配剩余空间的 50％。可以通过更改权重值来调整此比例。例如，如果将一个组件的权重设置为 200，将另一个组件的权重设置为 100，则第一个组件占用剩余空间的三分之二，而另一个组件只占三分之一。第一个组件的大小是另一个组件的两倍，因为它的重量是第二个组件权重的两倍。

对齐

将组件相对于其父容器向左、向右或居中对齐。

提示： 如果组件的父容器的 “高度” 设置为 “ 自动调整大小”，则组件不能垂直居中对齐。要更正此问题，请将父容器的高度设置为 拉伸 或设置为固定高度（以 像素为单位）。

設置	示例

边距

边距设置边框周围的左、右、上和下间距。

要有选择地一次更新所有边距值，请在属性面板中 按边距的全部 设置按钮。
单击保证金的值字段。旋转控件出现在该字段中。
使用旋转控制来增加或减少边距。如果选择 了 “全部 设置”，则更改将应用于所有边距。

该组件会立即使用其新的边距设置重新定位。

可见

根据布尔值（True 或 False）变量的值设置组件的可见性。

单击 “ 布局” 属性组。在可见下方，单击 选择变量。
选择一个变量，或者选择性地创建一个新的 “是/否” 变量，然后将该新变量分配给 Visible 属性。
在运行时，当变量的值为 True 时，组件是可见的。相反，当变量的值为 False 时，它会被隐藏。

高级

值

占位符