Skip to content

Update shape() CSS function description #1266

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
captainbrosset wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Update shape() CSS function description #1266

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
70b9b91
Update shape() CSS function description
captainbrosset Mar 3, 2026
f62dd47
Apply suggestion from @captainbrosset
captainbrosset Mar 3, 2026
7d09833
Apply suggestion from @captainbrosset
captainbrosset Mar 3, 2026
c05628d
Apply suggestion from @captainbrosset
captainbrosset Jul 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion 2026/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -260,7 +260,7 @@ CSS scroll snap controls the panning and scrolling behavior within a scroll cont

### CSS shape()

@yisibl yisibl May 8, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Since the content below has been revised, how about changing the title to “CSS <basic-shape>”?
https://drafts.csswg.org/css-shapes/#typedef-basic-shape

@captainbrosset captainbrosset Jul 1, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The angle brackets might be a little confusing to developers. I know this is how the spec documents it, and even MDN has CSS types pages that uses angle brackets, but I still don't think developers are familiar with these in CSS.

How about this:

Suggested change
### CSS shape()
### CSS shape functions


The `shape()` CSS function creates shapes with a series of commands like line, move, and curve. It can be used with `clip-path` and `shape-outside`.
The `inset()`, `rect()`, `xywh()`, `circle()`, `ellipse()`, `polygon()`, `path()`, and `shape()` CSS functions create shapes for use with `clip-path` and `shape-outside`.

#### Resources

Expand Down