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

CKTIS / CSS

clip-rule — regra do interior de uma região de recorte SVG

clip-rule determina que partes de uma forma SVG composta pertencem a uma região de recorte. Os valores nonzero e evenodd diferem na forma como tratam as intersecções e os subcaminhos aninhados.

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

Sintaxe

clip-rule: nonzero | evenodd;

clip-rule aplica-se aos elementos gráficos dentro de clipPath, e não ao elemento que lhe faz referência através de clip-path. A propriedade é herdada; o seu valor inicial é nonzero e a sua animação é discreta.

nonzero soma os cruzamentos de um raio que parte do ponto examinado, tendo em conta a direção de cada cruzamento: uma soma diferente de zero significa que o ponto está no interior. evenodd conta os cruzamentos sem ter em conta a direção: um número ímpar significa que o ponto está no interior. Assim, subcaminhos aninhados com a mesma direção de percurso criam um orifício com evenodd, mas não com nonzero.

fill-rule controla o interior do preenchimento; clip-rule controla o interior da região de recorte. clip-rule não se aplica a valores CSS <basic-shape>, como polygon().

No exemplo, a regra é definida no path que define a região de recorte. O resultado esperado é uma moldura azul com o centro branco; mudar para nonzero remove o orifício.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>clip-rule</title>
<style>
  #cutout { clip-rule: evenodd; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="120" height="120" viewBox="0 0 120 120">
  <defs>
    <clipPath id="window">
      <path id="cutout" d="M10 10H110V110H10Z M40 40H80V80H40Z"/>
    </clipPath>
  </defs>
  <rect width="120" height="120" fill="white"/>
  <rect width="120" height="120" fill="royalblue" clip-path="url(#window)"/>
</svg>

Resultado

Expected: a royalblue square frame on white, with outer bounds (10, 10)–(110, 110) and a white central opening (40, 40)–(80, 80).

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes