HTML Table Cell Links with Descriptive Accessible Names

A link inside a data cell should say what it opens. Readers moving from cell to cell need enough context to know which event or item it belongs to. Before writing the code, picture the information as a small grid. Each label should help a reader understand the value next to it.

What You Need to Know

Avoid a long grid of identical Details links with no accessible distinction. A clear linked phrase is often better than relying only on surrounding cells.

Read a table like a story about data. The caption says what you are looking at; row and column headers explain what the numbers or words mean.

Example: See It in Action

This example keeps the idea small. Copy it carefully, then follow the explanation instead of guessing what the browser will do.

This is a short HTML fragment. To try it as a webpage, put it inside the body element of a complete HTML document.

<table>
    <tr>
        <th scope="col">Event</th>
        <th scope="col">Details</th>
    </tr>
    <tr>
        <th scope="row">Robotics</th>
        <td><a href="robotics.html">View the robotics event details</a>
        </td>
    </tr>
</table>

Let’s Understand the Example

• Table represents information whose row and column relationships matter.
• Th is a header cell. Its text explains what nearby data cells mean.
• Scope explains which table row, column or group a th cell labels.
• Href contains the destination of a link. A value starting with # points to an id on the same page.

Look at a data cell and ask: “What row and column does this value belong to?” The header elements help answer that question, including for people who navigate the table with a screen reader.

What Should You See?

You should see a grid for the data table, with headers such as “Event”, “Details”, “Robotics”. The browser displays cells, but meaningful table markup also helps readers connect each cell to its labels.

Read the first data row aloud together with its column labels. If you cannot explain a value without pointing to its position on screen, strengthen the headers.

Try It Yourself

1. Write a descriptive link label for a second event row.
2. Save your changes, open or refresh the page, and compare the result with the original example.
3. Tell a friend what your change did. If you are not sure, undo it, refresh the page, and compare.

Common Beginner Mistakes

• Using Click here inside every row and making each destination unclear.
• Do not replace actual header cells with bold ordinary cells. Header markup is part of the meaning, not just the appearance.

Key Takeaways

• A link inside a data cell should say what it opens.
• Table represents information whose row and column relationships matter.
• Avoid a long grid of identical Details links with no accessible distinction. A clear linked phrase is often better than relying only on surrounding cells.