単一の 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 を使用しています。