w3c / w3c/csswg-drafts

[css-shadow] Confusing spec naming

Open
#13,360 3 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

css-shadow-1
Dominant language
Bikeshed
Stars
4.9k
Forks
816
PR merge metrics
PR metrics pending

Description

The CSSWG, on 2 September 2021, resolved on #5809 as follows:

astearns: What should we rename scoping to?
css-shadow-dom
TabAtkins: Have shadow-parts. maybe just shadow? Shadow-dom?
fantasai: I would go with css-shadow. Clarify in title
fantasai: Should shadow-parts merge in?
TabAtkins: If this became a shadow spec, yeah
astearns: css-shadow styling spec for both
fantasai: CSS Shadow DOM Integration or something like that. not styling the shadows
TabAtkins: Shortname is what'simportant. shadow or shadow-dom
fantasai: css-shadow
astearns: Other opinions?
astearns: prop: Take css-shadow-parts and css-scoping drafts, integrate, adn republish as css-shadow
astearns: Obj?
RESOLVED: Take css-shadow-parts and css-scoping drafts, integrate, and republish as css-shadow

Originally, #6370 was about updating css-scoping. This has been prepared in #13333 together with the merger.

In that editorial issue, I questioned the naming choice. Since @SebastianZ suggested this should be discussed in a separate issue, I’m just copying my remarks from there:

I find the name chosen for this CSS module most unfortunate! CSS has text shadows and box shadows (with several properties and grammar productions named accordingly), as well as a drop-shadow() filter function. Confusingly, this "CSS Shadow Module" is not about any of these styling-related topics. Instead, the module is about a DOM concept and, accordingly, it does not introduce any new properties or values to CSS, just several selectors (i.e. pseudo-classes :host, :host(), :host-context() and :has-slotted and functional pseudo-elements ::slotted() and ::part(), as of writing this comment) and even generic(?) host document attributes (part and exportparts), which surely should be something left to the respective document language standards like HTML and SVG, or perhaps to the specification of the DOM . A previous WD had introduced a ::shadow pseudo-element, but that is apparently gone for good (or just for now?).

Before advancing this ED to WD, I would therefore strongly suggest the CSSWG reconsidered the (full and short) name and the scope of this specification.
From the little I understand of the topic and inspired by the precedence set by “Non-element Selectors” selectors-nonelement, I offer the suggestions “Component Selectors” selectors-component, “Hosted Selectors” selectors-hosted, “Scoped Selectors” selectors-scoped or, if you really must, “Shadow Selectors” selectors-shadow.

PS: The original, seemingly brief discussion mentions css-shadow-dom and “CSS Shadow DOM Integration” as alternatives.

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.

Research direction

Start by reading the CSSWG resolution in #5809 and the related editorial work in #13333, then compare the css-scoping and css-shadow-parts drafts. Done would require an agreed full name, shortname, and specification scope, with the merged draft reflecting that decision consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
css
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.