跳到主要内容

追加输入文本 (ui_element.input_text)

该函数在 20260507 以后版本方可使用

声明​

状态, 信息或错误信息 = ui_element.input_text(选择器或元素, 文本 [, 选项 ])

参数​

  • 选择器或元素
    表型，可以是 选择器、查询返回的元素，或 { x = 横坐标, y = 纵坐标 } 坐标表。
  • 文本
    文本型，要追加输入的内容。
  • 选项
    可选参数，表型，可参考 通用选项说明。

返回值​

  • 状态
    布尔型，成功时为 true，失败时为 nil。
  • 信息或错误信息
    成功时为表型动作信息，失败时为文本型错误原因。

说明​

该接口会先定位文本输入目标，再追加输入文本。 如果需要替换原有文本，使用 set_text。

示例​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.input_text({
    title = "搜索",
    role = "text_field",
}, "XXTouch")

if not ok then
    sys.toast(info_or_err)
end

注：上述代码中使用了非本章函数 sys.toast