メインコンテンツまでスキップ

UI スナップショットを取得する (ui_element.snapshot)

この関数は 20260507 以降のバージョンでのみ使用できます

宣言​

スナップショット, エラー情報 = ui_element.snapshot([ オプション ])

引数​

戻り値​

  • スナップショット テーブル型。現在の UI 要素一覧とスナップショットメソッドが含まれます。失敗した場合は nil です。
  • エラー情報 文字列型。失敗した理由です。

スナップショットメソッド​

要素 = スナップショット:find(セレクター)
要素リスト = スナップショット:find_all(セレクター)
状態, 情報 = スナップショット:click(セレクターまたは要素 [, オプション ])
状態, 情報 = スナップショット:scroll([ セレクターまたは要素, ] 方向 [, オプション ])
状態, 情報 = スナップショット:input_text(セレクターまたは要素, テキスト [, オプション ])
状態, 情報 = スナップショット:set_text(セレクターまたは要素, テキスト [, オプション ])
状態, 情報 = スナップショット:clear_text(セレクターまたは要素 [, オプション ])
状態, 情報 = スナップショット:toggle(セレクターまたは要素 [, オプション ])
状態, 情報 = スナップショット:set_checked(セレクターまたは要素, チェック状態 [, オプション ])
状態, 情報 = スナップショット:set_value(セレクターまたは要素, 値 [, オプション ])
状態, 情報 = スナップショット:increase(セレクターまたは要素 [, オプション ])
状態, 情報 = スナップショット:decrease(セレクターまたは要素 [, オプション ])

説明​

スナップショットは一時的な結果で、同じ画面内で検索や連続操作を繰り返す場合に適しています。 画面遷移、ポップアップ、スクロール、または内容の更新が発生した後は、snapshot() を再度呼び出してください。 スナップショットテーブルの一般的なフィールドには、elements と count があります。

使用例​

local ui_element = require("ui_element")

local ui, err = ui_element.snapshot({
    max_level = 2,
})

if ui then
    local search = ui:find({
        title = "搜索",
        role = "text_field",
    })
    if search then
        ui:set_text(search, "XXTouch")
    end
else
    sys.toast(err)
end

注記：上記のコードでは、この章で扱っていない関数 sys.toast を使用しています。