Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

ellipse() — geometria elíptica

`ellipse()` define uma forma básica com raios horizontal e vertical e uma posição central opcional relativa a uma caixa de referência.

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

Sintaxe

ellipse( <radial-size>? [ at <position> ]? )

ellipse() define uma forma básica com raios horizontal e vertical e uma posição central opcional relativa a uma caixa de referência.

O exemplo recorta um retângulo vermelho com ellipse(40px 20px at 50px 30px). A alfa no centro e imediatamente dentro dos raios é 255, enquanto fora de qualquer eixo é 0; ellipse(-1px 20px at center) é inválida devido ao raio negativo.

Gramática: ellipse( <radial-size>? [ at <position> ]? ).

A percentagem do raio horizontal resolve-se pela largura de <reference-box> e a vertical pela sua altura. Sem centro usa-se center e sem tamanho closest-side. Também são permitidos farthest-side, closest-corner e farthest-corner. A forma funciona em clip-path e shape-outside; um raio zero fá-la colapsar e os dois raios não são permutáveis numa caixa não quadrada.

Exemplos

const render=async()=>{
  const svg='<svg xmlns="http://www.w3.org/2000/svg" width="100" height="60"><foreignObject width="100" height="60"><div xmlns="http://www.w3.org/1999/xhtml" style="width:100px;height:60px;background:red;clip-path:ellipse(40px 20px at 50px 30px)"></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=100; canvas.height=60;
  const context=canvas.getContext('2d'); context.drawImage(image,0,0);
  const alpha=(x,y)=>context.getImageData(x,y,1,1).data[3];
  return [alpha(50,30),alpha(89,30),alpha(95,30),alpha(50,49),alpha(50,55)];
};
const alpha=await render();
const negativeRadius=CSS.supports('clip-path','ellipse(-1px 20px at center)');
console.log('center='+alpha[0]+'; horizontal-in/out='+alpha[1]+'/'+alpha[2]+'; vertical-in/out='+alpha[3]+'/'+alpha[4]+'; negative-radius='+negativeRadius);

Resultado

center=255; horizontal-in/out=243/0; vertical-in/out=255/0; negative-radius=false

`ellipse()` define uma forma básica com raios horizontal e vertical e uma posição central opcional relativa a uma caixa de referência.

Fontes