Forms • Graffiti Hotline

Custom404 • Rancho Santa Margarita, CA • CivicEngage

Site Map • Rancho Santa Margarita, CA • CivicEngage

Services | Rancho Santa Margarita, CA

Citizen Request Tracker • Rancho Santa Margarita, CA • Civic

Forms & Handouts | Rancho Santa Margarita, CA

My Account • Rancho Santa Margarita, CA • CivicEngage

Agendas & Minutes | Rancho Santa Margarita, CA

Government | Rancho Santa Margarita, CA

Staff Directory • Rancho Santa Margarita, CA • CivicEngage

To comply with WCAG 2.1, fields must identify what their purpose is _programmatically_. If done correctly,
this allows browsers to help users fill in forms with known information, such as their name and email address.

This is accomplished via the `autocomplete` attribute, which should be set to a 
[supported value](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) wherever
appropriate, e.g. 

```html
<label for="name">
  First Name
</label>
<input id="name" type="text" autocomplete="given-name">
```

For fields where `autocomplete` is not appropriate, e.g. due to security, or the field not matching the
specification, the specific field should be ignored.

## Methodology

* All fields which could support `autocomplete` (e.g. text fields)
  are checked. Other fields - like dropdown menus - are ignored.
* The [accessible name](https://www.w3.org/TR/accname-1.2/) of each field is considered. In most cases this
  will be the `<label>` for the field.
* If the name matches a known pattern the field 
  must have an appropriate `autocomplete` value specified.
  For example, an `<input>` with type `text` with a label of 
  "First Name" would be expected to have an autocomplete value 
  of `given-name` or similar.

Note that using `autocomplete="on"` is not sufficient to pass this check, a
specific named autocomplete value must be used. See the
[supported values](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete).

## Troubleshooting

If a field is a false positive, check whether the field has an 
appropriate accessible name (i.e. a `<label>` or `aria-label`).

If the label is incorrect, Silktide may assume that the field 
requires `autocomplete` where it does not. You should fix the 
label to avoid this.

Otherwise, you can simply ignore the specific field.

## More information

* [How to use HTML 5.2 attributes](https://www.w3.org/WAI/WCAG21/Techniques/html/H98)

identify-input-purpose

June 2024

May 2024

City of Rancho Santa Margarita

Title / URL	Issues
Forms • Graffiti Hotlinecityofrsm.org/forms.aspx?fid=90	19
Custom404 • Rancho Santa Margarita, CA • CivicEngagecityofrsm.org/invented-url-for-404-page	5
Site Map • Rancho Santa Margarita, CA • CivicEngagecityofrsm.org/sitemap	5
Services \| Rancho Santa Margarita, CAcityofrsm.org/101/Services	5
Citizen Request Tracker • Rancho Santa Margarita, CA • Civiccityofrsm.org/requesttracker.aspx	5
Forms & Handouts \| Rancho Santa Margarita, CAcityofrsm.org/197/Forms-Handouts	5
My Account • Rancho Santa Margarita, CA • CivicEngagewww.cityofrsm.org/MyAccount?dn=cityofrsm.org&from=&url=&anchor=&validationMessage=	5
Agendas & Minutes \| Rancho Santa Margarita, CAcityofrsm.org/129/Agendas-Minutes	5
Government \| Rancho Santa Margarita, CAcityofrsm.org/27/Government	5
Staff Directory • Rancho Santa Margarita, CA • CivicEngagecityofrsm.org/directory.aspx	5

Identify the purpose of fields programmatically

City of Rancho Santa Margarita

Where this issue has occurred