Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

::first-line — la première ligne mise en forme

Le pseudo-élément ::first-line met en forme la première ligne du contenu après la mise en page du texte par le navigateur. Sa portée dépend des retours à la ligne, et non des lignes du code source. L’écriture :first-line est une syntaxe équivalente plus ancienne.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

selector::first-line { color: navy; }
/* Legacy equivalent: */
selector:first-line { color: navy; }

::first-line représente le contenu de la première ligne mise en forme d’un élément. Il ne sélectionne ni un élément DOM distinct ni la première ligne du fichier HTML. La largeur du conteneur et les métriques de la police influencent les fragments de texte concernés ; sa portée peut changer lorsque la mise en page change.

Ce pseudo-élément agit sur les conteneurs de type bloc, et non sur les éléments ordinaires avec display: inline. Si un conteneur contient du contenu de niveau bloc, sa première ligne peut provenir de son premier enfant de niveau bloc dans le flux normal. Une première ligne vide compte également.

Les propriétés applicables comprennent les propriétés de police, color, les arrière-plans, text-transform et les décorations de texte. Ce n’est pas une boîte ordinaire permettant un positionnement arbitraire : ne l’utilisez pas pour définir la largeur ou les marges d’une ligne. writing-mode, direction et text-orientation sont exclus.

Utilisez ::first-line dans le nouveau code. L’ancienne écriture :first-line désigne le même pseudo-élément, et non une pseudo-classe. Dans l’exemple, un saut de ligne explicite sépare alpha beta de gamma delta ; seule la première ligne doit devenir bleu marine et passer en majuscules.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>::first-line example</title>
<style>
  .sample {
    width: 30em;
    font: 20px/1.5 monospace;
    color: black;
  }
  .sample::first-line {
    color: navy;
    text-transform: uppercase;
  }
</style>
<p class="sample">alpha beta<br>gamma delta</p>
</html>

Résultat

ALPHA BETA
gamma delta

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources