Home > Contents > Index >
Template Tags TOC | Alpha TOC | Tag Family TOC | Purpose TOC | Annotated TOC | Index
insite:list
Streams additional editing widgets allowing content contributors to edit multivalued asset fields in a dedicated popup window
Syntax
<insite:list field="asset field name" [assetid="asset id"] [assettype="asset type"] [mode="text|html"] [editor="type of editor"] [params="editor parameters"] [countervar="name of variable containing current list index"]> [<insite:edit ... /> <insite:edit ... /> ...] </insite:list>Parameters
field (required)
- Indicates the name of the edited field.
assetid (optional)
- Indicates the id of the edited asset.
Defaults to the value of thecid
variable, i.e. the value returned byics.GetVar("cid")
.
assettype (optional)
- Indicates the type of the edited asset.
Defaults to the value of thec
variable, i.e. the value returned byics.GetVar("c")
.
mode (optional)
- see the
mode
attribute of insite:edit.
editor (optional)
- see the
editor
attribute of insite:edit.
params (optional)
- see the
params
attribute of insite:edit.
countervar (optional)
- Designates a variable containing a 1-based index. This attribute is used when insite:list is combined with nested insite:edit tags and the values are rendered in an order which doesn't match the field ordering.
Alternatively, the
index
attribute of each nested insite:edit tag can be used for the same purpose.Description
insite:list
typically wraps an area rendering multivalued field values. It can be used:
- in conjunction with nested
insite:edit
tags, allowing nested value to be edited in-context- or on its own, without nested
insite:edit
tags. This is especially useful when field values are not directly editable on the web page. For instance, the field values could represent a list of addresses rendered on an interactive map.In editing mode, the tag generates a toolbar, displayed when the content contributor hovers over the wrapped area. This toolbar allows contributors to access a dedicated popup window showing all field values. In this popup, contributors can edit field values, but also add, remove and reorder them.
In any other rendering mode, this tag does not generate any markup.
Notes
- Nested
insite:edit
tags inherit the following attribute values set in their parentinsite:list
tag:editor
,params
,mode
,assetid
,assettype
,field
.- This tag is applicable to any data types, except asset reference fields. See
insite:slotlist
for more details on editing multivalued fields containing asset references.Example
The following example enables editing the multivalued
teaserText
field of the asset determined by thec
andcid
variables:<%-- - The code sample assumes the values of the field to be available in a list called "teaserList" - with a single column named "value" (such as lists returned by tags such as assetset:getattributevalues). --%> <insite:list field="teaserText" editor="ckeditor" > <div class="teasers"> <ics:listloop listname="teaserList"> <%--Note that the "editor" attribute is passed to each nested insite:edit tag --%> <insite:edit list="teaserList" column="value" /> </ics:listloop> </div> </insite:list> For more information about editing assets in web mode, see "Coding Templates for In-Context Content Editing" in the Sites Developer's Guide.See Also
Home > Contents > Index > Oracle JSP Tag Reference
Copyright (c) 2013, 2016 Oracle and/or its affiliates. All rights reserved.