ContentBlocks v1 Input Types Layout

The Nested Layout input type provides you with the opportunity to add layouts from within a field. This enables you to further split up the page into multiple columns or to provide different wrappers.

Input types like the Repeater also support embedding Layout fields, allowing you to add layouts where normally you would only be able of adding fields.

While editing a layout through the ContentBlocks component, you can tick a checkbox on the Availability tab to make the layout only available through a Layout field. This way you can set up layouts that only appear when in a layout field. Through the layout field properties itself, you can also choose which layouts and templates should be available.

  • Key: layout
  • Template Placeholders: [[+value]], containing the fully parsed HTML output from the children layouts
  • Requirements: ContentBlocks 1.1

On this page

Example

Layout

Example Use Cases

Setting up a Nested Layout

Despite the enormous flexibility and additional functionality the Nested Layout brings, it is surprisingly simple to set up.

Go to Extras in the top navigation and open the ContentBlocks component. On the Fields tab, hit the button to create a new field. Choose Layout as the input type, give it a name and choose an icon.

On the Properties tab, you can customise the template (just make sure it contains ) and choose to limit the available layouts or templates to the one you want to use, however this is not required. Save the field.

When editing a resource, choose Add Content and insert the Layout field you just created. You will immediately see the Add Layout modal pop up asking you to choose a layout to insert, and you're done. :)