blob: fadc318c678017d11d0bfa7044e6393baa399393 (
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
---
title: ':defined'
slug: Web/CSS/:defined
tags:
- CSS
- Layout
- Pseudo-class
- Reference
- Selector
- Web
translation_of: Web/CSS/:defined
browser-compat: css.selectors.defined
---
{{CSSRef}}
La [pseudo-classe](/fr/docs/Web/CSS/Pseudo-classes) **`:defined`** représente n'importe quel élément ayant été défini. Cela inclut les éléments standards provenant du navigateur, ainsi que les éléments personnalisés (« _custom elements_ ») ayant correctement été définis (c'est-à-dire grâce à la méthode [`CustomElementRegistry.define()`](/fr/docs/Web/API/CustomElementRegistry/define)).
```css
/* Cette règle cible tout élément défini */
:defined {
font-style: italic;
}
/* Cette règle cible n'importe quelle instance d'un élément personnalisé donné */
simple-custom:defined {
display: block;
}
```
## Syntaxe
{{csssyntax}}
## Exemples
Les fragments de code qui suivent sont tirés [du dépôt `defined-pseudo-class`](https://github.com/mdn/web-components-examples/tree/master/defined-pseudo-class) ([voir le résultat en _live_](https://mdn.github.io/web-components-examples/defined-pseudo-class/)).
Pour cette démonstration on définit un élément personnalisé trivial :
```js
customElements.define('simple-custom',
class extends HTMLElement {
constructor() {
super();
let divElem = document.createElement('div');
divElem.textContent = this.getAttribute('text');
let shadowRoot = this.attachShadow({mode: 'open'})
.appendChild(divElem);
}
})
```
On insère ensuite une copie de cet élément dans le document, à côté d'un paragraphe classique {`<p>` :
```html
<simple-custom text="Le texte de l'élément personnalisé"></simple-custom>
<p>Un paragraphe normal</p>
```
Dans la feuille CSS, on inclut d'abord les règles suivantes :
```css
// On utilise deux arrières-plans distincts pour ces deux éléments
p {
background: yellow;
}
simple-custom {
background: cyan;
}
// On met en italique le texte de ces deux éléments
:defined {
font-style: italic;
}
```
Ensuite, on fournit les deux règles suivantes afin de masquer les instances de l'élément personnalisé qui ne sont pas définies et, pour celles qui sont définies, on indique que ce sont des éléments de bloc :
```css
simple-custom:not(:defined) {
display: none;
}
simple-custom:defined {
display: block;
}
```
Ces dernières règles sont utiles lorsqu'on a un élément personnalisé complexe qui met du temps à charger : pour ceux-là, on peut vouloir les masquer jusqu'à ce que la définition soit complète afin de ne pas avoir de scintillement d'éléments non mis en forme sur la page.
## Spécifications
{{Specifications}}
## Compatibilité des navigateurs
{{Compat}}
## Voir aussi
- [Les composants web](/fr/docs/Web/Web_Components)
|
