[selectors-4] Clarify the value range of pseudo selectors

Open
#11,299 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
55/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
css
Domain
documentation

Research direction

Locate the source for § Grammar and review the linked sections on pseudo-elements, invalid selectors, partial implementations, and Web Compat. Add a clarifying note covering the intended open value range and invalid unsupported pseudos, then build the specification and check that the links and wording render correctly.

Written by the indexing model from the issue text.

Description

selectors-4

§ Grammar defines pseudos with a relatively open range of values that does not come with any restriction, at least not within reasonable reading proximity.

§ Pseudo-elements says that pseudos are defined by CSS specifications and the host language.

§ Invalid Selectors says that UAs must treat as invalid any pseudos for which they have no usable level of support. But in a non-normative note, as reported in #8305. § Appendix B: [...] Web Compat adds an exception: UAs must support ::webkit-unknown even if they have no support for it.

A note similar to the one below could be added in § Grammar:

The <pseudo-element-selector> and <pseudo-class-selector> productions are intentionally open to represent any pseudo-class and pseudo-element defined in CSS specifications or by the host language, that is supported by the UA. As per Patial implementations, other pseudos are otherwise invalid, unless otherwise specified (like in § Appendix B: [...] Web Compat).

Dominant language
Bikeshed
Stars
4.9k
Forks
816
Avg merge
2d 18h
Merged PRs (30d)
24

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from w3c/csswg-drafts

All issues in w3c/csswg-drafts

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.