HTML Input Control Elements
A key component of interactive web systems, input tags are HTML elements designed to take a specific form of input from users. Different types of input elements can regulate the data entered to fit a specified format and provide security to password entry.
Syntax[edit | edit source]
<input type="" name="" value="">
Parameters[edit | edit source]
|class||Indicates the Class of the input|
|id||Indicates the ID of the input|
|type||Identifies the type of input control to display. Acceptable values are |
|name||Indicates the name of the input|
|disabled||Boolean value that indicates the input should be disabled. Disabled controls cannot be edited, are not sent on form submission, and cannot receive focus.|
|checked||When the value of the type attribute is radio or checkbox, the presence of this Boolean attribute indicates that the control is selected by default; otherwise it is ignored.|
|multiple||HTML5 Indicates multiple files or values can be passed (Applies only to |
|placeholder||HTML5 A hint to the user of what can be entered in the control . The placeholder text must not contain carriage returns or line-feeds|
|autocomplete||HTML5 Indicates whether the value of the control can be automatically completed by the browser.|
|readonly||Boolean value that indicates the input is not editable. Readonly controls are still sent on form submission, but will not receive focus. HTML5: This attribute is ignored when the value of |
|required||HTML5 Indicates a value must be present or the element must be checked in order for the form to be submitted|
|alt||An alternative text for images, in case they are not displayed.|
|value||Specifies the value of |
Remarks[edit | edit source]
As with other HTML5 void elements,
<input> is self-closing and may be written
<input />. HTML5 does not require this slash.
The following are valid input types in HTML:
The following are newly introduced input types as a part of HTML 5 standard. Some of these types are not supported by all web browsers. In the case where a type is not supported, the input element will default to the
datetime(Deprecated and Obsolete)
To check which browsers support which types, you can go to caniuse.com.
Checkbox and Radio Buttons[edit | edit source]
Overview[edit | edit source]
Checkboxes and radio buttons are written with the HTML tag
<input>, and their behavior is defined in the HTML specification.
The simplest checkbox or radio button is an
<input> element with a
type attribute of
<input type="checkbox"> <input type="radio">
A single stand-alone checkbox element is used for a single binary option such as a yes-or-no question. Checkboxes are independent, meaning the user may select as many choices as they would like in a group of checkboxes. In other words, checking one checkbox does not uncheck the other checkboxes in checkbox group.
Radio buttons usually come in groups (if it's not grouped with another radio button, you probably meant to use a checkbox instead) identified by using the same
name attribute on all buttons within that group. The selection of radio buttons are mutually exclusive, meaning the user may only select one choice from a group of radio buttons. When a radio button is checked, any other radio button with the same
name that was previously checked becomes unchecked.
<input type="radio" name="color" id="red" value="#F00"> <input type="radio" name="color" id="green" value="#0F0"> <input type="radio" name="color" id="blue" value="#00F">
When viewed, radio buttons appear as a circle (unchecked) or a filled circle (checked). Checkboxes appear as a square (unchecked) or a filled square (checked). Depending on the browser and operating system, the square sometimes has rounded corners.
Attributes[edit | edit source]
checkboxes and radio buttons have a number of attributes to control their behavior:
value[edit | edit source]
Like any other input element, the
value attribute specifies the string value to associate with the button in the event of form submission. However, checkboxes and radio buttons are special in that when the value is omitted, it defaults to
on when submitted, rather than sending a blank value. The
value attribute is not reflected in the button's appearance.
checked[edit | edit source]
checked attribute specifies the initial state of a checkbox or radio button. This is a boolean attribute and may be omitted.
Each of these are valid, equivalent ways to define a checked radio button:
<input checked> <input checked=""> <input checked="checked"> <input checked="ChEcKeD">
The absence of the
checked attribute is the only valid syntax for an unchecked button:
<input type="radio"> <input type="checkbox">
When resetting a
<form>, checkboxes and radio buttons revert to the state of their
Accessibility[edit | edit source]
Labels[edit | edit source]
To give context to the buttons and show users what each button is for, each of them should have a label. This can be done using a
<label> element to wrap the button. Also, this makes the label clickable, so you select the corresponding button.
<label> <input type="radio" name="color" value="#F00"> Red </label>
or with a
<label> element with a
for attribute set to the
id attribute of the button:
<input type="checkbox" name="color" value="#F00" id="red"> <label for="red">Red</label>
Button Groups[edit | edit source]
Since each radio button affects the others in the group, it is common to provide a label or context for the entire group of radio buttons.
To provide a label for the entire group, the radio buttons should be included in a
<fieldset> element with a
<legend> element within it.
<fieldset> <legend>Theme color:</legend> <p> <input type="radio" name="color" id="red" value="#F00"> <label for="red">Red</label> </p> <p> <input type="radio" name="color" id="green" value="#0F0"> <label for="green">Green</label> </p> <p> <input type="radio" name="color" id="blue" value="#00F"> <label for="blue">Blue</label> </p> </fieldset>
Checkboxes can also be grouped in a similar fashion, with a fieldset and legend identifying the group of related checkboxes. However, keep in mind that checkboxes should not share the same name because they are not mutually exclusive. Doing this will result in the form submitting multiple values for the same key and not all server-side languages handle this in the same way (undefined behavior). Each checkbox should either have a unique name, or use a set of square brackets (
) to indicate that the form should submit an array of values for that key. Which method you choose should depend on how you plan to handle the form data client-side or server-side. You should also keep the legend short, since some combinations of browsers and screen readers read the legend before each input field in the fieldset.
Input Validation[edit | edit source]
Some newer input types (like
date and many more ) are automatically validated and do not require your own validation constraints.
Required[edit | edit source]
required attribute to indicate that a field must be completed in order to pass validation.
Minimum / Maximum Length[edit | edit source]
maxlength attributes to indicate length requirements. Most browsers will prevent the user from typing more than max characters into the box, preventing them from making their entry invalid even before they attempt submission.
<input minlength="3"> <input maxlength="15"> <input minlength="3" maxlength="15">
Specifying a range[edit | edit source]
max attributes to restrict the range of numbers a user can input into an input of type
Marks: <input type="number" size="6" name="marks" min="0" max="100" /> Subject Feedback: <input type="range" size="2" name="feedback" min="1" max="5" />
Match a Pattern[edit | edit source]
For more control, use the
pattern attribute to specify any regular expression that must be matched in order to pass validation. You can also specify a
title, which is included in the validation message if the field doesn't pass.
<input pattern="\d*" title="Numbers only, please.">
Here's the message shown in Google Chrome version 51 when attempting to submit the form with an invalid value inside this field:
Not all browsers display a message for invalid patterns, although there is full support among most used modern browsers.
Check the latest support on CanIUse and implement accordingly.
Accept File Type[edit | edit source]
For input fields of type
file, it is possible to accept only certain types of files, such as videos, images, audios, specific file extensions, or certain media types. For example:
<input type="file" accept="image/*" title="Only images are allowed">
Multiple values can be specified with a comma, e.g.:
<input type="file" accept="image/*,.rar,application/zip">
novalidate attribute to the
form element or
formnovalidate attribute to the submit button, prevents validation on form elements. For example:
<form> <input type="text" name="name" required> <input type="email" name="email" required> <input pattern="\d*" name="number" required> <input type="submit" value="Publish"> <!-- form will be validated --> <input type="submit" value="Save" formnovalidate> <!-- form will NOT be validated --> </form>
The form has fields that are required for "publishing" the draft but arenât required for "saving" the draft.
Text[edit | edit source]
The most basic input type and the default input if no
type is specified. This input type defines a single-line text field with line-breaks automatically removed from the input value. All other characters can be entered into this.
<input> elements are used within a
<form> element to declare input controls that allow users to input data.
or (without specifying a
type, using the default attribute):
The default width of a text field input is 20 characters. This can be changed by specifying a value for the
size attribute like this:
<input type="text" size="50">
size attribute is distinctly different than setting a width with CSS. Using a width defines a specific value (in number of pixel, percentage of the parent element, etc.) that the input must always be wide. Using the
size calculates the amount of width to allocate based on the font being used and how wide the characters normally are.
Note: Using the
size attribute does not inherently limit the number of characters which can be entered into the box, only how wide the box is displayed. For limiting the length, see Input Validation.
An input field only allows one line of text. If you need a multi-line text input for substantial amount of text, use a
<textarea> element instead.
Color[edit | edit source]
<input type="color" name="favcolor" value="#ff0000">
In supporting browsers, the input element with a type attribute whose value is
color creates a button-like control, with a color equal to the value of
color attribute (defaults to black if value is not specified or is an invalid hexadecimal format).
Clicking this button opens the operating system's color widget, which allows user to select a color.
Fallback for browsers which do not support this input type is a regular input
Password[edit | edit source]
<input type="password" name="password">
The input element with a type attribute whose value is
password creates a single-line text field similar to the input
type=text, except that text is not displayed as the user enters it.
<input type="password" name="password" placeholder="Password">
Placeholder text is shown in plain text and is overwritten automatically when a user starts typing.
Note: Some browsers and systems modify the default behavior of the password field to also display the most recently typed character for a short duration, like so:
File[edit | edit source]
<input type="file" name="fileSubmission">
File inputs allow users to select a file from their local filesystem for use with the current page. If used in conjunction with a
form element, they can be used to allow users to upload files to a server (for more info see Uploading Files).
The following example allows users to use the
file input to select a file from their filesystem and upload that file to a script on the server named
<form action="upload_file.php" method="post" enctype="multipart/form-data"> Select file to upload: <input type="file" name="fileSubmission" id="fileSubmission"> <input type="submit" value="Upload your file" name="submit"> </form>
multiple attribute the user will be able to select more than one file:
<input type="file" name="fileSubmission" id="fileSubmission" multiple>
Accept attribute specifies the types of files that user can select. E.g.
<input type="file" name="fileSubmission" accept="image/x-png,image/gif,image/jpeg" />
Button[edit | edit source]
<input type="button" value="Button Text">
Buttons can be used for triggering actions to occur on the page, without submitting the form. You can also use the
<button> element if you require a button that can be more easily styled or contain other elements:
<button type="button">Button Text</button>
Buttons are typically used with an "onclick" event:
<input type="button" onclick="alert('hello world!')" value="Click Me">
<button type="button" onclick="alert('hello world!')">Click Me</button>
Attributes[edit | edit source]
[name][edit | edit source]
name of the button, which is submitted with the form data.
[type][edit | edit source]
type of the button.
Possible values are:
submit : The button submits the form data to the server. This is the default if the attribute is not specified, or if the attribute is dynamically changed to an empty or invalid value.
reset : The button resets all the controls to their initial values.
button : The button has no default behavior. It can have client-side scripts associated with the element's events, which are triggered when the events occur.
menu : The button opens a popup menu defined via its designated element.
[value][edit | edit source]
The initial value of the button.
Extra Attributes for Submit Buttons[edit | edit source]
||Specifies the ID of the form the button belongs to.
If none is specified, it will belong to its ancestor form element (if one exists).
||Specifies where to send the form-data
when the form is submitted using this button.
||Specifies how the form-data should be encoded
when submitting it to the server using this button.
Can only be used with
||Specifies the HTTP method to use (POST or GET)
when sending form-data using this button.
||Specifies that the form-data should not be validated on submission.|
||Specifies where to display the response that is received
after submitting the form using this button.
Reset[edit | edit source]
<input type="reset" value="Reset">
An input of type
reset creates a button which, when clicked, resets all inputs in the form it is contained in to their default state.
- Text in an input field will be reset to blank or its default value (specified using the
- Any option(s) in a selection menu will be deselected unless they have the
- All checkboxes and radio boxes will be deselected unless they have the
Note: A reset button must be inside or attached to (via the
form attribute) a
<form> element in order to have any effect. The button will only reset the elements within this form.
Submit[edit | edit source]
<input type="submit" value="Submit">
A submit input creates a button which submits the form it is inside when clicked.
You can also use the
<button> element if you require a submit button that can be more easily styled or contain other elements:
<button type="submit"> <img src="submit-icon.jpg" /> Submit </button>
Tel[edit | edit source]
<input type="tel" value="+8400000000">
The input element with a type attribute whose value is
tel represents a one-line plain-text edit control for entering a telephone number.
Hidden[edit | edit source]
<input type="hidden" name="inputName" value="inputValue">
A hidden input won't be visible to the user, but its value will be sent to the server when the form is submitted nonetheless.
Email[edit | edit source]
<input type="email"> is used for input fields that should contain an e-mail address.
<form> <label>E-mail: <label> <input type="email" name="email"> </form>
E*mail address can be automatically validated when submitted depending on browser support.
Number[edit | edit source]
<input type="number" value="0" name="quantity">
The Input element with a type attribute whose value is
number represents a precise control for setting the elementâs value to a string representing a number.
Please note that this field does not guarantee to have a correct number. It just allows all the symbols which could be used in any real number, for example user will be able to enter value like
Range[edit | edit source]
<input type="range" min="" max="" step="" />
A control for entering a number whose exact value is not important.
|min||Minimum value for range||0|
|max||Maximum value for range||100|
|step||Amount to increase by on each increment.||1|
Search[edit | edit source]
Input type search is used for textual search. It will add magnifier symbol next to space for text on most browsers
<input type="search" name="googlesearch">
Image[edit | edit source]
<input type="image" src="img.png" alt="image_name" height="50px" width="50px"/>
An Image. You must use the src attribute to define the source of the image and the alt attribute to define alternative text. You can use the height and width attributes to define the size of the image in pixels.
Week[edit | edit source]
<input type="week" />
Dependent on browser support, a control will show for entering a week-year number and a week number with no time zone.
Month[edit | edit source]
<input type="month" />
Dependent on browser support, a control will show to pick the month.
Time[edit | edit source]
<input type="time" />
time input marks this element as accepting a string representing a time. The format is defined in RFC 3339 and should be a partial-time such as
Currently, all versions of Edge, Chrome, Opera, and Chrome for Android support type="time". The newer versions of Android Browser, specifically 4.4 and up support it. Safari for iOS offers partial support, not supporting min, max, and step attributes.
DateTime-Local[edit | edit source]
<input type="datetime-local" />
Dependent on browser support, a date and time picker will pop up on screen for you to choose a date and time.
Url[edit | edit source]
<input type="url" name="Homepage">
This is used for input fields that should contain a URL address.
Depending on browser support, the
url field can be automatically validated when submitted.
Some smartphones recognize the
url type, and adds ".com" to the keyboard to match url input.
Date[edit | edit source]
<input type="date" />
A date picker will pop up on screen for you to choose a date. This is not supported in Firefox or Internet Explorer.
DateTime (Global)[edit | edit source]
The input element with a type attribute whose value is "datetime" represents a control for setting the elementâs value to a string representing a global date and time (with timezone information).
<fieldset> <p><label>Meeting time: <input type=datetime name="meeting.start"></label> </fieldset>
- global attributes
- min & max
- step (float)
- required value