How to add hyperlink to table row <tr>

How to add hyperlink to table row <tr>

  1. Blog
  2. 15 November 2026
  3. 4 min read

Stefan Bogdanescu

Founder & Senior Architect

Making <tr> Elements Clickable: Strategies for Linking Table Rows

When generating HTML tables dynamically, particularly within loops in backend frameworks like Laravel or PHP, a common requirement is to make the entire row clickable. The goal is often to navigate to a detail page based on the specific record rendered in that row. A frequent misconception driving this query is the belief that one must wrap every cell (<td>) in an anchor tag or force the link inside a table structure. While placing <a> tags directly inside <td> elements works, it fragments the clickable area and often breaks layout consistency if the link text doesn't span the full width.

The most robust solution involves wrapping the entire row element (<tr>) in an anchor tag. This approach treats the row as a single navigational unit. However, this requires specific CSS adjustments because browsers do not apply default link styling to table rows. Without explicit rules, the row remains non-interactive even if wrapped.

The HTML Structure

To achieve full-row interactivity, you must nest the <tr> tag inside an <a> tag. When looping through your data array, ensure your template logic reflects this nesting. In a Blade template for Laravel, for instance, your loop might look like this:

@foreach($records as $record)
    <tr>
        <td>{{ $record->name }}</td>
        <td>{{ $record->email }}</td>
    </tr>
@endforeach

To make the row clickable, you modify the loop to wrap the content:

@foreach($records as $record)
    <tr>
        <td><a href="/details/{{ $record->id }}">{{ $record->name }}</a></td>
        <td>{{ $record->email }}</td>
    </tr>
@endforeach

While the above snippet puts a link inside the first cell, it fails to make the entire row clickable. The correct structural implementation is:

@foreach($records as $record)
    <a href="/details/{{ $record->id }}" class="row-link">
        <tr>
            <td>{{ $record->name }}</td>
            <td>{{ $record->email }}</td>
            <!-- Additional columns -->
        </tr>
    </a>
@endforeach

Styling the Interaction

Structural correctness alone is insufficient. You must apply CSS to visually indicate that the row is a link and to ensure it behaves correctly within the table grid. The primary challenge is that standard <td> cells do not inherit text-decoration or color from their parent <a> tag by default in all browsers, nor does the cursor usually change to a pointer for table rows.

You need to target the <tr> descendant and apply link-specific styles:

.row-link {
    background-color: #f9f9f9; /* Optional subtle background */
}

.row-link tr {
    display: block;             /* Ensures the row fills the anchor's width */
    text-decoration: none;      /* Prevents underline on the whole row if unwanted */
    color: #0066cc;             /* Sets link color for the row background or text */
}

.row-link tr:hover {
    background-color: #eef;     /* Visual feedback on hover */
}

/* Change cursor to indicate clickability */
a[href]:hover, 
tr:hover {
    cursor: pointer;
}

In this implementation, the display: block property on the <tr> is crucial. Table rows are inherently block-level elements, but inside an anchor tag, they sometimes collapse or fail to expand to fill the link's dimensions depending on browser rendering quirks. Explicitly setting it ensures the entire row acts as a single hit box.

Trade-offs and Browser Compatibility

There is a significant trade-off with this approach: accessibility. Screen readers interpret <a> tags differently than simple <tr> elements. When a screen reader encounters an anchor wrapping a row, it reads "link" followed by the text content of the cells. This can be confusing if the row contains multiple distinct pieces of information rather than a single summary title.

For better accessibility, consider using JavaScript to attach click listeners to the row instead of nesting HTML tags. However, this requires extra JavaScript code and careful handling of event bubbling to prevent double-triggering if buttons exist inside the cells.

If you decide on the pure CSS solution, ensure that the text-decoration is managed carefully. If you want an underline to appear only on hover, apply it to the :hover state rather than the default state. This keeps the design clean while maintaining the semantic meaning that the row is a navigational element.

Conclusion

Wrapping <tr> elements in <a> tags is the most straightforward way to achieve full-row navigation without complex JavaScript. By combining the correct HTML nesting with specific CSS rules for display and color, you create a responsive, intuitive table where every row serves as a direct portal to its respective detail view.

Our network