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

List/Set.format("formatString")


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Item   [operators of similar scope]

 Formatting   [other Formatting operators]

 5.8.0

 


List/Set.format("formatString")

If data is a List or Set, the formatString is used to separate set elements:

$MyList.format("formatString") 

The process preserves original data - duplicate values in lists are maintained. For example

$KeyAttributes.format(", ") 

converts key attributes to a comma+space-separated list. To put each item on a separate line use this:

$KeyAttributes.format("\n") 

Doing the same for HTML export, you might want the rendered text to have each value on a new line so use:

$KeyAttributes.format("<br>") 

Thus $Text may be created from concatenation of other texts:

$Text = (collect(children, $Text)).format("\n") 

Optionally, you may supply four arguments to format the list or set as an HTML list:

List/Set.format("listPrefix","itemPrefix","itemSuffix","listSuffix") 

For example:

$Classes.format("<ul>","<li>","</li>","</ul>") 

will return HTML code for a bulleted list with each set member marked up as a list item. Note that the tags must be in double quotes. To have each element on a separate line and indent the items add tabs and line breaks:

$Classes.format("<ul>\n","\t<li>","</li>\n","</ul>\n") 

To make this easier to use in a code export context, you might pass the output of format into another attribute and call the latter within the template with a ^value()^ code. By a repeated use of format it is possible to export lists of links.

Trailing semi-colons

Although Tinderbox happily accepts user-input lists with a trailing semi-colon after the last item, i.e. "cow;ant;" vs. "cow;ant"", trailing semi-colons can be problematic when formatting lists. This is because that process emits an extra empty item and preceded by the user specified delimiter. Thus the output my have an unwanted trailing delimiter. If encountered, the best approach to dealing with this is to clear the source data.

Similar functions

This supplements the existing format() function.


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


A Tinderbox Reference File : Actions & Rules : Operators : Action Operator Functional Types : Function actions : List/Set.format("formatString")