2019.2

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 page1).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-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",
mysnippet).text(); results.append("<p style='font-weight: bold;'>" + subject + "</p>");loadhtml
(location, selector)Retrieves specific content from the specified HTML file.locationString containing
Page 1344