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 the cid variable, i.e. the value returned by ics.GetVar("cid").

assettype (optional)

Indicates the type of the edited asset.
Defaults to the value of the c variable, i.e. the value returned by ics.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 parent insite: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 the c and cid 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>

See Also

insite:edit

insite:slotlist

		Home >	Contents >	Index >
	Oracle JSP Tag Reference Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.