Overview   Library    Tag    Help 
 FRAMES   NO FRAMES 

content
Tag absoluteContainerList

initializes Jahia in order to display a container list referenced using absolute addressing and declares it if required.

This class extends the ContainerListTag class, it therefore inherits all its attributes. Therefore The reader should refer to containerList tag's documentation for more details.

The term “absolute” is a little bit misleading, it does not mean that we are retrieving a special kind of container list, but rather that we access a container list on another page. With the containerList tag, only the current page container lists may be retrieved, but absoluteContainerList allows us to retrieve a container list on another page, using absolute addressing of a container list. So we pass an the 'pageID' attribute that contains the page ID for which we want to display the current children in the current recursive pass.

Example:

<content:absoluteContainerList name=”addressList” pageId=”3”>
    <!-- tags to display container list here -->
</content:absoluteContainerList>


Tag Information
Tag Classorg.jahia.taglibs.container.AbsoluteContainerListTag
TagExtraInfo ClassNone
Body Contenttagdependent
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
pageIdfalsetruejava.lang.Stringthe Page ID of the page which contains the desired container.

pageLevelfalsetruejava.lang.Stringthe offset from the root page, specifying the number of levels to go down in the tree.

The level is therefore independent of the current page, for this use the relativeContainerList tag. For example, if we have the following path page1 -> page2 -> page3 (current page) then the levels correspond to:
level 0 = Exception returned (doesn't exist)
level 1 = page1 (root page ID)
level 2 = page2
level 3 = page3
level 4 = Exception returned (doesn't exist)

nametruetruejava.lang.Stringthe name of the list.

This is an identifier that must be unique within the current parent object (page or containerlist) CHECK [To Be Completed] , Usually it is good practice to avoid using spaces in this name, which makes manipulation easier in general. See content:containerList.

sizefalsetruejava.lang.Stringthe number of elements in the list. Returns the size of the container list.

This now returns only the size that has been loaded in memory, as opposed to the full -i.e. real- size of the list set in the database. To get the real full size of data set, use @see JahiaContainerList#getFullSize(). The reason for this is due to the introduction of scrollable container lists which load only the set for the view.

windowSizefalsetruejava.lang.StringThe pagination window size i.e. the number of objects on each page.

It is possible to allow the user to change the number of items per page used in the Pagination of a given Container List. Say, if a container list contains a 1000 containers/fields, you'll want to spread this list across mutilple pages. If you don't, then enjoy the wait...

The default value is -1 meaning the functionality is deactivated. This value can be set in during the declaration of the container list with the @see declareContainerList#windowSize

windowOffsetfalsetruejava.lang.StringThe pagination window offset.

This attribute dictates the initial number of pages into the paginated list for this containerList. The default value is 0.

Note that if windowOffset is superior to the number of elements in the container list, it defaults back to a zero value.

maxSizefalsetruejava.lang.StringThe max size.

This attribute can be used to set the maximum size of the container list ( the max containers to load ). The default value is Integer.MAX_VALUE


Variables
No Variables Defined.

 Overview   Library    Tag    Help 
 FRAMES   NO FRAMES 
Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.