CSSFontFeatureValuesRule

基线 2025 *
新推出

自 ⁨2025 年 3 月⁩ 起,此功能可在最新的设备和浏览器版本上使用。此功能可能在旧设备或浏览器上无法正常工作。

* 此特性的某些部分可能存在不同级别的支持。

CSSFontFeatureValuesRule 接口代表一个 @font-feature-values at-rule,允许开发者为每个字体人脸(font face)分配一个通用名称,以指定在 font-variant-alternates 中使用的特性索引。

CSSRule CSSFontFeatureValuesRule

实例属性

继承自其祖先 CSSRule 的属性。

CSSFontFeatureValuesRule.fontFamily

一个字符串,标识此规则适用的字体系列。

实例方法

继承其祖先 CSSRule 的方法。

示例

读取字体系列

在此示例中,我们声明了两个 @font-feature-values 规则,一个用于Font One字体系列,另一个用于Font Two。然后,我们使用 CSSOM 读取这些字体系列,并将它们显示在日志中。

HTML

html
<pre id="log"></pre>

CSS

css
/* At-rule for "nice-style" in Font One */
@font-feature-values Font One {
  @styleset {
    nice-style: 12;
  }
}

/* At-rule for "nice-style" in Font Two */
@font-feature-values Font Two {
  @styleset {
    nice-style: 4;
  }
}

/* Apply the at-rules with a single declaration */
.nice-look {
  font-variant-alternates: styleset(nice-style);
}

JavaScript

js
const log = document.getElementById("log");
const rules = document.getElementById("css-output").sheet.cssRules;

const fontOne = rules[0]; // A CSSFontFeatureValuesRule
log.textContent = `The 1st '@font-feature-values' family: "${fontOne.fontFamily}".\n`;

const fontTwo = rules[1]; // Another CSSFontFeatureValuesRule
log.textContent += `The 2nd '@font-feature-values' family: "${fontTwo.fontFamily}".`;

规范

规范
CSS 字体模块第 4 级
# cssfontfeaturevaluesrule

浏览器兼容性

另见