dy
The dy attribute indicates a shift along the y-axis on the position of an element or its content.
You can use this attribute with the following SVG elements:
Example
<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: 0.5px;
stroke-dasharray: 3px;
}
feDropShadow
For <feDropShadow>, dy defines the y offset of the dropped 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 glyphs, the remaining glyphs use a value of 0. If there are more values than glyphs, extra values are ignored.
| Value | List of (<length> | <percentage>) |
|---|---|
| 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: 0.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 glyphs, the remaining glyphs use a value of 0. If there are more values than glyphs, extra values are ignored.
| Value | List of (<length> | <percentage>) |
|---|---|
| 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 glyphs, the remaining glyphs use a value of 0. If there are more values than glyphs, extra values are ignored.
| Value | List of (<length> | <percentage>) |
|---|---|
| Default value | none |
| Animatable | Yes |
Specifications
| Specification |
|---|
| Filter Effects Module Level 1 # element-attrdef-fedropshadow-dy |
| Filter Effects Module Level 1 # element-attrdef-feoffset-dy |
| Scalable Vector Graphics (SVG) 2 # TextElementDYAttribute |