要素フィールドの説明

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

クエリ API が返す要素は通常の Lua テーブルです。フィールドは現在の画面で公開されている情報に基づくため、App やコントロールの種類によって返されるフィールドが異なる場合があります。

一般的なフィールド

• text
  文字列型。要素の可読タイトルです。
• value
  任意の型。要素の現在値です。テキストフィールドでは通常、現在のテキスト、スイッチでは 0 または 1、スライダーではパーセント表記のテキストになる場合があります。
• identifier
  文字列型。要素の識別子です。
• hint
  文字列型。システムの補助ヒントです。
• bundleId
  文字列型。要素が属する App の bundle identifier です。
• x / y / width / height
  整数型。要素の領域を物理ピクセル単位で表します。
• centerPoint
  テーブル型。要素の中心点を物理ピクセル単位で表します。例：{ x = 100, y = 200 }。
• children
  テーブル型。子要素の配列です。展開する深さは max_level で制御します。
• traits
  整数型。要素の特性値です。
• traitsDescription
  テーブル型。要素の特性名を格納した配列です。例：Button、StaticText、Toggle、Adjustable。
• isVisible
  ブール型。要素が表示されているかどうかを示します。
• isSelected
  ブール型。要素が選択されているかどうかを示します。
• isToggle
  ブール型。要素がスイッチのようなコントロールかどうかを示します。
• isAdjustable
  ブール型。要素が値の増減調整に対応しているかどうかを示します。
• checked
  ブール型。スイッチ、チェックボックス、ラジオ項目などのコントロールのチェック状態です。信頼できる状態を取得できない場合は存在しないことがあります。
• hasTextEntry
  ブール型。要素がテキスト入力対象のように振る舞うかどうかを示します。
• isKeyboardKey
  ブール型。要素がキーボードキーのように振る舞うかどうかを示します。
• absoluteValue
  実数型。スライダーなどの調整可能なコントロールが返すことのある正規化された値です。

ヒット状態フィールド

これらのフィールドは、include_hit_state、hit_test、fallback_hit_test を有効にした場合、またはアクション実行時の再検証を行った場合にのみ現れることがあります。

• canHit
  ブール型。現在トップレベルからヒットできるかどうかを示します。
• hitVerified
  ブール型。ヒット状態が検証済みかどうかを示します。
• hitTestPoint
  テーブル型。ヒット位置を物理ピクセル単位で表します。

説明

要素フィールドは、現在の画面状態の取得や判定に適しています。 安定した要素特定が必要な場合は、text、role、checked、selected などの意味的なフィールドを優先してセレクターを構成してください。 画面が変化した後は、要素を再検索するか、スナップショットを再取得してください。