2022.2

l
With.or/youcannavigatedownintotherecordorobject.Forexample:{{Cars.Brand}}and
{{Cars/Brand}}refertothesamefield.
Notethattoaccessaniteminadetailtableorarraydirectly,youalsohavetonavigatedown.For
example:Cars.Brand.Models[0]referstothefirstiteminModels.Alternativelyyoucanwrite:
Cars.Brand.Models.0
l
@rootrepresentsthetoplevelofthedata.
Ifatemplateisrenderedwiththecurrentrecordorpartofit,@rootreferstotherootofthecurrent
record.
WithaJavaScriptobject,@rootreferstotherootlevelofthedatathatwaspassedtotheHandle-
barstemplate.
l
Thebuilt-inhelpers#eachand#withdiveintoanobject-property,givingyoudirectaccesstoits
properties.(See"Usingfunctionsinexpressions:Helpers"onthefacingpageandthedoc-
umentationofHandlebars.)
l
Use../tonavigateonelevelup.Thisisparticularlyusefulin#eachand#withblocks.
Note: IfaHandlebarstemplateisrenderedwithpartofthecurrentrecord,thetemplatestill
hasaccesstotheentirerecordandcannavigateupandoutsideofthatpart,toahigher
levelinthecurrentrecord.
IfaJavaScriptobjectispassed,thetemplateonlyhasaccesstothepasseddata,andit
doesnothaveaccesstothecurrentrecord.
Formattingvalues
FunctionsthatcanbeusedinaHandlebarsexpressionarecalled"Helpers".OLConnectprovidesa
numberofHelperstoformat the valuethatistheresultofanexpression.Forexample:{{upperCase
FirstName}}returnsthevalueoftheFirstNamedatafieldinuppercase.
Theavailablefunctionsarelistedinthetopic:"FormatHelpers"onpage334.
HTMLvalues
ThevaluereturnedbyanexpressionisHTML-escaped.Thismeansthatcharactersthathaveaspecial
functioninHTML:& < > \" ' ` =arereplacedwithHTMLcharacterreferences.Forexample:&willbe
changedinto&amp;.
Takethisexpression:<span>{{foo}}</span>.
Ifthefieldfoocontainsa'>'andyoudon'tHTML-escapeit,thiswouldproduceinvalidHTML:
<span>...>...</span>.
AfterHTML-escaping,itbecomesvalidHTML:<span>&gt;</span>.
Page 329