---
title: use
slug: Web/SVG/Element/use
tags:
  - SVG
  - SVG图形
  - 元素
  - 参考
  - 需要浏览器兼容性
translation_of: Web/SVG/Element/use
---
<div>{{SVGRef}}</div>

<p><code>use</code>元素在SVG文档内取得目标节点，并在别的地方复制它们。它的效果等同于这些节点被深克隆到一个不可见的DOM中，然后将其粘贴到<code>use</code>元素的位置，很像HTML5中的克隆<a href="/en-US/docs/Web/HTML/Element/template">模板元素</a>。因为克隆的节点是不可见的，所以当使用<a href="/en/CSS">CSS</a>样式化一个<code>use</code>元素以及它的隐藏的后代元素的时候，必须小心注意。隐藏的、克隆的DOM不能保证继承CSS属性，除非你明文设置使用<a href="/en/CSS/inheritance">CSS继承</a>。</p>

<p>出于安全原因，一些浏览器可能在use元素上应用同源策略，还有可能拒绝载入xlink:href属性内的跨源URI。</p>

<h2 id="用法">用法</h2>

<p>{{svginfo}}</p>

<h2 id="示例">示例</h2>

<pre class="brush: xml" id="Attributes">&lt;svg width="100%" height="100%" xmlns="<a href="http://www.w3.org/2000/svg">http://www.w3.org/2000/svg</a>" xmlns:xlink="<a href="http://www.w3.org/1999/xlink">http://www.w3.org/1999/xlink</a>"&gt;
  &lt;style&gt;
    .classA { fill:red }
  &lt;/style&gt;
  &lt;defs&gt;
    &lt;g id="Port"&gt;
      &lt;circle style="fill:inherit" r="10"/&gt;
    &lt;/g&gt;
  &lt;/defs&gt;

  &lt;text y="15"&gt;black&lt;/text&gt;
  &lt;use x="50" y="10" xlink:href="#Port" /&gt;
  &lt;text y="35"&gt;red&lt;/text&gt;
  &lt;use x="50" y="30" xlink:href="#Port" class="classA"/&gt;
  &lt;text y="55"&gt;blue&lt;/text&gt;
  &lt;use x="50" y="50" xlink:href="#Port" style="fill:blue"/&gt;
 &lt;/svg&gt;
</pre>

<p> </p>

<h2 id="属性">属性</h2>

<h3 id="全局属性">全局属性</h3>

<ul>
 <li><a href="/en/SVG/Attribute#ConditionalProccessing" title="en/SVG/Attribute#ConditionalProccessing">条件处理属性</a> »</li>
 <li><a href="/en/SVG/Attribute#Core" title="en/SVG/Attribute#Core">核心属性</a> »</li>
 <li><a href="/en/SVG/Attribute#GraphicalEvent" title="en/SVG/Attribute#GraphicalEvent">图形事件属性</a> »</li>
 <li><a href="/en/SVG/Attribute#Presentation" title="en/SVG/Attribute#Presentation">外观属性</a> »</li>
 <li><a href="/en/SVG/Attribute#XLink" title="en/SVG/Attribute#XLink">Xlink属性</a> »</li>
 <li>{{ SVGAttr("class") }}</li>
 <li>{{ SVGAttr("style") }}</li>
 <li>{{ SVGAttr("externalResourcesRequired") }}</li>
 <li>{{ SVGAttr("transform") }}</li>
</ul>

<h3 id="专有属性">专有属性</h3>

<ul>
 <li>{{ SVGAttr("x") }}</li>
 <li>{{ SVGAttr("y") }}</li>
 <li>{{ SVGAttr("width") }}</li>
 <li>{{ SVGAttr("height") }}</li>
 <li>{{ SVGAttr("xlink:href") }}</li>
</ul>

<h2 id="DOM接口">DOM接口</h2>

<p>该元素实现了<code><a href="/en/DOM/SVGUseElement" title="en/DOM/SVGUseElement">SVGUseElement</a></code>接口。</p>

<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2>

{{Compat("svg.elements.use")}}