MusicXML 4.1 Draft
< >elements
@attributes
MusicXML 4.1 Draft>Elements>The <bracket> element

The <bracket> element

Parent element: <direction-type>

bracket

Brackets are combined with words in a variety of modern directions. The line-type is solid if not specified.

Content

Always empty.

Attributes

NameTypeRequired?(Default)Description
line-endline-endYesSpecifies if there is a jog up or down (or both), an arrow, or nothing at the start or end of the bracket.
Specifies if there is a jog up or down (or both), an arrow, or nothing at the start or end of the bracket.
typestart-stop-continueYesIndicates if this is the start, stop, or continuation of the bracket.
Indicates if this is the start, stop, or continuation of the bracket.
colorcolorNoIndicates the color of an element.
Indicates the color of an element.
dash-lengthtenthsNoThe length of dashes in a dashed line. Ignored if the corresponding line-type attribute is not dashed.
The length of dashes in a dashed line. Ignored if the corresponding line-type attribute is not dashed.
default-xtenthsNoChanges 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.

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-ytenthsNoChanges 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.

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.

end-lengthtenthsNoSpecifies the length of the jog if the line-end attribute is up or down.
Specifies the length of the jog if the line-end attribute is up or down.
idxs:IDNoSpecifies an ID that is unique to the entire document.
Specifies an ID that is unique to the entire document.
line-typeline-typeNoSpecifies if the line is solid, dashed, dotted, or wavy.
Specifies if the line is solid, dashed, dotted, or wavy.
numbernumber-levelNoDistinguishes multiple brackets when they overlap in MusicXML document order.
Distinguishes multiple brackets when they overlap in MusicXML document order.
relative-xtenthsNoChanges 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.
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-ytenthsNoChanges 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.
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.
space-lengthtenthsNoThe length of spaces in a dashed line. Ignored if the corresponding line-type attribute is not dashed.
The length of spaces in a dashed line. Ignored if the corresponding line-type attribute is not dashed.

Examples

This element is used in the following examples:

<bracket><with-bar>