!	In order to access this site, you need to enable Javascript.

You are here: Reference > JavaScript > client-side > HTML DOM > objects > nodes and tags > input:range

input:range object

A A

Font size

Browser support:

Creates a slider control.

With the slider control the user can set a value by moving an indicator. The lowest and the highest values of the slider control can be set with the min and max properties. The step property defines the step size. The value of the control can be set with the value property.

This control is one of the form controls.

The contents of the control can be submitted to a server if the following conditions are met:

A form element must contain the slider control.
The action property of the container form must be set to the URL of the server.
The name property of the slider control must be specified and non-empty.

When the container form is submitted, the name and the value of the control are sent as a name/value pair.

You can access the value of the control with the value property. Sometimes it is useful to check the value before submitting. See the second example for details.

The base interface, through which you can add new functionalities to the slider control, is the HTMLInputElement interface.

Syntax:

Methods that return the object:

•	var inputObj = document.createElement ("input"); inputObj.type = "range"

The base interface, through which you can add new functionalities to the slider control, is the HTMLInputElement interface.

If you want to see the HTML objects by categories, please visit this page.

HTML page for this element: input:range

Possible members:

Properties

Methods

Events

Style properties

accessKey

Sets or retrieves an access key to an element.

attributes

Represents a collection of attribute nodes that belong to an element.

baseURI

Returns the base URL for the object.

className

Sets or retrieves the style class or classes that belong to the element.

clientHeight

Returns the height of the visible area for an object, in pixels. The value contains the height with the padding, but it does not include the scrollBar, border, and the margin.

clientLeft

Returns the width of the left border.

clientTop

Returns the height of the top border.

clientWidth

Returns the width of the visible area for an object, in pixels. The value contains the width with the padding, but does not include the scrollBar, border, and the margin.

contentEditable

Sets or retrieves whether the contents of the object are editable.

currentStyle

Represents the computed style settings for an element.

defaultValue

Specifies or returns the initial value of the object. The initial state can be set with the value attribute in HTML.

dir

Sets or retrieves the text direction as related to the lang property.

disabled

Sets or retrieves the state of an object for user interaction.

form

Returns a reference to the form element in which the object is placed.

forms

Represents a collection of all form elements in the current document.

hspace

Specifies or returns the number of pixels to use as a margin at the left and right sides of the object.

Sets or retrieves a unique identifier for the object.

isContentEditable

Returns a Boolean value that indicates whether the contents of the object are editable by the user.

lang

Specifies or returns the language of the element.

max

Sets or retrieves the maximum value of a range type input object (slider).

min

Sets or retrieves the minimum value of a range type input object (slider).

name

Sets or retrieves the name of a form control that affects the contents of the message submitted to the server.

nextElementSibling

Returns a reference to the next child element of the current element's parent.

nextSibling

Returns a reference to the next child of the current element's parent.

nodeName

Returns the name of the current node.

nodeType

Returns an integer that indicates the type of the node.

nodeValue

Sets or returns the value of the current node.

offsetHeight

Returns the height of the visible area for an object, in pixels. The value contains the height with the padding, scrollBar, and the border, but does not include the margin.

offsetLeft

Returns the left position of an object relative to the left side of its offsetParent element, in pixels.

offsetParent

Returns a reference to the closest ancestor element in the DOM hierarchy from which the position of the current element is calculated.

offsetTop

Returns the top position of the object relative to the top side of its offsetParent element, in pixels.

offsetWidth

Returns the width of the visible area for an object, in pixels. The value contains the width with the padding, scrollBar, and the border, but does not include the margin.

outerHTML

Sets or retrieves the HTML content (the source code including the start and end tags) of the current element.

outerText

Sets or returns a string that represents the text content of an element.

ownerDocument

Returns the document object that contains the current element.

parentElement

Returns the parent element of the object in the DOM hierarchy.

parentNode

Returns the parent element of the object in the DOM hierarchy.

previousElementSibling

Returns a reference to the previous child element of the current element's parent.

previousSibling

Returns a reference to the previous node of the current element's parent.

readOnly

Sets or retrieves whether the contents of the element are changeable.

scrollHeight

Returns the total height of an element's contents, in pixels. The value contains the height with the padding, but does not include the scrollBar, border, and the margin.

scrollLeft

Sets or retrieves the number of pixels by which the contents of an object are scrolled to the left.

scrollTop

Sets or retrieves the number of pixels by which the contents of an object are scrolled upward.

scrollWidth

Returns the total width of an element's contents, in pixels. The value contains the width with the padding, but does not include the scrollBar, border, and the margin.

size

Specifies or returns the width of a control, in characters.

sourceIndex

Returns the position of the current object in the all collection of the document.

step

Sets the discrete step size of the input:range element.

style

Represents the inline style settings for an element.

tabIndex

