大网数据广告活动
Web 标准与前端开发

::first-letter

· 52CE 我爱测

**`::first-letter`** CSS 伪元素将样式应用于区块容器第一行的第一个字母,但仅当其前面没有其他内容(例如图像或行内表格)时才有效。

::first-letter CSS 伪元素将样式应用于区块容器第一行的第一个字母,但仅当其前面没有其他内容(例如图像或行内表格)时才有效。

CSS Demo: ::first-letter

p::first-letter {
  font-size: 1.5rem;
  font-weight: bold;
  color: brown;
}
<p>
  Scientists exploring the depths of Monterey Bay unexpectedly encountered a
  rare and unique species of dragonfish. This species is the rarest of its
  species.
</p>

<p>
  When Robison and a team of researchers discovered this fish, they were aboard
  a week-long expedition.
</p>

元素的第一个字母并不总是容易识别:

  • 第一个字母之前或紧随其后的标点符号也包含在匹配中。标点符号包括在 Unicode 中定义的开始括号(Ps)、结束括号(Pe)、起始引号(Pi)、结束引号(pf)和其他标点符号(po)类别的任何字符。
  • 有些语言的数字符总是一起大写,如荷兰语中的 IJ。在这种情况下,数字的两个字母都应与 ::first-letter 伪元素匹配。
  • ::before 伪元素和 content 属性的组合可能会在元素开头注入一些文本。在这种情况下,::first-letter 将匹配生成内容的第一个字母。

[!NOTE] CSS 引入了 ::first-letter 符号(带两个冒号),以区分伪类和伪元素。为了向后兼容,浏览器也接受早先引入的 :first-letter。

浏览器对荷兰语中 IJ 等数字字符的支持较差。请查看下面的兼容性表,以了解当前的支持情况。

允许的属性

只有一小部分 CSS 属性可以与 ::first-letter 伪元素一起使用:

  • 所有字体属性: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 和 font-family
  • 所有背景属性:background、background-color、background-image、background-clip、background-origin、background-position、background-repeat、background-size、background-attachment 和 background-blend-mode
  • 所有外边距属性:margin、margin-top、margin-right、margin-bottom、margin-left
  • 所有内边距属性:padding、padding-top、padding-right、padding-bottom、padding-left
  • 所有边界属性:简写 border、border-style、border-color、border-width、border-radius、border-image,以及详细属性
  • color 属性
  • text-decoration、text-shadow、text-transform、letter-spacing、word-spacing(在适当的时候)、line-height、text-decoration-color、text-decoration-line、text-decoration-style、box-shadow、float、vertical-align(仅当 float 为 none 时)CSS 属性

语法

::first-letter {
  /* ... */
}

示例

简单的下沉式首字母

在此示例中,我们将使用 ::first-letter 伪元素在紧接 <h2> 后的段落的首字母上创建一个简单的下沉式首字母效果。

HTML

<h2>我的标题</h2>
<p>
  人的心只容得下一定程度的绝望,海绵已经吸够了水,即使大海从它上面流过,也不能再给它增添一滴水了。文学就像炉中的火一样,我们从人家借得火来,把自己点燃,而后传给别人,以致为大家所共同拥有。魂牵梦萦在江南,有一片土地,名唤故乡;对酒当歌在烟雨,有一份情愫,称作痴迷。
</p>
<p>世界上最宽阔的是海洋,比海洋更宽阔的是天空,比天空更宽阔的是人的心灵。</p>

CSS

p {
  width: 500px;
  line-height: 1.5;
}

h2 + p::first-letter {
  color: white;
  background-color: black;
  border-radius: 2px;
  box-shadow: 3px 3px 0 red;
  font-size: 250%;
  padding: 6px 3px;
  margin-right: 6px;
  float: left;
}

结果

简单的下沉式首字母

对特殊标点符号和非拉丁字符的影响

此示例说明了 ::first-letter 对特殊标点符号和非拉丁字符的影响。

HTML

<p>一些段落,一些段落,一些段落,一些段落。</p>
<p>-特殊标点符号的开头。</p>
<p>_特殊标点符号的开头。</p>
<p>"特殊标点符号的开头。</p>
<p>'特殊标点符号的开头。</p>
<p>*特殊标点符号的开头。</p>
<p>#特殊标点符号的开头。</p>
<p>「特殊的汉字标点符号开头。</p>
<p>《特殊的汉字标点符号开头。</p>
<p>"特殊的汉字标点符号开头。</p>

CSS

p::first-letter {
  color: red;
  font-size: 150%;
}

结果

对特殊标点符号和非拉丁字符的影响

为 SVG 文本元素中的第一个字母设置样式

在此示例中,我们使用 ::first-letter 伪元素来设置 SVG text 元素中第一个字母的样式。

[!NOTE] 在撰写本文时,此功能已获得有限支持。

HTML

<svg viewBox="0 0 300 40">
  <text y="30">&lt;text&gt; SVG 中的首个字母</text>
</svg>

CSS

text {
  font-family: sans-serif;
}

text::first-letter {
  font-family: serif;
  font-size: 2rem;
  font-weight: 600;
  fill: tomato;
  stroke: indigo;
}

结果

为 SVG 文本元素中的第一个字母设置样式

规范

浏览器兼容性

参见

  • ::first-line

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。