font-variant

{{CSSRef}} 

The font-variant CSS shorthand property allows you to set all the font variants for a font.

You can also set the <font-variant-css2> values of font-variant defined in CSS Level 2.1, (that is, normal or small-caps), by using the font shorthand.

{{EmbedInteractiveExample("pages/css/font-variant.html")}} 

Constituent properties

This property is a shorthand for the following CSS properties:

• font-variant-alternates
• font-variant-caps
• font-variant-east-asian
• font-variant-emoji
• font-variant-ligatures
• font-variant-numeric
• font-variant-position

Syntax

font-variant: small-caps;
font-variant: common-ligatures small-caps;

/* Global values */
font-variant: inherit;
font-variant: initial;
font-variant: revert;
font-variant: revert-layer;
font-variant: unset;

Values

• normal

  • : Specifies a normal font face. Each longhand property has an initial value of normal.

• none

  • : Sets the value of the font-variant-ligatures as none and the values of the other longhand properties as normal, their initial value.

• <common-lig-values>, <discretionary-lig-values>, <historical-lig-values>, <contextual-alt-values>

  • : Specifies the keywords related to the font-variant-ligatures longhand property. The possible values are common-ligatures, no-common-ligatures, discretionary-ligatures, no-discretionary-ligatures, historical-ligatures, no-historical-ligatures, contextual, and no-contextual.

• stylistic(), historical-forms, styleset(), character-variant(), swash(), ornaments(), annotation()

  • : Specifies the keywords and functions related to the font-variant-ligatures longhand property.

• small-caps, all-small-caps, petite-caps, all-petite-caps, unicase, titling-caps

  • : Specifies the keywords and functions related to the font-variant-caps longhand property. The small-caps value is the only non-normal font variant valid within the {{cssxref("font")}}  shorthand property.

• <numeric-figure-values>, <numeric-spacing-values>, <numeric-fraction-values>, ordinal, slashed-zero

  • : Specifies the keywords related to the font-variant-numeric longhand property. The possible values are lining-nums, oldstyle-nums, proportional-nums, tabular-nums, diagonal-fractions, stacked-fractions, ordinal, and slashed-zero.

• <east-asian-variant-values>, <east-asian-width-values>, ruby

  • : Specifies the keywords related to the font-variant-east-asian longhand property. The possible values are jis78, jis83, jis90, jis04, simplified, traditional, full-width, proportional-width, and ruby.

• sub, super

  • : Specifies the keywords and functions related to the font-variant-position longhand property.

• text, emoji, unicode

  • : Specifies the keywords and functions related to the font-variant-emoji longhand property.

Formal definition

{{cssinfo}} 

Formal syntax

{{csssyntax}} 

Examples

Setting the small-caps font variant

HTML

<p class="normal">Firefox rocks!</p>
<p class="small">Firefox rocks!</p>

CSS

p.normal {
  font-variant: normal;
}
p.small {
  font-variant: small-caps;
}

Result

{{ EmbedLiveSample('Setting the small-caps font variant') }} 

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

• {{cssxref("text-transform")}} 
• {{cssxref("text-combine-upright")}} 
• {{cssxref("text-orientation")}} 
• SVG {{SVGAttr("font-variant")}}  attribute