Specifies or returns the tabbing order for keyboard navigation using the TAB key.

tagName

Returns the tag name of the current element.

title

Specifies or returns a ToolTip for an object.

type

Sets or retrieves the type of the input element.

value

Specifies or returns the value of the control.

vspace

Specifies or returns the number of pixels to use as a margin at the top and bottom sides of an object.

addEventListener

Registers an event handler function (event listener) for the specified event on the current object.

attachEvent

Registers an event handler function (event listener) for the specified event on the current object.

blur

Removes the focus from the current element, and fires the onblur event.

click

Simulates a mouse click on the current element.

cloneNode

Returns an exact copy of the current node.

compareDocumentPosition

Compares the placement of the specified node with the current node in the DOM hierarchy.

detachEvent

Removes the specified event handler from the current element that was registered earlier with the attachEvent method.

dispatchEvent

Dispatches the specified event to the current element.

focus

Sets the focus on the current element.

getAttribute

Returns the value of the attribute with the specified name from the current element.

getAttributeNode

Returns the attribute node with the specified name from the current element.

getAttributeNodeNS

Returns the attribute node with the specified namespace and name from the current element.

getAttributeNS

Returns the value of the attribute with the specified namespace and name from the current element.

getBoundingClientRect

Returns a TextRectangle object that specifies the bounding rectangle of the current element or TextRange object, in pixels, relative to the upper-left corner of the browser's client area.

getClientRects

Retrieves a TextRectangles collection that specifies the exact shape of the current element or TextRange object.

hasAttribute

Returns whether the current element has an attribute with the specified name or not.

hasAttributeNS

Returns whether the current element has an attribute with the specified namespace and name or not.

hasAttributes

Returns whether the current element has any attributes specified or not.

hasChildNodes

Returns whether the current node has any child nodes or not.

insertAdjacentElement

Inserts an element at the specified position relative to the current element.

insertAdjacentHTML

Inserts a HTML formatted text at the specified position relative to the current element.

insertAdjacentText

Creates a new TextNode from the specified text and inserts it at the specified position relative to the current element.

isEqualNode

Returns whether the current node is equal to the specified one.

isSameNode

Returns whether the current node is the same node as the specified one.

isSupported

Returns whether the specified DOM module and version is supported by the current node.

normalize

Puts the subtree that belongs to the current node into a 'normalized' form.

removeAttribute

Removes the attribute with the specified name from the current element.

removeAttributeNode

Removes the specified attribute node from the current element.

removeAttributeNS

Removes the attribute with the specified namespace and name from the current element.

removeEventListener

Removes the specified event handler from the current element that was registered earlier with the addEventListener method.

removeNode

Removes the current element with or without its children from the document tree.

scrollIntoView

Scrolls the specified element into the visible area of the document.

select

Highlights the entire text in the element.

setAttribute

Adds an attribute with the specified name and value to the current element.

setAttributeNode

Adds the specified attribute node to the current element.

setAttributeNodeNS

Adds the specified attribute node to the current element.

setAttributeNS

Adds an attribute with the specified namespace, name and value to the current element.

onbeforecut

Occurs before the selection is cut from the document and provides a possibility to enable the Cut menu item.

onbeforepaste

Occurs before the contents of the clipboard are pasted into the document and provides a possibility to enable the Paste menu item.

onblur

Occurs when an element loses focus.

onchange

Occurs when the selection, the checked state or the contents of an element have changed. In some cases, it only occurs when the element loses the focus.

onclick

Occurs when the user clicks on an element.

oncontextmenu

Occurs when the right mouse button is clicked on an element and the context menu is shown.

oncopy

Occurs before the selection is copied to the clipboard.

oncut

Occurs before the selection is cut from the document and added to the clipboard.

ondblclick

Occurs when the user double clicks on an element.

ondrag

Occurs periodically on the source element during the drag operation.

ondragend

Occurs on the source element when the user has finished the drag operation.

ondragenter

Occurs on an element when the user moves the mouse pointer into it during a drag operation.

ondragleave

Occurs on an element when the user moves the mouse pointer out of it during a drag operation.

ondragover

Occurs periodically on an element while the mouse pointer is over it during a drag operation.

ondragstart

Occurs on the source element when the user starts the drag operation.

ondrop

Occurs on a possible target element when the dragged data is dropped on it.

onfocus

Occurs when an element receives focus.

oninput

Occurs when the text content of an element is changed through the user interface.

onkeydown

Occurs on an element that has the focus when a key is pressed down and occurs periodically until the key is released.

onkeypress

Occurs on an element that has the focus when a key is pressed down and occurs periodically until the key is released.

onkeyup

Occurs on an element that has the focus when the user releases a key.

onmousedown

Occurs when the user presses a mouse button over an element.

onmousemove

Occurs when the user moves the mouse over the element.

