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

Find results pop-over

Find results pop-over

The Find results for main view searches are shown in a pop-over. The pop-over can be torn off as a stand-alone dialog to give a more persistent record of the search results. The torn-off Find window retains its selection when clicking on a note. Its title reflects the number of notes found in the document, and the number in the scope of the current view. Selecting a note in the torn-off find window will select that notes in the view, if the note is available.

[list of matching notes]. The list are shows notes matching the Find criteria. Results are listed by note title ($Name) sorted in the default, lexical, sort order. A lexical sort is used means that instances of the same word in different letter case do not sort together: Ant, Bee, ant and not Ant, ant, Bee as a non-coder might assume. To have greater control over the sorting of results or to get a count of matches, use an agent instead of Find.

For notes where the match is in $Text, the (first) match context is sown in a second line of listing with the match highlighted. Matches for note title or user attribute value use a single line listing.

Clicking on a list item makes that note the context of the front window's text pane. Listed notes are rendered in using $Color.

The pop-over has a series of controls:

  • search input box (from which a new search can be run). From v8.1.0, the box's pop-up menu offers an option for case-sensitive search, and an option to turn off regular expression search.
  • a tick-box to alter the case-sensitivity of searches.
  • a tick-box to allow inclusion of aliases (by default they are filtered out).
  • sort order pop-up with the following choices:
    • outline order (default)
    • Creation date
    • last modified
    • name

The controls work live on the current search results (both in pop-over and tear-off form) without the need to re-run the Find.

Found items are grouped into two groups. The first grouping shows items within context of the current tab’s view. Such items might not necessarily immediately be seen within the current view area, e.g. because they are outside the display part of a current Map or inside a collapsed container within a current Outline, etc. The second group lists all other matches that cannot be seen in the view pane without changing the context of the current view, i.e. setting its scope differently from the current settings.

The Find window can match outline separators and map adornments.

A contextual menu lets the right-clicked-on list item be opened in a new tear-off text window or in a new tab. Shift-double-click on a listed item will also open the result in a new tab.

From v8.5.1, results from the Find results pop-over can be dragged into a text pane. The display name of the dragged item will be inserted into the text and linked to the corresponding note.

Further changes from v8.8.0:

  • Find offers up to 7 suggested related words as possible autocompletions in the Find bar and in torn-off Find windows. Note: the related text feature only works on macOS 10.14 or later.
  • The Find results pop-over contains controls to replace all occurrences of a pattern with a designated string. Note: this is not undoable. These replacements apply to $Text only; $Name or the (optionally) selected user attribute are not checked/altered. This features in not included in the torn-off version of the Find results.
  • After selecting a note in the Find window, if the note cannot be selected and previewed in the current view, Tinderbox now displays a preview of the note’s text.

A Tinderbox Reference File : Dialogs : Find results pop-over