---
title: Attr
slug: Web/API/Attr
tags:
- API
- DOM
- Gecko DOM
- JavaScript
translation_of: Web/API/Attr
---
<p>{{APIRef("DOM")}}<br>
Este tipo representa um atributo de elemento DOM como um objeto. Na maioria dos métodos DOM, você provavelmente irá retornar diretamente o atributo como uma string (e.g., {{domxref("Element.getAttribute()")}}, mas certas funções (e.g., {{domxref("Element.getAttributeNode()")}}) ou meios de iteração retornam tipos <code>Attr</code>.</p>
<p>{{InheritanceDiagram}}</p>
<div class="warning"><strong>Aviso:</strong> Começando no Gecko 7.0 {{geckoRelease("7.0")}}, os que serão removidos mostram mensagens de aviso no console. Você deve revisar seu código de acordo. Veja <a href="https://developer.mozilla.org/pt-BR/docs/Web/API/Attr$edit#Deprecated_properties_and_methods">métodos e propriedades descontinuadas</a> para uma lista completa.</div>
<h2 id="Propriedades">Propriedades</h2>
<p> </p>
<dl>
<dt>{{domxref("Attr.name", "name")}} {{readOnlyInline}}</dt>
<dd>O nome do Atributo.</dd>
</dl>
<p> </p>
<p> </p>
<dl>
<dt>{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}</dt>
<dd>Uma {{domxref("DOMString")}} representando o namespace URI do atributo, ou <code>null</code> se não há namespace</dd>
<dt>{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}</dt>
<dd>Uma {{domxref("DOMString")}} representando a parte local do nome qualificado do atributo.</dd>
<dt>{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}</dt>
<dd>Uma {{domxref("DOMString")}} representando o prefixo do namespace do atributo ou <code>null</code> se nenhum prefixo foi especificado.</dd>
<dt>{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}</dt>
<dd>
<p>O elemento que possui o atributo.</p>
</dd>
</dl>
<p> </p>
<div class="note">
<p><strong>Nota:</strong> DOM Level 4 removeu esta propriedade. Foi suposto que como você recebe um objeto <code>Attr</code> de um {{domxref("Element")}}, você já deve saber qual é o elemento associado.<br>
Como isto não é sempre verdadeiro em casos como objetos <code>Attr</code> sendo retornados pelo {{domxref("Document.evaluate")}}, o DOM Living Standard reintroduziu a propriedade.</p>
<p>Gecko mostra uma mensagem de descontinuação começando no Gecko 7.0 {{geckoRelease("7.0")}}. Esta mensagem foi removida novamente no Gecko 49.0 {{geckoRelease("49.0")}}.</p>
</div>
<h2 id="Propriedades_e_métodos_descontinuados">Propriedades e métodos descontinuados</h2>
<p>As seguintes propriedades e métodos foram descontinuados. Quando disponíveis, são substituidas adequadamente.</p>
<dl>
<dt><code>attributes</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>childNodes</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>firstChild</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>lastChild</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>nextSibling</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>nodeName</code></dt>
<dd>Use {{domxref("Attr.name")}} no lugar.</dd>
<dt><code>nodeType</code></dt>
<dd>Esta propriedade agora sempre retorna 2 (<code>ATTRIBUTE_NODE</code>).</dd>
<dt><code>nodeValue</code></dt>
<dd>Use {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>ownerDocument</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>ownerElement</code></dt>
<dd>Desde que você obtenha o objeto <code>Attr</code> de um {{domxref("Element")}}, você já conhece os elementos associados.</dd>
<dt><code>parentNode</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>previousSibling</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>specified</code></dt>
<dd>Esta propriedade agora sempre retorna <code>true</code>.</dd>
<dt><code>textContent</code></dt>
<dd>Use {{domxref("Attr.value")}} no lugar.</dd>
</dl>
<p>Os seguintes métodos foram reprovados:</p>
<dl>
<dt><code>appendChild()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>cloneNode()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>createAttribute()</code></dt>
<dd>Use {{domxref("Element.setAttribute()")}} no lugar.</dd>
<dt><code>createAttributeNS()</code></dt>
<dd>Use {{domxref("Element.setAttributeNS()")}} no lugar.</dd>
<dt><code>getAttributeNode()</code></dt>
<dd>Use {{domxref("Element.getAttribute()")}} no lugar.</dd>
<dt><code>getAttributeNodeNS()</code></dt>
<dd>Use {{domxref("Element.getAttributeNS()")}} no lugar.</dd>
<dt><code>hasAttributes() </code>{{obsolete_inline("21.0")}}</dt>
<dd>Este método agora sempre retorna false.</dd>
<dt><code>hasChildNodes()</code></dt>
<dd>Este método agora sempre retorna false.</dd>
<dt><code>insertBefore()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>isSupported()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>isEqualNode()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>normalize()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>removeAttributeNode()</code></dt>
<dd>Use {{domxref("Element.removeAttribute()")}} no lugar.</dd>
<dt><code>removeChild()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>replaceChild()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>setAttributeNode()</code></dt>
<dd>Use {{domxref("Element.setAttribute()")}} no lugar.</dd>
<dt><code>setAttributeNodeNS()</code></dt>
<dd>Use {{domxref("Element.setAttributeNS()")}} no lugar.</dd>
</dl>
<h2 id="Especificações">Especificações</h2>
<ul>
<li><a class="external" href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-637646024" title="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-637646024">Document Object Model Core level 3: Interface Attr</a></li>
<li><a class="external" href="http://www.w3.org/TR/dom/#interface-attr">Document Object Model 4: Interface Attr</a></li>
</ul>