@SupportsInformalParameters public class Label extends ObjectGenerates a <label> element for a particular field. It writes the CSS class "control-label". A Label will render its body, if it has one. However, in most cases it will not have a body, and will render its field's label as its body. Remember, however, that it is the field label that will be used in any error messages. The Label component allows for client- and server-side validation error decorations.
<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_0_0.xsd"> <body> <t:form> <t:label for="search"/> <t:textfield t:id="search" size="50"/> <t:checkbox t:id="all"/> <t:label for="all"> Include out of date records </t:label> . . . </html>
This demonstrates that the Label can come before or after the form control element component (the TextField and Checkbox components). When a Label has a body, that takes precendence over the field's label, though the field's label is what's used in any error messages.
The Label component is very important for user accessibility. A user will be able to click on the label to move the cursor into the corresponding field.
The Label component supports informal parameters; this can be very useful for adding the
accesskeyattribute supported by most browsers.