Watch Live - Belvedere, CA

Government - Belvedere, CA

Newsletter - Belvedere, CA

News - Belvedere, CA

Events - Belvedere, CA

About Belvedere - Belvedere, CA

Community - Belvedere, CA

How do I... - Belvedere, CA

Links must be defined in a specific way to be accessed by screen readers, which are used by 
blind and the partially-sighted.

To work with accessibility technologies, links must contain both machine-readable text, and 
a `href` attribute. If a link is not actually
pointing to a page or part of a page, it should be replaced with another semantic element, such
as a `button`, or the `<a>` tag should have a role of `button`. 

For example:

```html
<a href="/about">About us</a>
```

If the link contains _nothing but an image_, that image should specify alternative text, e.g.

```html
<a href="/apple">
    <img src="apple.png" alt="Apple">
</a>
```

Before HTML5, an anchor was often used to create a target to link to, e.g.

```html
<a name="example"></a>
```

This is not supported in HTML5, and the use of anchors for targets is discouraged. Use an `id`
attribute on a non-anchor tag instead, e.g.

```html
<div id="example"> ... </div>
```

Empty links (e.g. `<a></a>`) are often incorrectly used for buttons or controls in a
JavaScript application. In these cases, you should usually define the link as having a more appropriate
role, e.g. as a button. To do this, use the `role` attribute (e.g `<a role="button">`), or replace 
the `<a>` tag with a more appropriate tag, such as `<button>`.

For more details, see [Technique H91](https://www.w3.org/TR/2016/NOTE-WCAG20-TECHS-20161007/H91)
and learn about [ARIA roles](https://www.sitepoint.com/how-to-use-aria-effectively-with-html5/).

bad-anchor

May 2025

April 2025

City of Belvedere

Title / URL	Issues
Watch Live - Belvedere, CAwww.cityofbelvedere.org/watch-live	5
Government - Belvedere, CAwww.cityofbelvedere.org/government	4
Newsletter - Belvedere, CAwww.cityofbelvedere.org/newsletter	4
News - Belvedere, CAwww.cityofbelvedere.org/news/	4
Events - Belvedere, CAwww.cityofbelvedere.org/events/	4
About Belvedere - Belvedere, CAwww.cityofbelvedere.org/about/	4
Community - Belvedere, CAwww.cityofbelvedere.org/community/	4
How do I... - Belvedere, CAwww.cityofbelvedere.org/how-do-i/	4
Newsletter - Belvedere, CAwww.cityofbelvedere.org/newsletter/	4
News - Belvedere, CAwww.cityofbelvedere.org/news	4

Ensure links can be used by screen readers

City of Belvedere

Where this issue has occurred