..  include:: /Includes.rst.txt
..  index::
    Content objects; Array
    Content objects; Content object array
    Content objects; COA
    Content objects; COA_INT
..  _cobj-cobj-array:
..  _cobj-coa:
..  _cobj-coa-int:

====================================
Content object array - COA, COA\_INT
====================================

..  note::

    *   COA is an object type (= complex data type).
    *   It is a specific :ref:`cObject <cobject>` data type.

COA stands for "content object array".

An object with the content type COA is a cObject, in which you
can place several other cObjects using numbers to enumerate them.

You can also create this object as a COA\_INT in which case it works
exactly like the :ref:`USER_INT <cobj-user-int>` object does: It's
rendered non-cached! That way you cannot only render non-cached
:ref:`USER_INT <cobj-user-int>` objects, but COA\_INT allows
you to render *every* cObject non-cached.

..  _cobj-coa-properties:

Properties
==========

..  confval-menu::
    :display: table
    :type:

..  _cobj-coa-index:

1,2,3,4...
----------

..  confval:: 1,2,3,4...
    :name: coa-array
    :type: :ref:`cObject <data-type-cobject>`

    Numbered properties to define the different cObjects, which should be
    rendered.

..  _cobj-coa-cache:

cache
-----

..  confval:: cache
    :name: coa-cache
    :type: :ref:`cache <cache>`

    See :ref:`cache function description <cache>` for details.

..  _cobj-coa-if:

if
--

..  confval:: if
    :name: coa-if
    :type: :ref:`->if <if>`

    If `if` returns false, the COA is **not** rendered.

..  _cobj-coa-stdWrap:

stdWrap
-------

..  confval:: stdWrap
    :name: coa-stdWrap
    :type: :ref:`->stdWrap <stdwrap>`

    Executed on all rendered cObjects after property :ref:`wrap <cobj-coa-wrap>`.

..  _cobj-coa-wrap:

wrap
----

..  confval:: wrap
    :name: coa-wrap
    :type: :ref:`wrap <data-type-wrap>` / :ref:`stdWrap <stdwrap>`

     Wraps all rendered cObjects. Executed before property :ref:`stdWrap <cobj-coa-stdWrap>`.


..  _cobj-cobj-array-examples:
..  _cobj-coa-examples:
..  _cobj-coa-int-examples:

Examples:
=========

..  literalinclude:: _examples2.typoscript
    :caption: EXT:site_package/Configuration/Sets/Main/setup.typoscript

The previous example will print a simple :html:`<h1>` header, followed by the page
content records and a :html:`<footer>` element.

..  literalinclude:: _int.typoscript
    :caption: EXT:site_package/Configuration/Sets/Main/setup.typoscript

This example will not be cached and so will display the current time
on each page hit.