Tinderbox 7 Icon

Roles for composite items

Items in a composite may have a $Role, which indicates what part they play in a composite. For example, a composite that describes a research paper might include notes with roles like Author, Abstract, and References. If a note has a $Role but no $Subtitle, the Role is displayed where the Subtitle would normally appear.

Some kinds of composites may have multiple notes with the same role. For example, a list with a header would have one note with the role Header, but might have any number of notes with the role ListItem. The boolean attribute $IsMultiple indicates that a note with that role may occur more than once in a given composite. If $IsMultiple is true, when a note is moved into the composite touching that note, the moved note inherits the note’s role. Thus, items moved into a composite and touching a ListItem will themselves become a ListItem.