Section element (Server Ribbon)

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Defines a section of a layout.

<Section
  Type="Divider | OneRow | TwoRow | ThreeRow"
  Alignment="Top | Middle"
/>

Elements and attributes

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
Type
Optional. An enumeration value that specifies the type of section.

Divider. The section cannot contain child Row elements.
OneRow. The section can contain one child Row element.
TwoRow. The section can contain two child Row elements.
ThreeRow. The section can contain three child Row elements.
Alignment
Optional. An enumeration value that specifies the vertical alignment of controls within the section.

Top. Control icons are aligned to the top edge of their row.
Middle. Control icons are aligned in the middle of their row.

The default alignment is Top.

Child elements

Parent elements

Occurrences

  • Minimum: 0
  • Maximum: unbounded

Example

The following example defines a layout with two sections of different types.

<Layout Title="Large">
  <Section Type="OneRow">
    <Row>
      <ControlRef TemplateAlias="createView" DisplayMode="Large" />
    </Row>
  </Section>
  <Section Type="ThreeRow">
    <Row>
      <ControlRef TemplateAlias="viewSelector" DisplayMode="Medium" />
    </Row>
    <Row>
      <ControlRef TemplateAlias="modifyView" DisplayMode="Medium" />
    </Row>
    <Row>
      <Strip>
        <ControlRef TemplateAlias="previousPage" DisplayMode="Small" />
        <ControlRef TemplateAlias="currentPage" DisplayMode="Medium" />
        <ControlRef TemplateAlias="nextPage" DisplayMode="Small" />
      </Strip>
    </Row>
  </Section>
</Layout>