2022.2

Tip: MoreexamplesofhowtouseanAPItoloadexternalcontentaregivenintheseHow-to's:
l
UsingtheGoogleMapsAPI
l
UsingtheOpenWeatherMapAPI
Using scripts in Dynamic Tables
Ifthecontentsorstyleofcellsorrowsina"DynamicTable"onpage742needtobepersonalized
basedonthevalueofadatafield,youwillneedascript.
Doyouwanttostyleorchangetheoutputofanexpression,basedonthevalueofadatafield?Thena
customHelpercancomeinhandy.AHelperisafunctionthatcanbeusedinanexpression.Howtocre-
ateacustomHelperisdescribedinthetopic:"CreatingcustomHelpers"onpage771.Aftercreatinga
HelperyoucantypethatHelper'snameinanyexpression.
InallothercasesyouwillneedaStandardScript.
Thistopicgivessomeinformationthatwillhelpyoutowriteascriptfor(anelementin)aDynamic
Table.
Itisassumedthatyouarefamiliarwiththescriptingbasics;see"Writingyourownscripts"onpage808.
WritingscriptsforaDynamicTable
Ifyou'regoingtocreateyourownscriptsforDynamicTables,thereareafewthingsyouneedtoknow.
Selectors
Scriptsthattarget(anelementin)aDynamicTablecanusethesametypesofselectorsasother
scripts.Intheoutput,DynamicTablerowsarerepeatedincludinganyclassesthataresetontherow
andonitscontents.
Inaddition,DynamicTablesandtheirrowsandcellshavesomespecialdata- attributesthatcanbe
usedasselector.See:"ADynamicTable'sdata-attributes"onpage755.
Notehowever,thatthedata-repeatattributecannotbeusedasaselectorforStandardscripts,since
itgetsremovedwhenthetableisexpanded,whichhappensbeforeStandardscriptsrun.
Thedata-scriptattributeisusedifyoulettheDesignercreateascriptforyou(see"Quick-starta
scriptwiththeCreatescriptbutton"onthefacingpage).
How the scope of a script can simplify code
Itisrecommendedtosetthescopeofascriptthattargets(anelementin)dynamicallyaddedrowsto
Each matched element.
Theselectorofascriptthattargets(somethingin)arowthatislinkedtoadetailtablewillprobably
matchmultipleelements.
Page 835