2022.2

ThebigadvantageofusingHandlebarssnippetsinOLConnectisthatonlyoneortwoverysimple
Designerscriptsareneededtoreplaceapotentiallylargenumberofexpressionswithvaluesandinsert
thecontentinasection.ThisisespeciallybeneficialforOLConnecttemplateswithmanysnippetsand
variabledatathatwouldotherwiserequirealargenumberofscripts.
WorkingwithHandlebarstemplatesinvolvesalittlebitofscripting.Ifyouarenewtoscriptinginthe
Designer,firstread:"Writingyourownscripts"onpage808.
Note: TheinformationinthisOnlineHelpfocusesontheimplementationofHandlebarsinOL
Connect.ForgeneralinformationaboutHandlebarsandhowtouseit,seethefollowingweb
sites:https://handlebarsjs.com/andhttps://devdocs.io/handlebars.
CreatingaHandlebarstemplate
Tocreateanew,emptyHandlebarstemplate:
1. OntheResourcespane,right-clicktheSnippetsfolderandselectNew Snippet.
2. Selectthetypeofsnippetthatyouwanttocreate:Handlebars template.
3. Givethesnippetaname.
4. Double-clickthenewfiletoopenitintheDesignerandfillitwithHTMLtextandHandlebars
expressions.
TheeditorforHandlebarssnippetsdoesnothaveaDesignview.HTMLwithHandlebarsexpressionsis
notnecessarilyvalidHTML.ProcessingitwithanHTMLparsermightbreakboththeHandlebars
expressionsandtheHTML.
Moreaboutexpressionsandthefunctionsthatyoucanuseinexpressionscanbefoundinthetopics
"Handlebarsexpressions"onpage763and"Usingfunctionsinexpressions:Helpers"onpage766.
UsingaHandlebarstemplateinasection
AlthoughHandlebarstemplatescontainHTMLtext,theycannotbeinsertedintothecontentofasec-
tionastheyare.Theexpressionswouldnotbereplacedwithdata.
WhatittakesisashortscriptthatreplacestheHandlebarsexpressionswithvaluesandthenaddsthe
contentoftheHandlebarstemplatetoasection.
1. OntheScriptspane,clickontheblacktrianglenexttotheNewbuttonandselectStandard
Script.
2. Givethescriptaname.
3. Entertheselectorthatwillidentifyelementsinthetemplateforwhichthescriptshouldrun.(See:
"SelectorsinOLConnect"onpage825.)
Page 775