2022.2

}
]
ThefollowingcoderegistersaHelpercalledmakeHyperlinkthatwillturnthesevaluesintoahyperlink
inthetext.
Handlebars.registerHelper('makeHyperlink', function () {
let result = `<a href="${this.url}">${this.label}</a>`;
return new Handlebars.SafeString( result );
})
Inthetemplateyouwouldcallthefunctioninanexpression.
Example: Goto{{makeHyperlink}}
HTML-escapinginaHelper
IfaHelperneedstoHTML-escapeastringyoucancallHandlebars.escapeExpression()inthatfunc-
tion.
Forexample,ifyouwouldwanttoHTML-escapethevalueofthis.field,butnot"<p>"or"</p>",you
couldwrite:
function() { return "<p>" + Handlebars.escapeExpression(this.field) +
"</p>"; }
Note: Asaruleofthumb,putasmuchcontentinthetemplateaspossibleandletHelpersgen-
erateaslittlecontentaspossible.
Handlebars templates
InOLConnect,Handlebarstemplatesareaspecialkindofsnippets.Justlikeothertypesofsnippets
(see"Snippets"onpage661),HandlebarstemplatesarestoredintheSnippetsfolderonthe
Resourcespane,buttheirfilenameendsin.hbs.
HandlebarsisthenameofaJavaScriptlibrarythatimplementsatemplatinglanguage(see
https://handlebarsjs.com/).Itusesatemplateandaninputobjecttogenerateoutput.
ThetemplatelookslikeregulartextwithembeddedHandlebarsexpressions.Ahandlebarsexpression
issomecontentsenclosedbydoublecurlybraces:{{...}}.Forexample:
<p>Hello {{firstname}}!</p>
Whenthetemplateisrendered,theseexpressionsarereplacedwithvaluesfromaninputobject.
TheHandlebarslibraryisintegratedinOLConnectDesigner.ThismeansthatyoucanuseHandle-
barsexpressionsinallsections(asofversion2022.2),aswellasinaspecialtypeofsnippetscalled
"Handlebarstemplates"(asofversion2022.1).
Page 774