w3c / w3c/csswg-drafts

UA stylesheets in CSS specs cause interop issues

Open
#8,959 18 comments 7 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

HTML meta Needs Edits
Dominant language
Bikeshed
Stars
4.9k
Forks
816
PR merge metrics
PR metrics pending

Description

For the record, other UA stylesheets defined include:

Originally posted by @gsnedders in https://github.com/w3c/csswg-drafts/issues/8573#issuecomment-1466259733

In https://bugzilla.mozilla.org/show_bug.cgi?id=645642 match-parent was implemented in Gecko, and per https://bugzilla.mozilla.org/show_bug.cgi?id=645642#c14 the suggested UA stylesheet for option was implemented. But it was not implemented in WebKit or Chromium.

https://drafts.csswg.org/css-text/#default-stylesheet says

This appendix is informative, and is to help UA developers to implement a default stylesheet for HTML, but UA developers are free to ignore or modify as appropriate.

I do not find these optional UA stylesheets helpful at all, and would prefer if the UA stylesheet for HTML was left entirely to the HTML standard to define.

Maybe there are exceptional cases where a new feature isn't ready to be included in HTML's UA stylesheet. If you want to include example UA stylesheets, please say that they must not be implemented in UAs, so that they don't cause further interop issues.

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

Review the UA stylesheet sections linked in the issue, including CSS Color Adjustment, CSS Text, CSS Transforms, CSS UI, CSS Writing Modes, and CSS 2. Compare their guidance with the HTML UA stylesheet approach and the cited Gecko, WebKit, and Chromium context. Done means the affected specifications have an agreed, consistent policy that avoids creating interop discrepancies.

Written by the indexing model from the issue text.

Assessment

Tech stack
css
Domain
documentation, web-dev
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.