Movatterモバイル変換


[0]ホーム

URL:


MDN Web Docs

<label>: The Label element

BaselineWidely available

The<label>HTML element represents a caption for an item in a user interface.

Try it

<div>  <label for="cheese">Do you like cheese?</label>  <input type="checkbox" name="cheese" /></div><div>  <label for="peas">Do you like peas?</label>  <input type="checkbox" name="peas" /></div>
.preference {  display: flex;  justify-content: space-between;  width: 60%;  margin: 0.5rem;}

Associating a<label> with a form control, such as<input> or<textarea> offers some major advantages:

  • The label text is not only visually associated with its corresponding text input; it is programmatically associated with it too. This means that, for example, a screen reader will read out the label when the user is focused on the form input, making it easier for an assistive technology user to understand what data should be entered.
  • When a user clicks or touches/taps a label, the browser passes the focus to its associated input (the resulting event is also raised for the input). That increased hit area for focusing the input provides an advantage to anyone trying to activate it — including those using a touch-screen device.

To explicitly associate a<label> element with an<input> element, you first need to add theid attribute to the<input> element. Next, you add thefor attribute to the<label> element, where the value offor is the same as theid in the<input> element.

Alternatively, you can nest the<input> directly inside the<label>, in which case thefor andid attributes are not needed because the association is implicit:

html
<label>  Do you like peas?  <input type="checkbox" name="peas" /></label>

The form control that a label is labeling is called thelabeled control of the label element. Multiple labels can be associated with the same form control:

html
<label for="username">Enter your username:</label><input name="username" type="text" /><label for="username">Forgot your username?</label>

Elements that can be associated with a<label> element include<button>,<input> (except fortype="hidden"),<meter>,<output>,<progress>,<select> and<textarea>.

Attributes

This element includes theglobal attributes.

for

The value of thefor attribute must be a singleid for alabelable form-related element in the same document as the<label> element. So, any givenlabel element can be associated with only one form control.

Note:To programmatically set thefor attribute, usehtmlFor.

The first element in the document with anid attribute matching the value of thefor attribute is thelabeled control for thislabel element — if the element with thatid is actually alabelable element. If it isnot a labelable element, then thefor attribute has no effect. If there are other elements that also match theid value, later in the document, they are not considered.

Multiplelabel elements can be given the same value for theirfor attribute; doing so causes the associated form control (the form control thatfor value references) to have multiple labels.

Note:A<label> element can have both afor attribute and a contained control element, as long as thefor attribute points to the contained control element.

Styling with CSS

There are no special styling considerations for<label> elements — structurally they are inline elements, and so can be styled in much the same way as a<span> or<a> element. You can apply styling to them in any way you want, as long as you don't cause the text to become difficult to read.

Accessibility

Interactive content

Don't place interactive elements such asanchors orbuttons inside alabel. Doing so makes it difficult for people to activate the form input associated with thelabel.

Don't do this:

html
<label for="tac">  <input type="checkbox" name="terms-and-conditions" />  I agree to the <a href="terms-and-conditions.html">Terms and Conditions</a></label>

Prefer this:

html
<label for="tac">  <input type="checkbox" name="terms-and-conditions" />  I agree to the Terms and Conditions</label><p>  <a href="terms-and-conditions.html">Read our Terms and Conditions</a></p>

Headings

Placingheading elements within a<label> interferes with many kinds of assistive technology, because headings are commonly used asa navigation aid. If the label's text needs to be adjusted visually, use CSS classes applied to the<label> element instead.

If aform, or a section of a form needs a title, use the<legend> element placed within a<fieldset>.

Don't do this:

html
<label for="your-name">  <h3>Your name</h3>  <input name="your-name" type="text" /></label>

Prefer this:

html
<label for="your-name">  Your name  <input name="your-name" type="text" /></label>

Buttons

An<input> element with atype="button" declaration and a validvalue attribute does not need a label associated with it. Doing so may actually interfere with how assistive technology parses the button input. The same applies for the<button> element.

Examples

Defining an implicit label

html
<label>Click me <input type="text" /></label>

Defining an explicit label with the "for" attribute

html
<label for="username">Click me to focus on the input field</label><input type="text" />

Technical summary

Content categoriesFlow content,phrasing content,interactive content,form-associated element, palpable content.
Permitted contentPhrasing content, but no descendantlabel elements. Nolabelable elements other than the labeled control are allowed.
Tag omissionNone, both the starting and ending tag are mandatory.
Permitted parents Any element that acceptsphrasing content.
Implicit ARIA roleNo corresponding role
Permitted ARIA rolesNorole permitted
DOM interfaceHTMLLabelElement

Specifications

Specification
HTML
# the-label-element

Browser compatibility

Help improve MDN

Learn how to contribute.

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2025 Movatter.jp