Add the referencetarget feature #3376
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
github-actions
bot
added
feature definition
captainbrosset
changed the title
|
There are a few open issues that still need to be worked through, tracked from WICG/webcomponents#1086. |
dandclark
reviewed
Sep 24, 2025
| @@ -0,0 +1,8 @@ | |||
| name: Reference target | |||
| description: The `referenceTarget` property of a `ShadowRoot` object forwards attributes such as `for` and `aria-labelledby` to elements inside a shadow DOM. This allows, for example, to link a `<label>` to its `<input>` even if the `<input>` is in the shadow DOM of a web component. | |||
| spec: https://github.com/WICG/webcomponents/blob/gh-pages/proposals/reference-target-explainer.md | |||
There was a problem hiding this comment.
Not sure if it's customary to link in-progress spec PRs for features in development, but if those are allowed here then these are the best spec links for the feature for now:
whatwg/html#10995
whatwg/dom#1353
14 tasks
ddbeck
reviewed
Oct 14, 2025
| @@ -0,0 +1,8 @@ | |||
| name: Reference target | |||
| description: The `referenceTarget` property of a `ShadowRoot` object forwards attributes such as `for` and `aria-labelledby` to elements inside a shadow DOM. This allows, for example, to link a `<label>` to its `<input>` even if the `<input>` is in the shadow DOM of a web component. | |||
There was a problem hiding this comment.
Suggested change
| description: The `referenceTarget` property of a `ShadowRoot` object forwards attributes such as `for` and `aria-labelledby` to elements inside a shadow DOM. This allows, for example, to link a `<label>` to its `<input>` even if the `<input>` is in the shadow DOM of a web component. | |
| description: The `referenceTarget` property of a `ShadowRoot` object forwards attributes such as `for` and `aria-labelledby` to elements inside a shadow DOM. You can use this to, for example, link a `<label>` to its `<input>` even if the `<input>` is in the shadow DOM of a web component. |
Comment on lines
+6
to
+8
| # No BCD keys yet as the feature hasn't shipped anywhere. | ||
| # It's being implemented in Chromium, and has gone through an origin trial in 133-135: | ||
| # https://chromestatus.com/feature/5188237101891584 |
There was a problem hiding this comment.
In lieu of "no BCD" comments, I think it would be nice if we started listing predicted BCD keys. So in this case, something like:
Suggested change
| # No BCD keys yet as the feature hasn't shipped anywhere. | |
| # It's being implemented in Chromium, and has gone through an origin trial in 133-135: | |
| # https://chromestatus.com/feature/5188237101891584 | |
| # Expected keys via Chrome origin trial in 133-135 https://chromestatus.com/feature/5188237101891584 | |
| # api.Element.attachShadow.options_referenceTarget_parameter |
and so on
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fixes #2309.
This is a pretty pivotal feature for web components, as it allows to correctly map IDREF attributes to things inside the shadow DOM, without breaking encapsulation.
It's apparently been through an origin trial in Chromium, but I'm not sure what the plans are when it comes to shipping.
@dandclark can you share any plans on the above?
It's been proposed for Interop 26: web-platform-tests/interop#1011