Skip to content

Document CSS shape() relative control points and add related Fx146 rel notes#42132

Merged
chrisdavidmills merged 18 commits intomdn:mainfrom
chrisdavidmills:fx146-css-shape-curve-relative-control-points
Dec 3, 2025
Merged

Document CSS shape() relative control points and add related Fx146 rel notes#42132
chrisdavidmills merged 18 commits intomdn:mainfrom
chrisdavidmills:fx146-css-shape-curve-relative-control-points

Conversation

@chrisdavidmills
Copy link
Copy Markdown
Contributor

@chrisdavidmills chrisdavidmills commented Nov 26, 2025

Description

Firefox 146 adds support for CSS shape() relative control points, as used in <curve-command> and <smooth-command> commands, behind the layout.css.basic-shape-shape.enabled pref. See https://bugzilla.mozilla.org/show_bug.cgi?id=1921501, and in particular, this comment for some useful details.

This PR:

  • Adds entries to the Firefox 146 rel notes and Experimental features pages to detail the new availability.
  • Updates the shape() function reference page to improve the <curve-command> and <smooth-command> descriptions (making them easier to understand and adding details) and add some working examples.

Some notes:

  • I don't think we need to update the BCD. The Chromium and Safari data appears to be correct (they already support relative control points), and the Firefox data is also correct (it is all still supported only in preview, behind a pref, even though that support arrived in different versions). Let me know if you disagree.
  • Ideally, we should update this page to better organize the command descriptions and provide multiple examples of each of them in use. The function is really complex, so more guidance would be helpful. What I've done here is not perfect, but I think it does improve the coverage of the two commands in question, and allows me to link to them from the rel notes. I think a full page rewrite is out of scope for this PR.

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested review from a team as code owners November 26, 2025 16:34
@chrisdavidmills chrisdavidmills requested review from estelle and pepelsbey and removed request for a team November 26, 2025 16:34
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs Content:Firefox Content in the Mozilla/Firefox subtree size/m [PR only] 51-500 LoC changed labels Nov 26, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Nov 26, 2025 •
edited
Loading

Preview URLs

Flaws (181)

Note! 2 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/CSS/Reference/Values/basic-shape/shape
Title: shape()
Flaw count: 181

  • broken_links:
    • /en-US/docs/Web/CSS/fill-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_values_and_units/Value_definition_syntax#question_mark is a redirect
    • /en-US/docs/Web/CSS/CSS_values_and_units/Value_definition_syntax#hash_mark is a redirect
    • /en-US/docs/Web/CSS/CSS_values_and_units/Value_definition_syntax#single_bar is a redirect
    • /en-US/docs/Web/CSS/CSS_values_and_units/Value_definition_syntax#single_bar is a redirect
    • and 174 more flaws omitted
  • macros:
    • Macro produces link /en-US/docs/Web/CSS/position which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position which is a redirect
External URLs (2)

URL: /en-US/docs/Mozilla/Firefox/Experimental_features
Title: Experimental features in Firefox

(comment last updated: 2025-12-03 15:54:46)

@chrisdavidmills chrisdavidmills mentioned this pull request Nov 26, 2025
Closed
8 tasks
dipikabh
dipikabh requested changes Dec 2, 2025
View reviewed changes
Copy link
Copy Markdown
Contributor

@dipikabh dipikabh left a comment

Choose a reason for hiding this comment

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

Thanks a lot @chrisdavidmills! It's looking really good.
Added a few suggestions for clarifying and simplifying some text. I can take another look after your updates.

Agree - BCD looks good as is.

@github-actions github-actions bot added the merge conflicts 🚧 [PR only] label Dec 2, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Dec 2, 2025

This pull request has merge conflicts that must be resolved before it can be merged.

@github-actions github-actions bot removed the merge conflicts 🚧 [PR only] label Dec 3, 2025
@chrisdavidmills @github-actions
Update files/en-us/mozilla/firefox/releases/146/index.md
dd07115 
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
github-actions[bot]
github-actions bot reviewed Dec 3, 2025
View reviewed changes
chrisdavidmills and others added 8 commits December 3, 2025 12:27
@chrisdavidmills @dipikabh
Update files/en-us/mozilla/firefox/experimental_features/index.md
26e3506 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
9d63354 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
ca16203 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
4727e63 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
faa0521 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
d638192 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
1a927fb 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
4e54549 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
chrisdavidmills and others added 6 commits December 3, 2025 12:36
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
099304e 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
84803b3 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @dipikabh
Update files/en-us/web/css/reference/values/basic-shape/shape/index.md
b5e0b6c 
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
@chrisdavidmills @github-actions
Update files/en-us/mozilla/firefox/releases/146/index.md
584c713 
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@chrisdavidmills
Fixes for dipika review comments
16d8b93
@chrisdavidmills
Add note in about default relative setting
75e3db8
@dipikabh
Copy link
Copy Markdown
Contributor

dipikabh commented Dec 3, 2025

The updates are looking great, thanks a lot!

I have a tiny suggestion in #42132 (comment) but other than that, this is good to go.

@chrisdavidmills chrisdavidmills merged commit bb650d1 into mdn:main Dec 3, 2025
8 checks passed
@chrisdavidmills chrisdavidmills deleted the fx146-css-shape-curve-relative-control-points branch December 3, 2025 15:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@dipikabh dipikabh dipikabh approved these changes

@github-actions github-actions[bot] github-actions[bot] left review comments

Assignees

No one assigned

Labels

Content:CSS Cascading Style Sheets docs Content:Firefox Content in the Mozilla/Firefox subtree size/m [PR only] 51-500 LoC changed

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@chrisdavidmills @dipikabh @mdn-bot