<section>
The <section> element defines a named section of the score.
<section> declares that a section exists and where it falls in the play order. It holds no notes.
Parents
Section titled “Parents”Attributes
Section titled “Attributes”| Attribute | Required | Type | Description |
|---|---|---|---|
id |
Yes | ID | Unique identifier. Referenced by <section-ref section="...">. |
name |
No | string | Human-readable label (e.g. "ท่อน 1"). Not printed on the score, see Rendering below. |
Children
Section titled “Children”Zero or more <line-repeat> elements, each repeating a range of lines inside the section. A section with no <line-repeat> children plays its lines straight through.
Example
Section titled “Example”<section id="s1" name="ท่อน 1" /><section id="s1" name="ท่อน 1"> <line-repeat first="2" last="3" times="2"/></section>- Referenced by
<section-ref>in part data, which holds the actual notes. - A section’s order in the score is its position among the other
<section>elements in<structure>. There is no separate ordering attribute. See<structure>. - To play a section more than once in a row, wrap it in a
<repeat>in<structure>. Repetition is a property of where the section sits in the score, not of the section itself, which is why it is not an attribute here. - To play it again later, after something else, add a
<play>where it comes back. A section is declared by exactly one<section>however many times it plays. - When a section’s total pass count is greater than
1, a part can vary individual passes with<ending>.
Rendering
Section titled “Rendering”name labels the section for the file and for an editor’s interface. It is not printed above the grid. A printed heading such as สามชั้น ท่อน ๑ comes from an <annotation> the arranger placed in <structure> before the section, which leaves the wording to them. See Section headings.