mjml教程详解

2021-03-05 13:18:03

参考地址 mjml - 如何快速编写响应式电子邮件?

一、背景#


以前做项目碰到发邮件的需求,邮件模板的编辑就是一件头疼的事。因为虽说邮件是支持 HTML 的,但是确是 HTML 子集程度的支持,所以存在必须通过 <table> 排版的恶心之处,还有很多兼容性的坑。本质上是各家邮件商的标准有差异吧。

具体可参考阮一峰的这篇:http://www.ruanyifeng.com/blog/2013/06/html_email.html

于是我在网上 google 了下,发现了 mjml 这个最 hot 的 响应式电子邮件框架

二、特点#


1、那 mjml 就是一个类似 bootstrap 在 HTML + CSS 的地位,他们都提供了一些更高级的语法(标签)【叫MJML】,磨平了各家客户端在解析和指定标准上的差异。

2、mjml 的新语法学起来也很快,不多,好理解,易上手,然后基于组件化,能很快的搭出来你想要的 Email 内容。

3、mjml更支持响应式布局,且是移动端优先

三、使用#


1、安装#

其实有 npm 包,我懒得安装,遂用的在线编辑器

https://mjml.io/try-it-live

支持在线自动保存,很好用。

2、DEMO#

(1) 地址#

https://mjml.io/try-it-live/ry_x-1IZH

