UI 요소 하나 찾기 (ui_element.find)

이 함수는 20260507 이후 버전에서 사용할 수 있습니다.

선언

요소, 오류 정보 = ui_element.find(선택자 [, 옵션 ])

매개변수

• 선택자 테이블. 찾을 UI 요소를 설명하며 선택자 필드 설명을 참조할 수 있습니다.
• 옵션 테이블, 선택 사항. 공통 옵션 설명을 참조하십시오.

반환값

• 요소 테이블. 첫 번째로 일치하는 UI 요소이며 실패하면 nil입니다.
• 오류 정보 문자열. 실패 원인입니다. 일치 항목이 없으면 일반적으로 "target not found"입니다.

설명

선택자에 index가 있으면 일치 결과에서 index 번째 요소를 반환합니다. title 또는 text_contains를 role과 함께 사용하여 위치를 지정하면 이름이 같은 요소로 인한 모호성을 줄일 수 있습니다.

예제

local ui_element = require("ui_element")

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

if item then
    ui_element.click(item)
else
    sys.toast(err)
end

참고: 위 코드에서는 이 장에서 설명하지 않는 함수인 sys.toast를 사용합니다.