HTML attribute: min
Theminattribute defines the minimum value that is acceptable and valid for the input containing the attribute. If thevalueof the element is less than this, the element failsvalidation.This value must be less than or equal to the value of themaxattribute.
Some input types have a default minimum. If the input has no default minimum and a value is specified forminthat can't be converted to a valid number (or no minimum value is set), the input has no minimum value.
It is valid for the input types including:date,month,week,time,datetime-local,numberandrangetypes, and the<meter>element.
Syntax
| Input type | Syntax | Example |
|---|---|---|
| date | yyyy-mm-dd |
<input type= "date" min= "2019-12-25" step= "1" > |
| month | yyyy-mm |
<input type= "month" min= "2019-12" step= "12" > |
| week | yyyy-W## |
<input type= "week" min= "2019-W23" step= "" > |
| time | HH:mm |
<input type= "time" min= "09:00" step= "900" > |
| datetime-local | yyyy-mm-ddTHH:mm |
<input type= "datetime-local" min= "2019-12-25T19:30" > |
| number | <number> | <input type= "number" min= "0" step= "5" max= "100" > |
| range | <number> | <input type= "range" min= "60" step= "5" max= "100" > |
Note:When the data entered by the user doesn't adhere to the min value set, the value is considered invalid in constraint validation and will match the:invalidand:out-of-rangepseudo-classes.
SeeClient-side validationandrangeUnderflowfor more information.
For the<meter>element, theminattribute defines the lower numeric bound of the measured range. This must be less than the maximum value (maxattribute), if specified. In both cases, if omitted, the value defaults to 1.
Impact on step
The value ofminandstepdefine what are valid values, even if thestepattribute is not included, asstepdefaults to0.
We add a big red border around invalid inputs:
input:invalid {
border: solid red 3px;
}
Then define an input with a minimum value of 7.2, omitting the step attribute, wherein it defaults to 1.
<input id= "myNumber" name= "myNumber" type= "number" min= "7.2" value= "8" />
Becausestepdefaults to 1, valid values include7.2,8.2,9.2,and so on. The value 8 is not valid. As we included an invalid value, supporting browsers will show the value as invalid.
If not explicitly included,stepdefaults to 1 fornumberandrange,and 1 unit type (second, week, month, day) for the date/time input types.
Accessibility concerns
Provide instructions to help users understand how to complete the form and use individual form controls. Indicate any required and optional input, data formats, and other relevant information. When using theminattribute, ensure this minimum requirement is understood by the user. Providing instructions within the<label>may be sufficient. If providing instructions outside of labels, which allows more flexible positioning and design, consider usingaria-labelledbyoraria-describedby.
Specifications
| Specification |
|---|
| HTML Standard #attr-input-min |
| HTML Standard #attr-meter-max |
Browser compatibility
html.elements.input.min
BCD tables only load in the browser
html.elements.meter.min
BCD tables only load in the browser
See also
stepmax- other meter attributes:
low,high,optimum - Constraint validation
- Form validation
validityState.rangeUnderflow:out-of-range<input>- date,month,week,time,datetime-local,numberandrangetypes, and the
<meter>