Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

stroke-dashoffset — posunutí vzoru čárek

Vlastnost stroke-dashoffset určuje, ve kterém místě opakujícího se vzoru čárek a mezer začíná obrys SVG. Mění fázi vzoru, nikoli polohu nebo délku cesty.

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

Syntaxe

stroke-dashoffset: <length-percentage>;
/* SVG 2 also permits <number>. */
stroke-dashoffset: 0;
stroke-dashoffset: 10px;
stroke-dashoffset: -10px;
stroke-dashoffset: 5%;

stroke-dashoffset určuje vzdálenost od začátku opakujícího se vzoru definovaného pomocí stroke-dasharray, ve které začíná čárkování cesty. Počáteční hodnota je 0; vlastnost se dědí a vztahuje se na obrysy tvarů SVG a textu. Bez vzoru čárek nemá změna posunutí viditelný účinek. Nejde o ekvivalent transform ani vlastností border.

Povoleny jsou kladné i záporné hodnoty. Kladné posunutí přeskočí začátek vzoru; záporné posune jeho fázi opačným směrem. CSS Fill and Stroke uvádí syntaxi <length-percentage>, zatímco SVG 2 navíc povoluje <number> v uživatelských jednotkách. Procenta se vztahují k normalizované úhlopříčce zobrazovací oblasti SVG, nikoli k délce cesty: sqrt((width² + height²) / 2). V SVG 2 ovlivňuje atribut pathLength interpretaci vzdáleností čárek.

V příkladu vytváří stroke-dasharray: 20px 10px čárky o délce 20 jednotek a mezery o délce 10 jednotek. Dolní obrys má stroke-dashoffset: 10px, takže jeho první viditelná čárka měří 10 jednotek. Geometrie zůstává beze změny.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>stroke-dashoffset</title>
<style>
  path {
    fill: none;
    stroke: black;
    stroke-width: 4px;
    stroke-linecap: butt;
    stroke-dasharray: 20px 10px;
  }
  .shifted { stroke-dashoffset: 10px; }
</style>
<svg xmlns="http://www.w3.org/2000/svg" width="160" height="70" viewBox="0 0 160 70">
  <path d="M 20 20 H 140" />
  <path class="shifted" d="M 20 50 H 140" />
</svg>

Výsledek

Two horizontal black dashed strokes. The upper stroke begins with a 20-unit dash; the lower stroke begins with a 10-unit dash, followed by a 10-unit gap. Neither path moves.

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje