Squircles e chanfros com CSS corner-shape
Use CSS corner-shape para criar squircles, chanfros e recortes côncavos. Veja a sintaxe, o controle por canto, sombras, animações e suporte dos navegadores.
A propriedade CSS corner-shape altera a curva de um canto sem alterar o seu tamanho. O border-radius continua definindo até onde o canto se estende ao longo de cada lado, e o corner-shape escolhe o traçado que o contorno segue dentro dessa área.
Durante anos, uma tag chanfrada exigia escrever à mão as coordenadas de um polígono com clip-path, e um canto suave no estilo de ícone de app exigia recorrer a uma máscara SVG. As duas gambiarras costumam falhar no mesmo ponto: a sombra da caixa, que acaba cortada ou precisa ser simulada.
Este artigo aborda a sintaxe, o que cada palavra-chave desenha, como definir formas por canto, por que as sombras se comportam melhor do que com clip-path, como animar entre formas e quando é necessário um fallback.
Principais pontos
- O
corner-shapesó tem efeito quando oborder-radiusresulta em um valor diferente de zero, e seu valor inicial,round, desenha o mesmo canto que oborder-radiusdesenha sozinho. - Cada palavra-chave é um valor
superellipse()nomeado:squareéinfinity,squircleé2,roundé1,bevelé0,scoopé-1enotché-infinity. - Bordas, outlines, box shadows e fundos acompanham o canto remodelado. O
clip-pathse comporta de outra forma e corta a sombra junto com tudo o que estiver fora da região de recorte. - Chrome e Edge oferecem o
corner-shapea partir da versão 139. No Firefox e no Safari, ele só está disponível nas builds Nightly, Technology Preview e beta, portanto o recurso ainda não é Baseline.
O que o CSS corner-shape faz
O corner-shape remodela a área que o border-radius reserva em cada canto. Sem raio, não há o que remodelar. A referência de border-radius do MDN reforça esse ponto com um exemplo: um canto com border-radius igual a 0 não recebe nenhuma forma de canto.
Pense no border-radius e no corner-shape como dois controles separados. border-radius: 2rem reserva uma região de 2rem no canto. O corner-shape decide se o contorno atravessa essa região como uma curva, um corte reto ou uma concavidade para dentro. Segundo a referência de corner-shape do MDN, todas as longhands de canto começam em round, então adicionar a propriedade não muda nada até você definir um valor.
As seis palavras-chave e o superellipse()
Toda palavra-chave do corner-shape é um atalho para um valor superellipse(). Argumentos positivos se projetam para fora e ficam mais quadrados à medida que o número aumenta. Zero desenha uma diagonal reta entre as duas extremidades do raio. Argumentos negativos se curvam para dentro, em direção ao centro da caixa. A página de <corner-shape-value> no MDN define squircle como uma curva convexa entre o arredondado e o quadrado, equivalente a superellipse(2), e bevel como uma diagonal reta que não é convexa nem côncava, equivalente a superellipse(0).
| Palavra-chave | Equivalente em superellipse() | Aparência do canto |
|---|---|---|
square | superellipse(infinity) | Um ângulo reto e vivo |
squircle | superellipse(2) | Uma curva suave, mais quadrada que a arredondada |
round | superellipse(1) | O arco elíptico padrão |
bevel | superellipse(0) | Um corte diagonal reto |
scoop | superellipse(-1) | Um arco côncavo |
notch | superellipse(-infinity) | Um recorte quadrado para dentro |
A gramática do rascunho do CSS Borders and Box Decorations Level 4 aceita um único argumento: um número, infinity ou -infinity, como também mostra a referência de corner-start-start-shape no MDN. Para comparar as seis lado a lado, aplique-as em seis cards irmãos:
.shapes { display: grid; grid-template-columns: repeat(3, 8rem); gap: 1rem; }
.shapes > * {
aspect-ratio: 1;
background: #4f46e5;
border-radius: 2rem;
}
.shapes > :nth-child(1) { corner-shape: square; }
.shapes > :nth-child(2) { corner-shape: squircle; }
.shapes > :nth-child(3) { corner-shape: round; }
.shapes > :nth-child(4) { corner-shape: bevel; }
.shapes > :nth-child(5) { corner-shape: scoop; }
.shapes > :nth-child(6) { corner-shape: notch; }
Por que o border-radius não consegue desenhar um squircle
O border-radius só desenha arcos elípticos, então a curvatura muda de forma abrupta no ponto em que o canto encontra o lado reto. O corner-shape: squircle substitui esse arco por uma superelipse que se afasta do lado de maneira mais gradual. O resultado é o canto mais suave, comum em ícones de apps modernos.
.icon { width: 6rem; aspect-ratio: 1; border-radius: 30%; background: #0ea5e9; }
.icon.smooth { corner-shape: squircle; } /* same as superellipse(2) */
Com o mesmo raio, um squircle parece menos arredondado que o round, porque um valor de superelipse mais alto fica mais próximo do quadrado. Se o canto parecer fechado demais, aumente o raio antes de partir para um valor superellipse() personalizado.
Formas por canto com sintaxe de múltiplos valores e longhands
O corner-shape aceita de um a quatro valores, na mesma ordem de cantos do border-radius. Um valor define os quatro cantos. Com dois valores, o primeiro define o canto superior esquerdo e o inferior direito, e o segundo define o superior direito e o inferior esquerdo. Com quatro valores, a ordem segue no sentido horário a partir do canto superior esquerdo. Para um controle mais refinado, o MDN lista longhands físicas, como corner-top-left-shape, longhands lógicas, como corner-start-start-shape, e shorthands de lado, como corner-top-shape e corner-inline-start-shape.
Para um chip de breadcrumb que aponta de volta para o início da linha, use a shorthand lógica de lado para que o chanfro se inverta em textos da direita para a esquerda. A corner-inline-start-shape define os dois cantos do lado inline-start, que são corner-start-start-shape e corner-end-start-shape.
.crumb {
border-radius: 0.75rem;
corner-inline-start-shape: bevel; /* LTR: same as corner-shape: bevel round round bevel */
padding-inline: 1.25rem 0.75rem;
}
O padding extra no início de .crumb tem um motivo. O corner-shape altera a forma como a caixa é pintada, não a forma como o conteúdo é disposto no layout. Textos e elementos filhos continuam posicionados na caixa retangular e podem invadir um canto chanfrado ou côncavo, a menos que o padding os mantenha afastados.
Bordas e box-shadow acompanham a forma
O corner-shape remodela a própria caixa, então a sombra, a borda, o outline e o fundo acompanham o novo canto. O clip-path, por outro lado, corta tudo o que está fora da região de recorte, inclusive o box-shadow. Segundo o MDN, a forma do canto também se aplica ao recorte de overflow e ao backdrop-filter.
/* Before: clip-path removes the shadow along with the cut corners */
.ticket-clip {
--cut: 1rem;
box-shadow: 0 8px 24px rgb(0 0 0 / .25);
clip-path: polygon(0 0, calc(100% - var(--cut)) 0, 100% var(--cut),
100% 100%, var(--cut) 100%, 0 calc(100% - var(--cut)));
}
/* After: shadow, border and outline trace the bevel */
.ticket {
border-radius: 1rem;
corner-shape: square bevel; /* TL+BR square, TR+BL bevelled */
border: 2px solid #f59e0b;
box-shadow: 0 8px 24px rgb(0 0 0 / .25);
}
A gambiarra habitual com clip-path é envolver o elemento em um wrapper e aplicar filter: drop-shadow() nele. O corner-shape dispensa tanto o wrapper quanto o filtro. O clip-path continua sendo a ferramenta certa para contornos arbitrários, como mostram os artigos getting creative with CSS shape functions e drawing layout-friendly shapes with xywh().
Animando entre formas no hover
O corner-shape é animável, então uma transition comum consegue transformar uma forma em outra. O MDN observa que as animações interpolam pelos equivalentes em superellipse(), o que permite que as palavras-chave façam transições suaves entre si.
.btn {
border-radius: 1rem;
corner-shape: squircle;
transition: corner-shape 250ms ease;
}
.btn:hover, .btn:focus-visible { corner-shape: bevel; }
@media (prefers-reduced-motion: reduce) {
.btn { transition: none; }
}
Evite criar designs que dependam dos frames intermediários exatos de uma transição de corner-shape. As notas do Technology Preview 252 do WebKit mencionam uma correção que alinha a interpolação de curvas convexas ao algoritmo atualizado da especificação, o que significa que os frames intermediários ainda podem variar entre engines.
Fallback com @supports (corner-shape: squircle)
Navegadores sem suporte a corner-shape ignoram a declaração e desenham cantos arredondados comuns a partir do border-radius existente. Assim, um card com squircle ou um chanfro suave volta a ser um retângulo arredondado normal, e a maioria dos casos de uso não exige nenhum código extra.
O Chrome adicionou a propriedade no Chrome 139, e o Edge a suporta a partir da mesma versão. O Firefox a suporta apenas nas builds Nightly, a partir da 158, de acordo com as notas de versão do Firefox Nightly. O Safari adicionou suporte no Technology Preview 251, e as notas de versão do Safari 27.3 beta também a listam, mas ela ainda não está em uma versão estável do Safari. O MDN classifica o recurso como Limited availability, então consulte a tabela de compatibilidade antes de colocá-lo em produção.
O fallback deixa de ser aceitável quando a forma depende do próprio corner-shape. Um raio grande combinado com bevel cria um losango nos navegadores com suporte, mas um navegador sem suporte renderiza o mesmo raio como uma elipse. Nesse caso, condicione o raio grande ao @supports:
.badge { border-radius: 0.5rem; }
@supports (corner-shape: bevel) {
.badge { border-radius: 50%; corner-shape: bevel; }
}
Alguns casos em que a propriedade não faz o que você talvez espere:
- Um
border-radiusque resulta em 0 faz com que ocorner-shapenão tenha efeito. - O conteúdo continua retangular. Use padding para afastá-lo de cantos chanfrados ou côncavos.
- Quando as formas de cantos opostos se sobrepõem, o MDN documenta que o navegador as restringe.
- Segundo o MDN, o
corner-shapenão tem efeito quandoborder-shapeestá definido.
Conclusão
O corner-shape transforma o border-radius em um controle de duas partes: o raio define o tamanho do canto e a palavra-chave define sua curva. Como navegadores sem suporte voltam a exibir cantos arredondados simples, squircles e chanfros suaves já podem ser adicionados com segurança a componentes existentes. Reserve o @supports para designs em que o próprio contorno, como um losango ou um badge com recorte, se transformaria em uma elipse sem a propriedade. Uma boa primeira mudança é adicionar corner-shape: squircle a um card ou ícone que já usa border-radius e compará-lo com o original.
Perguntas frequentes
Posso usar valores de superellipse() diferentes dos seis equivalentes das palavras-chave?
Sim. O superellipse() aceita qualquer número, além de infinity e -infinity. superellipse(0.5) desenha uma curva entre bevel e round, superellipse(1.5) fica entre round e squircle, e valores como -2 ou -3 geram concavidades mais profundas. O mesmo valor pode parecer diferente em dois elementos se o tamanho da caixa ou o border-radius forem diferentes, porque a forma é desenhada dentro da região de raio de cada elemento.
O corner-shape funciona com valores de border-radius elípticos ou em porcentagem?
Sim. O corner-shape desenha sua curva dentro de qualquer região que o border-radius calcule para cada canto, incluindo raios em porcentagem e raios elípticos definidos com a sintaxe de barra, como border-radius: 2rem / 1rem. Um bevel em um raio elíptico vira um corte diagonal mais longo e menos inclinado. Um squircle em um raio elíptico vira uma superelipse esticada, então alterar o raio altera as proporções da forma.
Como recortar uma imagem ou um elemento filho no formato de um card com squircle ou chanfro?
Defina overflow: hidden ou overflow: clip no card. O MDN inclui o recorte de overflow entre os itens que acompanham a forma do canto, então o conteúdo filho é recortado no formato do squircle ou do chanfro, e não do retângulo. Sem o recorte de overflow, os filhos são pintados na caixa retangular e podem aparecer nos cantos cortados. O corner-shape não é herdado, então os filhos nunca assumem a forma do elemento pai automaticamente.
Complete picture for complete understanding
Capture every clue your frontend is leaving so you can instantly get to the root cause of any issue with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data.
Star on GitHub12k