W3cubDocs

/Web APIs

HTMLInputElement: value property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

The value property of the HTMLInputElement interface represents the current value of the <input> element as a string.

This property can also be set directly, for example to set a default value based on some condition.

Value

A string specifying the default value of the <input> element.

Examples

>

Retrieving a text input's value

In this example, the log displays the current value as the user enters data into the input.

HTML

We include an <input> and an associated <label>, with a <pre> container for our output.

<label for="given-name">Your name:</label>

<input name="given-name" id="given-name" />

<pre id="log"></pre>

JavaScript

The <pre> element's innerText is updated to the current value of the <input> every time a keyup event is fired.

const logElement = document.getElementById("log");
const inputElement = document.getElementById("given-name");

inputElement.addEventListener("keyup", () => {
  logElement.innerText = `Name: ${inputElement.value}`;
});

Results

Retrieving a color value

This example demonstrates that the value property with an <input> of type color.

HTML

We include an <input> of type color:

<label for="color">Pick a color:</label>

<input name="color" id="color" type="color" />

<pre id="log"></pre>

JavaScript

The <pre> element's innerText is updated with the default color value (#000000) and then updated every time a change event is fired.

const logElement = document.getElementById("log");
const inputElement = document.getElementById("color");

logElement.innerText = `Color: ${inputElement.value}`;

inputElement.addEventListener("change", () => {
  logElement.innerText = `Color: ${inputElement.value}`;
});

Results

Specifications

Specification
HTML>
# dom-input-value>

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
value 1 12 1 ≤12.1 1 18 4 ≤12.1 1 1.0 4.4 1

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/value