---
title: Attr
slug: Web/API/Attr
tags:
- API
- DOM
translation_of: Web/API/Attr
---
<div>{{APIRef("DOM")}}</div>
<p><code><font face="Arial, x-locale-body, sans-serif"><span style="background-color: #ffffff;">Interfejs </span></font><strong>Attr</strong></code> reprezentuje jeden z atrybutów elementu DOM jako obiekt.W większości metod DOM otrzymujesz wartość atrybutu bezpośrednio jako ciąg znaków (np., {{domxref("Element.getAttribute()")}}), oprócz niektórych funkcji (np., {{domxref("Element.getAttributeNode()")}}) lub sposobów iteracji zwracających typ <code>Attr</code>.</p>
<p>{{InheritanceDiagram}}</p>
<div class="warning"><strong>Warning: </strong>Poczynając od Gecko 7.0 {{geckoRelease("7.0")}}, pojawia się szereg przestarzałych właściwości i metod wyświetlających ostrzeżenia w konsoli. Powinieneś odpowiednio przejrzeć swój kod. Zobacz <a href="#Deprecated_properties_and_methods"> Przestarzałe właściwości i metody</a> aby zobacyć pełną listę.</div>
<h2 id="Właściwości">Właściwości</h2>
<dl>
<dt>{{domxref("Attr.name", "name")}} {{readOnlyInline}}</dt>
<dd>Nazwa atrybutu.</dd>
<dt>{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}</dt>
<dd>{{domxref("DOMString")}} reprezentujący przestrzeń nazw URI atrybutu lub <code>null</code> jeśli nie ma określonej przestrzeni nazw.</dd>
<dt>{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}</dt>
<dd>{{domxref("DOMString")}} reprezentujący lokalną część kwalifikowanej przestrzeni nazw atrybutu.</dd>
<dt>{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}</dt>
<dd>{{domxref("DOMString")}} reprezentujący prefiks przestrzeni nazw atrybutu lub <code>null</code> jeśli nie określono prefiksu.</dd>
<dt>{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}</dt>
<dd>
<p>Element posiadający atrybut.</p>
<div class="note">
<p><strong>Note:</strong> DOM Level 4 usunął tę właściwość. Założono, że skoro otrzymujesz <code>Attr</code> z {{domxref("Element")}}, powinieneś znać powiązany element.<br>
Ponieważ nie jest to prawdą w przypadkach, takich jak obiekty <code>Attr</code> zwracane przez {{domxref("Document.evaluate")}}, DOM Living Standard wprowadził tę właściwość ponownie.</p>
<p>Gecko wyświetla notę o deprecjonowaniu poczynając od Gecko 7.0 {{geckoRelease("7.0")}}. Nota została usunięta w in Gecko 49.0 {{geckoRelease("49.0")}}.</p>
</div>
</dd>
<dt>{{domxref("Attr.specified", "specified")}} {{readOnlyInline}}</dt>
<dd>Ta właściwosć zawsze zwraca <code>true</code>. Pierwotnie, zwracała <code>true</code> jeśli właściwość była określona wprost w kodzie źródłowym lub poprzez skrypt a <code>false</code> jeśli była domyślna lub określona w <acronym title="Document Type Definition">DTD</acronym>.</dd>
<dt>{{domxref("Attr.value", "value")}}</dt>
<dd>Wartość atrybutu.</dd>
</dl>
<div class="note">
<p><strong>Note:</strong> DOM Level 3 zdefiniował <code>namespaceURI</code>, <code>localName</code> i <code>prefix</code> w interfejsie{{domxref("Node")}}. W DOM4 zostały przeniesione do <code>Attr</code>.</p>
<p>Ta zmiana została zaimplementowana w Chrome 46.0 i Firefox od wersji 48.0.</p>
</div>
<h2 id="Przestarzałe_właściwości_i_metody">Przestarzałe właściwości i metody</h2>
<p>Następujące właściwości są przestarzałe. Kiedy to możliwe, odpowiednie zastępcze właściwości są podane.</p>
<dl>
<dt><code>attributes</code></dt>
<dd>Obecnie zawsze zwraca <code>NULL</code>.</dd>
<dt><code>childNodes</code> {{obsolete_inline(14)}}</dt>
<dd>Ta właściwość obecnie zawsze zwraca pusty {{domxref("NodeList")}}.</dd>
<dt><code>firstChild</code> {{obsolete_inline(14)}}</dt>
<dd>Obecnie zawsze zwraca <code>NULL</code>.</dd>
<dt><code>isId</code> {{readOnlyInline}}</dt>
<dd>Wskazuje czy atrybut jest atrybutem "ID". An "ID" jest atrybutem, którego wartość powinna być unikalna w całym dokumencie DOM. W HTML DOM, "id" to atrybut ID, ale XML może definiować inne. To, czy atrybut jest unikalny, czy nie, jest często determinowane przez {{Glossary("DTD")}} lub inny schemat dokumentu.</dd>
<dt><code>lastChild</code> {{obsolete_inline(14)}}</dt>
<dd>Obecnie zawsze zwraca <code>NULL</code>.</dd>
<dt><code>nextSibling</code></dt>
<dd>Obecnie zawsze zwraca <code>NULL</code>.</dd>
<dt><code>nodeName</code></dt>
<dd>Zamiast tego używaj {{domxref("Attr.name")}} .</dd>
<dt><code>nodeType</code></dt>
<dd>Obecnie zawsze zwraca 2 (<code>ATTRIBUTE_NODE</code>).</dd>
<dt><code>nodeValue</code></dt>
<dd>Zamiast tego używaj {{domxref("Attr.value")}}.</dd>
<dt><code>ownerDocument</code></dt>
<dd>Nie powinieneś był tego używać, więc prawdopodobnie nie obchodzi cię, że to zniknie.</dd>
<dt><code>parentNode</code></dt>
<dd>Obecnie zawsze zwraca <code>NULL</code>.</dd>
<dt><code>previousSibling</code></dt>
<dd>Obecnie zawsze zwraca <code>NULL</code>.</dd>
<dt><code>schemaTypeInfo</code> {{obsolete_inline}} {{readOnlyInline}}</dt>
<dd>Typ informacji powiązane z tym atrybutem. Podczas gdy typ informacji zawierany przez ten atrybut ma gwarantowaną poprawność po waładowaniu dokumentu lub wywołaniu {{domxref("Document.normalizeDocument")}}, ta właściwość może nie być wiarygodna jeśli węzeł został przeniesiony.</dd>
<dt><code>specified</code></dt>
<dd>Obecnie zawsze zwraca <code>true</code>.</dd>
<dt><code>textContent</code></dt>
<dd>Zamiast tego używaj {{domxref("Attr.value")}}.</dd>
</dl>
<p>Poniższe metody są przestarzałe:</p>
<dl>
<dt><code>appendChild()</code> {{obsolete_inline(14)}}</dt>
<dd>Zamiast tego, modyfikuj wartość {{domxref("Attr.value")}}.</dd>
<dt><code>cloneNode()</code></dt>
<dd>Nie powinieneś był tego używać, więc prawdopodobnie nie obchodzi cię, że to zniknie.</dd>
<dt><code>createAttribute()</code></dt>
<dd>Zamiast tego używaj {{domxref("Element.setAttribute()")}}.</dd>
<dt><code>createAttributeNS()</code></dt>
<dd>Zamiast tego używaj {{domxref("Element.setAttributeNS()")}}.</dd>
<dt><code>getAttributeNode()</code></dt>
<dd>Zamiast tego używaj {{domxref("Element.getAttribute()")}}.</dd>
<dt><code>getAttributeNodeNS()</code></dt>
<dd>Zamiast tego używaj {{domxref("Element.getAttributeNS()")}}.</dd>
<dt><code>hasAttributes()</code> {{obsolete_inline("21.0")}}</dt>
<dd>Obecnie zawsze zwraca <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">false</span></font>.</dd>
<dt><code>hasChildNodes()</code></dt>
<dd>Obecnie zawsze zwraca <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">false</span></font>.</dd>
<dt><code>insertBefore()</code></dt>
<dd>Zamiast tego modyfikuj wartość {{domxref("Attr.value")}}.</dd>
<dt><code>isSupported()</code></dt>
<dd>Nie powinieneś był tego używać, więc prawdopodobnie nie obchodzi cię, że to zniknie.</dd>
<dt><code>isEqualNode()</code></dt>
<dd>Nie powinieneś był tego używać, więc prawdopodobnie nie obchodzi cię, że to zniknie.</dd>
<dt><code>normalize()</code></dt>
<dd>Nie powinieneś był tego używać, więc prawdopodobnie nie obchodzi cię, że to zniknie.</dd>
<dt><code>removeAttributeNode()</code></dt>
<dd>Zamiast tego używaj {{domxref("Element.removeAttribute()")}}.</dd>
<dt><code>removeChild()</code> {{obsolete_inline(14)}}</dt>
<dd>Zamiast tego, modyfikuj wartość {{domxref("Attr.value")}} instead.</dd>
<dt><code>replaceChild()</code> {{obsolete_inline(14)}}</dt>
<dd>Zamiast tego, modyfikuj wartość {{domxref("Attr.value")}} instead.</dd>
<dt><code>setAttributeNode()</code></dt>
<dd>Zamiast tego używaj {{domxref("Element.setAttribute()")}}.</dd>
<dt><code>setAttributeNodeNS()</code></dt>
<dd>Zamiast tego używaj {{domxref("Element.setAttributeNS()")}}.</dd>
</dl>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName("DOM WHATWG", "#interface-attr", "Attr")}}</td>
<td>{{Spec2("DOM WHATWG")}}</td>
<td>Przywraca właściwość <code>ownerElement</code> </td>
</tr>
<tr>
<td>{{SpecName("DOM4", "#interface-attr", "Attr")}}</td>
<td>{{Spec2("DOM4")}}</td>
<td>
<ul>
<li>Przenosi <code>namespaceURI</code>, <code>prefix</code> i <code>localName</code> z {{domxref("Node")}} do tego API i usuwa <code>ownerElement</code>, <code>schemaTypeInfo</code> oraz <code>isId</code>.</li>
</ul>
</td>
</tr>
<tr>
<td>{{SpecName("DOM3 Core", "core.html#ID-637646024", "Attr")}}</td>
<td>{{Spec2("DOM3 Core")}}</td>
<td>Wstępna definicja</td>
</tr>
</tbody>
</table>
<h2 id="Kompatybilność_z_przeglądarkami">Kompatybilność z przeglądarkami</h2>
<p>{{Compat("api.Attr")}}</p>