MIP 校验规则

MIP页面会有严格的规范校验,不允许存在任何校验不通过的问题存在.

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

本文档意在帮助开发者找到校验的内容和规则,快速定位校验不通过的原因。

MIP HTML 标签和属性错误

1. 缺少强制性标签

提示MANDATORY_TAG_MISSING
错误说明"The mandatory tag '%1' is missing or incorrect."
错误说明强制性标签'xxx'缺失或错误
修复方法添加(或者更正)强制性html标签

在MIP HTML中,强制性标签包括:

说明备注
<!doctype html>大小写均可
<html mip>强制小写
<head>强制小写
<meta charset="utf-8">utf-8不区分大小写,无单引号或者双引号限制
<meta name="viewport" content="width=device-width,initial-scale=1">强制小写,无单引号或者双引号限制
< link rel="stylesheet" type="text/css" href="https://mipcache.bdstatic.com/static/v1/mip.css" >强制小写,无单引号或者双引号限制,v1.1.1会根据版本不同而不同
<script src="https://mipcache.bdstatic.com/static/v1/mip.js" ></script >强制小写,无单引号或者双引号限制,v1.1.2会根据版本不同而不同
<body>强制小写
<link rel="canonical" href="http(s)://xxx">强制小写
  • P.S.: meta 标签 name="viewport" 时, content的值必须且最少含有 width=device-width, minimum-scale=1 以及 initial-scale=1这3个属性且顺序不固定。

2. 禁用标签

提示DISALLOWED_TAG
错误说明"The tag '%1' is disallowed."
错误说明禁止使用'xx'标签
修复方法删除禁用标签

大部分 HTML 标签都是允许使用的,禁用或者需要替换的标签使用请参考:MIP HTML规范

3. 无效属性值

提示INVALID_ATTR_VALUE
错误说明"The attribute '%1' in tag '%2' is set to the invalid value '%3'."
错误说明标签'xx'中的属性'xx'的属性值'xx'无效
修复方法修改为有效属性值

当html标签有属性值不正确的时候,会报这个错误。mip中需要注意的有:

  • a:href属性不允许使用javascript:协议,

  • mip-img

    • src:必须是一个url
  • mip-pix

    • src:必须是一个支持https的地址url,
    • 如果选用百度云提供的https代理,url中带"t={TIME}&title={TITLE}&host={HOST}&from=baidu"
  • 其他html基本页面属性规范不变

注意: 1. MIP HTML中的url强制是https的
2. <a>标签:
- <a href="javascript:xxx()"></a>
- <a href="xxx" target="_blank"></a>

4. 属性值的无效值

提示INVALID_PROPERTY_VALUE_IN_ATTR_VALUE
错误说明"The property '%1' in attribute '%2' in tag '%3' is set to '%4', which is invalid."
错误说明标签'xx'中存在属性'yy','yy'中存在属性'zz',属性'zz'的属性值'aa'无效
修复方法更正无效属性值

可能出现属性值的无效值的情况:

  • <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">

    • width的属性值device-width
    • initial-scale的属性值1
  • <script type="application/ld+json"></script>

  • <script type="application/json"></script>

    • 除了外链 MIP 所需 js,script标签的type的属性值应该为application/ld+json 或 application/json
注意: 1. 除上述给出的值外均为无效值

5. 缺少强制性属性

提示MANDATORY_ONEOF_ATTR_MISSING
错误说明"The tag '%1' is missing a mandatory attribute - pick one of %2."
错误说明标签'xx'的强制性属性'xx'缺失
修复方法添加正确是属性

例如 mip html中 mip-img 和 mip-pix具有强制性属性的src:

  • mip-img
    • src
  • mip-pix
    • src

6. 直接父标签错误

提示WRONG_PARENT_TAG
错误说明"The parent tag of tag '%1' is '%2', but it can only be '%3'."
错误说明标签'a'的直接父标签应该是'b',而不是'c'
修复方法添加所需的父标签

有一些标签有制定的直接父标签,如下示例给出了每个标签必须的直接父标签:

  • !doctype 的直接父标签是 root
  • head 的直接父标签是 html
  • body 的直接父标签是 html
  • link 的直接父标签是 head
  • meta 的直接父标签是 head
  • style mip-custom 的直接父标签是 head
  • style 的直接父标签是 boilerplate

7. 非法父级标签

提示DISALLOWED_TAG_ANCESTOR
错误说明"The tag '%1' may not appear as a descendant of tag '%2'."
错误说明标签'a'不应该是标签'b'的子标签
修复方法删除非法嵌套标签

如:

  • <body>的子标签写在了<head>

8. 强制父级标签

提示MANDATORY_TAG_ANCESTOR
错误说明"The tag '%1' may only appear as a descendant of tag '%2'."
错误说明标签'a'只能是标签'b'的子级标签
修复方法删除标签或者给标签添加正确的父级标签
  • img 必须是noscript的子级标签
  • video 必须是noscript的子级标签
  • audio 必须是noscript的子级标签
  • head 中使用 noscript 时必须作为head的最后一个子节点, body中的noscript没有限制

9. 唯一标签重复

提示DUPLICATE_UNIQUE_TAG
错误说明"The tag '%1' appears more than once in the document."
错误说明标签'xx'只能出现一次
修复方法删除多余的标签

一份html中,有的标签具有唯一性,也就是说只能出现一次,当html中有重复的唯一标签的时候,应该报错。

以下是唯一标签列表:

  • <doctype html>
  • <html mip>
  • <head>
  • <link rel="canonical" href=...>
  • <meta charset="utf-8">
  • <meta viewport>
  • <style mip-custom>
  • <body>