border-top
==========

La propriété CSS **`border-top`** est une propriété raccourcie qui permet de paramétrer la bordure haute d'un élément.

C'est une propriété raccourcie qui permet de définir les valeurs de :

* `border-top-width`,
* `border-top-style`,
* `border-top-color`.
Exemple interactif
------------------

**Note :** Les trois valeurs de la propriété raccourcie peuvent être définies dans n'importe quel ordre et une ou deux d'entre elles peuvent être absentes.

Comme pour les autres propriétés raccourcies, `border-top` définit toujours les valeurs de toutes les propriétés qu'elle peut définir, même si celles-ci ne sont pas indiquées. Pour les valeurs qui ne sont pas indiquées, on prendra les valeurs par défaut. Ainsi :


```css
border-top-style: dotted;
border-top: thick green;
```


est équivalent à :


```css
border-top-style: dotted;
border-top: none thick green;
```


et la valeur `border-top-style` fournie avant `border-top` est ignorée.

La valeur par défaut de `border-top-style` étant `none`, si on ne définit pas le style de la bordure, on aura la valeur par défaut, c'est-à-dire qu'on aura aucune bordure.

Syntaxe
-------


```css
border-top: 1px;
border-top: 2px dotted;
border-top: medium dashed green;
```


Les valeurs de la propriété raccourcie peuvent être fournies dans n'importe quel ordre et une voire deux valeurs peuvent être omises.

### Valeurs

`<br-width>`

Voir `border-top-width`.

`<br-style>`

Voir `border-top-style`.

`<color>`

Voir `border-top-color`.

Définition formelle
-------------------

|  |  |
| --- | --- |
| Valeur initiale | pour chaque propriété individuelle de la propriété raccourcie :* `border-top-width`: `medium`
* `border-top-style`: `none`
* `border-top-color`: `currentcolor`
 |
| Applicabilité | tous les éléments. S'applique aussi à `::first-letter`. |
| Héritée | non |
| Valeur calculée | pour chaque propriété individuelle de la propriété raccourcie :* `border-top-width`: la longueur absolue ou `0` si `border-top-style` vaut `none` ou `hidden`
* `border-top-style`: comme spécifié
* `border-top-color`: couleur calculée
 |
| Type d'animation | pour chaque propriété individuelle de la propriété raccourcie :* `border-top-color`: une couleur
* `border-top-style`: discrète
* `border-top-width`: une longueur
 |

Syntaxe formelle
----------------
```

border-top =   
  <line-width>  ||  
  <line-style>  ||  
  <color>         
  
<line-width> =   
  <length [0,∞]>  |  
  thin            |  
  medium          |  
  thick             
  
<line-style> =   
  none    |  
  hidden  |  
  dotted  |  
  dashed  |  
  solid   |  
  double  |  
  groove  |  
  ridge   |  
  inset   |  
  outset    
  
```

Exemples
--------

### CSS


```css
.exemple {
  border-top: 3px dotted orange;
}
```

### HTML


```html
<p class="exemple">
  En passant elle prit sur un rayon un pot de confiture portant cette étiquette,
  « MARMELADE D’ORANGES. »
</p>
```

### Résultat

Spécifications
--------------

| Specification |
| --- |
| CSS Backgrounds and Borders Module Level 3 # border-shorthands |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.