Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

:focus-within — focus sur un élément ou l’un de ses descendants

La pseudo-classe :focus-within correspond à un élément qui a le focus ou qui contient un descendant ayant le focus. Elle permet de mettre en évidence tout un groupe de contrôles.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

:focus-within

:focus-within est une pseudo-classe sans argument. Elle correspond à un élément qui correspond lui-même à :focus, ou qui possède un descendant satisfaisant les conditions de focus dans l’arbre aplati (flat tree), lequel tient compte du Shadow DOM.

Contrairement à :focus, elle permet donc de mettre en forme un conteneur lorsqu’un contrôle qu’il contient a le focus. Elle ne déplace toutefois pas le focus vers le conteneur.

Dans l’exemple, .group:focus-within colore la bordure en bleu lorsque First ou Second a le focus. Passer de l’un à l’autre conserve la mise en évidence ; lorsque Outside reçoit le focus, la bordure redevient grise. La règle ne supprime pas l’indicateur de focus propre au contrôle.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:focus-within example</title>
<style>
  .group {
    padding: 1rem;
    border: 3px solid gray;
  }
  .group:focus-within {
    border-color: blue;
  }
</style>
<div class="group">
  <label>First <input type="text"></label>
  <label>Second <input type="text"></label>
</div>
<label>Outside <input type="text"></label>
</html>

Résultat

Focus First or Second: the group border is blue. Focus Outside: the group border is gray.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources