# 要素にフォーカス

ノードタイプ `browser_focusElement`

## 機能

選択した要素にキーボードフォーカスを移動します。

## デスクトップクライアントでの設定

![デスクトップクライアントでの「要素にフォーカス」の設定](/assets/focus-element.059f817c9aa22acb41216183ad5689f8c6a380e957a48dee3dd2954be0c34eb9.0538f3a9.webp)

MoreLogin デスクトップクライアント V2.73.101 の英語インターフェースで撮影しました。

## 入力

これらのフィールドは `data.browserUi.inputs` に置きます。

| フィールド | 型または値 | スキーマで必須 | 実行時の既定値 | 説明と制約 |
|  --- | --- | --- | --- | --- |
| `selectorType` | `"selector"` / `"element"` / `"frame"`（変数参照をサポート） | いいえ | `"selector"` | 要素の取得元。エディターの初期値：`"selector"` |
| `frame` | `string` | いいえ | — | iframe の変数 |
| `element` | `string` | いいえ | — | 要素の変数 |
| `selectorRadio` | `"CSS"` / `"XPath"`（変数参照をサポート） | いいえ | `"CSS"` | セレクターの種類。エディターの初期値：`"CSS"` |
| `selector` | `string` | いいえ | — | セレクター |
| `serialType` | `"fixed"` / `"randomInterval"`（変数参照をサポート） | いいえ | `"fixed"` | 複数の要素オブジェクトが一致した場合。エディターの初期値：`"fixed"` |
| `serial` | `WorkflowNumber` | いいえ | `1` | 要素のインデックス。整数、解決後の最小値：1。エディターの初期値：`1` |
| `serialMin` | `WorkflowNumber` | いいえ | — | 最小インデックス。整数、解決後の最小値：1 |
| `serialMax` | `WorkflowNumber` | いいえ | — | 最大インデックス。整数、解決後の最小値：1 |
| `postWaitMs` | `WorkflowNumber` | いいえ | `200` | 完了後の待機時間（ms）。解決後の最小値：0。エディターの初期値：`200` |


## モードごとの要件と制限

- **ロケーターのルール**：selectorType=selector では selector が必要です。frame では frame+selector、element では前のノードの ElementRef 参照が必要です。serial は 1 から始まります。randomInterval では serialMin/serialMax を使用し、最小値を最大値より大きくすることはできません。ノードはまず、セレクターが要素に一致するまで待機し、その後インデックスを 1 回だけ選択します。範囲の上限は、実際に一致した数に切り詰められます。固定のインデックスまたは範囲の下限が一致した数より大きい場合は、ただちに ELEMENT_NOT_FOUND（reason=range、details.field は serial または serialMin）が返され、ページは操作されません。
- 検証コード：`RPA_NODE_INPUT_INVALID`


## 入力の参照

| フィールド | 許可される形式 |
|  --- | --- |
| `selectorType` | `literal`, `template` |
| `frame` | `literal`, `template` |
| `element` | `literal`, `template` |
| `selectorRadio` | `literal`, `template` |
| `selector` | `literal`, `template` |
| `serialType` | `literal`, `template` |
| `serial` | `literal`, `numericExpression` |
| `serialMin` | `literal`, `numericExpression` |
| `serialMax` | `literal`, `numericExpression` |
| `postWaitMs` | `literal`, `numericExpression` |


## 出力

| 出力フィールド | 型または値 |
|  --- | --- |
| `tabId` | `string` |
| `element` | `ElementRef` |
| `isFocused` | `boolean` |


公開されているフィールドは、`${nodeId.data.field}` として参照します。

## JSON の例

ワークフローの `nodes` 配列、または別のノードの `blocks` に入れる完全なノードオブジェクトです。

```json
{
  "id": "focus_email",
  "type": "browser_focusElement",
  "data": {
    "title": "Focus the email field",
    "browserAction": "focusElement",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "input[name=email]",
        "postWaitMs": 200
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[ノードカタログに戻る](/ja/browser-rpa/nodes)