@font-feature-values

语法

@font-feature-values Font Name {
  font-display: swap;
  @styleset {
    nice-style: 12;
  }
  @swash {
    fancy: 2;
  }
}

每个 @font-feature-values 块可以包含一个特性值块列表（如下所示），以及 font-display 描述符。

特性值块

@swash

指定一个特性名称，该名称将与 font-variant-alternates 的 swash() 函数符号一起使用。一个 swash 特性值定义只允许一个值：ident1: 2 是有效的，但 ident2: 2 4 无效。

@annotation

指定一个特性名称，该名称将与 font-variant-alternates 的 annotation() 函数符号一起使用。一个 annotation 特性值定义只允许一个值：ident1: 2 是有效的，但 ident2: 2 4 无效。

@ornaments

指定一个特性名称，该名称将与 font-variant-alternates 的 ornaments() 函数符号一起使用。一个 ornaments 特性值定义只允许一个值：ident1: 2 是有效的，但 ident2: 2 4 无效。

@stylistic

指定一个特性名称，该名称将与 font-variant-alternates 的 stylistic() 函数符号一起使用。一个 stylistic 特性值定义只允许一个值：ident1: 2 是有效的，但 ident2: 2 4 无效。

@styleset

指定一个特性名称，该名称将与 font-variant-alternates 的 styleset() 函数符号一起使用。一个 styleset 特性值定义允许无限数量的值：ident1: 2 4 12 1 映射到 OpenType 值 ss02、ss04、ss12 和 ss01。请注意，大于 99 的值是有效的，但不会映射到任何 OpenType 值并被忽略。

@character-variant

指定一个特性名称，该名称将与 font-variant-alternates 的 character-variant() 函数符号一起使用。一个 character-variant 特性值定义允许一个或两个值：ident1: 3 映射到 cv03=1，ident2: 2 4 映射到 cv02=4，但 ident2: 2 4 5 是无效的。

正式语法

@font-feature-values = 
  @font-feature-values <family-name># { <declaration-rule-list> }  

<family-name> = 
  <string>         |
  <custom-ident>+  

示例

在 @font-feature-values 规则中使用 @styleset

/* 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);
}

规范

浏览器兼容性

另见

• font-variant-alternates 属性使用此 @规则定义的值。