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

Sort


Attribute Data Type: 

Attribute Default Value: 

Attribute Group: 

Attribute Purpose: 

Attribute Inherited from Preferences?   

Attribute Read-Only? 

Attribute Intrinsic? 

Attribute First Added: 

Attribute Altered: 

 string   [other string-type attributes]

 (not set - empty string)

 Sorting   [other Sorting Group attributes]

 Sort configuration

 No

 No

 No

 Already in v5.0.0

 


Specifies the primary sorting order for notes within containers, agents and smart adornments.

The order is based on the name of an existing system or user attribute. The name is cited without a $-prefix as this attribute stores the traget attributes name, not it's value:

CORRECT: $Sort = "SomeAttribute" (case-sensitive)

FAIL: $Sort = $SomeAttribute

In default sorting A-Z precedes a-z, thus the sort order Aardvark, Boy, aardvark [sic], though this can be altered by $SortAlso which offers three choices of sort logic.

A secondary sort is also allowed, such as where two notes have equal values under the main sort criterion. The secondary sort is set via $SortAlso.

On Create/Rename dialogs, the list of available choices is shown in a $Sort pop-up menu.

If unsure of allowed target attribute on which to sort, the best place to set a sort is via the note's naming panel (Enter key). If exposed via $KeyAttributes, the value pop-up will only show values already sorted on within the document.

To reverse the sort order based on the given attribute, use $SortBackward.


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


A Tinderbox Reference File : Attributes : Attribute Groups within Tinderbox : Sorting Attributes : Sort