Email Subscriptions | Brentwood, CA

eSubscribe | Brentwood, CA

Accessibility Statement | Brentwood, CA

City Manager | Brentwood, CA

First time visit: View without clicking anything

Council Committees | Brentwood, CA

City Clerk | Brentwood, CA

Government | Brentwood, CA

2024 City Election Information | Brentwood, CA

City Council | Brentwood, CA

People using screen readers are not able to see the layout of a form. To make forms
accessible, they must define explicit text labels for each form control. 

Usually the best solution is to use a `<label>` element. The label may be linked to 
by the form control:

```html
<label for="name">Full name</label>
<input type="name" id="name">
```

or the `<label>` can be wrapped around the form control:

```html
<label>
    Full name <input type="name">
</label>
```

Buttons are different, as their labels are specified by the code for the button, e.g.

```html
<input type="submit" value="Send message">
<button>Send message</button>
```

Alternatively ARIA attributes, such as `aria-label` may be used, but this information
will not be conveyed to visual users. For more information, see [W3C's guide to labeling controls](https://www.w3.org/WAI/tutorials/forms/labels/).

Hidden input fields (`<input type="hidden">`) do not require labels.
Note that the `placeholder` attribute 
[should not be used as an alternative to a label](https://www.w3.org/TR/html/sec-forms.html#the-placeholder-attribute),
nor should the `title` attribute.

## Custom roles

Note that this check considers the underlying accessible role of an element, which can be 
different from the tag itself.

For example, this `<div>` has a `role` of `button`, and so is expected to have a label, like
a button would.

```html
<div role="button"></div>
```

form-control-labels

June 2025

May 2025

The City of Brentwood

	Title / URL	Issues
	Email Subscriptions \| Brentwood, CAwww.brentwoodca.gov/residents/email-subscriptions	2
	eSubscribe \| Brentwood, CAwww.brentwoodca.gov/government/advanced-components/custom-pages/esubscribe	2
	Accessibility Statement \| Brentwood, CAwww.brentwoodca.gov/residents/accessibility-statement	1
	City Manager \| Brentwood, CAwww.brentwoodca.gov/government/city-manager	1
	First time visit: View without clicking anythingwww.brentwoodca.gov/	1
	Council Committees \| Brentwood, CAwww.brentwoodca.gov/government/city-council/council-committees	1
	City Clerk \| Brentwood, CAwww.brentwoodca.gov/government/city-manager/city-clerk	1
	Government \| Brentwood, CAwww.brentwoodca.gov/government	1
	2024 City Election Information \| Brentwood, CAwww.brentwoodca.gov/government/city-council/elections	1
	City Council \| Brentwood, CAwww.brentwoodca.gov/government/city-council	1

Ensure form controls have labels

The City of Brentwood

Where this issue has occurred