Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

stroke-dashoffset — przesunięcie wzoru kreskowania

Właściwość stroke-dashoffset określa, od którego miejsca powtarzanego wzoru kresek i przerw rozpoczyna się obrys SVG. Zmienia fazę kreskowania, a nie położenie ani długość ścieżki.

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

Składnia

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

stroke-dashoffset określa odległość w głąb powtarzanego wzoru zdefiniowanego przez stroke-dasharray, od której zaczyna się kreskowanie ścieżki. Wartość początkowa to 0; właściwość jest dziedziczona i dotyczy obrysów kształtów SVG oraz tekstu. Bez wzoru kreskowania przesunięcie nie daje widocznego efektu. Nie jest to odpowiednik transform ani właściwości border.

Dozwolone są wartości dodatnie i ujemne. Dodatnie przesunięcie pomija początek wzoru; ujemne przesuwa jego fazę w przeciwną stronę. CSS Fill and Stroke podaje składnię <length-percentage>, a SVG 2 dodatkowo dopuszcza <number> w jednostkach użytkownika. Procenty odnoszą się do znormalizowanej przekątnej obszaru SVG, nie do długości ścieżki: sqrt((width² + height²) / 2). W SVG 2 atrybut pathLength wpływa na interpretację odległości kreskowania.

W przykładzie stroke-dasharray: 20px 10px tworzy kreski długości 20 i przerwy długości 10. Dolny obrys ma stroke-dashoffset: 10px, więc pierwsza widoczna kreska ma długość 10. Geometria pozostaje bez zmian.

Przykłady

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

Wynik

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.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła