2020.2

Table Of Contents
Tip
To load an HTML fragment, you can use use loadhtml() (see
Skin/Formats/CrossReferencePrintFormat("loadhtml()Loads HTML content from the
specified HTML file. The file may be located inside the template (see
Skin/Formats/CrossReferencePrintFormat("Snippets" on page1)) or hosted on a Content
Management System or on another location outside the template.An optional selector
allows you to retrieve only the content of matching elements.The specified HTML file is
expected to be UTF-8 encoded.Loadhtml() is cached per batch run (based on the URL) in
print/email.To load a JavaScript file (.js) or a style sheet (.css) you can use loadtext(). See
Skin/Formats/CrossReferencePrintFormat("loadtext()" on page1).External content is not
loaded while editing a script. To test a script that loads external content, you can do a
preflight; see Skin/Formats/CrossReferencePrintFormat("Doing a Preflight" on
page1).loadhtml(location)Loads all HTML 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/https 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
Skin/Formats/CrossReferencePrintFormat("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.ExamplesThis script loads a local HTML snippet (from the
Resources panel) directly into the matched elementsresults.loadhtml
("snippets/snippet.html");The following script loads a local HTML snippet (Resources
panel) into a variable. The replaceWith() command is used to replace the element(s)
matched by the script's selector with the contents of the snippet.var mysnippet = loadhtml
('snippets/snippet.html'); results.replaceWith(mysnippet);Same result as the previous
script, but a different notation:results.replaceWith(loadhtml('snippets/snippet.html'));The
following script loads a snippet into a variable and finds/replaces text in the variable
before inserting the content into the page. The second find command also adds
formatting to the replacing text.var mysnippet = loadhtml
('file:///C:/Users/PParker/Documents/Example.html'); mysnippet.find('@var1@').text('OL
Connect 1'); mysnippet.find('@var2@').html('<i>OL Connect 2</i>').css('text-
Page 1287