2022.2

UsingJavaScriptfilesinatemplate
Including a JavaScript file in a Web context
TolinkaJavaScriptfiletotheWebcontext,ortoacertainWebsectionorCOTGtemplate:
1. OntheResourcespane,expandtheContextsfolder,andtheneitherright-clicktheWebcon-
text,orexpandtheWebcontextandright-clickaWebsection.
2. ClickIncludes.
3. FromtheFile typesdropdown,selectJavaScripts.
4. TheavailableJavaScriptfilesarelistedattheleft.Usethearrowbuttonsordouble-clicktomove
theJavaScriptfilesthatshouldbeincludedtotheright-handlist.UsingtheUpandDownbuttons
ordrag-and-dropyoucanchangetheorderofthefiles,too.
5. ClickOK.
Note: JavaScriptfilesthatarelinkedto(i.e.includedin)asectionshowachainiconinthe
Resourcespane(see"Resourcespane"onpage978).
Note: AnyJavaScriptfilesincludedinasectionrunafterthescriptsintheScriptspane.
Using JavaScript in other contexts
EmailclientsdonotsupportJavaScript.Therefore,EmailcontextscannotincludeJavaScript
resources.
WhenaJavaScriptfileisincludedinaPrintsection,theDesigneritselfactsasthebrowser.Whengen-
eratingPrintoutput,itrunstheJavaScriptaftergeneratingthemainpageflowcontentsandthepagin-
ation,butbeforeanyMasterPagesareadded.SoitispossibletochangePrintoutput(exceptcontent
onMasterPages)byaJavaScript;forexample,toaddabarcodethatincludesthepagenumberto
eachdocument.Awarningisappropriate,however:changingthePrintoutputmaychangethepage
flowanddoingsoatthispointmayresultinbadoutputand/orseriouserrorsoracrashofthesoftware.
Previewing a template with JavaScript resources
WhenasectionispreviewedintheDesigner,scriptsintheResourcespaneareinterpretedbyan
internalbrowser.
JavaScriptresourcesincludedinaWebsectionareonlyexecutedontheLivetab,notonthePreview
tab.
RememberthatthefinaloutputofaWebsectioniseventuallyprocessedbyaclientbrowser.Sinceyou
cannotpredictwhattypeofbrowserwillbeused,youshouldmakesureyourscriptsarecompatible
withawiderangeofbrowsertypesandversions.
Page 515