大网数据广告活动
Web 标准与前端开发

CanvasRenderingContext2D:fontVariantCaps 属性

· 52CE 我爱测

Canvas API 的 `CanvasRenderingContext2D.fontVariantCaps` 属性用于指定渲染文本的替代大写形式。

Canvas API 的 CanvasRenderingContext2D.fontVariantCaps 属性用于指定渲染文本的替代大写形式。

该属性对应于 CSS 中的 font-variant-caps 属性。

值

字体的替代大写形式值,可以是以下之一:

  • normal(默认)
    • : 停用替代字形。
  • small-caps
    • : 启用小型大写字母(small capital)的显示(OpenType 特性:smcp)。小型大写字形通常使用大写字母的形式,但大小与小写字母相同。
  • all-small-caps
    • : 同时为大写和小写字母启用小型大写字母(small capital)的显示(OpenType 特性:c2sc、smcp)。
  • petite-caps
    • : 启用小型大写字母(petite capital)的显示(OpenType 特性:pcap)。
  • all-petite-caps
    • : 同时为大写和小写字母启用小型大写字母(petite capital)的显示(OpenType 特性:c2pc、pcap)。
  • unicase
    • : 启用将大写字母显示为小型大写字母(small capital),同时正常显示小写字母的混合显示(OpenType 特性:unic)。
  • titling-caps
    • : 启用标题大写字母的显示(OpenType 特性:titl)。大写字母字形通常设计用于与小写字母配合使用。在全大写的标题序列中使用时,它们可能显得过于强烈。标题大写字母是专为这种情况而设计的。

该属性可以用于获取或设置字体的大写值。

请注意,某些内容可能会引发无障碍问题,具体内容请参阅相应的 font-variant-caps 主题。

示例

以下示例演示了使用 fontVariantCaps 属性支持的每种值来显示文本“Hello World”。每种情况还通过读取属性来显示其值。

HTML

<canvas id="canvas" width="700" height="220"></canvas>

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
ctx.font = "20px serif";

// 默认值(normal)
ctx.fillText(`Hello world(默认:${ctx.fontVariantCaps})`, 5, 20);

// 大写形式:small-caps
ctx.fontVariantCaps = "small-caps";
ctx.fillText(`Hello world(${ctx.fontVariantCaps})`, 5, 50);

// 大写形式:all-small-caps
ctx.fontVariantCaps = "all-small-caps";
ctx.fillText(`Hello world(${ctx.fontVariantCaps})`, 5, 80);

// 大写形式:petite-caps
ctx.fontVariantCaps = "petite-caps";
ctx.fillText(`Hello world(${ctx.fontVariantCaps})`, 5, 110);

// 大写形式:all-petite-caps
ctx.fontVariantCaps = "all-petite-caps";
ctx.fillText(`Hello world(${ctx.fontVariantCaps})`, 5, 140);

// 大写形式:unicase
ctx.fontVariantCaps = "unicase";
ctx.fillText(`Hello world(${ctx.fontVariantCaps})`, 5, 170);

// 大写形式:titling-caps
ctx.fontVariantCaps = "titling-caps";
ctx.fillText(`Hello world(${ctx.fontVariantCaps})`, 5, 200);

结果

示例

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。