This version is out of date, covering development from v9.5.0 to v9.7.3. 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 v9 Icon

Badge pop-up picker

Badge pop-up picker

Called from the badge control of main view note icons, this picker gives a visual picker for available badges. The badge selection is stored, via its string name, in $Badge.

From v9.7.3, the Badge Picker gains a Search field. When using the search field, Tinderbox displays badges from any family that match the string typed in the search field. Clear the search field to view badges by family. In addition to matching the name of the badge, the picker also searches for words semantically related to the searched-for (English) word. Thus, searching for "flight" will locate the badge "airplane".

The range of badges shown depends on the built-in sets and any added by the user. The pickers tabs are (left to right):

  • User. Any custom badge artwork placed directly into the 'badges' folder within Tinderbox's application support folder.
  • Classic. The primary set of badges (default tab selection)
  • Avatars. Built-in set.
  • Icons. Built-in set.
  • Symbols. Built-in set.
  • User folders… Any discrete folders of custom badges placed into the 'badges' folder within Tinderbox's application support folder. The tab name is the folder name.

Click on any badge to set the note's $Badge. Clicking the first (blank) tile in any set resets the Badge to the default inherited state.

Place the mouse cursor over any icon, without clicking, and after a brief pause the icon's name is shown as a tool-tip. Names are case-sensitive and all built-in badges use all-lowercase.

To close the pop-over click anywhere outside it.

The Badge Picker adopts the prevailing background colour in dark mode. Monochrome icon families are drawn in white over a dark background, and in black over a light background; colour families are drawn normally.