Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Propriété CSS outline-offset

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2017.

La propriété CSS outline-offset définit l'espace entre un contour et le bord ou la bordure d'un élément.

Exemple interactif

outline-offset: 4px;
outline-offset: 0.6rem;
outline-offset: 12px;
outline: 5px dashed blue;
<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    Ceci est une boîte avec un contour autour.
  </div>
</section>
#example-element {
  border: 2px solid crimson;
  outline: 0.75em solid;
  padding: 0.75em;
  width: 80%;
  height: 100px;
}

Syntaxe

css
/* Valeurs de type <length> */
outline-offset: 3px;
outline-offset: 0.2em;

/* Valeurs globales */
outline-offset: inherit;
outline-offset: initial;
outline-offset: revert;
outline-offset: revert-layer;
outline-offset: unset;

Valeurs

<length>

La largeur de l'espace entre l'élément et son contour. Une valeur négative place le contour à l'intérieur de l'élément. Une valeur de 0 place le contour de manière à ce qu'il n'y ait pas d'espace entre lui et l'élément.

Description

Un contour est une ligne tracée autour d'un élément, à l'extérieur du bord de la bordure. L'espace entre un élément et son contour est transparent. En d'autres termes, il est identique à l'arrière-plan de l'élément parent.

Accessibilité

Lorsqu'un contour est utilisé comme indicateur de sélection, la proportion de contraste de 3:1 défini dans le critère de succès 1.4.11 Contraste non textuel (angl.) exige que outline-color soit mesurée par rapport à la couleur de l'arrière-plan. Le outline-offset crée un espace transparent entre le bord de l'élément et son contour. Le contour décalé est tracé soit sur ce qui se trouve derrière l'élément, soit, avec un décalage négatif, sur l'arrière-plan de l'élément lui-même, ce qui peut modifier la couleur par rapport à laquelle le rapport est mesuré.

Lorsqu'un contour est utilisé comme indicateur de sélection, testez votre contour de sélection à l'intérieur d'un conteneur qui coupe son débordement et à l'intérieur d'un conteneur de défilement. Un décalage positif peut déplacer le contour en dehors d'un tel ancêtre, où une partie de l'indicateur est coupée. Le critère de succès 2.4.11 La Sélection N'est Pas Obscurcie (Minimum) (angl.) exige que le composant sélectionné ne soit pas entièrement caché, et le critère de succès 2.4.13 Apparence de la Sélection (angl.) définit une surface minimale pour l'indicateur lui-même.

Définition formelle

Valeur initiale0
Applicabilitétous les éléments
Héritéenon
Valeur calculéela longueur (<length>) absolue, ajustée à la largeur d'une ligne
Type d'animationune longueur

Syntaxe formelle

outline-offset = 
<length> |
inset

Exemples

Définir un décalage de contour en pixels

HTML

html
<p>Gallia est omnis divisa in partes tres.</p>

CSS

css
p {
  outline: 1px dashed red;
  outline-offset: 10px;
  background: yellow;
  border: 1px solid blue;
  margin: 15px;
}

Résultat

Spécifications

Spécification
CSS Basic User Interface Module Level 4
# outline-offset

Compatibilité des navigateurs

Voir aussi