border-left
===========

La propriété **`border-left`** est une propriété raccourcie qui permet de définir la bordure gauche d'un élément

Cette propriété raccourcie définit les valeurs des propriétés détaillées suivantes :

* `border-left-width`,
* `border-left-style`,
* `border-left-color`.

Ces propriétés permettent de décrire la bordure du côté gauche d'un élément.

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-left` 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-left-style: dotted;
border-left: thick green;
```


est équivalent à :


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


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

La valeur par défaut de `border-left-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-left: 1px;
border-left: 2px dotted;
border-left: medium dashed green;
```

### Valeurs

`<br-width>`

Voir `border-left-width`.

`<br-style>`

Voir `border-left-style`.

`<color>`

Voir `border-left-color`.

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

|  |  |
| --- | --- |
| Valeur initiale | pour chaque propriété individuelle de la propriété raccourcie :* `border-left-width`: `medium`
* `border-left-style`: `none`
* `border-left-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-left-width`: la longueur absolue ou `0` si `border-left-style` vaut `none` ou `hidden`
* `border-left-style`: comme spécifié
* `border-left-color`: couleur calculée
 |
| Type d'animation | pour chaque propriété individuelle de la propriété raccourcie :* `border-left-color`: une couleur
* `border-left-style`: discrète
* `border-left-width`: une longueur
 |

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

border-left =   
  <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-left: 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.