Border - Propriété CSS

border

Résumé des caractéristiques de la propriété border

Description rapide
Propriété résumée qui définit l'ensemble des paramètres des bordures : épaisseur, style et couleur.
Statut
Standard
Utilisable sur
HTML
Pourcentages
Ne s'appliquent pas.
Valeur initiale
Voir les propriétés individuelles.
Héritée par défaut
Non.
Voir les propriétés individuelles.
Module W3C
Module CSS - Arrière-plans et bordures
 🡇  
 🡅  
Statut du document: CR (document candidat à la recommandation)

Statut du document: WD (document de travail)

Statut du document: REC (recommandation)

Statut du document: DEPR (Ancienne spécification, déclarée obsolète)

Schéma syntaxique de border.

Diagramme syntaxique de border
Schéma syntaxique de la propriété border.
Télécharger le schéma en SVG.
  • length est une valeur numérique suivie d'une des unités de dimension.
  • color est une couleur exprimée dans n'importa laquelle des syntaxes reconnues par CSS (voir Les couleurs).

Description de la propriété border.

Une bordure est définie par trois propriétés : l'épaisseur, le type de trait et la couleur du trait. Ces paramètres peuvent être définis globalement pour l'ensemble des quatre côtés, ou au contraire être individualisés pour chacun des traits (en haut, à droite, en bas et à gauche). Ceci explique le nombre important de propriétés relatives aux bordures mais il ne s'agit que des combinaisons des trois paramètres de base et des quatre côtés.

La propriété border définit les trois paramètres (épaisseur, style et couleur) pour les quatre côtés de l'élément. Mais les nombreuses propriété résumée sont souvent utiles.

Propriétés résumées regroupant les valeurs des trois paramètres pour l'un des côtés :

border-top border-right border-bottom border-left

Propriétés résumées regroupant les valeurs d'un paramètres pour les 4 côtés :

border-color border-style border-width

Enfin, les propriétés détaillées, pour définir un des paramètres pour l'un des côtés :

border-width-top border-width-right border-width-bottom border-width-left
border-style-top border-style-right border-style-bottom border-style-left
border-color-top border-color-right border-color-bottom border-color-left

Pour plus d'informations sur les valeurs possibles avec border, reportez-vous aux propriétés border-width, border-style et border-color.

Attention ! La bordure définie par border peut être masquée si une bordure image est définie par la suite ou avec une priorité supérieure (voir border-image).

Ne confondez pas bordures et contours. Reportez-vous à la description de la propriété CSS outline pour une présentation détaillée des différences entre bordures et contours.

Particularités des propriétés résumées.

Le fait que les propriétés résumées définissent toutes les valeurs qui les concerne, même si certaines ne sont pas spécifiées, peut conduire à des résultats surprenants, mais explicables. Ce comportement est commun à toutes les propriétés résumées, pas seulement celles qui concernent les bordures, mais il est particulièrement présent dans le cas des bordures car on utilise principalement des propriétés résumées.

border-color:red; border:2px solid;
La couleur définie par border-color est ré-initialisée par la propriété border qui suit : bien que la couleur ne soit pas spécifiée, elle est remise à sa valeur initiale.
border:2px solid red; border-top:6px double;
Ce deuxième exemple est encore plus surprenant : la couleur rouge est réinitialisée par border-top, alors que le développeur pensait probablement modifier uniquement l'épaisseur et le style de trait.

Prise en charge de la langue.

Les propriétés border-top, border-right, border-bottom, border-left, ainsi que leurs déclinaisons pour chacun des paramètres de la bordure, peuvent être remplacées par leur équivalent logique si on souhaite que les bordures s'adaptent à la langue du texte. Les propriétés logiques sont les suivantes, avec leur correspondance avec les propriétés physiques dans le cas des langues latines :

Propriétés logiquesPropriétés physiques
équivalentes pour le latin
border-block-start-width
border-inline-end-width
border-block-end-width
border-inline-start-width
border-width-top
border-width-right
border-width-bottom
border-width-left
border-block-start-style
border-inline-end-style
border-block-end-style
border-inline-start-style
border-style-top
border-style-right
border-style-bottom
border-style-left
border-block-start-color
border-inline-end-color
border-block-end-color
border-inline-start-color
border-color-top
border-color-right
border-color-bottom
border-color-left
border-block-start
border-inline-end
border-block-end
border-inline-start
border-top
border-right
border-bottom
border-left
border-block-width
border-inline-width
border-block-style
border-inline-style
border-block-color
border-inline-color

Mais le plus souvent on se contentera des propriétés résumées regroupant les paramètres pour l'un des bords. Elles sont présentées sur le schéma ci-dessous.

border-top
border-left
La direction et le sens d'écriture de ce texte s'adaptent à la langue choisie.
border-right
border-bottom

Valeurs pour border.

  • border: none;

    Valeur par défaut. Aucune bordure n'est tracée autour de l'élément.

  • border: solid;

    Syntaxe minimale : une bordure est tracée, avec l'épaisseur par défaut (medium) et la couleur par défaut (currentcolor).

    Pour connaître les différents types de tracé, reportez-vous à la propriété border-style.

  • border: 2px solid green;

    Syntaxe complète, décrivant l'épaisseur de la bordure, son type, et sa couleur.

  • border: initial; border: inherit; border: revert; border: revertLayer; border: unset;

    Ces valeurs sont décrites plus en détail sur leur page respective : initial, inherit, revert, revert-layer, unset.

Exemples avec la propriété border.

Bordure classique : il suffit de définir son épaisseur et son style (la couleur sera la même que celle du texte)

Une bordure avec effet 3D (ridge). Pour que l'effet 3D soit correctement restitué, prévoir une épaisseur suffisante (5 pixels le plus souvent), et une couleur de luminosité intermédiaire (ici du gris).

Bordure en pointillés sur les côtés verticaux et en tirets sur les côtés haut et bas.

Bordure avec effet 3D (groove) et avec des coins arrondis (voir border-radius). Les bordures 3D ne sont pas faciles à restituer avec des coins arrondis : on note des imperfections dans les arrondis en haut à droite et en bas à gauche.

251814
8180
40027

Bordure à gauche et à droite seulement, avec des coins arrondis. Appliquée à un tableau, cette bordure permet de présenter facilement une matrice telle qu'on la représente habituellement en mathématique.

 

Prise en charge de border par les navigateurs.

Aucun problème de compatibilité : les bordures sont correctement gérées par les navigateurs depuis très longtemps.

Colonne 1
Traitement correct par les navigateurs de la propriété résumée border, qui définit tous les paramètres d'une bordure.
1
Propriété
border
Estimation de la prise en charge globale.
96%

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.

  • CSS 1 - Spécification concernant les feuilles de styles en cascade - Version 1

    Ce premier niveau de la spécification CSS décrit le mécanisme des feuilles de styles en cascade. Les auteurs et les lecteurs peuvent ajouter des styles aux documents. Principalement destiné à la mise en forme des documents HTML, CSS permet de définir les couleurs, les polices de caractères, la mise en forme du texte, les espacements (marges), etc. Le langage CSS est d'une compréhension aisée, lisible et facile à rédiger, il utilise les termes courants de la publication de bureau.

    Concernant border. Définition initiale des propriétés relatives aux bordures et de la propriété résumée border.
    WD
    17 Novembre 1995
    Document de travail.
    PR
    12 Novembre 1996
    Proposé à la recommandation.
    REC
    17 Décembre 1996
    Recommandation.
    DEPR
    13 Septembre 2018
    Ancienne spécification, déclarée obsolète.
  • CSS 2.1 - Spécification concernant les feuilles de styles en cascade - Révision 1

    Ce niveau 2 de la spécification décrit le mécanisme des styles en cascade de CSS. Ce langage est utilisé pour formater les documents HTML ou XML. Il prend en charge les feuilles de style spécifiques aux médias afin que les auteurs puissent adapter la présentation de leurs documents aux navigateurs visuels, aux dispositifs auditifs, aux imprimantes, aux appareils braille, aux appareils portables, etc.

    Concernant border. Pas de changement sur les propriétés définissant les bordures, si ce n'est qu'elles acceptent la valeur inherit.
    WD
    04 Novembre 1997
    Document de travail.
    PR
    24 Mars 1998
    Proposé à la recommandation.
    REC
    11 Mai 1998
    Recommandation.
  • Module CSS - Propriétés et valeurs logiques - Niveau 1

    Concernant border. Introduction des propriétés logiques pour définir les bordures. Ces propriétés sont dépendantes du mode d'écriture de la langue utilisée.
    WD
    18 Mai 2017
    Document de travail.
    CR
    PR
    REC
  • Module CSS - Arrière-plans et bordures - Niveau 3

    Concernant border. Pas de changement concernant directement les propriétés relatives aux bordures, mais les propriétés détaillées ont maintenant un équivalent logique (prenant en charge le mode d'écriture en fonction de la langue).
    WD
    02 Août 2002
    Document de travail.
    CR
    17 Décembre 2009
    Candidat à la recommandation.
    PR
    REC

Voir aussi, au sujet des bordures.

Les descriptions des propriétés relatives aux arrière-plans et aux bordures sont rassemblées dans la spécification du W3C "Module CSS - Arrière-plans et bordures".

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 : épaisseur, style et couleur.
border-bottom-color
Définit la couleur du trait de bordure pour le bas de l'élément.
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-bottom-style
Définit le style de trait pour la bordure en dessous de l'élément.
border-bottom-width
Définit l'épaisseur du trait de bordure situé en dessous de l'élément.
border-color
Définit la couleur des bordures pour les 4 cotés de l'élément.
border-image
Résumé des propriétés des bordures réalisées avec des images.
border-image-outset
Définit le débordement de l'image de bordure.
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 le chemin et le nom de fichier pour 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-left-color
Définit la couleur du trait de bordure à gauche de l'élément.
border-left-style
Définit le type de trait pour la bordure sur la gauche de l'élément.
border-left-width
Définit l'épaisseur du trait de bordure situé à gauche de l'élément.
border-radius
Rayon des angles arrondis.
border-right-color
Définit la couleur du trait de bordure à droite de l'élément.
border-right-style
Définit le type de trait pour la bordure à droite de l'élément.
border-right-width
Définit l'épaisseur du trait de bordure situé à droite de l'élément.
border-style
Définit le type de trait pour les quatre bordures autour de l'élément (solide, double, pointillé...).
border-top-color
Définit la couleur du trait de la bordure au dessus de l'élément.
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-top-style
Définit le type de trait pour la bordure à gauche de l'élément.
border-top-width
Définit l'épaisseur du trait de bordure au dessus de l'élément.
border-width
Définit l'épaisseur du trait de la bordure situé tout autour 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.