This version is out of date, covering development as far as v4.2.5. It is maintained here only for inbound reference links from elsewhere. Jump to the current version of aTbRef. |
A Tinderbox Reference File : Export Codes : Export Codes - Full Listing : ^childLinks( start, list-item-prefix, list-item-suffix, end )^ |
^childLinks( start, list-item-prefix, list-item-suffix, end )^ |
^childLinks( start, list-item-prefix, list-item-suffix, end )^
returns links to all of the children of this note (if any), formatted as an unordered list. NB! If "Hierarchical lists" in the HTML pane of the preferences is unchecked, this will not work.
To v2.4.1:
^childLinks( "start", "list-item-prefix", "list-item-suffix", "end" )^
From v2.5.0:
^childLinks( start, list-item-prefix, list-item-suffix, end )^
Allows you to format the group of links as an HTML list or table in the exact format you want, where "start" is text that will be inserted before all of the links, "end" is text that will be inserted after all of the links, "list-item-prefix" is text that will be inserted before each link, and "list-item-suffix" is text that will be inserted after each link.
If "Hierarchical lists" in the HTML pane of the preferences is unchecked, this will not work.
The HTMLDontExport settings of children are respected.
Previous to Tinderbox 2.5.0, the arguments to export list elements were enclosed in quotes
^childLinks("<ul>", "<li>",
.....
These quotes are now optional and may be omitted, except where the mark-up itself includes characters (e.g. commas) that would confuse the parser.
In Tinderbox 2.5.0, the quotation marks that were formerly mandatory were prohibited: if they appeared, Tinderbox would include them in the mark-up elements.
Tinderbox 3.0.0 now strips quotation marks enclosing arguments, when they occur. Mark-up elements embedded in ^childLinks^ are now evaluated.
Usually, rules and queries to test whether a note has children will test ChildCount. But ^if(^childLinks^)... is better if you want the expression to be false if the note has children BUT none of the children are exported.
From v3.5.0 this code exports CSS class and target based on their underlying Tinderbox link values.
From v4.0.0, new item objects source and destination may be used to indicate from where data used within the arguments is drawn.
Up: Creation of Links | |
Previous: ^basicLinks( start, list-item-prefix, list-item-suffix, end )^ | Next: ^inboundBasicLinks( [start, list-item-prefix, list-item-suffix, end, type] )^ |
Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]