Back to Content

ascent-override

files/en-us/web/css/reference/at-rules/@font-face/ascent-override/index.md

latest1.7 KB
Original Source

The ascent-override CSS descriptor for the {{cssxref("@font-face")}} at-rule defines the ascent metric for the font. The ascent metric is the height above the baseline that CSS uses to lay out line boxes in an inline formatting context.

Syntax

css
ascent-override: normal;
ascent-override: 90%;

Values

  • normal
    • : The default value. When used the metric value is obtained from the font file.
  • <percentage>
    • : A {{cssxref("<percentage>")}} value.

Formal definition

{{cssinfo}}

Formal syntax

{{csssyntax}}

Examples

Overriding metrics of a fallback font

The ascent-override property can help when overriding the metrics of a fallback font to better match those of a primary web font.

css
@font-face {
  font-family: "web-font";
  src: url("https://example.com/font.woff");
}

@font-face {
  font-family: "local-font";
  src: local("Local Font");
  ascent-override: 125%;
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{cssxref("@font-face/descent-override", "descent-override")}}
  • {{cssxref("@font-face/font-display", "font-display")}}
  • {{cssxref("@font-face/font-family", "font-family")}}
  • {{cssxref("@font-face/font-weight", "font-weight")}}
  • {{cssxref("@font-face/font-style", "font-style")}}
  • {{cssxref("@font-face/font-stretch", "font-stretch")}}
  • {{cssxref("font-feature-settings", "font-feature-settings")}}
  • {{cssxref("@font-face/font-variation-settings", "font-variation-settings")}}
  • {{cssxref("@font-face/line-gap-override", "line-gap-override")}}
  • {{cssxref("@font-face/src", "src")}}
  • {{cssxref("@font-face/size-adjust", "size-adjust")}}
  • {{cssxref("@font-face/unicode-range", "unicode-range")}} descriptor