text-underline-offset
CSS
property sets the offset distance of an underline text decoration line (applied using
text-decoration
) from its original position.
text-underline-offset
is not part of the
text-decoration
shorthand. While an element can have multiple
text-decoration
lines,
text-underline-offset
only impacts underlining, and
not
other possible line decoration options such as
overline
or
line-through
.
/* Single keyword */ text-underline-offset: auto; /* length */ text-underline-offset: 0.1em; text-underline-offset: 3px; /* percentage */ text-underline-offset: 20%; /* Global values */ text-underline-offset: inherit; text-underline-offset: initial; text-underline-offset: unset;
text-underline-offset
property is specified as a single value from the list below.
auto
The browser chooses the appropriate offset for underlines.
<length>
<length>
, overriding the font file suggestion and the browser default. It is recommended to use
em
units so the offset scales with the font size.
<percentage>
<percentage>
of
1 em
in the element's font. A percentage inherits as a relative value, and so therefore scales with changes in the font. For a given application of this property, the offset is constant across the whole box that the underline is applied to, even if there are child elements with different font sizes or vertical alignment.
| 初始值 |
auto
|
|---|---|
| 适用于 |
所有元素。它还适用于
::first-letter
and
::first-line
.
|
| 继承 | yes |
| 百分比 | refer to the font size of the element itself |
| 计算值 | 如指定 |
| 动画类型 | by computed value type |
auto | <length> | <percentage>
<p class="oneline">Here's some text with an offset wavy red underline!</p> <br> <p class="twolines">This text has lines both above and below it. Only the bottom one is offset.</p>
p {
text-decoration: underline wavy red;
text-underline-offset: 1em;
}
.twolines {
text-decoration-color: purple;
text-decoration-line: underline overline;
}
| 规范 | 状态 | 注释 |
|---|---|---|
|
CSS Text Decoration Module Level 4
The definition of 'text-underline-offset' in that specification. |
工作草案 | 初始定义。 |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
text-underline-offset
|
Chrome
不支持
No
注意事项
|
Edge 不支持 No |
Firefox
完整支持
70
|
IE 不支持 No | Opera 不支持 No | Safari 完整支持 12.1 | WebView Android 不支持 No | Chrome Android 不支持 No | Firefox Android 不支持 No | Opera Android 不支持 No | Safari iOS 完整支持 12.2 | Samsung Internet Android 不支持 No |
| percentage values | Chrome 不支持 No | Edge 不支持 No | Firefox 完整支持 74 | IE 不支持 No | Opera 不支持 No | Safari 不支持 No | WebView Android 不支持 No | Chrome Android 不支持 No | Firefox Android 不支持 No | Opera Android 不支持 No | Safari iOS 不支持 No | Samsung Internet Android 不支持 No |
完整支持
不支持
见实现注意事项。
用户必须明确启用此特征。