legend Element

 

Module

The legend element is declared by the XHTML 1.1 Forms Module but is not present in the *W3C XHTML 1.1 Basic Forms Module

Elements in the Forms Module are:
form | label | textarea | select | optgroup | option | button | fieldset | legend |
input type="button" | input type="checkbox" | input type="file" | input type="hidden" | input type="image" | input type="password" | input type="radio" | input type="reset" | input type="submit" | input type="text"

Description

A legend element is used to provide a heading for a fieldset within a form. See the fieldset element for more information.

Note: Bear in mind that some screen readers may read out the contents of the legend element prior to each label within a fieldset, so legends should be short and make sense when read out before each and every label within the fieldset.

#REQUIRED Attributes

There are no #REQUIRED attributes on the legend element.

---

Specific Attributes

From the Forms Module - the Element's own Module

accesskey [ type Character ]

Accesskey for the legend - allows quick navigation to the set of form controls captioned by the legend

---

Common Attributes

From the Core Attribute Collection

class [ type NMTOKENS ]

One or more space separated classes

id [ type ID ]

A unique identifier for the element

style [ type CDATA ], from the Style Attribute Module (deprecated)

Element-specific styles

title [ type Text ]

Descriptive title for the element (in some user agents this may appear as a "tooltip" when the mouse hovers over the element)

xmlns [ type URI - #FIXED 'http://www.w3.org/1999/xhtml' ]

XML namespace

From the I18N Attribute Collection

dir [ type Enumeration (ltr | rtl) ], from the Bi-directional Text Module

Left-to-right or right-to-left directionality

xml:lang [ type LanguageCode ]

A language code for the element

From the Events Attribute Collection

All attributes in the Events Attribute Collection are supported:
onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup

---

Content Model

The Content Model for the legend element is:

( #PCDATA | Inline.mix )*

See Content Model & Nesting for information about Content Model syntax and Nesting Groups.

Valid children of legend

• #PCDATA
• From the Text Module: abbr, acronym, br, cite, code, dfn, em, kbd, q, samp, span, strong, var
• From the Hypertext Module: a
• From the Forms Module: button, input, label, select, textarea
• From the Images Module: img
• From the Presentation Module: b, big, i, small, sub, sup, tt
• From the Client-side Image Map Module: map
• From the Scripting Module: noscript, script
• From the Edit Module: del, ins
• From the Bi-directional Text Module: bdo
• From the Object Module: object
• From the Ruby Annotation Module: ruby

Valid parents of legend

• From the Forms Module: fieldset