Type alias WordsAttributes

Type declaration

• color: string | null

  Indicates the color of an element.

• default-x: number | null

  Changes the computation of the default horizontal position. If the parent is a <notehead-text> element, the origin is changed relative to the left-hand side of the note or the musical position within the bar. Otherwise, the origin is changed relative to the start of the first measure on the system, and these values are used when the current measure or a succeeding measure starts a new system. Positive x is right and negative x is left.

• default-y: number | null

  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.

• dir: "ltr" | "rtl" | "lro" | "rlo" | null

  The text-direction attribute is used to adjust and override the Unicode bidirectional text algorithm, similar to the Directionality data category in the W3C Internationalization Tag Set recommendation. The default value is ltr. This attribute is typically used by applications that store text in left-to-right visual order rather than logical order. Such applications can use the lro value to better communicate with other applications that more fully support bidirectional text.

• enclosure: "none" | "rectangle" | "square" | "oval" | "circle" | "bracket" | "inverted-bracket" | "triangle" | "diamond" | "pentagon" | "hexagon" | "heptagon" | "octagon" | "nonagon" | "decagon" | null

  Formatting of an enclosure around text or symbols.

• font-family: string | null

  A comma-separated list of font names.

• font-size: "xx-small" | "x-small" | "small" | "medium" | "large" | "x-large" | "xx-large" | number | null

  One of the CSS sizes or a numeric point size.

• font-style: "normal" | "italic" | null

  Normal or italic style.

• font-weight: "normal" | "bold" | null

  Normal or bold weight.

• halign: "left" | "center" | "right" | null

  In cases where text extends over more than one line, horizontal alignment and justify values can be different. The most typical case is for credits, such as:

  Words and music by Pat Songwriter

  Typically this type of credit is aligned to the right, so that the position information refers to the right-most part of the text. But in this example, the text is center-justified, not right-justified.

  The halign attribute is used in these situations. If it is not present, its value is the same as for the justify attribute. For elements where a justify attribute is not allowed, the default is implementation-dependent.

• id: string | null

  Specifies an ID that is unique to the entire document.

• justify: "left" | "center" | "right" | null

  Indicates left, center, or right justification. The default value varies for different elements. For elements where the justify attribute is present but the halign attribute is not, the justify attribute indicates horizontal alignment as well as justification.

• letter-spacing: "normal" | number | null

  Specifies text tracking. Values are either normal, which allows flexibility of letter-spacing for purposes of text justification. or a number representing the number of ems to add between each letter. The number may be negative in order to subtract space. The value is normal if not specified.

• line-height: "normal" | number | null

  Specifies text leading. Values are either normal or a number representing the percentage of the current font height to use for leading. It is normal if not specified. The exact normal value is implementation-dependent, but values between 100 and 120 are recommended.

• line-through: number | null

  Number of lines to use when striking through text.

• overline: number | null

  Number of lines to use when overlining text.

• relative-x: number | null

  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.

• relative-y: number | null

  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.

• rotation: number | null

  Used to rotate text around the alignment point specified by the halign and valign attributes. Positive values are clockwise rotations, while negative values are counter-clockwise rotations.

• underline: number | null

  Number of lines to use when underlining text.

• valign: "top" | "middle" | "bottom" | "baseline" | null

  Indicates vertical alignment to the top, middle, bottom, or baseline of the text. The default is implementation-dependent.

• xml:lang: string | null

  Specifies the language used in the element content. It is Italian ("it") if not specified.

• xml:space: "default" | "preserve" | null

  Indicates whether white space should be preserved by applications.