Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

clip-rule — regola per l’interno di un’area di ritaglio SVG

clip-rule determina quali parti di una forma SVG composta appartengono a un’area di ritaglio. I valori nonzero ed evenodd differiscono nel modo in cui trattano le intersezioni e i sottotracciati annidati.

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

Sintassi

clip-rule: nonzero | evenodd;

clip-rule si applica agli elementi grafici all’interno di clipPath, non all’elemento che vi fa riferimento tramite clip-path. La proprietà è ereditata; il suo valore iniziale è nonzero e la sua animazione è discreta.

nonzero somma gli attraversamenti di un raggio che parte dal punto esaminato, tenendo conto della direzione di ciascun attraversamento: una somma diversa da zero significa che il punto è all’interno. evenodd conta gli attraversamenti senza considerarne la direzione: un numero dispari significa che il punto è all’interno. Di conseguenza, sottotracciati annidati con la stessa direzione di percorrenza creano un foro con evenodd, ma non con nonzero.

fill-rule controlla l’interno del riempimento; clip-rule controlla l’interno dell’area di ritaglio. clip-rule non si applica ai valori CSS <basic-shape>, come polygon().

Nell’esempio, la regola è impostata sul path che definisce l’area di ritaglio. Il risultato atteso è una cornice blu con il centro bianco; passando a nonzero si rimuove il foro.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti