TemplateApply

✖
`TemplateApply`

✖

TemplateApply[template]

applies a template, evaluating all template elements it contains.

✖

TemplateApply[template,args]

applies a template, using args to fill slots in the template.

Details and Options

The template in TemplateApply can be an explicit TemplateObject, as generated from StringTemplate, FileTemplate, XMLTemplate, or NotebookTemplate.
The following special forms can also be used directly as templates:

	"string"	string template
	File["filename.xx"]	general file template
	File["filename.html"] etc.	XML-like file template
	File["filename.nb"] etc.	notebook-like file template
	URL[…]	a URL pointing to a file template
	NotebookObject[…]	notebook template
	CloudObject[…]	template type based on the contents of the cloud object

In TemplateApply[template,args], args can have the following forms:
{arg₁,arg₂,…} positional arguments

<|"name₁"->val₁,"name₂"->val₂,…|> named arguments
In string and general file templates, positional arguments corresponding to TemplateSlot[i] can be referred to using `` and `i`. Named arguments corresponding to TemplateSlot["name_i"] can be referred to using `name_i`. TemplateExpression elements can be given as <*…*>.

Examples

open allclose all

Basic Examples (3)Summary of the most common use cases

Render a template:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-i6p7hl

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0puwgsqjk0-4gn4zv

Out[2]=2

Use key-value pairs:

In[3]:=3

✖

https://wolfram.com/xid/0puwgsqjk0-sbf42x

Out[3]=3

TemplateApply works with any expression:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-hmr9ms

Out[1]=1

TemplateApply can be used directly on strings; in that case, the string is taken to be a StringTemplate:

In[2]:=2

✖

https://wolfram.com/xid/0puwgsqjk0-jwh3aj

Out[2]=2

TemplateApply can be used to build held expressions:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-066igr

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0puwgsqjk0-ics4uo

Out[2]=2

Scope (5)Survey of the scope of standard use cases

TemplateApply can be used to parse and apply a StringTemplate in one step:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-8qyixc

Out[1]=1

File is fully supported:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-f48c8p

Out[1]=1

Templates can be hosted in the Wolfram Cloud:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-zn99tp

Out[1]=1

CloudObject can be directly used by TemplateApply:

In[2]:=2

✖

https://wolfram.com/xid/0puwgsqjk0-euzfet

Out[2]=2

The second argument of any TemplateObject can be used to bound data to the template:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-u7p483

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0puwgsqjk0-8tx9dm

Out[2]=2

URL can be used to fetch templates:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-ehr44g

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0puwgsqjk0-uwsajo

Out[2]=2

In[3]:=3

✖

https://wolfram.com/xid/0puwgsqjk0-se9tn7

Out[3]=3

URL can be directly used by TemplateApply:

In[4]:=4

✖

https://wolfram.com/xid/0puwgsqjk0-6etf82

Out[4]=4

Generalizations & Extensions (2)Generalized and extended use cases

CombinerFunction (1)

Specify a different way to combine parts of templates:

Using CombinerFunction:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-4bhzn7

Out[1]=1

InsertionFunction (1)

Specify a function to convert arguments before they are inserted:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-ubvqks

Applications (1)Sample problems that can be solved with this function

TemplateApply can be used to build complex expressions:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-fhg6px

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0puwgsqjk0-kks95h

Out[2]=2

Properties & Relations (1)Properties of the function, and connections to other functions

If you deploy a template with data, each time you visit it TemplateApply will render the content again:

In[6]:=6

✖

https://wolfram.com/xid/0puwgsqjk0-kwsq8a

Out[6]=6

Neat Examples (1)Surprising or curious use cases

You can deploy any TemplateObject to the cloud. When you visit the URL, TemplateApply will render the template on each visit:

In[1]:=1

✖

https://wolfram.com/xid/0puwgsqjk0-bat1nv

Out[1]=1

Top