This version is out of date, covering development from v8.0.0 to v8.x.x. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v8 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.