텍스트 요소 모듈 (ui_element)

이 모듈은 20260507 이후 버전에서 사용할 수 있습니다.

ui_element는 텍스트, 역할, 상태 또는 좌표를 기준으로 현재 화면의 UI 요소를 읽고, 일치하는 요소에 클릭, 스크롤, 입력, 전환, 조절 등의 작업을 수행합니다. 스크립트에서 화면 구조를 파악하거나 하드 코딩된 좌표를 줄여야 할 때, 또는 해상도가 다른 기기에서도 읽기 쉬운 위치 지정 로직을 유지해야 할 때 적합합니다.

고정 좌표 터치에는 계속 터치 시뮬레이션 모듈(touch)을 사용하는 것이 좋습니다. ui_element에 나오는 좌표는 모두 물리 픽셀 단위입니다.

기본 사용법

local ui_element = require("ui_element")

local item, err = ui_element.find({
    title = "搜索",
    role = "text_field",
})

if item then
    ui_element.input_text(item, "hello")
else
    sys.toast(err)
end

설명

조회 인터페이스는 실패할 때 일반적으로 nil, err를 반환합니다. find_all은 일치 항목이 없으면 빈 배열을 반환합니다. 동작 인터페이스는 성공하면 true, info, 실패하면 nil, err를 반환합니다. 화면이 바뀌면 이전에 가져온 스냅샷은 더 이상 최신 화면을 나타내지 않으므로 snapshot()을 다시 호출해야 합니다.

기본 사용법​

설명​

기본 사용법

설명