The <arrow> element
Parent element: <technical>
The <arrow> element represents an arrow used for a musical technical indication. It can represent both Unicode and Standard Music Font Layout (SMuFL) arrows. The smufl attribute distinguishes different SMuFL glyphs that have an arrow appearance such as arrowBlackUp, guitarStrumUp, or handbellsSwingUp. The specified glyph should match the descriptive representation.
Content
Exactly one of the following
-
In this order
- <arrow-direction> (Required)
- <arrow-style> (Optional)
- <arrowhead> (Optional)
- <circular-arrow>
Attributes
| Name | Type | Required? | Description |
|---|---|---|---|
| color | color | No | Indicates the color of an element. |
| default-x | tenths | No | Changes the computation of the default horizontal position. The origin is changed relative to the left-hand side of the note or the musical position within the bar. Positive x is right and negative x is left. This attribute provides higher-resolution positioning data than the <offset> element. Applications reading a MusicXML file that can understand both features should generally rely on this attribute for its greater accuracy. |
| default-y | tenths | No | Changes the computation of the default vertical position. The origin is changed relative to the top line of the staff. Positive y is up and negative y is down. This attribute provides higher-resolution positioning data than the placement attribute. Applications reading a MusicXML file that can understand both attributes should generally rely on this attribute for its greater accuracy. |
| font-family | font-family | No | A comma-separated list of font names. |
| font-size | font-size | No | One of the CSS sizes or a numeric point size. |
| font-style | font-style | No | Normal or italic style. |
| font-weight | font-weight | No | Normal or bold weight. |
| placement | above-below | No | Indicates whether something is above or below another element, such as a note or a notation. |
| relative-x | tenths | No | Changes the horizontal position relative to the default position, either as computed by the individual program, or as overridden by the default-x attribute. Positive x is right and negative x is left. It should be interpreted in the context of the <offset> element or directive attribute if those are present. |
| relative-y | tenths | No | Changes the vertical position relative to the default position, either as computed by the individual program, or as overridden by the default-y attribute. Positive y is up and negative y is down. It should be interpreted in the context of the placement attribute if that is present. |
| smufl | smufl-glyph-name | No | Indicates a particular Standard Music Font Layout (SMuFL) character using its canonical glyph name. Sometimes this is a formatting choice, and sometimes this is a refinement of the semantic meaning of an element. |
Examples
This element is used in the following examples: