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

CanvasRenderingContext2D:textBaseline 属性

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.textBaseline`** 属性用于描述绘制文本时使用的文本基线。

Canvas 2D API 的 CanvasRenderingContext2D.textBaseline 属性用于描述绘制文本时使用的文本基线。

值

有效值:

  • "top"
    • : 文本基线在文本块的顶部。
  • "hanging"
    • : 文本基线是悬挂基线。(用于藏文和其他印度文字。)
  • "middle"
    • : 文本基线在文本块的中间。
  • "alphabetic"
    • : 文本基线是标准的字母基线。默认值。
  • "ideographic"
    • : 文字基线是表意字基线;如果字符本身超出了 alphabetic 基线,那么 ideograhpic 基线位置在字符本身的底部。(用于中文、日文和韩文。)
  • "bottom"
    • : 文本基线在文本块的底部。与 ideographic 基线的区别在于 ideographic 基线不需要考虑下行字母。

默认值是 "alphabetic"。

示例

属性值比较

这个例子演示了 textBaseline 属性的各种值。

HTML

<canvas id="canvas" width="550" height="500"></canvas>

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

const baselines = [
  "top",
  "hanging",
  "middle",
  "alphabetic",
  "ideographic",
  "bottom",
];
ctx.font = "36px serif";
ctx.strokeStyle = "red";

baselines.forEach((baseline, index) => {
  ctx.textBaseline = baseline;
  const y = 75 + index * 75;
  ctx.beginPath();
  ctx.moveTo(0, y + 0.5);
  ctx.lineTo(550, y + 0.5);
  ctx.stroke();
  ctx.fillText(`Abcdefghijklmnop (${baseline})`, 0, y);
});

结果

属性值比较

基于同一水平线比较各个属性值

与前面的示例一样,本示例演示了各种 textBaseline 属性值,但在本例中,所有属性值都沿同一条线水平排列,以便更容易看到它们之间的差异。

HTML

<canvas id="canvas" width="724" height="160"></canvas>

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

const baselines = [
  "top",
  "hanging",
  "middle",
  "alphabetic",
  "ideographic",
  "bottom",
];
ctx.font = "20px serif";
ctx.strokeStyle = "red";

ctx.beginPath();
ctx.moveTo(0, 100);
ctx.lineTo(840, 100);
ctx.moveTo(0, 55);
ctx.stroke();

baselines.forEach((baseline, index) => {
  ctx.save();
  ctx.textBaseline = baseline;
  let x = index * 120 + 10;
  ctx.fillText("Abcdefghijk", x, 100);
  ctx.restore();
  ctx.fillText(baseline, x + 5, 50);
});

结果

基于同一水平线比较属性值的差异

规范

浏览器兼容性

参见

  • 定义该属性的接口:CanvasRenderingContext2D

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

资料来源与适用范围

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

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

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