This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Timeline bands

By default, all events are shown in a single band. However, notes may be dragged down to create a second, or even more bands, by dragging to the bottom of the main view area. The timeline band to which an (event) note belongs is stored in $TimelineBand, noting that bands number from zero, not 1.

Timeline bands may have a label - drawn at left end of the band - that is stored as a list in the $TimelineBandLabels attribute of the container holding the timeline. In the simplest scenario, of a container holding event children (and not grandchildren), $TimelineBandLabels is set in the container and $TimelineBand in the children. In other words, the band labels are set in the parent or some other ancestor of the events being shown and never in the events themselves (unless an event note is itself used as a source of a timeline view. Using excessively high values for $TimelineBand (as might occur through data entry errors) may result in timeline band labels being suppressed due to the sheer number of bands to be drawn. In the latter event, query for the largest $TimelineBand value in use and adjust it if necessary.

Bands are drawn down as far as the lowest with data or lowest named label defined. From v5.7.0, empty bands are drawn at a fixed height as long as there is at least one higher-numbered band (i.e. drawn lower down in the view) with data. Previously, the view collapsed unused bands to make more efficient use of vertical space. The modified behaviour makes it easier to show data like lecture theatre or operating room scheduling, where it is expected that at times a given band (e.g. a given room) may have no events (bookings).

All even-numbered bands, with numbers starting from zero, are drawn in $MapBackgroundColor; all odd-numbered bands are drawn in a tint of $TimelineColor. For a given view these colours are those of the view's container - i.e. the same place (note) as with $TimelineBands described above.

From v5.10.1, $TimelineBandLabelColor and $TimelineBandLabelOpacity allow control over the color and opacity of timeline band labels.

From v5.10.2, $TimelineBand is intrinsic for aliases, allowing aliases to be placed in a different timeline band to their original.

Possible relevant notes (via "Similar Notes" feature):

A Tinderbox Reference File : Misc. User Interface Aspects : Timeline View Interface : Timeline bands