跳到主要内容

用户输入

请用户输入内容。

当前模块定义

sys:userInput基础Action
标准模块
输入 17 · 输出 5 · 枚举 3

输入参数

  • 类型typeEnum必填

    输入内容的类型

    填写 固定输入默认 text
    4 个选项单行文本、多行文本、数字
    单行文本默认text
    多行文本multiline
    数字number
    日期时间date_time
  • 提示文字promptText必填

    提示用户输入什么内容。显示在输入框上方。

    填写 输入或变量默认 请输入内容
  • 默认值defaultValueText可选

    默认填写到输入框中的内容

    填写 输入或变量
  • 文本选择工具texttoolsText可选

    鼠标悬浮在文本框上时显示的小工具

    填写 输入或变量条件 仅:text, multiline
  • 扩展设置extraSettingsText可选

    可用于自定义文本选择工具,详情请参考文档。

    填写 输入或变量条件 仅:text, multiline
  • 验证表达式patternText可选

    正则验证表达式

    填写 固定输入条件 仅:text, multiline, number
  • 必填isRequiredBoolean可选

    是否必须填写内容

    填写 固定输入默认 false
  • 窗口位置winLocationEnum可选

    在哪里显示选择窗口

    填写 输入或变量默认 CenterScreen
    11 个选项跟随鼠标(指针周围)、跟随鼠标(指针右下)、屏幕中间
    跟随鼠标(指针周围)WithMouse1
    跟随鼠标(指针右下)WithMouse2
    屏幕中间默认CenterScreen
    屏幕左上TopLeft
    屏幕中上TopCenter
    屏幕右上TopRight
    屏幕左中LeftCenter
    屏幕右中RightCenter
    屏幕左下BottomLeft
    屏幕中下BottomCenter
    屏幕右下BottomRight
  • 恢复活动窗口restoreFocusBoolean可选

    用户输入后,是否将焦点还原到之前的活动窗口

    填写 固定输入默认 true
  • 失去焦点后关闭窗口closeOnDeactivatedBoolean可选
    填写 固定输入默认 false
  • 回车提交结果(Shift+回车换行)submitWithReturnBoolean可选
    填写 固定输入条件 仅:multiline默认 false
  • 字体名称fontfamilyText可选

    可选。设置字体名称。如有2个字体,使用逗号分隔。

    填写 输入或变量条件 仅:text, multiline, number
  • 字体大小fontsizeNumber必填
    填写 输入或变量条件 仅:text, multiline, number默认 14.0
  • 输入法状态imeStateEnum可选
    填写 固定输入条件 仅:text, multiline默认 NO_CONTROL
    不控制默认NO_CONTROL
    开启ON
    关闭OFF
  • 帮助按钮内容helpText可选

    点击弹出显示帮助内容,MarkDown格式

    填写 固定输入
  • 置顶显示topMostBoolean可选
    填写 固定输入默认 false
  • 失败后停止stopIfFailBoolean可选

    用户取消后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 文本值textValueText

    文本类型的输入值

  • 数字值numberValueNumber

    数字类型的输入值

    条件 仅:number
  • 日期时间值datetimeValueDateTime
    条件 仅:date_time
  • 是否为空isEmptyBoolean

    用户是否没有输入内容

概述

显示一个文本输入窗口,获取用户输入的内容。

注:

  • 用户输入模块仅能用于输入一个信息,如果需要同时输入多个内容,以及使用其它类型的输入方式(如下拉选择等),请使用《多字段表单》模块。

参数

步骤参数示意(只读):

用户输入

请用户输入内容。
类型
输入内容的类型
提示文字
请选择程序路径
提示用户输入什么内容。显示在输入框上方。
默认值
d:\test.exe
默认填写到输入框中的内容
文本选择工具
 
鼠标悬浮在文本框上时显示的小工具
扩展设置
 
可用于自定义文本选择工具,详情请参考文档。
验证表达式
 
正则验证表达式
窗口位置
在哪里显示选择窗口
字体名称
 
可选。设置字体名称。如有2个字体,使用逗号分隔。
字体大小
14
输入法状态
帮助按钮内容
 
点击弹出显示帮助内容,MarkDown格式
是否成功
-- 选择变量 --
操作是否成功
文本值
text
文本类型的输入值
是否为空
-- 选择变量 --
用户是否没有输入内容
步骤注释
 

输入参数

类型:输入内容的类型及输入方式。可选值:单行文本、多行文本、数字、日期时间。

提示文字:向用户显示的提示信息。

默认值:预先填写到输入框里的内容。

验证表达式:如果对输入的内容有格式要求,可以使用正则表达式进行验证。

必填:是否必须填写内容后才能保存。

恢复活动窗口:由于用户输入窗口会抢占输入焦点,如果希望在此窗口关闭后对原有软件窗口进行操作,可以选择此项以将输入焦点恢复到弹窗之前的窗口上。

失去焦点后关闭窗口:弹出输入窗口后,如果用户鼠标点击了窗口以外的地方,则自动关闭此窗口取消当前操作。

失败后停止:取消输入后,是否停止动作。

文本选择工具:在输入框右侧显示的工具按钮(鼠标悬浮在输入框上时显示),点击之后可以用于选择文件、进程路径等内容。

字体名称:输入框字体类型;

字体大小:输入框字体大小;

窗口位置:输入框的显示位置。

输入法状态:设置是否主动开启和关闭中文输入状态;

帮助按钮内容:Markdown格式的帮助内容,点击“帮助”按钮时显示。提示:

输出

是否成功:是否成功获得了用户输入。

文本值:输入的文字内容(文本格式)。

数字值:输入的数字,用于输出到数字类型变量中。仅适用于类型为“数字”时。

是否为空:用户是否没有输入任何内容。

更新历史

  • 1.1.0,增加“必填”选项。如果为非必填,允许空值的时候保存。
  • 20241029 增加帮助按钮Markdown扩展语法文档链接。

示例动作

更新于