Container elements 

Extension key

container_elements

Package name

buepro/typo3-container-elements

Version

main

Language

en

Author

Roman Büchler

Email

rb@buechler.pro

License

This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml

Rendered

Sat, 25 Oct 2025 18:17:35 +0000


This extension provides elements to further structure the website content area by using the extension container and the bootstrap framework. Currently the following elements are available: container, columns, grid, register, accordion, tile unit, card and randomizer. A demo can be found at pizpalue.buechler.pro.


Credits

This extension can be provided thanks to generous support from partners. A big thanks goes to:


Table of content

Latest Stable Version TYPO3 13 Total Downloads Monthly Downloads Continuous Integration Status

Introduction 

What it does 

This extension provides elements to further structure the content area. It is powered by the extension container. Many thanks to the b13.com team!

Currently the following elements are available: container, columns, grid, registers, accordion, tile unit, card and randomizer. The extension is intended to be used together with the bootstrap framework.

Since the elements are provided by container they are following referred to as container elements.

Container elements can hold any kind of content elements hence as well other container elements.

Limitations 

When using images in container elements reducing the horizontal space (e.g. column elements) the image dimensions should be adapted to the resulting space. The approach to obtain the final space depends on the context and therefore no general solution can be offered. The template pizpalue offers a flexible way to optimize image dimensions in structure elements and fully supports this extension. An example can be found under pizpalue.buechler.pro.

Example contents 

Columns, tabs and accordion 

The following image shows the usage from a two columns container element containing a tabs container element in the left column and an accordion container element in the right column. Three and four columns container elements are available too.

Two columns with a tabs and accordion element

Container and cards 

