mjml-hero

4.15.3 • Public • Published

mj-hero

This element displays a hero image. It behaves like an mj-section with a single mj-column.

background-height and background-width attributes are mandatory.

It's best to use an image with width the same as the mj-body width (width="600px" by default). For better results, it's best to use an image with height the same or larger than the height of mj-hero.

Use background-color to provide a fallback color in case an email client doesn't support background-url.

The "height" attribute is required only for 'mode="fixed-height"'.

Fixed height

demo background picture with fixed height

<mjml>
  <mj-body>
    <mj-hero
      mode="fixed-height"
      height="469px"
      background-width="600px"
      background-height="469px"
      background-url=
          "https://cloud.githubusercontent.com/assets/1830348/15354890/1442159a-1cf0-11e6-92b1-b861dadf1750.jpg"
      background-color="#2a3448"
      padding="100px 0px">
      <mj-text
        padding="20px"
        color="#ffffff"
        font-family="Helvetica"
        align="center"
        font-size="45px"
        line-height="45px"
        font-weight="900">
        GO TO SPACE
      </mj-text>
      <mj-button href="https://mjml.io/" align="center">
        ORDER YOUR TICKET NOW
      </mj-button>
    </mj-hero>
  </mj-body>
</mjml>

try it live

Fluid height

demo background picture with fixed height

<mjml>
  <mj-body>
    <mj-hero
      mode="fluid-height"
      background-width="600px"
      background-height="469px"
      background-url=
          "https://cloud.githubusercontent.com/assets/1830348/15354890/1442159a-1cf0-11e6-92b1-b861dadf1750.jpg"
      background-color="#2a3448"
      padding="100px 0px">
      <mj-text
        padding="20px"
        color="#ffffff"
        font-family="Helvetica"
        align="center"
        font-size="45px"
        line-height="45px"
        font-weight="900">
        GO TO SPACE
      </mj-text>
      <mj-button href="https://mjml.io/" align="center">
        ORDER YOUR TICKET NOW
      </mj-button>
    </mj-hero>
  </mj-body>
</mjml>

try it live

attribute unit description default value
background-color color hero background color #ffffff
background-height px height of the image used, mandatory none
background-position top/center/bottom left/center/right background image position center center
background-url url absolute background url n/a
background-width px width of the image used, mandatory parent element width
border-radius px border radius n/a
height px hero section height (required for fixed-height mode) 0px
mode fluid-height/fixed-height choose if the height is fixed based on the height attribute or fluid fluid-height
padding px supports up to 4 parameters 0px
padding-bottom px bottom offset 0px
padding-left px left offset 0px
padding-right px right offset 0px
padding-top px top offset 0px
vertical-align top/middle/bottom content vertical alignment top

Readme

Keywords

none

Package Sidebar

Install

npm i mjml-hero

Homepage

mjml.io

Weekly Downloads

563,058

Version

4.15.3

License

MIT

Unpacked Size

19.1 kB

Total Files

4

Last publish

Collaborators

  • mjmlio
  • iryusa
  • loeck
  • ngarnier
  • meriadec
  • kmcb