Accountability

School Hours

Parent Quick Links

Strategic Plan

Graduate Profile

Alumni

Marquee Programs

Quick Links

Parent Resources

About ROISD

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

September 2025

August 2025

Red Oak ISD

	Title / URL	Issues
	Accountabilitywww.redoakisd.org/district-85/accountability	4
	School Hourswww.redoakisd.org/district-85/school-hours	4
	Parent Quick Linkswww.redoakisd.org/parents/parent-quick-links	4
	Strategic Planwww.redoakisd.org/district-85/strategic-plan	4
	Graduate Profilewww.redoakisd.org/students/graduate-profile	4
	Alumniwww.redoakisd.org/community/alumni	4
	Marquee Programswww.redoakisd.org/students/marquee-programs	4
	Quick Linkswww.redoakisd.org/staff/quick-links	4
	Parent Resourceswww.redoakisd.org/parents/parent-resources	4
	About ROISDwww.redoakisd.org/district-85/about-roisd	4

Ensure links can be used by screen readers

Red Oak ISD

Where this issue has occurred