要素フィールドの説明

このモジュールは 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 などの意味的なフィールドを優先してセレクターを構成してください。 画面が変化した後は、要素を再検索するか、スナップショットを再取得してください。