.. include:: /Includes.rst.txt

===========================================================================
Feature: #79622 - SpaceBefore- and SpaceAfterClass for Fluid Styled Content
===========================================================================

See :issue:`79622`

Description
===========

CSS Styled Content provided the possibility to the editor to fine-tune distances
between content elements. The concept of CSC relied on the editor
understanding what `margins` are, how they are calculated and had to maintain
an overview of pixels that were used on the site he/she is maintaining.

This led to different problems not only for the editor but also for the
integrator because he had no control about what the editor fills into these
fields. Also it was hardly controllable when these distances should be
variable and change on certain viewports for mobile usage.

To regain control over this behaviour we are now introducing a new concept
that purely relies on CSS classes, that can be defined by the integrator.

All CSS classes are prefixed with `frame-space-before-` or
`frame-spacer-after-` by default and added to the surrounding frame when available.
If the frame of the content element is set to none, placeholder elements
are placed before and after to generate that distance.

The default CSS definitions are placed in the optional static template
`Fluid Content Elements CSS (optional)`. If this is not included only the
CSS classes will be added but without having CSS rules matching these classes.


Example for before classes
--------------------------

=============   =============   ===============================   =============
Name            Value           CSS Class                         Margin
=============   =============   ===============================   =============
None            (empty)         (No CSS Class added)              (No Margin)
Extra Small     extra-small     frame-space-before-extra-small     1em
Small           small           frame-space-before-small           2em
Medium          medium          frame-space-before-medium          3em
Large           large           frame-space-before-large           4em
Extra Large     extra-large     frame-space-before-extra-large     5em
=============   =============   ===============================   =============


Example Output
--------------

.. code-block:: html

   <div id="c43" class="frame ... frame-space-before-medium">
      ...
   </div>

.. code-block:: html

   <a id="c43"></a>
   <div class="frame-space-before-medium"></div>
   ...
   <div class="frame-space-after-medium"></div>


Edit predefined options
-----------------------

.. code-block:: typoscript

   TCEFORM.tt_content.space_before_class {
      removeItems = extra-small,small,medium,large,extra-large
      addItems {
         superspace = LLL:EXT:extension/Resources/Private/Language/locallang.xlf:superSpace
      }
   }

.. code-block:: php

   $GLOBALS['TCA']['tt_content']['columns']['space_before_class']['config']['items'][] = [
      0 = LLL:EXT:extension/Resources/Private/Language/locallang.xlf:superSpace
      1 = superspace
   ];


Impact
======

SpaceBefore and SpaceAfter is now available to all Fluid Styled Content elements.

.. index:: Fluid, Frontend, ext:fluid_styled_content, TypoScript
