update

See also

Updates the content of an HTML element with a template or a literal HTML text.

Example:

<div id="mydiv"><p>Bye Bye.</p></div>
{% button text="hello" action={update target="mydiv" text="<p>Hello World!</p>"} %}

When clicked, the contents of the div will be set to the HTML fragment <p>Hello World!</p>. This replaces any content present.

Note

Use the update_iframe action for updating the contents of an iframe element.

Another example, now rendering a template:

<ul id="mylist"><li>Some item</li></li>
{% button text="hello" action={update target="mylist" template="_list_item.tpl" id=42} %}

This updates the <ul/> with the output of the template _list_item.tpl. All arguments to the update action are also arguments to the template.

Argument	Description	Example
target	The id of the element receiving the rendered HTML.	target=”my-view”
text	Literal HTML text to be inserted, no escaping will be done.	text=”Hello <b>World</b>”
template	Name of the template to be rendered.	template=”_list_view.tpl”
include_all	Add this argument to include all templates with the same name. If not added then the best template will be used.	include_all
catinclude	Add this argument to use a catinclude instead of a normal include of the template. The id argument must be present for a catinclude to work.	catinclude id=1

All other arguments are passed as-is to the included template(s).