Skip to content

Ff154 css typed OM cleanup - #44945

Merged
hamishwillee merged 7 commits into
mdn:mainfrom
hamishwillee:ff154_css_typed_om_cleanup
Jul 31, 2026
Merged

Ff154 css typed OM cleanup#44945
hamishwillee merged 7 commits into
mdn:mainfrom
hamishwillee:ff154_css_typed_om_cleanup

Conversation

@hamishwillee

Copy link
Copy Markdown
Collaborator

FF154 adds preview support for the CSS Typed OM API. This is an initial fix to the docs in preparation for more thorough docs afterwards.

The fixes are done three commits.

  • The first adds a missing method: CSSStyleValue.toString() - that's the only strict content addition.
  • The second updates the groupdata to add ALL the interfaces defined in the spec https://drafts.css-houdini.org/css-typed-om/ and to remove those that were in the Houdini APIs section. The Houdini APIs is a superset of the CSS Typed OM - its a project that defines a number of specs. MDN doesn't document APIs in that way so I've pulled out the interfaces where they belong. More tidy to do there.
  • The last one fixes up the sidebar macro on most of the docs, which were wrong. It also fixes any odd line breaks, and adds a Basic usage heading for examples. That can be treated more or less as a layout only review.

There is a lot more to do. The entry point for the API doc is out of date, and so on. Many of the docs have "to do" in examples. This is just to get the basics ready for a more thorough look.

Related docs can be tracked in #44849

@hamishwillee
hamishwillee requested review from a team as code owners July 28, 2026 08:04
@hamishwillee
hamishwillee requested review from dipikabh and sideshowbarker and removed request for a team July 28, 2026 08:04
@hamishwillee hamishwillee changed the title Ff154 css typed om cleanup Ff154 css typed OM cleanup Jul 28, 2026
@github-actions github-actions Bot added Content:WebAPI Web API docs size/l [PR only] 501-1000 LoC changed labels Jul 28, 2026
@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor
Preview URLs (114 pages)

(comment last updated: 2026-07-31 02:24:08)

@dipikabh dipikabh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, Hamish! Your updates look good overall.

I've added minor edit suggestions, mostly around adding/removing commas, "that" vs. "which"...tidying up as we go since you're already touching these lines to fix the line breaks.

And there's also a few specific comments in CSSStyleValue.toString().

Comment thread files/en-us/web/api/cssmathmin/cssmathmin/index.md Outdated
Comment thread files/en-us/web/api/cssmathnegate/value/index.md Outdated
Comment thread files/en-us/web/api/cssmathproduct/cssmathproduct/index.md Outdated
Comment thread files/en-us/web/api/cssmathsum/cssmathsum/index.md Outdated
Comment thread files/en-us/web/api/cssmathsum/values/index.md Outdated
Comment thread files/en-us/web/api/stylepropertymapreadonly/foreach/index.md Outdated
Comment thread files/en-us/web/api/stylepropertymapreadonly/get/index.md Outdated
Comment thread files/en-us/web/api/stylepropertymapreadonly/getall/index.md Outdated
Comment thread files/en-us/web/api/stylepropertymapreadonly/keys/index.md Outdated
Comment thread files/en-us/web/api/stylepropertymapreadonly/values/index.md Outdated
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
Co-authored-by: Hamish Willee <hamishwillee@gmail.com>
Comment thread files/en-us/web/api/stylepropertymapreadonly/get/index.md Outdated
@hamishwillee

hamishwillee commented Jul 31, 2026

Copy link
Copy Markdown
Collaborator Author

Thanks for the review @dipikabh ! Agree a good opportunity to fix these up - and I'm glad you did it because your grammar is better than mine. I've also tidied up toString(), hopefully to your satisfaction - if not, I'll be back here to continue the work :-).

Much appreciated.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@hamishwillee
hamishwillee merged commit ebb9a64 into mdn:main Jul 31, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/l [PR only] 501-1000 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants