border-top-style

La propriété border-top-style définit le style de ligne utilisé pour mettre en forme la bordure en haut d'une boîte.

Syntaxe

border-top-style: none;
border-top-style: hidden;
border-top-style: dotted;
border-top-style: dashed;
border-top-style: solid;
border-top-style: double;
border-top-style: groove;
border-top-style: ridge;
border-top-style: inset;
border-top-style: outset;

border-top-style: inherit;

Valeurs

<br-style>

Un mot-clé décrivant la forme qu'on souhaite avoir pour la bordure du côté haut. Il peut prendre l'une des valeurs suivantes :

none		L'effet obtenu est le même qu'avec hidden : aucune bordure n'est affichée. Dans ce cas, sauf si une image d'arrière-plan est définie, la valeur calculée de border-top-width sera 0, même si cette dernière indique une autre valeur. Lorsqu'utilisée sur une cellule d'un tableau avec la fusion des bordures, none a la priorité la plus basse donc si une autre bordure est définie et fusionne avec celle-ci, elle sera  affichée.
hidden		L'effet obtenu est le même qu'avec none : aucune bordure n'est affichée. Dans ce cas, sauf si une image d'arrière-plan est définie, la valeur calculée de border-top-width sera 0, même si cette dernière indique une autre valeur. Lorsqu'utilisée sur une cellule d'un tableau avec la fusion des bordures, hidden a la plus haute priorité et donc si une autre bordure est définie et fusionne avec celle-ci, aucune ne sera  affichée.
dotted		Affiche une série de points ronds. L'espace entre ces points n'est pas défini par la spécification et est donc laissé à l'implémentation. Le rayon des points correspond à la moitié de border-top-width.
dashed		Affiche une série de tirets. La taille de ces tirets n'est pas définie par la spécification et est laissée à l'implémentation.
solid		Affiche une ligne droite continue.
double		Deux lignes droites sont affichées dont la somme des épaisseurs correspond à la valeur fournie par border-width ou border-top-width.
groove		La bordure crée un effet 3D donnant l'impression qu'elle a été gravée dans le document. On obtient un effet opposé à ridge.
ridge		La bordure crée un effet 3D donnant l'impression que la bordure ressort du document. L'effet obtenu est opposé à celui obtenu avec groove.
inset		La bordure crée un effet 3D qui donne l'impression que la boîte est renfoncée dans le document (l'effet obtenu est opposé à celui obtenu avec outset). Lorsqu'elle est appliquée sur une cellule de tableau et que border-collapse vaut collapsed, cette valeur se comporte comme groove.
outset		La bordure crée un effet 3D qui fait ressortir la boîte (l'effet est opposé à inset). Lorsqu'elle est utilisé sur une cellule de tableau avec border-collapse qui vaut collapsed, cette valeur se comporte comme ridge.

inherit

Ce mot-clé représente le style de la bordure utilisé pour l'élément parent.

Syntaxe formelle

<br-style>
où 
<br-style> = none | hidden | dotted | dashed | solid | double | groove | ridge | inset | outset

Exemples

CSS

/* On applique un style sur le tableau */
table {
  border-width: 2px;
  background-color: #52E385;
}
tr, td {
  padding: 3px;
}

/* Des exemples pour border-top-style */
.b1 {border-top-style:none;}
.b2 {border-top-style:hidden;}
.b3 {border-top-style:dotted;}
.b4 {border-top-style:dashed;}
.b5 {border-top-style:solid;}
.b6 {border-top-style:double;}
.b7 {border-top-style:groove;}
.b8 {border-top-style:ridge;}
.b9 {border-top-style:inset;}
.b10 {border-top-style:outset;}

HTML

<table>
  <tr>
    <td class="b1">none</td>
    <td class="b2">hidden</td>
    <td class="b3">petits points</td>
    <td class="b4">tirets</td>
  </tr>
  <tr>
    <td class="b5">solid</td>
    <td class="b6">double</td>
    <td class="b7">groove</td>
    <td class="b8">ridge</td>
  </tr>
  <tr>
    <td class="b9">inset</td>
    <td class="b10">outset</td>
  </tr>
</table>

Résultat

Spécifications

Compatibilité des navigateurs

[1] Avant Firefox 50, les styles de bordure pour les coins arrondis (avec border-radius) étaient toujours affichés comme si border-top-style avait la valeur solid. Cela a été corrigé avec Firefox 50.

Voir aussi

• Les autres propriétés liées au style des bordures :
  • border-left-style
  • border-right-style
  • border-bottom-style
  • border-style.
• Les autres propriétés liées à la bordure haute :
  • border-top
  • border-top-color
  • border-top-width.