mdn / mdn/content

Document scopedcustomelementregistry and its HTMLElement reflection

Open
#45,383 1 comment 0 reactions 0 assignees View on GitHub
area: Web Components Content:WebAPI waiting for implementations
Dominant language
Markdown
Stars
11k
Forks
23.2k
Avg merge
2d 9h
Merged PRs (30d)
331

Description

### MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/CustomElementRegistry

### What information is incomplete?

The HTML Standard is adding the `scopedcustomelementregistry` global content attribute and the reflecting `HTMLElement.scopedCustomElementRegistry` IDL attribute.

The content attribute affects HTML parser creation: the element and its parsed subtree begin with a null custom element registry so a scoped `CustomElementRegistry` can claim the subtree later through `initialize()`. Changing the attribute after element creation does not change the assigned registry. The IDL attribute reflects as a `DOMString` for future extensibility.

### What should be documented?

- The `scopedcustomelementregistry` global attribute.
- `HTMLElement.scopedCustomElementRegistry` string reflection.
- Parser-only behavior and the relationship to `CustomElementRegistry.initialize()`.
- Serialization behavior at custom element registry boundaries.
- Browser compatibility once implementations adopt the final specification.

### References

- HTML specification PR: https://github.com/whatwg/html/pull/12000
- DOM infrastructure PR: https://github.com/whatwg/dom/pull/1500
- Web Platform Tests PR: https://github.com/web-platform-tests/wpt/pull/62206

Contributor guide

Open the contributing guide

Research direction

Start with the MDN CustomElementRegistry page and compare the requested behavior with the linked HTML, DOM, and Web Platform Tests pull requests. Document the global attribute, HTMLElement.scopedCustomElementRegistry reflection, parser-only behavior, initialize() relationship, and serialization boundaries. Finish by adding browser compatibility information once implementations adopt the final specification.

Written by the indexing model from the issue text.

Assessment

Tech stack
html, javascript
Domain
documentation, web-dev
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.