font-variant-ligatures property CSS Reference



Definition and Usage

Ligatures and contextual forms are ways of combining glyphs to produce more harmonized forms. For OpenType fonts, common ligatures and contextual forms are on by default, discretionary and historical ligatures are not. A value of 'none' implies that all types of ligatures and contextual forms covered by this property are explicitly disabled. In situations where ligatures are not considered necessary, this may improve the speed of text rendering.

  • <common-lig-values> = [ common-ligatures | no-common-ligatures ]
  • <discretionary-lig-values> = [ discretionary-ligatures | no-discretionary-ligatures ]
  • <historical-lig-values> = [ historical-ligatures | no-historical-ligatures ]
  • <contextual-alt-values> = [ contextual | no-contextual ]
Name: font-variant-ligatures
Value: normal | none | [ <common-lig-values> || <discretionary-lig-values> || <historical-lig-values> || <contextual-alt-values> ]
Initial: normal
Applies to: all elements
Inherited: yes
Percentages: N/A
Media: visual
Computed value: as specified

Syntax

font-variant-ligatures : normal | none | [ <common-lig-values> || <discretionary-lig-values> || <historical-lig-values> || <contextual-alt-values> ]

Values

common-ligatures
Enables display of common ligatures (OpenType features: liga, clig). For OpenType fonts, common ligatures are enabled by default.
no-common-ligatures
Disables display of common ligatures (OpenType features: liga, clig).
discretionary-ligatures
Enables display of discretionary ligatures (OpenType feature: dlig). Which ligatures are discretionary, or optional, is decided by the type designer so authors will need to refer to the documentation of a given font to understand which ligatures are considered discretionary.
no-discretionary-ligatures
Disables display of discretionary ligatures (OpenType feature: dlig).
historical-ligatures
Enables display of historical ligatures (OpenType feature: hlig).
no-historical-ligatures
Disables display of historical ligatures (OpenType feature: hlig).
contextual
Enables display of contextual alternates (OpenType feature: calt). Although not strictly a ligature feature, like ligatures this feature is commonly used to harmonize the shapes of glyphs with the surrounding context. For OpenType fonts, this feature is on by default.
no-contextual
Disables display of contextual alternates (OpenType feature: calt).

Examples

No examples


Relative articles