/
index.md
56 lines (38 loc) · 2.05 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
---
title: "ElementInternals: setFormValue() メソッド"
short-title: setFormValue()
slug: Web/API/ElementInternals/setFormValue
l10n:
sourceCommit: 86215eff9beccf2e069be9109347ad830cc5e9c4
---
{{APIRef("DOM")}}
**`setFormValue()`** は {{domxref("ElementInternals")}} インターフェイスのメソッドで、このメソッドは、要素の送信値と状態を設定し、これらをユーザーエージェントに伝えます。
## 構文
```js-nolint
setFormValue(value)
setFormValue(value, state)
```
### 引数
- `value`
- : サーバに送信する値として、{{domxref("File")}}、文字列、{{domxref("FormData")}} のいずれかを指定します。
- `state` {{optional_inline}}
- : {{domxref("File")}}、文字列、{{domxref("FormData")}} のいずれかで、ユーザーの入力を表します。
これにより、アプリケーションは必要に応じて、ユーザーが送信した情報を、ユーザーが入力した形式で再表示することができます。
> **メモ:** 一般的に、 `state` はユーザがー指定した情報を渡すために、 `value` はサニタイズ後、サーバーに送信するのに適した情報を渡すために使用されます。
> たとえば、カスタム要素で日付の入力を求められた場合、ユーザーは「3/15/2019」と入力するかもしれません。
> これは `state` です。
> サーバーは `2019-03-15` という日付書式を期待しているので、この書式の日付が `value` として渡されます。
### 返値
undefined です。
### 例外
- `NotSupportedError` {{domxref("DOMException")}}
- : 要素の `formAssociated` プロパティが `true` に設定されていない場合に発生します。
## 例
次の例では、チェックボックスのカスタム要素で、サーバーに送信する値として `on` を、状態として `checked` を設定しています。
```js
this.internals_.setFormValue("on", "checked");
```
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}