symbol
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Please take two minutes to fill out our short survey.
O elemento symbol é usado para definir um template que pode ser inicializado por um elemento <use>. A utilização de elementos symbol para gráficos que são usados várias vezes no mesmo documento acrescenta estrutura e semântica. Documentos que são ricos em estrutura podem ser renderizados graficamente, através da fala, ou do braille, e assim promover a acessibilidade. Note que o elemento symbol em si não é renderizado. Somente instâncias de um elemento symbol (por exemplo, uma referência à um elemento symbol feita por um elemento <use>) são renderizadas.
Contexto de uso
| Categorias | Elemento recipiente, elemento estrutural |
|---|---|
| Conteúdo permitido | Qualquer número dos seguintes elementos, em qualquer ordem: Elementos de animação Elementos descritivos Elementos de forma Elementos estruturais Elementos de gradiente <a>, <clipPath>, <cursor>, <filter>, <font>, <font-face>, <foreignObject>, <image>, <marker>, <mask>, <pattern>, <script>, <style>, <switch>, <text>, <view> |
Exemplo
<svg>
<!-- definição de symbol NUNCA é renderizada -->
<symbol id="sym01" viewBox="0 0 150 110">
<circle cx="50" cy="50" r="40" stroke-width="8" stroke="red" fill="red" />
<circle
cx="90"
cy="60"
r="40"
stroke-width="8"
stroke="green"
fill="white" />
</symbol>
<!-- renderização por elementos "use" -->
<use xlink:href="#sym01" x="0" y="0" width="100" height="50" />
<use xlink:href="#sym01" x="0" y="50" width="75" height="38" />
<use xlink:href="#sym01" x="0" y="100" width="50" height="25" />
</svg>
Atributos
Atributos globais
Atributos específicos
Interface DOM
Esse elemento implementa a interface do SVGSymbolElement.