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-color

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 juillet 2015.

La propriété CSS outline-color définit la couleur du contour d'un élément.

Exemple interactif

outline-color: red;
outline-color: #32a1ce;
outline-color: rgb(170 50 220 / 0.6);
outline-color: hsl(60 90% 50% / 0.8);
outline-color: currentColor;
<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 {
  outline: 0.75em solid;
  padding: 0.75em;
  width: 80%;
  height: 100px;
}

Syntaxe

css
/* Valeurs de type <color> */
outline-color: #f92525;
outline-color: rgb(30 222 121);
outline-color: blue;

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

La propriété outline-color est définie avec une des valeurs listées ci-après.

Valeurs

<color>

La couleur du contour, définie comme un <color>.

La spécification liste également une valeur supplémentaire, auto, qui n'est actuellement prise en charge par aucun navigateur. Lorsqu'elle est implémentée, auto est calculée comme currentColor sauf si outline-style est défini sur auto, auquel cas elle est calculée comme la couleur d'accentuation.

Description

Un contour est une ligne tracée autour d'un élément, à l'extérieur de la bordure (border). Contrairement à la bordure de l'élément, le contour est tracé à l'extérieur du cadre de l'élément et peut chevaucher d'autres contenus. La bordure, en revanche, modifie réellement la mise en page de la page pour s'assurer qu'elle s'adapte sans chevaucher quoi que ce soit d'autre (sauf si vous la configurez explicitement pour chevaucher).

Il est souvent plus pratique d'utiliser la propriété raccourcie outline lors de la définition de l'apparence d'un contour.

Accessibilité

Les styles de sélection personnalisés impliquent souvent des ajustements de la propriété outline. Si la couleur du contour est modifiée, il est important de s'assurer que le contraste entre celle-ci et l'arrière-plan sur lequel le contour est placé est suffisamment élevé pour que les personnes ayant une vision réduite puissent le percevoir.

Un contour est un indicateur visuel. Pour se conformer aux Directives pour l'accessibilité des contenus Web (WCAG), le critère de succès 1.4.11 Contraste non textuel exige une proportion de contraste d'au moins 3:1 entre le contour et les couleurs adjacentes sur lesquelles il se trouve. Notez que lorsque le contour est utilisé comme indicateur de sélection, les couleurs adjacentes incluent à la fois l'arrière-plan à l'extérieur de l'élément et l'arrière-plan de l'élément lui-même lorsque le contour borde les deux.

Définition formelle

Valeur initialeauto
Applicabilitétous les éléments
Héritéenon
Valeur calculéePour le mot-clé auto, la valeur calculée est currentcolor. Pour la valeur de la couleur, si la valeur est transparente, la valeur calculée sera la valeur rgba() correspondante. S'il n'y en a pas, ce sera la valeur rgb() correspondante. Le mot-clé transparent correspondra à rgba(0,0,0,0).
Type d'animationune couleur

Syntaxe formelle

outline-color = 
auto |
<'border-top-color'>

<border-top-color> =
<color> |
<image-1D>

<image-1D> =
<stripes()>

<stripes()> =
stripes( <color-stripe># )

<color-stripe> =
<color> &&
[ <length-percentage> | <flex> ]?

<length-percentage> =
<length> |
<percentage>

Exemples

Définir un contour bleu solide

HTML

html
<p>Mon contour est bleu, comme vous pouvez le voir.</p>

CSS

css
p {
  outline: 2px solid; /* Définir la largeur et le style du contour */
  outline-color: blue; /* Définir la couleur du contour */
  margin: 5px;
}

Résultat

Spécifications

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

Compatibilité des navigateurs

Voir aussi