MIP HTML 规范

编辑

头部使用规范

  • 起始标签使用 <!doctype html>

  • html 标签必须加上 mip 标记,即: <html mip>

  • 必须包含 <head>和 <body>标签

  • 必须在 head 标签中包含字符集声明: <meta charset="utf-8">,字符集统一为utf-8

  • 必须在 head 标签中包含 viewport 设置标签: <meta name="viewport" content="width=device-width,initial-scale=1">,推荐包含minimum-scale=1

  • 必须在 head 标签中包含 < link rel="stylesheet" type="text/css" href="https://mipcache.bdstatic.com/static/v1/mip.css" >

  • 必须在 body 标签中包含 <script src="https://mipcache.bdstatic.com/static/v1/mip.js" ></script >

  • 必须在 head 标签中包含 <link rel="canonical" href="http(s)://xxx" >

页面元素使用规范

MIP HTML 禁止使用对页面性能以及安全有较大影响的标签,请将其替换为 MIP 的特有标签(例如:将img标签替换为mip-img):

标签使用范围备注
img替换为 mip-img
video替换为 mip-video
audio替换为 mip-audio
iframe替换为 mip-iframe
style替换为 <style mip-custom>只能在 head 标签中使用一次
script禁止使用禁止使用 script 标签 , 以下两种情况除外:1)外链 mip 组件所需 js,2)type 为 "application/ld+json" 或 "application/json"
svg允许使用
button允许使用
link允许使用
a允许使用 , 建议使用 mip-link 组件 代替不可以 href="javascript:"
frame禁止使用
frameset禁止使用
object禁止使用
param禁止使用
applet禁止使用
embed禁止使用
form替换为 mip-form内部允许使用 input、textarea 标签
input elements禁止使用包括: select, option

HTML 属性

  • MIP HTML 中所有 on 开头的属性都不允许使用,如:onclickonmouseover
  • MIP HTML 中允许使用 on 属性。
  • MIP HTML 中不允许使用 style 属性。

自定义样式使用规范

出于性能考虑,html 中不允许使用内联 style,所有样式只能放到 head 的 style 标签里。

  • 正确:
<head>
    <style mip-custom>
        p { color: #00f;}
    </style>
</head>
<body>
    <p>Hello World!</p>
</body>
  • 错误:
<p style="color:#00f;">Hello World!</p>

验证规范

提示: MIP 校验工具地址:https://www.mipengine.org/validator/validate