aboutsummaryrefslogtreecommitdiff
path: root/files/pl/web/api/element/attributes/index.html
blob: 5ae9839a79e95c8cfd029292722f9d28f437b5a8 (plain)
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
---
title: element.attributes
slug: Web/API/Element/attributes
tags:
  - DOM
  - Dokumentacja_Gecko_DOM
  - Gecko
  - Wszystkie_kategorie
translation_of: Web/API/Element/attributes
---
<p>{{ ApiRef() }}</p>
<h3 id="Podsumowanie" name="Podsumowanie">Podsumowanie</h3>
<p><strong>attributes</strong> zwraca <em>kolekcję</em> atrybutów określonych dla danego elementu.</p>
<h3 id="Sk.C5.82adnia_i_warto.C5.9Bci" name="Sk.C5.82adnia_i_warto.C5.9Bci">Składnia i wartości</h3>
<pre class="eval">var <var>kolekcjaAtrybutów</var> = elementNodeReference.attributes;
</pre>
<p>Typem zwracanego obiektu kolekcji jest <a class="external" href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-1780488922">NamedNodeMap</a>. Jeśli element nie ma określonych żadnych atrybutów, zwrócony obiekt ma zerową długość. Właściwość <code>attributes</code> jest tylko do odczytu.</p>
<p><var>kolekcjaAtrybutów</var> to referencja do kolekcji atrybutów.</p>
<h3 id="Przyk.C5.82ad" name="Przyk.C5.82ad">Przykład</h3>
<pre>// weź pierwszy element &lt;p&gt; z dokumentu
var para = document.getElementsByTagName("p")[0];
var atts = para.attributes;
</pre>
<h3 id="Uwagi" name="Uwagi">Uwagi</h3>
<p>Zwracany obiekt ma typ <a class="external" href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-1780488922">NamedNodeMap</a>, nazywany także <em>kolekcją</em>, będący listą węzłów, a nie ciągów znakowych. Właściwości obiektów atrybutów dostępne są poprzez indeks, tak jak w poniższym przykładzie, który pobiera parę nazwa/wartość pierwszego atrybutu akapitu "p1":</p>
<pre>&lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd"&gt;

&lt;html&gt;

 &lt;head&gt;
  &lt;title&gt;Attributes example&lt;/title&gt;
  &lt;script type="text/javascript"&gt;
   function showFirstAttr()
   {
    var FirstParg = document.getElementById("p1");
    var outputText = document.getElementById("result");

    if (FirstParg.hasAttributes())
    // sprawdźmy, czy FirstParg ma atrybuty
     {
      outputText.value = FirstParg.attributes[0].name + "-&gt;"
                       + FirstParg.attributes[0].value;
     }
    else
     {
      outputText.value = "Brak atrybutów do wyświetlenia"
     };
   }
  &lt;/script&gt;
 &lt;/head&gt;

&lt;body&gt;
 &lt;p id="p1" style="color: green;"&gt;Przykładowy akapit&lt;/p&gt;
 &lt;form action=""&gt;
  &lt;p&gt;&lt;input type="button" value="Pokaż nazwę i wartość pierwszego atrybutu"
      onclick="showFirstAttr();"&gt;
  &lt;input id="result" type="text" value=""&gt;&lt;/p&gt;
 &lt;/form&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>
<p>Obiekt z atrybutami jest <em>kolekcją</em>, która podobna jest do tablicy, ponieważ ma właściwość <code>length</code>, a do atrybutów można odnosić się poprzez indeks liczbowy, ale kolekcja nie posiada specjalnych metod, jakie mają tablice, jak <code>join</code>, <code>split</code>, itd.</p>
<p>Kolejność w kolekcji atrybutów nie jest wiarygodna - dwie przeglądarki po otrzymaniu takiego samego kodu znaczników mogą zwracać różnie uporządkowane obiekty <code>attributes</code>.</p>
<p>By uzyskać dostęp do konkretnego atrybutu, użyj metody <a href="/pl/DOM/element.getAttribute" title="pl/DOM/element.getAttribute">getAttribute</a> lub zapisu z użyciem kropki:</p>
<pre> // pokaż id elementu, jeśli element go posiada
 if(element.id)
  {
   alert("id elementu to " + element.id);
  }
 else
  {
   alert("element nie ma id");
  };
</pre>
<h3 id="Specyfikacja" name="Specyfikacja">Specyfikacja</h3>
<ul>
 <li><a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-84CF096">W3C DOM Level 2 Core: attributes</a></li>
 <li><a class="external" href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-84CF096">W3C DOM Level 3 Core: attributes</a></li>
 <li><a class="external" href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-1780488922">W3C DOM Level 3 NamedNodeMap interface</a></li>
</ul>
<p>{{ languages( { "en": "en/DOM/element.attributes", "fr": "fr/DOM/element.attributes", "ja": "ja/DOM/element.attributes", "zh-cn": "cn/DOM/element.attributes" } ) }}</p>