diff --git a/files/ja/web/api/htmlinputelement/value/index.md b/files/ja/web/api/htmlinputelement/value/index.md new file mode 100644 index 00000000000000..d8e9464991a6fd --- /dev/null +++ b/files/ja/web/api/htmlinputelement/value/index.md @@ -0,0 +1,117 @@ +--- +title: "HTMLInputElement: value プロパティ" +short-title: value +slug: Web/API/HTMLInputElement/value +l10n: + sourceCommit: d47348199a379f68bea876a403eb510628ec4ccb +--- + +{{ APIRef("HTML DOM") }} + +**`value`** は {{DOMxRef("HTMLInputElement")}} インターフェイスのプロパティで、この {{htmlelement("input")}} 要素の現在の値を文字列で表します。 + +このプロパティは、直接設定することもできます。例えば、何らかの条件に基づいて既定値を指定する場合などです。 + +## 値 + +この {{htmlelement("input")}} 要素の値を含む文字列、または入力要素に値が設定されていない場合は空文字列です。 + +## 例 + +### text 型の input の値を受け取る + +この例では、ユーザーが入力フィールドにデータを入力すると、ログに現在の値を表示します。 + +#### HTML + +{{htmlelement("input")}} と関連づけられた {{htmlelement("label")}}、それと出力用に {{htmlelement("pre")}} コンテナーを設置しています。 + +```html + + + + +
+``` + +#### JavaScript + +`` 要素の {{domxref("HTMLElement.innerText", "innerText")}} は、{{domxref("Element/keyup_event", "keyup")}} イベントが発行されるたびに `` の現在の値に更新されます。 + +```js +const logElement = document.getElementById("log"); +const inputElement = document.getElementById("given-name"); + +inputElement.addEventListener("keyup", () => { + logElement.innerText = `名前: ${inputElement.value}`; +}); +``` + +```css hidden +#log { + height: 20px; + padding: 0.5rem; + background-color: #ededed; +} +``` + +#### 結果 + +{{EmbedLiveSample("Retrieving a text input's value", "", 100)}} + +### 色の値を受け取る + +この例では、`` の {{HTMLElement("input/color", "color")}} の `value` プロパティを示します。 + +#### HTML + +`` の `color` 型を設置します。 + +```html + + + + + +``` + +#### JavaScript + +`` 要素の {{domxref("HTMLElement.innerText", "innerText")}} は、既定の色値 (`#000000`) で更新され、 {{domxref("HTMLElement/change_event", "change")}} イベントが発行されるたびに更新されます。 + +```js +const logElement = document.getElementById("log"); +const inputElement = document.getElementById("color"); + +logElement.innerText = `Color: ${inputElement.value}`; + +inputElement.addEventListener("change", () => { + logElement.innerText = `Color: ${inputElement.value}`; +}); +``` + +```css hidden +#log { + height: 20px; + padding: 0.5rem; + background-color: #ededed; +} +``` + +#### 結果 + +{{EmbedLiveSample("Retrieving a color value", "", 100)}} + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- {{HTMLElement("input")}} +- {{DOMXref("HTMLInputElement.valueAsDate")}} +- {{DOMXref("HTMLInputElement.valueAsNumber")}}