aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/css/_colon_focus-within/index.md
blob: 0b530933ca19209e3781da5e92bb13dc84810a2b (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
---
title: ':focus-within'
slug: Web/CSS/:focus-within
tags:
  - CSS
  - Pseudo-classe
  - Reference
translation_of: Web/CSS/:focus-within
---
{{CSSRef}}

La [pseudo-classe](/fr/docs/Web/CSS/Pseudo-classes) **`:focus-within`** s'applique à tous les éléments pour lesquels la pseudo-classe {{cssxref(":focus")}} s'applique ainsi qu'à tous leurs éléments descendants, y compris ceux du _Shadow DOM_. Autrement dit, cette pseudo-classe s'applique lorsqu'un élément a reçu le focus via le clavier ou la souris (par exemple lorsqu'on clique sur un champ d'un formulaire).

```css
/* Cible n'importe quel <div> lorsqu'un */
/* de ses descendants a reçu le focus */
div:focus-within {
  background: yellow;
}
```

Cette pseudo-classe s'applique également aux descendants de l'élément ciblé ainsi qu'aux descendants dont la racine est la racine d'un arbre du {{Glossary("Shadow DOM")}}.

Ce sélecteur est notamment utile lorsqu'on veut, par exemple, mettre en avant l'ensemble d'un formulaire lorsque l'utilisateur passe le focus sur l'un de ses éléments {{HTMLElement("input")}}.

## Syntaxe

{{csssyntax}}

## Exemples

### CSS

```css
.name-container {
  padding: 4px;
}

.name-container:focus-within {
  background: yellow;
}

input {
  margin: 4px;
}
```

### HTML

```html
<p>
  L'élément div ci-après aura un fond jaune
  si l'un des deux champs de saisie a le focus.
</p>
<div class="name-container">
  <label for="prenom">
    Prénom :
    <input id="prenom" placeholder="Prénom" type="text">
  </label>
  <label for="nom">
    Nom :
    <input id="nom" placeholder="Nom" type="text">
  </label>
</div>
```

### Résultat

{{EmbedLiveSample("Exemples", 500, 150)}}

## Spécifications

| Spécification                                                                                        | État                                 | Commentaires         |
| ---------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- |
| {{SpecName("CSS4 Selectors", "#the-focus-within-pseudo", ":focus-within")}} | {{Spec2("CSS4 Selectors")}} | Définition initiale. |

## Compatibilité des navigateurs

{{Compat("css.selectors.focus-within")}}

## Voir aussi

- {{cssxref(":focus")}}
- {{CSSxRef(":focus-visible")}} {{Experimental_Inline}}