2022.2

Let'ssayyouwanttocreateacustomHelperthatreturnsthecurrentdate.ThenameoftheHelper
shouldbetoday,sothatitcanbeusedinanexpressionasfollows:
Example: {{today}}
Here'showyoudothat.
1. OntheScriptspane,clicktheblacktrianglenexttotheNewbuttonandclickControl Script.
ControlScriptsareexecutedfirst.See"ControlScripts"onpage838and"Thescriptflow:when
scriptsrun"onpage824.
2. EnteranameforthescriptintheNamefield.ThisnamewillappearontheScriptspane.It
doesn'thavetobethesameasthenameoftheHelperthatcanbeusedinexpressions.OneCon-
trolScriptcanregistermultipleHelpers.
3. WritecodethatregisterstheHelper,usingtheHandlebars.registerHelper(name,
helper)function.
l
nameisthenameoftheHelperbywhichitshouldbecalledinexpressions.Putthenamein
quotes.
l
helperisthecodethatshouldrunwhentheHelperiscalledfromanexpression.
Hereisanexample:
Handlebars.registerHelper('today', function() {
return new Date();
});
4. ClickOK.ThenewscriptappearsontheScriptspaneintheControl Scriptsfolder.
NowthattheHelperisregistered,theexpression{{today}}inatemplatewillreturnthecurrentdate.
InthesameexpressionyoucoulduseaHelperthatformatsthedate.Forexample:{{dateLong today}}
willformatthecurrentdateasalongdate,e.g.February23,2022.(ForalistofFormatHelpers,see
"FormatHelpers"onpage769.)
Ifyou'dliketoformatthevalueinthescriptitself,youcanusethefunctionsprovidedbytheformatter
objectinstandardDesignerscripts;see"formatter"onpage1175.
Forexample,thiscoderegistersaHelperthatformatstheoutputasa'medium'date.
Handlebars.registerHelper('today', function () {
let today = new Date();
return formatter.dateMedium( today )
})

Page 772