Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

stop-color — cor de uma paragem de gradiente SVG

A propriedade CSS `stop-color` especifica a cor de um elemento `stop` num gradiente SVG. Não define a posição da paragem nem diretamente a cor da forma.

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

Sintaxe

stop-color: <color>;

stop-color especifica a cor de uma paragem de gradiente representada por um elemento stop dentro de linearGradient ou radialGradient. A posição é definida pelo atributo separado offset; uma forma utiliza o gradiente através de fill ou stroke.

O valor é um <color>, por exemplo red, #ff0000 ou currentColor. O valor inicial é black. A propriedade não é herdada e pode ser animada. Uma declaração CSS pode substituir um atributo de apresentação stop-color no mesmo elemento.

currentColor refere-se ao valor color do elemento stop. O alfa da cor é multiplicado por stop-opacity. Atenção: transparent significa preto transparente; para esbater uma cor sem a transição para preto, mantém essa cor e define o valor final stop-opacity: 0.

No exemplo, as regras CSS definem um início vermelho e um fim azul para o gradiente. O resultado esperado é um retângulo de 240 × 80 com uma transição horizontal do vermelho à esquerda para o azul à direita.

Exemplos

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Set SVG gradient colors with stop-color</title>
<style>
  #start { stop-color: #ff0000; }
  #end { stop-color: #0000ff; }
</style>
</head>
<body>
<figure>
  <svg width="240" height="80" viewBox="0 0 240 80" role="img" aria-labelledby="gradient-title">
    <title id="gradient-title">Rectangle with a horizontal gradient</title>
    <defs>
      <linearGradient id="gradient" x1="0%" y1="0%" x2="100%" y2="0%">
        <stop id="start" offset="0%" />
        <stop id="end" offset="100%" />
      </linearGradient>
    </defs>
    <rect width="240" height="80" fill="url(#gradient)" />
  </svg>
  <figcaption id="result"></figcaption>
</figure>
<script>
  const colorNames = { 'rgb(255, 0, 0)': 'red', 'rgb(0, 0, 255)': 'blue' };
  function stopColor(id) {
    const color = getComputedStyle(document.getElementById(id)).getPropertyValue('stop-color');
    return colorNames[color] ?? color;
  }
  const result = `Rectangle gradient: ${stopColor('start')} on the left to ${stopColor('end')} on the right.`;
  document.getElementById('result').textContent = result;
  console.log(result);
</script>
</body>
</html>

Resultado

Rectangle gradient: red on the left to blue on the right.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes