<tspan>

The SVG <tspan> element defines a subtext within a <text> element or another <tspan> element. It allows for adjustment of the style and/or position of that subtext as needed.

Note: The <tspan> element does not wrap by default, to make this happen it needs to be styled with the white-space CSS property.

Example

html
<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">
    You are
    <tspan>not</tspan>
    a banana!
  </text>
</svg>

Attributes

x

The x coordinate of the starting point of the text baseline, or the x coordinate of each individual glyph if a list of values is provided. Value type: List of (<length>|<percentage>) ; Default value: 0; Animatable: yes

y

The y coordinate of the starting point of the text baseline, or the y coordinate of each individual glyph if a list of values is provided. Value type: List of (<length>|<percentage>) ; Default value: 0; Animatable: yes

dx

Shifts the text position horizontally from a previous text element, or shifts the position of each individual glyph if a list of values is provided. Value type: List of (<length>|<percentage>) ; Default value: none; Animatable: yes

dy

Shifts the text position vertically from a previous text element, or shifts the position of each individual glyph if a list of values is provided. Value type: List of (<length>|<percentage>) ; Default value: none; Animatable: yes

rotate

Rotates orientation of each individual glyph. Can rotate glyphs individually. Value type: <list-of-number> ; Default value: none; Animatable: yes

lengthAdjust

How the text is stretched or compressed to fit the width defined by the textLength attribute. Value type: spacing|spacingAndGlyphs; Default value: spacing; Animatable: yes

textLength

A width that the text should be scaled to fit. Value type: <length>|<percentage> ; Default value: none; Animatable: yes

Usage context

Categories Text content element, Text content child element
Permitted content Character data and any number of the following elements, in any order:
Descriptive elements
<a>, <animate>, <set>, <tref>, <tspan>

Specifications

Specification
Scalable Vector Graphics (SVG) 2
# TextElement

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
tspan 1 12 1.5 9 3 18 4 14 2 1.0 3
dx 1 12 1.5 15 3 18 4 14 2 1.0 4.4
dy 1 12 1.5 15 3 18 4 14 2 1.0 4.4
fill 1 79 1.5 15 3 18 4 14 2 1.0 4.4
lengthAdjust 1 79 1.5 15 3 18 4 14 2 1.0 4.4
rotate 1 ≤79 1.5 15 3 18 4 14 2 1.0 4.4
systemLanguage 1 12 12 9 3 18 14 14 2 1.0 3
textLength 1 12 1.5 15 3 18 4 14 2 1.0 4.4
x 1 12 1.5 15 3 18 4 14 2 1.0 4.4
y 1 12 1.5 15 3 18 4 14 2 1.0 4.4

See also

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/SVG/Element/tspan