Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / CSS

xywh() — rectangle from position, width, and height

`xywh()` creates a `<basic-shape>` from a top-left offset and explicit size, for example for `clip-path`.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

xywh( <length-percentage>{2} <length-percentage [0,∞]>{2} [ round <'border-radius'> ]? )

xywh() creates a <basic-shape> from a top-left offset and explicit size, for example for clip-path.

xywh(20% 10px 50% 60px round 10px) at 100 px width yields inside/outside/rounded-corner alpha 255/0/0, and at 200 px 255/0/0. Negative-width xywh(10px 10px -1px 20px) reports support false.

Grammar: xywh( <length-percentage>{2} <length-percentage [0,∞]>{2} [ round <'border-radius'> ]? ).

The four components are x, y, width, and height; horizontal percentages use the reference box width and vertical percentages its height. Sizes must be non-negative, although the position can lie outside the box. round accepts the full border-radius syntax, with oversized radii proportionally reduced. The shape can also serve shape-outside.

Examples

const render=async(width,points)=>{const value='xywh(20% 10px 50% 60px round 10px)';const svg='<svg xmlns="http://www.w3.org/2000/svg" width="'+width+'" height="100"><foreignObject width="'+width+'" height="100"><div xmlns="http://www.w3.org/1999/xhtml" style="width:'+width+'px;height:100px;background:green;clip-path:'+value+'"></div></foreignObject></svg>';const image=new Image();image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(svg);await image.decode();const canvas=document.createElement('canvas');canvas.width=width;canvas.height=100;const context=canvas.getContext('2d');context.drawImage(image,0,0);return points.map(([x,y])=>context.getImageData(x,y,1,1).data[3])};
const small=await render(100,[[30,30],[75,40],[20,10]]);const wide=await render(200,[[60,30],[150,40],[40,10]]);
const negative=CSS.supports('clip-path','xywh(10px 10px -1px 20px)');
console.log('100-in/out/corner='+small.join('/')+'; 200-in/out/corner='+wide.join('/')+'; negative-width='+negative);

Result

100-in/out/corner=255/0/0; 200-in/out/corner=255/0/0; negative-width=false

`xywh()` creates a `<basic-shape>` from a top-left offset and explicit size, for example for `clip-path`.

Sources