CSSFontFeatureValuesRule: characterVariant property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The read-only characterVariant property of the CSSFontFeatureValuesRule interface contains a CSSFontFeatureValuesMap object representing the user-defined-ident and feature index for a variable font which supports character-variant().

Value

A CSSFontFeatureValuesMap object.

Although the characterVariant property itself is read-only in the sense that you can't replace the CSSFontFeatureValuesMap object, you can still assign to the characterVariant property directly. You can also modify the values of the characterVariant using the CSSFontFeatureValuesMap instance methods.

Examples

Basic usage

CSS

css
@font-feature-values "MonteCarlo" {
  @character-variant {
    my-character-variant: 1;
  }
}

JavaScript

js
// look for the first stylesheet and the first cssRule in that sheet
const myRule = document.styleSheets[0].cssRules[0];
// check
if (
  myRule instanceof CSSFontFeatureValuesRule &&
  myRule.characterVariant.size
) {
  // do something with the characterVariant
}