::first-letter (:first-letter)

Sumari

El pseudo-element CSS ::first-letter selecciona la primera lletra de la primera línia d'un bloc, si no està precedit per qualsevol altre tipus de contingut (com imatges o taules en línia) en la seva línia.

La primera lletra d'un element que no és necessàriament trivial per identificar:

• Puntuació, és qualsevol caràcter definit en Unicode en open (Ps), close (Pe), initial quote (Pi), final quote (PF), other (PO) i altres classes de puntuació, abans o immediatament després de la primera lletre també es correspon per aquest pseudo-element.
• De la mateixa manera alguns idiomes tenen dígrafs que sempre es capitalitzen en conjunt, com el IJ en holandès. En aquests casos rars, les dues lletres del dígraf han d'anar acompanyades del pseudo-element ::first-letter. (Això no funciona bé en els navegadors, consulteu la taula de compatibilitat del navegador).
• Finalment, una combinació del pseudo-element ::before i la propietat content pot injectar una mica de text al principi de l'element. En aquest cas, ::first-letter coincidirà amb la primera lletra d'aquest contingut generat.

Una primera línia només té sentit en una caixa de bloc contenidor, per tant, el pseudo-element ::first-letter té un efecte només en elements amb un valor display de block, inline-block, table-cell, list-item o table-caption . En tots els altres casos, ::first-letter no té cap efecte.

Només un petit subconjunt de totes les propietats CSS es pot utilitzar dins d'un bloc de declaració d'un conjunt de regles CSS que conté un selector, usant el pseudo-element ::first-letter:

• Totes les propietats font: font, font-style, font-feature-settings, font-kerning, font-language-override, font-stretch, font-synthesis, font-variant, font-variant-alternates, font-variant-caps, font-variant-east-asian, font-variant-ligatures, font-variant-numeric, font-variant-position, font-weight, font-size, font-size-adjust, line-height i font-family.
• Totes les propietats background: background, background-color, background-image, background-clip, background-origin, background-position, background-repeat, background-size, background-attachment i background-blend-mode.
• Totes les propietats margin: margin, margin-top, margin-right, margin-bottom, margin-left.
• Totes les propietats padding: padding, padding-top, padding-right, padding-bottom, padding-left.
• Totes les propietats border: les shorthands border, border-style, border-color, border-width, border-radius, border-image i les propietats longhands.
• La propietat color.
• Les propietats CSS text-decoration, text-shadow, text-transform, letter-spacing, word-spacing (quan sigui apropiat ), line-height, text-decoration-color, text-decoration-line, text-decoration-style, box-shadow, float, vertical-align (unicament si float és none).

Ja que aquesta llista s'ampliarà en el futur, es recomana que no s'utilitzi altres propietats dins del bloc de declaració, per tal de mantenir el CSS a prova de futur.

Sintaxi

/* CSS3 syntax */
::first-letter { style properties }

/* CSS2 syntax */
:first-letter { style properties }

Exemple

Fa que la primera lletra de cada paràgraf sigui en vermell i gran.

Contingut HTML

<p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt
  ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo
  dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est. Lorem ipsum dolor
  sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy amet.</p>
<p>Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat.</p>
<p>Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut
  aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit
  esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et
  iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait
  nulla facilisi.</p>
<p>-The beginning of a special punctuation mark.</p>
<p>_The beginning of a special punctuation mark.</p>
<p>"The beginning of a special punctuation mark.</p>
<p>'The beginning of a special punctuation mark.</p>
<p>*The beginning of a special punctuation mark.</p>
<p>#The beginning of a special punctuation mark.</p>
<p>「特殊的汉字标点符号开头。</p>
<p>《特殊的汉字标点符号开头。</p>
<p>“特殊的汉字标点符号开头。</p>

Contingut CSS

p::first-letter { /* Use :first-letter if support for IE 8 or earlier is needed */
  color: red;
  font-size: 130%;
}

Sortida

Especificacions

Navegadors compatibles

Veure

• El pseudo-element ::first-line.