symbol
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> (en-US), <color-profile>, <cursor> (en-US), <filter>, <font> (en-US), <font-face> (en-US), <foreignObject> (en-US), <image>, <marker>, <mask>, <pattern>, <script>, <style>, <switch>, <text>, <view> |
Exemplo
html
<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.
Compatibilidade
BCD tables only load in the browser