(2) 代码#
Copy<mjml>
  <mj-head>
    <mj-title>Hello Register</mj-title>
    <mj-attributes>
      <!-- 1、定义 global 样式 -->
      <!-- 针对某个元素 -->
      <mj-text line-height="150%" />
      <!-- 针对所有元素 -->
      <mj-all font-family="Arial" />
      <!-- 2、定义 class 样式 -->
      <mj-class name="title" font-size="35px" align="center" />
    </mj-attributes>
    <!-- 3、定义 css 样式 -->
    <mj-style inline="inline">
      .sign div { padding-left : 5px !important; color:#8C8C8C !important; }    </mj-style>
  </mj-head>
  <mj-body>
    <mj-wrapper background-url="https://i.loli.net/2019/07/14/5d2b00fad302f18835.png" background-repeat="no-repeat" background-size="100% 100%" padding="30px">
      <mj-section>
        <mj-column>
          <!-- 4、定义 inline 样式 -->
          <mj-image width="100px" src="https://mjml.io/documentation/images/logo.png"></mj-image>
        </mj-column>
      </mj-section>
      <mj-section>
        <mj-column>
          <mj-text mj-class="title">Register Success!</mj-text>
          <mj-spacer height="10px" />
          <mj-text>Dear [username],</mj-text>
          <mj-text>Thank you for the registration, you are welcomed to be our first tier users. Please click the link to activate your account:</mj-text>
          <mj-button href="http://www.google.com"> Activate </mj-button>
        </mj-column>
      </mj-section>
      <mj-section>
        <mj-column width="70%">
          <mj-social>
            <mj-social-element name="facebook" href="https://mjml.io/">
              Facebook            </mj-social-element>
            <mj-social-element name="google" href="https://mjml.io/">
              Google            </mj-social-element>
            <mj-social-element name="twitter" href="https://mjml.io/">
              Twitter            </mj-social-element>
          </mj-social>
        </mj-column>
        <mj-column width="30%">
          <mj-text css-class="sign">
            COPYRIGHT<br/> @2019          </mj-text>
        </mj-column>
      </mj-section>
    </mj-wrapper>
  </mj-body></mjml>
(3) 预览效果#

3、注意知识点#

(1) 一个最简的框架#
Copy<mjml>
  <mj-body>
  
    <mj-section>
      <mj-column>
        <!-- First column content -->
      </mj-column>
      <mj-column>
        <!-- Second column content -->
      </mj-column>
    </mj-section>
    
    <mj-section>  
     <mj-column> 
     		<!-- 即使只有一个 <mj-column>,也得在<mj-section>下 --> 
     </mj-column> 
    </mj-section>
    
  </mj-body></mjml>

包含关系:mjml > mj-body > mj-section > mj-column

mj-section 不能嵌套到 mj-section 中, mj-column 也不能嵌套到 mj-column 中。

(2) mj-group#

因为 mjml 是移动端优先,那么mj-group 允许您阻止 mj-column 在移动设备上堆叠。

(3) mj-spacer#

建议用 mj-spacer 代替 br 去换行

(4) mj-text#

原生的 html,例如 <b>qwe</b> 、<a href="#">click</a> ,建议放在 mj-text 里 ,否则不显示也不生效。

(5) mj-hero 和 mj-warpper 的区别#

mj-hero 只针对 mj-section下

而 mj-warpper 可以把多个 mj-section 包装在一起。实现跨 mj-section 共享边框或背景图像

坑:background-color 只能加到 mj-warpper 、mj-hero、 mj-section 等上面。

4、高级功能#

(1)除了有社区组件的提供,自己也可以创建组件

(2)支持 JSON 语法构建 Email。

(3)有丰富的插件系统,支持 VS、Atom、Sublime。


参考文献

官方文档:https://mjml.io/documentation/#sections


  • 2020-03-16 16:52:05

    对icomoon的误解,以及最快速的使用

    此时需要注意顶部第一个选项,Quick Usage,一定要打开,Enable Quick Usage,谁让咱英语不好呢,这个时候会出现一个css连接,直接引用就好了,就可以随意使用图标了,引入这一个css就能实现我们的功能,省区引入太多文件的烦恼,你可以在浏览器打开这个css,可以看到里面把我们所用的文件整成base64了。所以挺好用的。

  • 2020-03-17 09:47:05

    video标签视频不自动播放的问题

    添加 muted 属性,就可以通过地址栏进入网页的时候自动播放了,手机端还是有的有限制的,比如iphone浏览器,就不行,苹果手机为了保护用户的流量和用户的意愿,是禁止自动播放的,必须有手动触发。

  • 2020-03-17 14:21:31

    nuxt+pm2 自动化部署及打包后文件自动上传阿里云 oss(精华)

    部署nuxtjs,这一篇文章就够了,pm2 代码自动发布依赖于 git 工具,先将 ssh 密钥配置再你的代码仓库(github 或者 gitLab),具体操作自行 google 或者点击github 配置 ssh。 使用 ssh 密钥链接服务器 s $ ssh-copy-id root@1.2.3.4 # 把本机的 SSH 秘钥添加至服务器,配置成功后,以后就不需要再执行这条 SSH 命令了

  • 2020-03-18 21:15:34

    使用canvas画布解决百度地图自定义图层全球连续显示问题

        基于百度地图的Web API进行自定义图层叠加时,默认的图层只能叠加到全球范围以内,即经度范围为[-180, 180],而无法将图层叠加到默认的全球范围以外,即经度范围超出了[-180, 180]之后,经纬度坐标会自动回归到(0, 0),而导致在地图拖拽时全球以外无法连续显示想要的图层,此时可以基于百度地图的自定义图层将经纬度坐标转为像素点使用画布canvas来解决该问题。解决后效果如下图所示: ———————————————— 版权声明:本文为CSDN博主「宏伟杰作」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。 原文链接:https://blog.csdn.net/u011284073/article/details/80549950

  • 2020-03-18 21:18:01

    node-canvas实现百度地图个性化底图绘制

    随着nodejs的推出,node的并发和异步的强大能力,越来越多的得到应用,而且取得了非常不错的效果。 作为一个前端工程师对node.js自然有着一份更深的感情,跃跃欲试的心情,总希望能将它应用到产品中来。

  • 2020-03-18 21:19:28

    高德地图和canvas画图结合应用的一些感想(一)

    入了团队才发现,该项目前后端分离,后端工程师已就位主要实现接口,IOS端工程师也已就位,还差一个web前端工程师。背脊一凉,我之前虽然写过一些js和css,虽有点功底但是离前端工程师还是有距离的啊。在和朋友说明情况后,朋友也是胆大,让我试试,主要他实在找不到人了(也有可能目前前端工程师报价都太贵了,创业嘛,能节约就节约,能理解。。。),没办法,走一步算一步吧。