CKTIS / CSS
circle() — forma básica circular
`circle()` descreve um círculo com um único raio e um centro opcional após `at`, resolvidos no sistema de coordenadas da 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
circle( <radial-size>? [ at <position> ]? )circle() descreve um círculo com um único raio e um centro opcional após at, resolvidos no sistema de coordenadas da caixa de referência.
O exemplo usa clip-path: circle(30px at 40px 50px) numa caixa de 120 por 100 píxeis. O teste de acerto aceita o centro e um ponto a 29px, mas rejeita outro a 31px e o canto — geometria observável de um recorte real.
Gramática: circle( <radial-size>? [ at <position> ]? ).
O raio aceita um <length-percentage> ou uma das quatro palavras-chave closest-side, farthest-side, closest-corner e farthest-corner; dois raios são inválidos. Um raio percentual é relativo ao tamanho independente da direção da caixa de referência, isto é, ao comprimento da diagonal dividido pela raiz quadrada de dois. Sem raio usa-se closest-side, e sem posição center. Em shape-outside a forma altera a área de contorno de um flutuante; em clip-path restringe a pintura e a deteção do ponteiro ao interior do círculo.
Exemplos
const box=document.createElement('div');document.body.append(box);box.style.cssText='position:absolute;left:20px;top:20px;width:120px;height:100px;background:black;clip-path:circle(30px at 40px 50px)';const rect=box.getBoundingClientRect(),computed=getComputedStyle(box).clipPath;const hit=(x,y)=>document.elementFromPoint(rect.left+x,rect.top+y)===box;const center=hit(40,50),inside=hit(69,50),outside=hit(71,50),corner=hit(0,0);if(computed!=='circle(30px at 40px 50px)'||!center||!inside||outside||corner)throw new Error('circle geometry/hit-test mismatch: '+[computed,center,inside,outside,corner]);console.log('computed='+computed+'; center='+center+'; r29='+inside+'; r31='+outside+'; corner='+corner);Resultado
computed=circle(30px at 40px 50px); center=true; r29=true; r31=false; corner=false
`circle()` descreve um círculo com um único raio e um centro opcional após `at`, resolvidos no sistema de coordenadas da caixa de referência.