dy

The dy attribute indicates a shift along the y-axis on the position of an element or its content.

Seven elements are using this attribute: <altGlyph>, <feDropShadow>, <feOffset>, <glyphRef>, <text>, <tref>, and <tspan>

<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
  <!-- Lines materialized the position of the glyphs -->
  <line x1="10%" x2="10%"  y1="0"   y2="100%" />
  <line x1="0"   x2="100%" y1="30%" y2="30%"  />
  <line x1="0"   x2="100%" y1="80%" y2="80%"  />

  <!-- Some reference text -->
  <text x="10%" y="30%" fill="grey">SVG</text>

  <!-- The same text with a shift along the y-axis -->
  <text dy="50%" x="10%" y="30%">SVG</text>
</svg>
line {
  stroke: red;
  stroke-width: .5px;
  stroke-dasharray: 3px;
}

altGlyph

Warning: As of SVG2 <altGlyph> is deprecated and shouldn't be used.

For <altGlyph>, if it contains a single value, dy defines a shift along the y-axis for all alternate glyph.

If there are multiple values, dy defines a shift along the y-axis for each individual glyph relative to the preceding glyph. If there are less values than glyphes, the remaining glyphes use a value of 0. If there are more values than glyphes, extra values are ignored.

Value List of <length>
Default value none
Animatable Yes

feDropShadow

For <feDropShadow>, dy defines the y offset of the droped shadow. The unit used to resolve the value of the attribute is set by the primitiveUnits attribute of the <filter> element.

Value <number>
Default value 2
Animatable Yes

feOffset

For <feOffset>, dy defines the y offset of the filter input graphic. The unit used to resolve the value of the attribute is set by the primitiveUnits attribute of the <filter> element.

Value <number>
Default value 0
Animatable Yes

glyphRef

Warning: As of SVG2 <glyphRef> is deprecated and shouldn't be used.

For <glyphRef>, dy defines the y offset of the glyph, in the font metric system.

Value <number>
Default value 0
Animatable Yes

text

For <text>, if it contains a single value, dy defines a shift along the y-axis for all glyphs.

If there are multiple values, dy defines a shift along the y-axis for each individual glyph relative to the preceding glyph. If there are less values than glyphes, the remaining glyphes use a value of 0. If there are more values than glyphes, extra values are ignored.

Value List of <length>
Default value none
Animatable Yes

Example

<svg viewBox="0 0 150 100" xmlns="http://www.w3.org/2000/svg">
  <!-- Horizontal lines -->
  <line x1="0" x2="100%" y1="30" y2="30" />
  <line x1="0" x2="100%" y1="40" y2="40" />
  <line x1="0" x2="100%" y1="50" y2="50" />
  <line x1="0" x2="100%" y1="60" y2="60" />

  <!-- Vertical lines -->
  <line x1="10" x2="10" y1="0" y2="100%" />
  <line x1="50" x2="50" y1="0" y2="100%" />
  <line x1="90" x2="90" y1="0" y2="100%" />

  <!-- Behaviors change based on the number of values in the attributes -->
  <text dy="20"      x="10" y="30">SVG</text>
  <text dy="0 10"    x="50" y="30">SVG</text>
  <text dy="0 10 20" x="90" y="30">SVG</text>
</svg>
line {
  stroke: red;
  stroke-width: .5px;
  stroke-dasharray: 3px;
}

tref

Warning: As of SVG2 <tref> is deprecated and shouldn't be used.

For <tref>, if it contains a single value, dy defines a shift along the y-axis for all glyphs.

If there are multiple values, dy defines a shift along the y-axis for each individual glyph relative to the preceding glyph. If there are less values than glyphes, the remaining glyphes use a value of 0. If there are more values than glyphes, extra values are ignored.

Value List of <length>
Default value none
Animatable Yes

tspan

For <tspan>, if it contains a single value, dy defines a shift along the y-axis for all alternate glyph.

If there are multiple values, dy defines a shift along the y-axis for each individual glyph relative to the preceding glyph. If there are less values than glyphes, the remaining glyphes use a value of 0. If there are more values than glyphes, extra values are ignored.

Value List of <length>
Default value none
Animatable Yes

Specifications

Specification Status Comment
Filter Effects Module Level 1
The definition of 'dy' in that specification.
Working Draft Initial definition for <feDropShadow>
Filter Effects Module Level 1
The definition of 'dy' in that specification.
Working Draft Definition for <feOffset>
Scalable Vector Graphics (SVG) 2
The definition of 'dy' in that specification.
Candidate Recommendation Definition for <text> and <tspan>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'dy' in that specification.
Recommendation Initial definition for <feOffset>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'dy' in that specification.
Recommendation Initial definition for <altGlyph>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'dy' in that specification.
Recommendation Initial definition for <glyphRef>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'dy' in that specification.
Recommendation Initial definition for <text>
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
The definition of 'dy' in that specification.
Recommendation Initial definition for <tref> and <tspan>

Document Tags and Contributors

Tags: 
Contributors to this page: Jeremie, m4jing, LachlanArthur, kscarfone
Last updated by: Jeremie,