CanvasRenderingContext2D.textBaseline

CanvasRenderingContext2D.textBaseline 是 Canvas 2D API 描述绘制文本时，当前文本基线的属性。

译者注：决定文字垂直方向的对齐方式。

语法

ctx.textBaseline = "top" || "hanging" || "middle" || "alphabetic" || "ideographic" || "bottom";

选项

有效值：

top

文本基线在文本块的顶部。

hanging

文本基线是悬挂基线。

middle

文本基线在文本块的中间。

alphabetic

文本基线是标准的字母基线。

ideographic

文字基线是表意字基线；如果字符本身超出了 alphabetic 基线，那么 ideograhpic 基线位置在字符本身的底部。

bottom

文本基线在文本块的底部。与 ideographic 基线的区别在于 ideographic 基线不需要考虑下行字母。

默认值是 alphabetic。

示例

属性值比较

这是一段简单的代码片段，使用 textBaseline 属性设置不同的文本基线。

HTML

html

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

JavaScript

js

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

结果

规范

Specification
HTML Standard
# dom-context-2d-textbaseline-dev

浏览器兼容性

BCD tables only load in the browser

参见