files/zh-cn/web/css/_doublecolon_slotted/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

---
title: '::slotted()'
slug: 'Web/CSS/::slotted'
translation_of: 'Web/CSS/::slotted'
---
<div>{{ CSSRef }}</div>

<p><strong><code>:slotted()</code></strong> <a href="/zh-CN/docs/Web/CSS">CSS</a> <a href="/zh-CN/docs/Web/CSS/Pseudo-elements">伪元素</a> 用于选定那些被放在 HTML模板 中的元素 (更多请查看 <a href="/zh-CN/docs/Web/Web_Components/Using_templates_and_slots">使用模板和插槽</a>).</p>

<p>这个伪类选择器仅仅适用于 <a href="/en-US/docs/Web/Web_Components/Using_shadow_DOM">影子节点树(Shadow Dom)</a>. 并且只会选择实际的元素节点， 而不包括文本节点.</p>

<pre class="brush: css no-line-numbers">/* Selects any element placed inside a slot */
::slotted(*) {
  font-weight: bold;
}

/* Selects any &lt;span&gt; placed inside a slot */
::slotted(span) {
  font-weight: bold;
}
</pre>

<h2 id="语法">语法</h2>

{{csssyntax}}

<h2 id="样例">样例</h2>

<p>下面的小片段是关于 <a href="https://github.com/mdn/web-components-examples/tree/master/slotted-pseudo-element">插槽伪类元素</a> 小demo (<a href="https://mdn.github.io/web-components-examples/slotted-pseudo-element/">点击查看实例</a>).</p>

<p>在这个小demo 中, 我们使用一个带有3个插槽的HTML模板:</p>

<pre class="brush: html">&lt;template id="person-template"&gt;
  &lt;div&gt;
    &lt;h2&gt;Personal ID Card&lt;/h2&gt;
    &lt;slot name="person-name"&gt;NAME MISSING&lt;/slot&gt;
    &lt;ul&gt;
      &lt;li&gt;&lt;slot name="person-age"&gt;AGE MISSING&lt;/slot&gt;&lt;/li&gt;
      &lt;li&gt;&lt;slot name="person-occupation"&gt;OCCUPATION MISSING&lt;/slot&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/div&gt;
&lt;/template&gt;</pre>

<p>自定义元素 <code>&lt;person-details&gt;</code> 的定义如下:</p>

<pre class="brush: js">customElements.define('person-details',
  class extends HTMLElement {
    constructor() {
      super();
      let template = document.getElementById('person-template');
      let templateContent = template.content;

      const shadowRoot = this.attachShadow({mode: 'open'});

      let style = document.createElement('style');
      style.textContent = 'div { padding: 10px; border: 1px solid gray; width: 200px; margin: 10px; }' +
                           'h2 { margin: 0 0 10px; }' +
                           'ul { margin: 0; }' +
                           'p { margin: 10px 0; }' +
                           '::slotted(*) { color: gray; font-family: sans-serif; } ';

      shadowRoot.appendChild(style);
      shadowRoot.appendChild(templateContent.cloneNode(true));
  }
})</pre>

<p>为了更好地区分<strong>未被成功填充的插槽</strong>和<strong>成功填充的插槽</strong>, 我们在CSS中选择了所有的插槽元素(<code>::slotted(*)</code>), 并填充了不一样的颜色和字体. 结果也是如此.</p>

<p>元素就像如下被填充了起来:</p>

<pre class="brush: html">&lt;person-details&gt;
  &lt;p slot="person-name"&gt;Dr. Shazaam&lt;/p&gt;
  &lt;span slot="person-age"&gt;Immortal&lt;/span&gt;
  &lt;span slot="person-occupation"&gt;Superhero&lt;/span&gt;
&lt;/person-details&gt;</pre>

<h2 id="规范">规范</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('CSS Scope', '#slotted-pseudo', '::slotted') }}</td>
   <td>{{ Spec2('CSS Scope') }}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2>


<p>{{Compat("css.selectors.slotted")}}</p>

<h2 id="参考">参考</h2>

<ul>
 <li><a href="/en-US/docs/Web/Web_Components">Web components</a></li>
</ul>