HTML IDREF Attribute Link

Navigate seamlessly from HTML attributes like for attributes to their target elements with Go to Definition support.

Features

This extension adds "Go to Definition" functionality for HTML for attributes, allowing you to quickly jump from a <label> element's for attribute to the corresponding input element with a matching id.

The extension also supports multiple IDs in a single attribute (space-separated), making it easy to navigate when an element references multiple target elements.

Navigate with Ctrl+Click

Simply Ctrl+Click (or Cmd+Click on Mac) on any value in a for attribute to jump directly to the element with that id. Works with single or multiple space-separated IDs.

Before:

<label for="email">Email Address</label>

<!-- Somewhere else in your file... -->
<input id="email" type="email">

With this extension: Click on "email" in the for attribute and instantly jump to the <input id="email"> element!

Supported Languages

HTML (.html, .htm)
Vue (.vue)
Svelte (.svelte)

Usage

Open any HTML file in VSCode
Find a <label> element with a for attribute
Ctrl+Click (Windows/Linux) or Cmd+Click (Mac) on the attribute value
You'll jump directly to the element with the matching id

Example

<form>
    <label for="username">Username</label>
    <input id="username" type="text">
    
    <label for="password">Password</label>
    <input id="password" type="password">
</form>

Click on username or password in the for attributes to navigate to their corresponding inputs.

Multiple IDs in a Single Attribute

Attributes can also reference multiple space-separated IDs:

<output for="input1 input2">Total</output>

<input id="input1" type="number" value="10">
<input id="input2" type="number" value="20">

Click on any ID in the for attribute (e.g., input1 or input2) to jump to that specific element.

Requirements

Visual Studio Code version 1.60.0 or higher

Extension Settings

This extension works out of the box with no configuration required.

Current attributes supported: HTML standard attributes: for, list, usemap, form, contextmenu, popovertarget; ARIA attributes: aria-labelledby, aria-describedby, aria-controls, aria-owns, aria-flowto; Custom attributes: em-bower, be-decked-with, 😶‍🌫️, be-inclusive, 🥰, be-imbued, 🧧.

To add your additional custom attributes:

Open VS Code settings (Ctrl+,) Search for "idref" Click on the Add Item button.

Known Issues

Currently only supports navigation within the same file
Requires exact id match (case-sensitive)

Release Notes

0.0.1

Initial release:

Go to Definition support for HTML for, em-bower and be-decked-with attributes
Support for HTML, Vue, and Svelte files
Works with quoted and unquoted attribute values
Support for multiple space-separated IDs in a single attribute

Contributing

Found a bug or have a feature request? Please open an issue on our GitHub repository.

License

MIT

Enjoy faster HTML navigation!

idref

andersonbruceb