files/ca/web/html/element/shadow/index.html


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: <shadow>
slug: Web/HTML/Element/Shadow
tags:
  - Element
  - HTML
  - Reference
  - Web Components
translation_of: Web/HTML/Element/shadow
---
<h2 id="Summary" name="Summary">Sumari</h2>

<p>L'element <strong><a href="/en-US/docs/Web/HTML">HTML</a> <code>&lt;shadow&gt;</code></strong> s'utilitza com una ombra DOM {{glossary("insertion point")}}. És possible utilitzar-ho si s'han creat múltiples arrels d'ombra sota una ombra d'acollida. No és útil en HTML ordinari. S'utilitza amb <a href="/en-US/docs/Web/Web_Components">Components Web (Web Components)</a>.</p>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row"><a href="/en-US/docs/Web/HTML/Content_categories" title="HTML/Content_categories">Categories de contingut</a></th>
   <td><a href="/en-US/docs/Web/HTML/Content_categories#Transparent_content_model" title="HTML/Content_categories#Transparent_content_model">Contingut transparent</a>.</td>
  </tr>
  <tr>
   <th scope="row">Contingut permès</th>
   <td><a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">Contingut dinàmic</a>.</td>
  </tr>
  <tr>
   <th scope="row">Omissió de l'etiqueta</th>
   <td>{{no_tag_omission}}</td>
  </tr>
  <tr>
   <th scope="row">Elements pares permesos</th>
   <td>Qualsevol element que accepti contingut dinàmic</td>
  </tr>
  <tr>
   <th scope="row">Interfície DOM</th>
   <td>{{domxref("HTMLShadowElement")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Attributes" name="Attributes">Atributs</h2>

<p>Aquest element inclou els <a href="/en-US/docs/Web/HTML/Global_attributes">atributs globals</a>.</p>

<h2 id="Exemple">Exemple</h2>

<p>Aquí teniu un exemple senzill de l'ús de l'element <code>&lt;shadow</code>&gt;. És un arxiu HTML amb tot el necessari.</p>

<div class="note">
<p><strong>Nota:</strong> Aquesta és una tecnologia experimental. Perquè aquest codi funcioni, el navegador que ho mostri ha de ser compatible amb els components web. Veure <a href="https://developer.mozilla.org/en-US/docs/Web/Web_Components#Enabling_Web_Components_in_Firefox">Habilitan components web en Firefox (Enabling Web Components in Firefox).</a></p>
</div>

<pre class="brush: html">&lt;html&gt;
  &lt;head&gt;&lt;/head&gt;
  &lt;body&gt;

  &lt;!-- This &lt;div&gt; will hold the shadow roots. --&gt;
  &lt;div&gt;
    &lt;!-- This heading will not be displayed --&gt;
    &lt;h4&gt;My Original Heading&lt;/h4&gt;
  &lt;/div&gt;

  &lt;script&gt;
    // Get the &lt;div&gt; above with its content
    var origContent = document.querySelector('div');
    // Create the first shadow root
    var shadowroot1 = origContent.createShadowRoot();
    // Create the second shadow root
    var shadowroot2 = origContent.createShadowRoot();

    // Insert something into the older shadow root
    shadowroot1.innerHTML =
      '&lt;p&gt;Older shadow root inserted by &amp;lt;shadow&amp;gt;&lt;/p&gt;';
    // Insert into younger shadow root, including &lt;shadow&gt;.
    // The previous markup will not be displayed unless
    // &lt;shadow&gt; is used below.
    shadowroot2.innerHTML =
      '&lt;shadow&gt;&lt;/shadow&gt; &lt;p&gt;Younger shadow root, displayed because it is the youngest.&lt;/p&gt;';
  &lt;/script&gt;

  &lt;/body&gt;
&lt;/html&gt;
</pre>

<p>Si visualitzes això en un navegador web ha de ser similar al següent.</p>

<p><img alt="shadow example" src="https://mdn.mozillademos.org/files/10083/shadow-example.png" style="height: 343px; width: 641px;"></p>

<h2 id="Especificacions">Especificacions</h2>

<table class="spec-table standard-table">
 <tbody>
  <tr>
   <th scope="col">Especificació</th>
   <th scope="col">Estat</th>
   <th scope="col">Comentari</th>
  </tr>
  <tr>
   <td>{{SpecName('Shadow DOM', "#the-shadow-element", "shadow")}}</td>
   <td>{{Spec2('Shadow DOM')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">Navegadors compatibles</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Suport bàsic</td>
   <td>35</td>
   <td>{{CompatGeckoDesktop("28")}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>26</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suport bàsic</td>
   <td>37</td>
   <td>{{CompatGeckoMobile("28")}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Si Shadow DOM no està activat en Firefox, l'element <code>&lt;shadow&gt;</code> es comportarà com {{domxref("HTMLUnknownElement")}}. Shadow DOM es va implementar per primera vegada a Firefox 33 i està darrere d'una preferència, <code>dom.webcomponents.enabled</code>, que està desactivat per defecte.</p>

<h2 id="See_also" name="See_also">Veure</h2>

<ul>
 <li><a href="/en-US/docs/Web/Web_Components">Web Components</a></li>
 <li>{{HTMLElement("content")}}, {{HTMLElement("template")}}, {{HTMLElement("element")}}</li>
</ul>

<div>{{HTMLRef}}</div>