# apex:outputLabel

A label for an input or output field. Use this component to provide a label for a controller method that does not correspond to a field on a Salesforce object.

This component supports [HTML pass-through attributes](https://developer.salesforce.com/docs/atlas.en-us.pages.meta/pages/pages_html_features_pass_through_attributes.htm) using the "html-" prefix. Pass-through attributes are attached to the generated `<label>` tag.

## Example

```apex
<apex:outputLabel value="Checkbox" for="theCheckbox"/>
<apex:inputCheckbox value="{!inputValue}" id="theCheckbox"/>
```

The example above renders the following HTML:

```html
<label for="theCheckbox">Checkbox</label>
<input id="theCheckbox" type="checkbox" name="theCheckbox" />
```

## Attributes

| Attribute Name | Attribute Type | Description                                                                                                                                                                                                                                                                                                                                                                                                               | Required? | API Version | Access |
| -------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | ------ |
| `accesskey`    | String         | The keyboard access key that puts the label and its associated field in focus.                                                                                                                                                                                                                                                                                                                                            |           | 10.0        | global |
| `dir`          | String         | The direction in which the generated HTML component should be read. Possible values include "RTL" (right to left) or "LTR" (left to right).                                                                                                                                                                                                                                                                               |           | 10.0        | global |
| `escape`       | Boolean        | A Boolean value that specifies whether sensitive HTML and XML characters should be escaped in the HTML output generated by this component. If you don't specify escape="false", the character escape sequence displays as written. For example, the only way to add a ">" symbol to a label is by using the symbol's character escape sequence and setting escape="false". If not specified, this value defaults to true. |           | 10.0        | global |
| `for`          | String         | The ID of the component with which the label should be associated. When the label is in focus, the component specified by this attribute is also in focus.                                                                                                                                                                                                                                                                |           | 10.0        | global |
| `id`           | String         | An identifier that allows the label component to be referenced by other components in the page.                                                                                                                                                                                                                                                                                                                           |           | 10.0        | global |
| `lang`         | String         | The base language for the generated HTML output, for example, "en" or "en-US". For more information on this attribute, see [the W3C specifications](http://www.w3.org/TR/REC-html40/struct/dirlang.html).                                                                                                                                                                                                                 |           | 10.0        | global |
| `onblur`       | String         | The JavaScript invoked if the onblur event occurs--that is, if the focus moves off of the label.                                                                                                                                                                                                                                                                                                                          |           | 10.0        | global |
| `onclick`      | String         | The JavaScript invoked if the onclick event occurs--that is, if the user clicks the label.                                                                                                                                                                                                                                                                                                                                |           | 10.0        | global |
| `ondblclick`   | String         | The JavaScript invoked if the ondblclick event occurs--that is, if the user clicks the label twice.                                                                                                                                                                                                                                                                                                                       |           | 10.0        | global |
| `onfocus`      | String         | The JavaScript invoked if the onfocus event occurs--that is, if the focus is on the label.                                                                                                                                                                                                                                                                                                                                |           | 10.0        | global |
| `onkeydown`    | String         | The JavaScript invoked if the onkeydown event occurs--that is, if the user presses a keyboard key.                                                                                                                                                                                                                                                                                                                        |           | 10.0        | global |
| `onkeypress`   | String         | The JavaScript invoked if the onkeypress event occurs--that is, if the user presses or holds down a keyboard key.                                                                                                                                                                                                                                                                                                         |           | 10.0        | global |
| `onkeyup`      | String         | The JavaScript invoked if the onkeyup event occurs--that is, if the user releases a keyboard key.                                                                                                                                                                                                                                                                                                                         |           | 10.0        | global |
| `onmousedown`  | String         | The JavaScript invoked if the onmousedown event occurs--that is, if the user clicks a mouse button.                                                                                                                                                                                                                                                                                                                       |           | 10.0        | global |
| `onmousemove`  | String         | The JavaScript invoked if the onmousemove event occurs--that is, if the user moves the mouse pointer.                                                                                                                                                                                                                                                                                                                     |           | 10.0        | global |
| `onmouseout`   | String         | The JavaScript invoked if the onmouseout event occurs--that is, if the user moves the mouse pointer away from the label.                                                                                                                                                                                                                                                                                                  |           | 10.0        | global |
| `onmouseover`  | String         | The JavaScript invoked if the onmouseover event occurs--that is, if the user moves the mouse pointer over the label.                                                                                                                                                                                                                                                                                                      |           | 10.0        | global |
| `onmouseup`    | String         | The JavaScript invoked if the onmouseup event occurs--that is, if the user releases the mouse button.                                                                                                                                                                                                                                                                                                                     |           | 10.0        | global |
| `rendered`     | Boolean        | A Boolean value that specifies whether the component is rendered on the page. If not specified, this value defaults to true.                                                                                                                                                                                                                                                                                              |           | 10.0        | global |
| `style`        | String         | The style used to display the label component, used primarily for adding inline CSS styles.                                                                                                                                                                                                                                                                                                                               |           | 10.0        | global |
| `styleClass`   | String         | The style class used to display the label component, used primarily to designate which CSS styles are applied when using an external CSS stylesheet.                                                                                                                                                                                                                                                                      |           | 10.0        | global |
| `tabindex`     | String         | The order in which this label is selected compared to other page components when a user presses the Tab key repeatedly. This value must be an integer between 0 and 32767, with component 0 being the first component that is selected when a user presses the Tab key.                                                                                                                                                   |           | 10.0        | global |
| `title`        | String         | The text to display as a tooltip when the user's mouse pointer hovers over this component.                                                                                                                                                                                                                                                                                                                                |           | 10.0        | global |
| `value`        | Object         | The text displayed as the label.                                                                                                                                                                                                                                                                                                                                                                                          |           | 10.0        | global |