Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

stroke-dasharray — schema di tratteggiatura del contorno

La proprietà CSS stroke-dasharray definisce lo schema ripetuto di tratti e spazi lungo un contorno SVG. Ne controlla le lunghezze, mentre none ripristina un contorno continuo.

Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate; usage example verification passed

Sintassi

/* CSS Fill and Stroke Level 3: # denotes a comma-separated list. */
stroke-dasharray: none | <length-percentage>#;
/* SVG 2: none or a list of lengths, percentages, or unitless numbers. List items may be separated by commas, whitespace, or both. */
stroke-dasharray: 12px 8px;

stroke-dasharray controlla la tratteggiatura di forme e testo SVG, non i bordi CSS. È ereditata; il suo valore iniziale, none, indica un contorno continuo. Per vedere l’effetto, imposta uno stroke visibile e uno stroke-width positivo.

L’elenco inizia con la lunghezza di un tratto, seguita dalla lunghezza di uno spazio, e ripete questa sequenza. 12px 8px indica un tratto lungo 12 e uno spazio lungo 8. Un elenco con un numero dispari di elementi viene raddoppiato: 5 3 2 si comporta come 5 3 2 5 3 2. Lo schema riparte da capo in ogni sottotracciato.

SVG accetta numeri senza unità, lunghezze e percentuali, separati da spazi o virgole. I numeri senza unità rappresentano unità utente SVG. Le percentuali si riferiscono alla diagonale normalizzata dell’area di visualizzazione SVG, non alla lunghezza del tracciato. I valori negativi non sono validi; un elenco composto solo da zeri si comporta come none.

stroke-dashoffset sposta la posizione iniziale dello schema, mentre stroke-linecap cambia l’aspetto delle estremità dei tratti. L’esempio usa butt in modo che le estremità non allunghino i tratti visibili.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>stroke-dasharray</title>
<style>
  line {
    stroke: black;
    stroke-width: 4px;
    stroke-linecap: butt;
    stroke-dasharray: 12px 8px;
  }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="220" height="40" viewBox="0 0 220 40" role="img" aria-label="Dashed line">
  <line x1="10" y1="20" x2="210" y2="20" />
</svg>

Risultato

A horizontal black line with 10 dashes, each 12 units long, separated by 8-unit gaps; the final 8 units are also a gap.

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