onmouseout

Occurs when the user moves the mouse pointer out of the element.

onmouseover

Occurs when the user moves the mouse pointer into the element.

onmouseup

Occurs when the user releases a mouse button over an element.

onmousewheel

Occurs when the mouse wheel rolls.

onpaste

Occurs before the contents of the clipboard are pasted into the document.

onselectstart

Occurs at the start of a selection process.

background

Specifies or returns up to five separate background properties, in a shorthand form.

backgroundAttachment

Specifies or returns whether the backgroundImage should scroll with the contents of the object or not.

backgroundColor

Specifies or returns the color to use for the background of the object.

backgroundImage

Specifies or returns the image to use as the background of the object.

backgroundPosition

Sets or retrieves the position of the backgroundImage within the element.

backgroundPositionX

Specifies or returns the horizontal coordinate of the backgroundImage relative to the upper-left corner of the container object.

backgroundPositionY

Specifies or returns the vertical-coordinate of the backgroundImage relative to the upper-left corner of the container object.

backgroundRepeat

Specifies or returns how to tile the backgroundImage relative to the upper-left corner of the container object.

border

Sets or retrieves up to three separate border properties, in a shorthand form.

borderBottom

Sets or retrieves the color, style and width properties for the element's bottom border, in a shorthand form.

borderBottomColor

Specifies or returns the color of the element's bottom border.

borderBottomStyle

Specifies or returns the style of the element's bottom border.

borderBottomWidth

Specifies or returns the width of the element's bottom border.

borderColor

Specifies or returns the color of the element's border.

borderLeft

Specifies or returns the color, style and width properties for the element's left border, in a shorthand form.

borderLeftColor

Specifies or returns the color of the element's left border.

borderLeftStyle

Specifies or returns the style of the element's left border.

borderLeftWidth

Specifies or returns the width of the element's left border.

borderRight

Specifies or returns the color, style and width properties for the element's right border, in a shorthand form.

borderRightColor

Specifies or returns the color of the element's right border.

borderRightStyle

Specifies or returns the style of the element's right border.

borderRightWidth

Specifies or returns the width of the element's right border.

borderStyle

Specifies or returns the style of the element's border.

borderTop

Specifies or returns the color, style and width properties for the element's top border, in a shorthand form.

borderTopColor

Specifies or returns the color of the element's top border.

borderTopStyle

Specifies or returns the style of the element's top border.

borderTopWidth

Specifies or returns the width of the element's top border.

borderWidth

Specifies or returns the width of the element's border.

bottom

Specifies or returns the bottom coordinate of a positioned element.

clip

Specifies or returns which part of a positioned element is visible.

color

Specifies or returns the color of the element's text content.

cssFloat

Specifies or returns the horizontal alignment of the object.

cssText

Sets or retrieves the contents of a style declaration as a string.

cursor

Specifies or returns the type of cursor to display for the pointing device (mouse).

direction

Specifies or returns the text direction.

display

Specifies or returns the element's display type.

height

Specifies or returns the height of the visible area for an element.

left

Specifies or returns the left coordinate of a positioned element.

length

Returns the number of properties that have been set in the current style object.

margin

Specifies or returns a shorthand property for setting the top, right, bottom and left margins, in that order.

marginBottom

Specifies or returns the bottom margin of the object.

marginLeft

Specifies or returns the left margin of the object.

marginRight

Specifies or returns the right margin of the object.

marginTop

Specifies or returns the top margin of the object.

OBackgroundSize

Sets or retrieves the size of the background image.

opacity

Sets or retrieves the transparency level of an element. For Internet Explorer, use filter with 'Alpha(opacity=percent)'.

outline

Specifies or returns a shorthand form for all outline properties at once. Outline is a line around an element, but different from the border property.

outlineColor

Specifies or returns the color for the outline for an element.

outlineOffset

Sets or retrieves the amount of space between the outline and the border or the edge of the element.

outlineStyle

Specifies or returns the style for an element's outline.

outlineWidth

Specifies or returns the width for an element's outline.

padding

Specifies or returns a shorthand property for setting the top, right, bottom and left spaces between an element's border and its contents, in that order.

paddingBottom

Specifies or returns the space between an element's bottom border and its contents.

paddingLeft

Specifies or returns the space between an element's left border and its contents.

paddingRight

Specifies or returns the space between an element's right border and its contents.

paddingTop

Specifies or returns the space between an element's top border and its contents.

pixelBottom

Specifies or retrieves the value of the bottom style property, in pixels.

pixelHeight

Specifies or retrieves the value of the height style property, in pixels.

pixelLeft

Specifies or retrieves the value of the left style property, in pixels.

pixelRight

Specifies or retrieves the value of the right style property, in pixels.

pixelTop

Specifies or retrieves the value of the top style property, in pixels.

