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

セレクターフィールドの説明

このモジュールは 20260507 以降のバージョンでのみ使用できます

セレクターは、検索または操作する UI 要素を記述する Lua テーブルです。可読テキストとロールを組み合わせた要素特定を優先し、必要な場合に index を追加して同名の要素を区別することを推奨します。

例​

local selector = {
    title = "搜索",
    role = "text_field",
}

local item = ui_element.find(selector)

フィールド​

  • title / text 文字列型。要素の可読タイトルと一致させます。どちらも同じ意味です。
  • text_contains 文字列型。可読タイトルに含まれる部分文字列と一致させます。
  • value 文字列型、数値型、またはブール型。要素の現在値と一致させます。
  • value_contains 文字列型。要素の値に含まれる部分文字列と一致させます。
  • identifier 文字列型。要素の識別子と一致させます。すべての App で提供されるわけではありません。
  • bundle_id 文字列型。要素が属する App の bundle identifier と一致させます。
  • role 文字列型。要素の種類と一致させます。一般的な値には button、text_field、static_text、switch、checkbox、radio、slider、picker、scrollable、link、image、keyboard_key があります。
  • traits 文字列型または文字列の配列。Button、StaticText、Toggle、Adjustable などの要素特性名と一致させます。
  • visible ブール型。要素が表示されているかどうかと一致させます。
  • hittable ブール型。要素が現在ヒット可能かどうかと一致させます。アクション系 API では通常、対象がヒット可能である必要があります。
  • checked ブール型。スイッチ、チェックボックス、ラジオ項目などのチェック状態と一致させます。
  • selected ブール型。要素が選択状態かどうかと一致させます。
  • index 整数型。複数の一致項目がある場合に何番目を取得するかを指定します。Lua の慣例に従い 1 から始まります。

説明​

座標、サイズ、ウィンドウ識別子など、変化しやすいフィールドを主要なセレクターとして使用することは推奨しません。 複数の要素が同時に一致し、index が指定されていない場合、アクション系 API は nil, "ambiguous target" を返すことがあります。 App や iOS のバージョンによって公開されるフィールドが異なる場合があるため、重要なフィールドが欠けている場合に備えた処理を用意してください。