[whatwg/dom] Definition of valid shadow elements is ambiguous (#745)

https://dom.spec.whatwg.org/#dom-element-attachshadow

Item 2 in the list says:
> If context object’s local name is _not_ a valid custom element name, "article", "aside", "blockquote", "body", "div", "footer", "h1", "h2", "h3", "h4", "h5", "h6", "header", "main" "nav", "p", "section", or "span", then throw a "NotSupportedError" DOMException. 

The above sentence is ambiguous. The enumeration can be read both as a list of valid names, or as a list of invalid names.  The sentence is also unnecessarily complex.  I would suggest:

If context object’s local name is _not_ a valid custom element name, then throw a "NotSupportedError" DOMException.  The only valid names are: "article", "aside", "blockquote", "body", "div", "footer", "h1", "h2", "h3", "h4", "h5", "h6", "header", "main" "nav", "p", "section", and "span".

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/dom/issues/745

Received on Monday, 1 April 2019 13:25:34 UTC