The container container element (it's not a typo since the container element is a dedicated container...) adds freedom in designing the layout. It might be used to group elements as well as to enhance the functionality. In the below shown image the Classes field from the container element container has been set to card-deck and accommodates two card container elements.

Card deck container with two cards

Tile unit 

The tile unit container element can be used to create panels showing tiles.

Tiles aren't yet supported by the bootstrap framework hence on bare installations won't show up as expected. To get started using tile units the extension pizpalue might be checked out.

Tile unit containing tile content elements

Randomizer 

Shows random content elements.

Grid 

To create grid components.

Slider 

Responsive slider using Swiper.

Allows to configure the quantity of content elements per breakpoints.

Slider with two content elements per slide for medium sized screens
Slider with four content elements per slide for large sized screens

Administration 

Requirements 

Component Version
TYPO3 12.4, 13.4
container 3.0.0

Compatibility 

Component Version
pizpalue 17
bootstrap 5

Installation 

Upgrade 

The following upgrade descriptions are available:

Upgrade to version 5.0.0 

Breaking changes 

Drop support for bootstrap 4 (06.03.2023, cc76e36) 

Drop deprecated pizpalue configuration (06.03.2023, 5d594a5) 

Descriptions 

Pizpalue v13+ accommodates these configurations.

Drop deprecated column flex forms (06.03.2023, 2aa16d4) 

Descriptions 

The dropped column flex forms were used in conjunction with older pizpalue versions. Using pizpalue v13+ these configurations aren't needed anymore.

Bump TYPO3 to v12.1 (12.12.2022, 2d09f58) 

Description 

And drop support for TYPO3 v10

Upgrade to version 4.0.0 

Breaking changes 

Add name space prefix to content element templates (d5e328e9) 

Description 

Content elements share rendering definitions from lib.contentElement. Extensions might take advantage from settings defined by container_elements by referencing the lib object (e.g.lib.containerContentElement =< lib.contentElement). As a result the template and partial root paths contain definitions from various extensions. To prevent conflicts templates and partials from container_elements content elements have been prefixed with 'Ce'.

Corrective action 

Templates or partials overriding container_elements content element rendering need to be adapted. In most cases the template and/or partial name has to be prefixed with Ce.

Drop pizpalue support (c9391184) 

Description 

In effort to improve separation of concerns pizpalue related adjustments have been moved to the extension pizpalue. As a result column flex forms as well as the partial CeColumns have changed.

Corrective action 

Sites not using pizpalue but making use of pizpalue related settings need to add their own column flex forms and CeColumns partial.

Upgrade to version 3.0.0 

This version is intended to be used together with bootstrap 5. To ease transition a static template supporting bootstrap 4 is available. To use it add Container elements DEPRECATED - Bootstrap 4 to Include static (from extensions) from the template record.

To ease upgrading css classes for the bootstrap 5 a wizard step is available.

Breaking changes 

Use buttons in accordion and tabs (6e4247d7) 

Description 

The rendering has been adapted to be compatible with bootstrap package (ext:bootstrap_package) 12 and bootstrap 5. As a result the components have a different look.

Corrective action 

Adapt the fluid template in the site package or add the static template Container elements DEPRECATED - Bootstrap 4 to the template record.

Configuration 

Some aspects can be adjusted through the extension configuration from the settings module.

Use container elements 

New content element wizard 

Container elements can be added by the new content element wizard. The available elements can be found under the register Container.

Container elements in new content element wizard

Container elements are available under the "Container" tab in new content element wizard

Content element type 

When changing a content element type the container elements are available in the section Special.

Container element in content element type selector

"Container element" in content element type selector

Vertical spacing 

Sometimes structure elements are rendered with excessive vertical spacing. To reduce them No Frame might be selected by the frame selector under the Appearance-tab.

Select the appropriate frame to adjust vertical spacing

Select the appropriate frame to adjust vertical spacing

Adjust container elements 

Information regarding special features from some container elements is given below.

Container 

A handy element to wrap content with a div-tag. Optionally an additional section wrap can be added.

A container element can be combined with card elements to define the cards layout (see layout from bootstrap's card component). Some layouts can be selected by the container classes value picker.

Properties from container element

Properties from container element

Tile unit 

Tile units are used to create a tile view typically showing images. Tile units aren't yet supported by the bootstrap framework hence might not show up correctly. For the tile units to work correctly content elements might be adapted to render with the desired tile side ratio. These content elements might be provided by an extension (e.g. the extension pizpalue provides various tile layouts for this purpose).

Tile units might be listed or combined together. In this case it can be convenient to collect them in a container. As well the Frame might need to be set to none in the Appearance tab.

Tile unit

Tile unit showing tiles

Card 

The card container element can render most card layouts as outlined on the bootstrap framework page.

Defining content 

Texts and an image can be defined through the content element's form and/or by adding any kind of content element to the available grid containers Content (optional) and Image content (optional).

Text tab from card

Text and image content defined in the card form


Card grid in backend

Any kind of content element to be used as image and body content

Using container 

Cards might be grouped with container elements.

Cards in container

Two cards in a container

Slider 

The slider container element uses the Swiper js library. The behaviour from each slider can be configured within the content element using json:

{
    "slidesPerView": 4,
    "spaceBetween": "20px",
    "slidesPerGroup": 1,
    "loop": 0,
    "disableOnInteraction": "true",
    "autoplay": "auto",
    "breakpoints": {
        "10": {
            "slidesPerView": 1
        },
        "576": {
            "slidesPerView": 1
        },
        "768": {
            "slidesPerView": 2
        },
        "1200": {
            "slidesPerView": 3
        },
        "1400": {
            "slidesPerView": 4
        }
    }
}
Copied!

Changelog 

The project changes can as well be looked up at Github.

Releases 

Changelog for release v7.0.0 

Bugfixes 

  • [!!!][BUGFIX] Adapt be partials to TYPO3 v13 (25.06.2025, 1407dd2 by Roman Büchler)
  • [BUGFIX] Strictify DataHandlerHook (06.12.2024, d55e653 by Roman Büchler)
  • [BUGFIX] Render card with be partial (06.12.2024, a85fe54 by Roman Büchler)
  • [BUGFIX] Use correct fluid namespace (06.12.2024, e742e75 by Roman Büchler)
  • [BUGFIX] Add request to form data compiler (03.11.2024, 56b0ab0 by Roman Büchler)
  • [BUGFIX] Avoid constructor argument in FormDataCompiler (29.10.2024, 2387775 by Roman Büchler)

Breaking changes 

  • [!!!][BUGFIX] Adapt be partials to TYPO3 v13 (25.06.2025, 1407dd2 by Roman Büchler)

Generated by:

git log v6.0.0..HEAD --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v6.0.0 

Bugfixes 

  • [BUGFIX] Bind slider to content element (20.10.2024, ffa6870 by Roman Büchler)

Breaking changes 

  • [!!!][TASK] Drop support for TYPO3 v11 & add v13 (16.08.2024, 725fcc4 by Roman Büchler)

Generated by:

git log v5.3.0..HEAD --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v5.3.0 

Features 

  • [FEATURE] Optionally render empty columns (16.08.2024, a2e5ab3 by Roman Büchler)

Bugfixes 

  • [BUGFIX] Enable nested accordions (15.08.2024, 0780efe by Roman Büchler)
  • [BUGFIX] Show localized content (15.08.2024, 1284056 by Roman Büchler)

Generated by:

git log v5.2.0..HEAD --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v5.2.0 

Features 

  • [FEATURE] Add resources to container ce (28.03.2024, c724f41 by Roman Büchler)
  • [FEATURE] External grid element rendering (27.03.2024, 6f969b2 by Roman Büchler)
  • [FEATURE] Decouple slider controls (26.03.2024, 9aba319 by Roman Büchler)
  • [FEATURE] External slide rendering (26.03.2024, e98fee7 by Roman Büchler)
  • [FEATURE] Add slider container element (25.03.2024, b9e0950 by Roman Büchler)

Generated by:

git log v5.1.0..HEAD --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v5.1.0 

Features 

  • [FEATURE] Make container content elements collapsible (30.05.2023, 71c26a9 by Roman Büchler)

Bugfixes 

  • [BUGFIX] Render container content (21.04.2023, 60d8786 by Roman Büchler)

Generated by:

git log v5.0.0..HEAD --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v5.0.0 

Features 

  • [!!!][FEATURE] Bump TYPO3 to v12.1 (12.12.2022, 2d09f58 by Roman Büchler)
  • [FEATURE] Add value picker to grid row (23.09.2022, 80fcb5e by Roman Büchler)

Bugfixes 

  • [BUGFIX] Restrict flex form processing (06.03.2023, 296edbe by Roman Büchler)
  • [BUGFIX] Strictify CardImageProcessor (03.01.2023, b1982bd by Roman Büchler)
  • [BUGFIX] Set default grid element classes (27.10.2022, 105a6a1 by Roman Büchler)

Breaking changes 

  • [!!!][TASK] Drop support for bootstrap 4 (06.03.2023, cc76e36 by Roman Büchler)
  • [!!!][TASK] Drop deprecated pizpalue configuration (06.03.2023, 5d594a5 by Roman Büchler)
  • [!!!][TASK] Drop deprecated column flex forms (06.03.2023, 2aa16d4 by Roman Büchler)
  • [!!!][FEATURE] Bump TYPO3 to v12.1 (12.12.2022, 2d09f58 by Roman Büchler)

Generated by:

git log v4.0.1..HEAD --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v¤.0.1 

Bugfixes 

  • [BUGFIX] Improve field access in DataHandlerHook (22.08.2022, 6a688ce by Roman Büchler)

Generated by:

git log v4.0.0..6a688ce6 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v4.0.0 

Bugfixes 

  • [!!!][BUGFIX] Add name space prefix to content element templates (13.08.2022, d5e328e by Roman Büchler)
  • [BUGFIX] Include dev-main branches in grid template (18.05.2022, c69948b by Roman Büchler)
  • [BUGFIX] Include dev branches in AspectProcessor (18.05.2022, 5f0d8a3 by Roman Büchler)

Breaking changes 

  • [!!!][TASK] Drop pizpalue support (15.08.2022, c939118 by Roman Büchler)
  • [!!!][BUGFIX] Add name space prefix to content element templates (13.08.2022, d5e328e by Roman Büchler)

Generated by:

git log v3.1.0..f67bc386 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release 3.1.0 

Features 

  • [FEATURE] Add grid element (07.12.2021, 2cf2a501 by Roman Büchler)

Bugfixes 

  • [BUGFIX] Add missing breakpoint to variants (07.12.2021, 16a19e1a by Roman Büchler)
  • [BUGFIX] Test table in data handler hook (06.12.2021, f04fbab by Roman Büchler)

Breaking changes 

Generated by:

git log v3.0.0..2fb2f847 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release 3.0.0 

Features 

  • [FEATURE] Add randomizer container element (03.12.2021, 7368bbb by Roman Büchler)
  • [!!!][FEATURE] Use buttons in accordion and tabs (26.08.2021, 6e4247d by Roman Büchler)
  • [FEATURE] Add bootstrap 5 classes (25.08.2021, 4b93bc2 by Roman Büchler)

Bugfixes 

  • [BUGFIX] Use variable provider directly (25.11.2021, be3495b by Roman Büchler)
  • [BUGFIX] Correct sheet definition in ClassesUpdate (18.11.2021, e8c9b87 by Roman Büchler)
  • [BUGFIX] Add missing data attribute to accordion (12.11.2021, 2d08391 by Roman Büchler)
  • [BUGFIX] Correct issue with updating empty fields (07.09.2021, cf1809b by Roman Büchler)

Breaking changes 

  • [!!!][TASK] Drop support for php 7.2 (09.11.2021, 9f7cf6e by Roman Büchler)
  • [!!!][FEATURE] Use buttons in accordion and tabs (26.08.2021, 6e4247d by Roman Büchler)

Generated by:

git log v2.1.2..afcd5e7 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v2.0.0 

Features 

  • [!!!][FEATURE] Respect gutter/correction for image rendering (30.04.2021, c40846f by roman)
  • [FEATURE] Automatically load static TS for pizpalue (07.04.2021, 381058e by roman)

Bugfixes 

Breaking changes 

  • [!!!][FEATURE] Respect gutter/correction for image rendering (30.04.2021, c40846f by roman)

Generated by:

git log v1.4.0..c40846f8 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v1.4.0 

Features 

  • [FEATURE] Support TYPO3 V11 on composer installations (30.03.2021, 4a6a4c9 by roman)

Bugfixes 

  • [BUGFIX] Correct aria attribute name (04.03.2021, 4b7c731 by Marco Christian Krenn)

Generated by:

git log v1.3.0..4a6a4c9 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v1.3.0 

Features 

  • [FEATURE] Allow to configure open accordion item (26.01.2021, df6fb33 by Roman)

Generated by 

git log f4c9031.. --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep FEATURE
git log f4c9031.. --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep BUGFIX
git log f4c9031.. --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep !!!

Copied!

Note: The above list contains just commits marked with FEATURE, BUGFIX, !!!. Complementary commits are available at Github.

Changelog for release v1.2.1 

Features 

  • [FEATURE] Render preview text for card element (21.12.2020, 6509b88 by roman)

Bugfixes 

  • [BUGFIX] Correct preview in backend (22.12.2020, 249ada9 by roman)

Generated by:

git log v1.1.0..249ada99 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v1.1.0 

Features 

  • [FEATURE] Enable setting column classes in card (17.11.2020, 4b528e6 by roman)

Bugfixes 

  • [BUGFIX] Don't render empty header tag in card (17.11.2020, 85142c7 by roman)

Breaking changes 

Generated by:

git log 1.0.0..eae481c8 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Changelog for release v1.0.0 

Bugfixes 

  • [BUGFIX] Correct rendering from localized contents (13.08.2020, b9a54b8 by Roman)

Generated by:

git log 62ae12a..cc57441 --pretty="* %s (%cd, %h by %an)" --date=format:%d.%m.%Y --abbrev-commit --grep

Note: The above list contains just commits marked with [FEATURE], [BUGFIX] and [!!!]. Complementary commits are available at Github.

Sitemap