1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
---
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>
|