2022.2

decoration','underline');results.replaceWith(mysnippet);Thislastscriptloadsaremotesnippet
intoavariableandretrievesanelementfromthesnippetusingquery().varmysnippet=loadhtml
('http://www.somewebsite.com/text-root-wrapped.html');varsubject=query("#subject",mys-
nippet).text();results.append("<pstyle='font-weight:bold;'>"+subject+"</p>");loadhtml(loc-
ation,selector)RetrievesspecificcontentfromthespecifiedHTMLfile.locationStringcontaininga
paththatcanbeabsoluteorrelativetothesection/context.Usesnippets/<snippet-name>to
retrievethecontentfromanHTMLfileresidingintheSnippetsfolderontheResourcespanel.In
ordertoretrievefilesfromoutsidethetemplatethefileprotocolissupportedaswellasthehttp/ht-
tpsprotocols.ThecompletesyntaxofafullyqualifiedURLwiththe"file"protocolis:
file://<host>/<path>.Ifthehostis"localhost",itcanbeomitted,resultinginfile:///<path>,for
example:file:///c:/somefolder/somecontent.html.Whenusingthehttp/httpsprotocol,remember
thatonlyabsolutepathsaresupportedinsideremotesnippets(see"Remotesnippets"on
page1).ToquicklygetthelocationofanHTMLsnippetinthetemplateresources,right-clickthe
snippetintheResourcespaneandselectCopyResourceLocation.ThepathtoaremoteHTML
snippetcanbecopiedfromthesnippet'sproperties:right-clickthesnippetintheResourcespane
andselectProperties.selectorString.ThesuppliedselectorshouldconformtoCSSselector
syntaxandallowsyoutoretrieveonlythecontentofmatchingelements.Iftheselectedelementis
aDynamicTable,theretrievedHTMLwillcontaintheexpandedtable.ExamplesThisscriptloads
aspecificelementfromasnippetandusesthattoreplacetheresults(theHTMLelementorsetof
HTMLelementsmatchedbytheselectorofthescript;see"results"onpage1).varmysnippet=
loadhtml('snippets/snippet-selectors.html','#item3');results.replaceWith(mysnippet);Thisscript
loadsthechildrenoftheselectedelement.varsnippet=loadhtml('file:///C:/User-
s/PParker/Documents/Example.html','foobar').children();results.replaceWith(snippet);Thenext
scriptloadsaremotesnippet(see"Remotesnippets"onpage1),looksforanH1headingand
usesthattext.varpost=loadhtml('snippets/post.rhtml');varh1=query('h1',post).text();res-
ults.text(h1);Anotherexampleisgiveninthefollowinghow-to:Usingaselectortoloadpartofa
snippet."onpage1);forJSON,useloadjson()("loadjson()"onpage729).
Tip: Externalcontentisnotloadedwhileeditingascript.Totestascriptthatloadsexternalcon-
tent,youcandoapreflight;see"DoingaPreflight"onpage378.
loadtext(location)
Returnsthecontentofatextfile.Thefileextensiondoesn'thavetobe.txt.ItmayalsobeaJavaScript
file(.js)orastylesheet(.css),forinstance.
location
StringcontainingapaththatcaneitherbeaURLorapaththatisrelativetothesection/context.
Inordertoretrievefilesfromoutsidethetemplatethefileprotocolissupportedaswellasthe
Page 731