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

<tspan>

· 52CE 我爱测

**`<tspan>`** SVG 元素定义了 text 元素或另一个 `<tspan>` 元素内的子文本。它允许按需调整该子文本的样式和位置。

<tspan> SVG 元素定义了 text 元素或另一个 <tspan> 元素内的子文本。它允许按需调整该子文本的样式和位置。

[!NOTE] <tspan> 元素默认不会换行;若要换行,需要使用 white-space CSS 属性进行样式设置。

使用上下文

属性

  • x
    • : 文本基线起点的 x 坐标;若提供的是值列表,则为每个字形各自的 x 坐标。值类型:(<length> | <percentage>)的列表;默认值:0;动画性:是
  • y
    • : 文本基线起点的 y 坐标;若提供的是值列表,则为每个字形各自的 y 坐标。值类型:(<length> | <percentage>)的列表;默认值:0;动画性:是
  • dx
    • : 相对于前一个文本元素水平偏移文本位置;若提供的是值列表,则为每个字形各自偏移。值类型:(<length> | <percentage>)的列表;默认值:无;动画性:是
  • dy
    • : 相对于前一个文本元素垂直偏移文本位置;若提供的是值列表,则为每个字形各自偏移。值类型:(<length> | <percentage>)的列表;默认值:无;动画性:是
  • rotate
    • : 旋转每个字形的方向。可以单独旋转各个字形。值类型:<list-of-number>;默认值:无;动画性:是
  • lengthAdjust
    • : 文本如何拉伸或压缩,以适配 textLength 属性所定义的宽度。值类型:spacing | spacingAndGlyphs;默认值:spacing;动画性:是
  • textLength
    • : 文本应缩放以适应的宽度。值类型:<length> | <percentage>;默认值:无;动画性:是

DOM 接口

此元素实现了 SVGTSpanElement 接口。

示例

html,
body,
svg {
  height: 100%;
}
<svg viewBox="0 0 240 40" xmlns="http://www.w3.org/2000/svg">
  <style>
    text {
      font: italic 12px serif;
    }
    tspan {
      font: bold 10px sans-serif;
      fill: red;
    }
  </style>

  <text x="10" y="30" class="small">
    你
    <tspan>不是</tspan>
    香蕉!
  </text>
</svg>

示例

规范

浏览器兼容性

参见

  • white-space

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

资料来源与适用范围

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

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

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