Border-image-outset - Propriété CSS

border-image-outset

Résumé des caractéristiques de la propriété border-image-outset

Description rapide
Définit le débordement de l'image de bordure.
Statut
Standard
Utilisable sur
HTML
Valeurs prédéfinies
0
Pourcentages
Ne s'appliquent pas.
Valeur initiale
0
Héritée par défaut
Non.
Type d'animation
Computed value : lors d'une animation, la propriété border-image-outset passe progressivement d'une valeur à une autre.
Module W3C
Module CSS - Arrière-plans et bordures
Références (W3C)
Statut du document: CR (document candidat à la recommandation)

Schéma syntaxique de border-image-outset.

border-image-outset - Syntax DiagramSyntax diagram of the border-image-outset CSS property. See stylescss.free.fr for details. length length number number {1,4} {1,4}border-image-outset:;border-image-outset:;
Schéma syntaxique de la propriété border-image-outset
Syntaxe détaillée

Sur le schéma ci-dessus...

  • length est un nombre positif ou nul suivi d'une des unités de dimension.
  • number est un nombre positif sans unité.
  • Ces syntaxes peuvent être répétées de 1 à 4 fois.

Description de la propriété border-image-outset.

border-image-outset définit un décalage de la bordure-image vers l'extérieur de l'élément. Elle accepte de une à quatre valeurs:

  • Si une seule valeur est précisée, elle s'applique aux quatre cotés.
  • Si deux valeurs sont précisées, la première définit le débordement des bordures haute et basse ; la deuxième des bordures gauche et droite.
  • Si trois valeurs sont indiquées, la première définit le débordement de la bordure du haut, la deuxième celle des cotés droite et gauche et la dernière le débordement sur la bordure du bas.
  • Enfin, lorsque les quatre valeurs sont indiquées, elles correspondent respectivement au débordement sur les cotés haut, droit, bas et gauche.

Sur l'exemple : ci-après la bordure image a été décalée de 20 pixels vers l'extérieur de l'élément. La couleur du fond fait apparaître les limites de l'élément.

Attention ! décaler la bordure ne change rien aux dimensions de l'élément, et donc en conséquence ne provoque pas un décalage des éléments qui suivent. La bordure image peut donc entrer en collision avec d'autres éléments.

D'autre part, et pour cette même raison que l'élément n'est pas agrandi, les événements de souris qui se produisent sur la bordure, à l'extérieur de la surface normale de l'élément, ne seront pas traités. Si la bordure est fortement décalée, ceci peut être déroutant pour l'utilisateur. En déplaçant la souris sur l'exemple ci-dessous on voit que le curseur change de forme. Ceci indique la zone qui est sensible au clic. On constate qu'elle ne s'étend pas jusqu'à la bordure.
 

 

 

Pour une présentation générale de l'utilisation d'images dans les bordures, reportez-vous à la propriété résumée border-image.

