area

Represents an area on an Escenic section page.

Syntax
<area
    name="text"
  >
  <options>...</options>?
  <content-ref>...</content-ref>*
  <list-ref>...</list-ref>*
  <group>...</group>*
</area>

Only one form of the content-ref element may be used: Section Page content-ref.

Examples
  • This example shows an area element that contains a child group

    <area name="center">
      <group name="twoCol">
        <area name="left">
          <list-ref source="ex" sourceid="s12" name="important" number-of-items="2"/>
        </area>
        <area name="right">
          <content-ref source="ex" sourceid="19">
            <field name="leadtext">New lead text</field>
          </content-ref>
          <content-ref source="ex" sourceid="20"/>
        </area>
      </group>
    </area>
  • This example shows an area element that contains content-ref elements.

    <area name="right">
      <content-ref source="ex" sourceid="19">
        <field name="leadtext">New lead text</field>
      </content-ref>
      <content-ref source="ex" sourceid="20"/>
    </area>
Attributes
name="text"

The name of this area. This must be the name of an area that is:

  • Defined in the layout-groups resource of the target publication.

  • Allowed in the current context.

"Allowed in the current context" means:

  • If this area element is the child of a section-page element, then it must be the name of an area defined in the layout-groups resource as a child of the layout group specified with the section-page element's layout-name attribute.

  • If this area element is the child of a group element, then it must be the name of an area defined in the layout-groups resource as a child of that group.