2022.2

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328and"Usingfunctionsinexpressions:Helpers"onpage330.
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385.)
4. WritealineofcodethatcallsthefunctionHandlebars.render(template, data).
l
Thetemplatecanbe:
a. thenameofaHandlebarstemplate(.hbs)inthetemplate
b. thenameofaHandlebarstemplate(.hbs)ondisk(file:///)
c. thenameofaremoteHandlebarstemplate(.hbs)(http://orhttps://)
d. astringthatcontainsHTMLandHandlebarsexpressions.
Withasnippetondisk,thecompletesyntaxis:file://<host>/<path>.Ifthehost
is"localhost",itcanbeomitted,resultinginfile:///<path>-notethethreeforwardslashes
afterfile:.
Intheremainderofthepathyoucaneitheruseescapedbackwardslashes:
"file:///C:\\Users\\Administrator\\Desktop\\Handlebars_LoadFile.hbs"
orforwardslashes:
"file:///C:/Users/Administrator/Desktop/Handlebars_LoadFile.hbs"
l
Thedatacanbethecurrentrecordorpartofit,oraJavaScriptobject(whichmayinclude
therecordorpartofit-see"HandlebarsAPI"onpage344foranexample).
Ifnodataispassed,thecurrent recordwillbeused.
Page 256