Skip to content

Component library

Stepper component

Last updated 2 November 2026

Defines an input field where user can enter data or use the -, + buttons to update the value.

Live demo

<ins-input-stepper
  value="50"
  step="10"
  min="10"
  max="100"
  tooltip="This is a sample tooltip content. It also support html content.">
</ins-input-stepper>

Attributes

FIELD ATTRIBUTE TYPE DEFAULT OPTIONS DESCRIPTION
value number 0 any Defines value of input field
label string "" any Defines label of input field
name string "" any Defines name of input field
min string "" any Defines min attribute value of the input field (for field type number)
max string "" any Defines max attribute value of the input field (for field type number)
step string "" any Defines increment value of the input field (for field type number)
required boolean false true, false Specifies that the input field must be filled out before submitting the form
disabled boolean false true, false Disables input field
readonly boolean false true, false Specifies that the input field is read-only
has-error boolean false true, false Specifies validation or mandatory input for the input field
error-message string "" any Defines the error message when input element is wrong
tooltip string "" - Displays a tooltip beside the label. Supports HTML Content
html-description boolean false true, false Enables HTML tags in the description
disabled boolean false true, false Disables input field
no-value-change-on-blur boolean false true, false Disables the insValueChange event trigger on blur

Event

EVENT OBJECT DESCRIPTION
insValueChange value Returns value when an element gets user input
insBlur value, keycode Emit field value and keycode on input blur event

Events

EventLive example
insInputTry insInput
insValueChangeTry insValueChange

Events - insInput

<ins-input-stepper 
  id="insInput">
</ins-input-stepper>

<p id="demo"></p>

<script>
const insInput = document.getElementById('insInput')
insInput.addEventListener('insInput', event => {
  console.log(event.detail.value);
  console.log(event.detail.validated);
  console.log(event.detail.keyCode);
  document.getElementById("demo").innerHTML = event.detail.validated;
});
</script>

Events - insValueChange

<ins-input-stepper
  id="valueChange"
  label="Step">
</ins-input-stepper>

<script>
  const valueChange = document.getElementById('valueChange')
  valueChange.addEventListener('insValueChange', event => {
    console.log(event.detail);
    document.getElementById("demo").innerHTML = event.detail;
  });
</script>

Examples

Default State

<ins-input-stepper></ins-input-stepper>

Description Example

<ins-input-stepper
  value="50"
  step="10"
  min="10"
  max="100"
  html-description
  description="This is a <strong>Description</strong> <i>Example</i>">
</ins-input-stepper>

Direct Set Data

<ins-input-stepper 
  id="dsv">
</ins-input-stepper>

<script>
  var dsv = document.getElementById('dsv');
  dsv.addEventListener('didLoad', function(e){
    dsv.value = '100';
  });
</script>

Static Data Source

<ins-input-stepper
  value="200"
  label="Name">
</ins-input-stepper>

Disabled State

<ins-input-stepper 
  label="Disabled" 
  disabled>
</ins-input-stepper>

Read-Only State

<ins-input-stepper 
  label="Read Only" 
  readonly>
</ins-input-stepper>

Error State

<ins-input-stepper 
  has-error 
  label="Quantity"
  error-message="Please enter quantity">
</ins-input-stepper>

noValueChangeOnBlur Attribute

<ins-input-stepper
  id="noValueChangeOnBlur"
  no-value-change-on-blur
  label="Step">
</ins-input-stepper>

<script>
  const noValueChangeOnBlur = document.getElementById('noValueChangeOnBlur')
  noValueChangeOnBlur.addEventListener('insValueChange', event => {
    console.log(event.detail);
    document.getElementById("demo").innerHTML = event.detail;
  });
</script>