pixelWidth

Specifies or retrieves the value of the width style property, in pixels.

posBottom

Specifies or retrieves the value of the bottom style property as a floating-point number that specifies the value in the current unit type of the bottom property.

posHeight

Specifies or retrieves the value of the height style property as a floating-point number that specifies the value in the current unit type of the height property.

position

Specifies or returns what type of positioning method is used to render the current element.

posLeft

Specifies or retrieves the value of the left style property as a floating-point number that specifies the value in the current unit type of the left property.

posRight

Specifies or retrieves the value of the right style property as a floating-point number that specifies the value in the current unit type of the right property.

posTop

Specifies or retrieves the value of the top style property as a floating-point number that specifies the value in the current unit type of the top property.

posWidth

Specifies or retrieves the value of the width style property as a floating-point number that specifies the value in the current unit type of the width property.

right

Specifies or returns the right coordinate of a positioned element.

styleFloat

Specifies or returns the horizontal alignment of the object.

top

Specifies or returns the top coordinate of a positioned element.

unicodeBidi

Specifies or returns whether the text should be overridden to support multiple languages in the same document. Use with the direction property.

visibility

Specifies or returns whether the element is visible.

webkitAppearance

Specifies or retrieves theme rendering mode for an element. Allows you to make an element look like a standard user interface element.

webkitBackgroundClip

Sets or retrieves which part of background is visible.

webkitBackgroundComposite

Sets or retrieves whether the background extends into the border or padding area or not.

webkitBackgroundOrigin

Specifies or retrieves how the backgroundPosition property is determined, ergo it defines the reference point that the backgroundImage is relative to.

webkitBackgroundSize

Sets or retrieves the size of the background image.

webkitBorderBottomLeftRadius

Sets or retrieves the rounding of the lower left corner of the border.

webkitBorderBottomRightRadius

Sets or retrieves the rounding of the lower right corner of the border.

webkitBorderHorizontalSpacing

Specifies or returns the amount of horizontal space between cells in a table.

webkitBorderImage

Specifies or retrieves an image to use as the border of the element. The image is sliced into 9 pieces along the four diagonals specified with the length units.

webkitBorderRadius

Sets or retrieves the rounding of the corners of the border.

webkitBorderTopLeftRadius

Sets or retrieves the rounding of the upper left corner of the border.

webkitBorderTopRightRadius

Sets or retrieves the rounding of the upper right corner of the border.

webkitBorderVerticalSpacing

Specifies or returns the amount of vertical space between cells in a table.

webkitMarginBottomCollapse

Specifies or retrieves whether the top and bottom margins can be shared between adjacent elements.

webkitMarginCollapse

Specifies or retrieves whether the top and bottom margins can be shared between adjacent elements.

webkitMarginEnd

Specifies or retrieves the width of the left or the right margin, depends on the writing direction.

webkitMarginStart

Specifies or retrieves the width of the left or the right margin, depends on the writing direction.

webkitMarginTopCollapse

Specifies or retrieves whether the top and bottom margins can be shared between adjacent elements.

webkitPaddingEnd

Specifies or returns the space between an element's left or right border and its contents, depends on the writing direction.

webkitPaddingStart

Specifies or returns the space between an element's left or right border and its contents, depends on the writing direction.

webkitTransform

Specifies or returns the two-dimensional linear transformation applied to an element. The origin of the transformation is specified by the MozTransformOrigin property.

webkitTransformOrigin

Specifies or returns the origin of the two-dimensional linear transformations specified with the MozTransform property.

width

Specifies or returns the width of the visible area for an element.

zIndex

Specifies or returns the stack level of positioned objects.

Example HTML code 1:

This example illustrates the use of the slider control:

<form method="post" action="#URL#">
    Username: <input type="text" name="userName" />
    <br /><br />
    Your bet: <input type="range" name="bet" min="20" max="200" step="20" value="40" />
    <br /><br />
    <input type="submit" value="Send" />
</form>

Copy Code

Preview

Syntax Highlighter

Did you find this example helpful? yes no

Example HTML code 2:

This example checks the value of the slider control before submitting the form:

<head>
    <script>
        function CheckAndSubmit () {
            var betForm = document.getElementById ("betForm");
            var betSlider = document.getElementById ("betSlider");

            if (betSlider.value == 200) {
                var bet = confirm ("Are you sure you want to bet the maximum?");
                if (!bet)
                    return;
            }

            betForm.submit ();
        }
    </script>
</head>
<body>
    <form id="betForm" method="post" action="#URL#">
        Username: <input type="text" name="userName" />
        <br />
        Your bet: <input type="range" name="bet" id="betSlider" min="20" max="200" step="20" value="200" />
        <br /><br />
        <input type="button" value="Send" onclick="CheckAndSubmit ()" />
    </form>
</body>