12k
All articles

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.

OpenReplay Team
OpenReplay Team
Squircles e chanfros com CSS corner-shape

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-shape só tem efeito quando o border-radius resulta em um valor diferente de zero, e seu valor inicial, round, desenha o mesmo canto que o border-radius desenha sozinho.
  • Cada palavra-chave é um valor superellipse() nomeado: square é infinity, squircle é 2, round é 1, bevel é 0, scoop é -1 e notch é -infinity.
  • Bordas, outlines, box shadows e fundos acompanham o canto remodelado. O clip-path se 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-shape a 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-chaveEquivalente em superellipse()Aparência do canto
squaresuperellipse(infinity)Um ângulo reto e vivo
squirclesuperellipse(2)Uma curva suave, mais quadrada que a arredondada
roundsuperellipse(1)O arco elíptico padrão
bevelsuperellipse(0)Um corte diagonal reto
scoopsuperellipse(-1)Um arco côncavo
notchsuperellipse(-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-radius que resulta em 0 faz com que o corner-shape nã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-shape não tem efeito quando border-shape está 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.

Open-source session replay

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

We use cookies to improve your experience. By using our site, you accept cookies.