Syntaxes pour border-image-outset.

  • border-image-outset: 10px;

    Une valeur positive ou nulle, avec son unité de dimension (voir les unités de dimension. La valeur par défaut est 0. La bordure-image sera décalée de la valeur indiquée, vers l'extérieur de l'élément.

    Les valeurs négatives sont interdites : il n'est donc pas possible de faire pénétrer la bordure à l'intérieur de l'élément.

  • border-image-outset: 2;

    Une valeur positive ou nulle, sans unité. Cette valeur est un multiple de la largeur de la bordure (border-width).

  • border-image-outset: 2 10 15;

    De une à quatre valeurs peuvent se succéder, séparées par des espaces.

    • Si une seul valeur est présente, elle s'applique à tous les côtés de l'élément/li>
    • Si deux valeurs sont présentes, la première s'applique aux côtés haut et bas, la deuxième aux côtés gauche et droit.
    • Si trois valeurs sont définies, la première s'applique au côté haut, la deuxième aux côtés gauche et droit, et la troisième au côté bas.
    • Enfin, si quatre valeurs sont définies, elles s'appliquent successivement aux côtés haut, droit, bas et gauche.
    Syntaxe avec une seule valeur Syntaxe avec deux valeurs Syntaxe avec trois valeurs Syntaxe avec quatre valeurs

Valeurs globales
(communes à toutes les propriétés)

border-image-outset: initial (0) border-image-outset: inherit border-image-outset: revert border-image-outset: revertLayer border-image-outset: unset

Consultez les pages suivantes pour plus de détails : initial, inherit, revert, revert-layer, unset.

Animation de la propriété border-image-outset.

La propriété border-image-outset peut être animée pour donner un effet de 'respiration', sans que les autres éléments de la page ne soient impactés.

Attention ! Il y a un petit piège dans l'écriture de la directive @keyframes. Dans la mesure où border-image-outset accepte des nombres sans unité ET des nombres avec une unité de dimension, il faut veiller à ce que la clause from et la clause to soient bien exprimées dans la même unité. C'est particulièrement trompeur avec la valeur 0 qui, d'habitude, peut être écrite sans unité sans que cela pose de problème. Mais ici, le code suivant ne générera pas une animation progressive de 0 à 20 pixels.

@keyframes xxx { from {border-image-outset:0;} /* erreur */ to {border-image-outset:20px;} }

Exemple interactif.

border-image-outset :

Prise en charge par les navigateurs.

La propriété border-image-outset ainsi que toutes les propriétés relatives aux images de bordure sont correctement prises en charge par les navigateurs actuels.

Colonne 1
Possibilité d'utiliser des images pour construire des bordures et, donc, support de la propriété border-image.
Colonne 2
Traitement correct par les navigateurs de la propriété border-image-outset, qui mentionne un espace entre le bord de l'élément et sa bordure.

Remarques :

(1) Supporte la propriété résumé mais pas les propriétés détaillées.

1
Utilisation d'images
pour des bordures
2
Propriété
border-image-outset
Estimation de la prise en charge globale.
97%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

KaiOS Browser

Opéra Mobile

Chrome

Edge

Opéra

Safari

Safari sur IOS

Androïd Brower

Chrome pour Androïd

Firefox pour Androïd

Samsung Internet

Firefox

Baidu Browser

QQ Browser

UC Browser pour Androïd

Opéra mini

Historique de la propriété border-image-outset.

Voir aussi : autres caractéristiques des bordures et arrière-plans.

Les propriétés relatives aux bordures et aux arrière-plans sont décrites dans la spécification du W3C dénommée CSS Backgrounds and Borders Module. En voici la liste :

Propriétés :

background
Résumé des propriétés de l'arrière-plan.
background-attachment
Mode de défilement de l'image d'arrière-plan.
background-clip
Définit l'étendue de l'arrière-plan, en particulier par rapport à la bordure et aux marges intérieures..
background-color
Définit la couleur en arrière-plan.
background-image
Définit l'image ou dégradé d'arrière-plan (plusieurs images ou dégradés peuvent coexister).
background-origin
Définit une référence pour positionner l'image d'arrière-plan.
background-position
Définit comment se positionne l'image d'arrière-plan.
background-position-x
Définit comment se positionne l'image d'arrière-plan dans le sens horizontal.
background-position-y
Définit comment se positionne l'image d'arrière-plan dans le sens vertical.
background-repeat
Définit comment est répétée l'image d'arrière-plan.
background-size
Dimensionnement de l'image d'arrière-plan.
border
Propriété résumée qui définit l'ensemble des paramètres des bordures.
border-bottom-left-radius
Définit le rayon de l'angle arrondi en bas à gauche.
border-bottom-right-radius
Définit le rayon de l'angle arrondi en bas à droite.
border-color
Définit la couleur des bordures.
border-image
Résumé des propriétés des bordures réalisées avec des images.
border-image-repeat
Définit comment l'image de bordure est répétée ou dilatée pour couvrir la zone voulue.
border-image-slice
Définit comment l'image de bordure est découpée.
border-image-source
Définit l'image utilisée pour construire la bordure.
border-image-width
Définit l'épaisseur de la bordure lorsque cette dernière est réalisée avec une image.
border-radius
Rayon des angles arrondis.
border-style
Type de bordure (solide, double, pointillé...).
border-top-left-radius
Définit le rayon de l'angle arrondi en haut à gauche.
border-top-right-radius
Définit le rayon de l'angle arrondi en haut à droite.
border-width
Définit l'épaisseur de la bordure de l'élément.
box-shadow
Applique un effet d'ombrage sur les blocs en indiquant tous les paramètres : couleur, décalage de l'ombre, flou, etc.