Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

dy

L'attribut dy indique un décalage sur l'axe y de la position d'un élément ou de son contenu.

Sept éléments utilisent cet attribut: <altGlyph>, <feDropShadow>, <feOffset>, <glyphRef>, <text>, <tref>, et <tspan>

Exemple

html
<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
  <!-- Lignes indiquant la position des glyphes -->
  <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%" />

  <!-- Un texte de référence -->
  <text x="10%" y="30%" fill="grey">SVG</text>

  <!-- Le même texte avec un décalage sur l'axe y -->
  <text dy="50%" x="10%" y="30%">SVG</text>
</svg>
css
line {
  stroke: red;
  stroke-width: 0.5px;
  stroke-dasharray: 3px;
}

altGlyph

Attention : Depuis <altGlyph> est déprécié et ne devrait pas être utilisé.

Pour <altGlyph>, s'il ne contient qu'une seule valeur, dy définit un décalge sur l'axe y pour tous les glyphes.

S'il a plusieurs valeurs, dy définit un décalage sur l'axe y individuellement pour chaque glyphe, relativement au glyphe précédent. S'il y a moins de valeurs qu'il n'y a de glyphes, les glyphes restants utilisent la valeur 0. S'il y a plus de valeurs qu'il n'y a de glyphes, les valeurs restantes sont ignorées.

Valeur Liste de <length>
Valeur par défaut aucune
Animation Oui

feDropShadow

Pour <feDropShadow>, dy définit le décalage x de l'ombre portée. L'unité utilisée pour résoudre la valeur est définie par l'attribut primitiveUnits de l'élément <filter>.

Valeur <number>
Valeur par défaut 2
Animation Oui

feOffset

Pour <feOffset>, dy définit le décalage x de l'élément source du filtre. L'unité utilisée pour résoudre la valeur est définie par l'attribut primitiveUnits de l'élément <filter>.

Valeur <number>
Valeur par défaut 0
Animation Oui

glyphRef

Attention : Depuis SVG2 <glyphRef> est déprécié et ne devrait pas être utilisé.

Pour <glyphRef>, dy définit le décalage x du glyphe, dans le système métrique de la police.

Valeur <number>
Valeur par défaut 0
Animation Oui

text

Pour <text>, s'il ne contient qu'une seule valeur, dx définit un décalage sur l'axe x pour tous les glyphes.

S'il a plusieurs valeurs, dx définit un décalage sur l'axe x individuellement pour chaque glyphe, relativement au glyphe précédent. S'il y a moins de valeurs qu'il n'y a de glyphes, les glyphes restants utilisent une valeur de 0. S'il y a plus de valeurs qu'il n'y a de glyphes, les valeurs supplémentaires sont ignorées.

Valeur Liste de <length>
Valeur par défaut aucune
Animation Oui

Exemple

html
<svg viewBox="0 0 150 100" xmlns="http://www.w3.org/2000/svg">
  <!-- Lignes horizontales -->
  <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" />

  <!-- Lignes verticales -->
  <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%" />

  <!-- Le comportement change en fonction du nombre de valeurs de l'attribut -->
  <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>
css
line {
  stroke: red;
  stroke-width: 0.5px;
  stroke-dasharray: 3px;
}

tref

Attention : Depuis SVG2 <tref> est déprécié et ne devrait pas être utilisé.

Pour <tref>, s'il ne contient qu'une seule valeur, dx définit un décalage sur l'axe x pour tous les glyphes.

S'il a plusieurs valeurs, dx définit un décalage sur l'axe x individuellement pour chaque glyphe, relativement au glyphe précédent. S'il y a moins de valeurs qu'il n'y a de glyphes, les glyphes restants utilisent une valeur de 0. S'il y a plus de valeurs qu'il n'y a de glyphes, les valeurs supplémentaires sont ignorées.

Valeur Liste de <length>
Valeur par défaut aucune
Animation Oui

tspan

Pour <tspan>, s'il ne contient qu'une seule valeur, dx définit un décalage sur l'axe x pour tous les glyphes.

S'il a plusieurs valeurs, dx définit un décalage sur l'axe x individuellement pour chaque glyphe, relativement au glyphe précédent. S'il y a moins de valeurs qu'il n'y a de glyphes, les glyphes restants utilisent une valeur de 0. S'il y a plus de valeurs qu'il n'y a de glyphes, les valeurs supplémentaires sont ignorées.

Valeur Liste de <length>
Valeur par défaut aucune
Animation Oui

Spécifications

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