Back to Mjml

README

packages/mjml-column/README.md

5.1.06.2 KB
Original Source

mj-column

Columns enable you to organize the content of your sections into distinct columns which stack when viewed on a mobile device.

They must be located within mj-section tags in order to be considered by the engine.

<div class="alert alert-caution" role="alert"> <p>Caution</p> <p>The sum of columns in a section cannot be greater than the width of the parent <code>mj-section</code> (or 100%).</p> </div>

Every single column has to contain something because they are responsive containers, and will be vertically stacked on a mobile view. Any standard component, or component that you have defined and registered, can be placed within a column – except mj-column or mj-section elements.

xml
<mjml>
  <mj-body>
    <mj-section>
      <mj-column>
        <!-- Your first column -->
      </mj-column>
      <mj-column>
        <!-- Your second column -->
      </mj-column>
    </mj-section>
  </mj-body>
</mjml>
<div class="alert alert-caution" role="alert"> <p>Caution</p> <p>Columns are used as a container for your content and should not be used to offset. Any MJML component included in a column will have a width equivalent to 100% of this column's width.</p> </div> <div class="alert alert-caution" role="alert"> <p>Caution</p> <p>Neither the <code>mj-column</code> or <code>mj-section</code> tags can be nested in an <code>mj-column</code> tag</p> </div>

Attributes

attributeacceptsdescriptiondefault attributes
background-colorCSS color formatsbackground color for a column
borderstringCSS border format
border-bottomstringCSS border format
border-leftstringCSS border format
border-radiusstringborder radius
border-rightstringCSS border format
border-topstringCSS border format
css-classstringclass name, added to the root HTML element created
directionltr rtlset the display order of direct childrenltr
inner-background-colorCSS color formatsinner background color for column; requires a padding
inner-borderstringCSS border; requires a padding format
inner-border-bottomstringCSS border format; requires a padding
inner-border-leftstringCSS border format; requires a padding
inner-border-radiusstringborder radius ; requires a padding
inner-border-rightstringCSS border format; requires a padding
inner-border-topstringCSS border format; requires a padding
paddingpx %column padding, supports up to 4 parameters
padding-bottompx %column bottom padding
padding-leftpx %column left padding
padding-rightpx %column right padding
padding-toppx %column top padding
widthpx %column width(100 / number of non-raw elements in section)%
vertical-aligntop middle bottomvertical alignment.
Note: middle only applies when all mj-column instances use ittop
<p class="cta-container"><a class="cta" href="https://mjml.io/try-it-live/components/column">Try it live</a></p>