diff --git a/PlatformProvidedBehaviors/explainer.md b/PlatformProvidedBehaviors/explainer.md index fd359368..c437a341 100644 --- a/PlatformProvidedBehaviors/explainer.md +++ b/PlatformProvidedBehaviors/explainer.md @@ -10,26 +10,26 @@ ## Introduction -Custom element authors frequently need their elements to use platform behaviors that are currently exclusive to native HTML elements, such as [form submission](https://github.com/WICG/webcomponents/issues/814), [popover invocation](https://github.com/whatwg/html/issues/9110), [label behaviors](https://github.com/whatwg/html/issues/5423#issuecomment-1517653183), [form semantics](https://github.com/whatwg/html/issues/10220), and [radio button grouping](https://github.com/whatwg/html/issues/11061#issuecomment-3250415103). This proposal introduces platform-provided behaviors as a mechanism for autonomous custom elements to adopt specific native HTML element behaviors. Rather than requiring developers to reimplement native behaviors in JavaScript or extend native elements (customized built-ins), this approach exposes native capabilities as composable behaviors. +Custom element authors frequently need their elements to use platform capabilities that are currently exclusive to native HTML elements, such as [form submission](https://github.com/WICG/webcomponents/issues/814), [popover invocation](https://github.com/whatwg/html/issues/9110), [label association](https://github.com/whatwg/html/issues/5423#issuecomment-1517653183), [form semantics](https://github.com/whatwg/html/issues/10220), and [radio button grouping](https://github.com/whatwg/html/issues/11061#issuecomment-3250415103). This proposal introduces platform-provided behaviors as a mechanism for autonomous custom elements to adopt specific native HTML element capabilities. Rather than requiring developers to reimplement native functionality in JavaScript or extend native elements (customized built-ins), this approach exposes native capabilities as composable element behaviors. ## User-facing problem -Custom element authors can't access native behaviors that are built into native HTML elements. This forces them to either: +Custom element authors can't access native capabilities that are built into native HTML elements. This forces them to either: 1. Use customized built-ins (`is/extends` syntax), which have [Shadow DOM limitations](https://developer.mozilla.org/en-US/docs/Web/API/Element/attachShadow#elements_you_can_attach_a_shadow_to) and [can't use the ElementInternals API](https://github.com/whatwg/html/issues/5166). -2. Try to reimplement native logic in JavaScript, which is error-prone, often less performant, and cannot replicate certain platform-internal behaviors. +2. Try to reimplement native logic in JavaScript, which is error-prone, often less performant, and cannot replicate certain platform-internal functionality. 3. Accept that their custom elements simply can't do what native elements can do. This creates a gap between what's possible with native elements and custom elements, limiting web components and forcing developers into suboptimal patterns. ### Goals -- Establish an extensible framework for custom elements to adopt native behaviors for built in elements. +- Establish an extensible framework for custom elements to adopt native capabilities of built-in elements. - Enable autonomous custom elements to trigger form submission like `