# SVG gradient: lineær, radial, streger, tekst og masker

[Canonical HTML page](https://gradiently.design/da/guide/svg-gradients)

SVG har sit eget gradientsystem, ældre end CSS-gradienter og i stand til ting, de ikke kan: farve en streg, fylde et ord, dele én gradient mellem mange former og tone hvad som helst ud med en maske.

## The short version

- En SVG-gradient defineres én gang som et linearGradient- eller radialGradient-element med stop som børn, får et id og bruges ved at sætte fill eller stroke til url(#id).
- Som standard bruger koordinaterne i en SVG-gradient objectBoundingBox-enheder, hvor 0 og 1 er kanterne af den form, der males.
- gradientUnits="userSpaceOnUse" placerer gradienten i tegningens egne koordinater, så én gradient kan spænde over flere former, og gradienter på helt lige linjer virker.
- spreadMethod bestemmer, hvad der sker uden for gradientens ender: pad holder endefarverne, reflect spejler overgangen, og repeat starter den forfra.
- En SVG-maske bruger lysstyrke, så en gradient fra hvid til sort i en maske toner det ud, den bruges på.

En **SVG gradient** er en maling, du definerer én gang og bruger på enhver form, linje eller tekst i en SVG. Du skriver et `<linearGradient>`- eller `<radialGradient>`-element inde i `<defs>`, giver det `<stop>`-børn til farverne og et `id` og sætter så en forms `fill` eller `stroke` til `url(#id)`. I modsætning til en CSS-baggrund kan den farve en streg eller et enkelt ord, og den skalerer med tegningen.

```html
<svg viewBox="0 0 200 120" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <linearGradient id="dusk" x1="0" y1="0" x2="1" y2="1">
      <stop offset="0" stop-color="#1e1b4b" />
      <stop offset="0.55" stop-color="#7c3aed" />
      <stop offset="1" stop-color="#f472b6" />
    </linearGradient>
  </defs>
  <rect width="200" height="120" rx="16" fill="url(#dusk)" />
</svg>
```

En diagonal gradient på et afrundet rektangel. x1, y1, x2 og y2 tegner gradientens linje fra øverst til venstre til nederst til højre.

Samme overgang som CSS: `linear-gradient(135deg, #1e1b4b 0%, #7c3aed 55%, #f472b6 100%)`

SVG’en ovenfor og denne CSS-gradient er ens på et kvadrat. På et rektangel strækker SVG-udgaven sig med formen. Se gradientUnits nedenfor.

## linearGradient og dens stop

`x1`, `y1`, `x2` og `y2` sætter start og slut på gradientens linje. Hvert `<stop>` har et `offset` fra 0 til 1 (eller 0% til 100%), en `stop-color` og en valgfri `stop-opacity`. `stop-color` er også en CSS-egenskab, så du kan style gradienter fra et stylesheet, for eksempel `stop { stop-color: var(--accent); }`.

| Attribut | Standard | Det gør den |
| --- | --- | --- |
| `x1 y1 x2 y2` | `0 0 1 0`, venstre mod højre | Start- og slutpunkt for gradientens linje |
| `gradientUnits` | `objectBoundingBox` | Om koordinaterne er relative til formen eller til tegningen |
| `spreadMethod` | `pad` | Hvad der sker uden for enderne: `pad`, `reflect` eller `repeat` |
| `gradientTransform` | ingen | Drej, skalér eller skævvrid gradienten, f.eks. `rotate(30)` |
| `href` | ingen | Arv stop og indstillinger fra en anden gradient |

De vigtigste attributter for linearGradient. radialGradient deler alle undtagen første række.

`href` sparer gentagelser. Definér dine stop én gang i en basisgradient, og lav så variationer, der peger på den og kun ændrer retning eller enheder. [MDN’s reference til linearGradient](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/linearGradient) gennemgår alle attributter.

## radialGradient: centrum, radius og fokuspunkt

En radial gradient har et centrum (`cx`, `cy`) og en radius (`r`), som alle er 0,5 som standard, så den fylder formen fra midten. Den har også noget, CSS mangler: et særskilt fokuspunkt (`fx`, `fy`), hvor den første farve begynder. Flytter du fokuspunktet væk fra midten, ser en kugle ud til at være belyst fra den ene side.

```html
<radialGradient id="orb" cx="0.5" cy="0.5" r="0.5" fx="0.32" fy="0.28">
  <stop offset="0" stop-color="#e0f2fe" />
  <stop offset="0.45" stop-color="#0ea5e9" />
  <stop offset="1" stop-color="#082f49" />
</radialGradient>

<circle cx="60" cy="60" r="50" fill="url(#orb)" />
```

Et fokuspunkt oppe til venstre gør en flad cirkel til en blank kugle.

Belyst kugle, tilnærmet i CSS: `radial-gradient(circle at 32% 28%, #e0f2fe, #0ea5e9 35%, #082f49 80%)`

CSS kan flytte centrum, men ikke skille centrum og fokus ad, så dette er kun en tilnærmelse af SVG-kuglen. Sammenlign med [radiale gradienter i CSS](https://gradiently.design/da/guide/css-radial-gradient).

## gradientUnits: objectBoundingBox eller userSpaceOnUse

Med standarden `objectBoundingBox` betyder 0 og 1 kanterne af den form, der males, så hver form får hele gradienten, strakt så den passer. Med `userSpaceOnUse` er koordinaterne i SVG’ens egne enheder, så gradienten bliver liggende, og formerne afslører den del, de dækker. Sådan kan en række søjler dele én sammenhængende gradient.

### objectBoundingBox

- Koordinater fra 0 til 1 hen over hver form
- Hver form viser hele gradienten
- Gradienten strækkes med formens proportioner
- Fejler på en helt vandret eller lodret linje

### userSpaceOnUse

- Koordinater i tegningens egne enheder
- Formerne afslører deres udsnit af én gradient
- Vinkler holder, uanset formen
- Virker på lige linjer og tynde streger

> **Den usynlige lige linje** En vandret `<line>` har en bounding box med højden nul, og bounding box-enheder kan ikke beregnes ud fra nul, så en gradientstreg med standardindstillinger tegner ingenting på den. Sæt `gradientUnits="userSpaceOnUse"`, og angiv rigtige koordinater.

## Gradienter på streger og tekst

`stroke="url(#id)"` maler konturer, og sådan tegnes gradientikoner, fremdriftsringe og linjer i diagrammer. På `<text>` farver `fill="url(#id)"` bogstaverne, og ordene kan stadig markeres og søges. Tilføj en ren farve efter URL’en, for eksempel `fill="url(#dusk) #7c3aed"`, så bruges den, hvis gradienten ikke kan findes.

```html
<svg viewBox="0 0 320 120" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <linearGradient id="line" gradientUnits="userSpaceOnUse" x1="20" y1="0" x2="300" y2="0">
      <stop offset="0" stop-color="#22d3ee" />
      <stop offset="1" stop-color="#a855f7" />
    </linearGradient>
  </defs>
  <path d="M20 90 C 90 20, 160 110, 300 30" fill="none" stroke="url(#line)" stroke-width="6" stroke-linecap="round" />
  <text x="20" y="115" font-size="20" font-weight="700" fill="url(#line) #7c3aed">Growth</text>
</svg>
```

Én gradient i tegningens enheder, delt af en kurve og et ord. Begge går fra cyan til lilla over samme vandrette stræk.

Til gradientbogstaver i HTML frem for SVG er [gradienttekst i CSS](https://gradiently.design/da/guide/css-gradient-text) som regel enklere. Vælg SVG-tekst, når ordene er en del af en illustration eller et logo eller skal følge en sti.

## spreadMethod: pad, reflect og repeat

Når gradientens linje er kortere end formen, bestemmer `spreadMethod`, hvad der fylder resten. `pad` holder endefarverne, `reflect` spejler overgangen frem og tilbage, og `repeat` starter den forfra med en hård kant. Her går hver gradient fra 30% til 70% af bredden.

- pad: `linear-gradient(90deg, #0f766e 30%, #fde68a 70%)`
- reflect: `repeating-linear-gradient(90deg, #fde68a -10%, #0f766e 30%, #fde68a 70%)`
- repeat: `repeating-linear-gradient(90deg, #0f766e 30%, #fde68a 70%)`

Blågrøn til sand med de tre spredningsmetoder, genskabt i CSS, så du kan sammenligne dem side om side.

## Udtoning med SVG-masker

En maske bruger lysstyrke: hvide områder viser det, der maskeres, sorte områder skjuler det, og grå ligger imellem. En gradient fra hvid til sort i en `<mask>` toner derfor enhver form eller ethvert billede blødt ud til ingenting, og sådan gør du kanten af et foto blød eller lader en diagramlinje tone ind fra starten.

```html
<defs>
  <linearGradient id="fade" x1="0" y1="0" x2="0" y2="1">
    <stop offset="0.4" stop-color="#fff" />
    <stop offset="1" stop-color="#000" />
  </linearGradient>
  <mask id="soft-bottom">
    <rect width="100%" height="100%" fill="url(#fade)" />
  </mask>
</defs>

<image href="photo.jpg" width="100%" height="100%" mask="url(#soft-bottom)" />
```

Fotoet er helt synligt øverst og toner ud over de nederste 60%.

Til HTML-elementer gør CSS’en `mask-image: linear-gradient(#000 40%, transparent)` det samme, med alfa i stedet for lysstyrke. Masketeknikken ligger også bag gennemsigtige [gradientkanter i CSS](https://gradiently.design/da/guide/css-gradient-border).

### Undgå

- At genbruge samme gradient-`id` i to inline-SVG’er på én side
- At skjule et sprite med gradientdefinitioner med `display: none`
- Standardenheder på lige linjer
- Meget lange, glatte, mørke gradienter uden tekstur

### Gør

- Unikke id’er eller ét fælles sprite med definitioner
- Skjul sprites med bredde og højde på nul i stedet
- `userSpaceOnUse` til streger og delte gradienter
- Tilføj korn til store udtoninger, se [støjtekstur i CSS](https://gradiently.design/da/guide/css-noise-texture)

## FAQ

### Hvordan tilføjer jeg en gradient til en SVG?

Definér en `<linearGradient>` eller `<radialGradient>` med `<stop>`-børn og et `id` inde i `<defs>`, og sæt så en forms `fill` eller `stroke` til `url(#id)`.

### Hvorfor vises min SVG-gradient ikke på stregen af en linje?

En lige vandret eller lodret linje har en bounding box uden størrelse, så standardenhederne `objectBoundingBox` fejler. Brug `gradientUnits="userSpaceOnUse"` med rigtige koordinater.

### Hvordan drejer jeg en SVG-gradient?

Ændr `x1`, `y1`, `x2` og `y2`, eller tilføj `gradientTransform="`rotate(45 0,5 0,5)`"` for at dreje om midten af bounding boxen.

### Kan jeg ændre farverne i en SVG-gradient med CSS?

Ja. `stop-color` og `stop-opacity` er CSS-egenskaber, så regler som `stop { stop-color: var(--accent); }` virker på inline-SVG.

### Hvorfor forsvandt min SVG-gradient, da jeg skjulte SVG’en?

Definitioner i en SVG med `display: none` bliver måske ikke tegnet. Skjul i stedet spritet med bredde og højde på nul eller med absolut positionering.
