文章目录[隐藏]
由于MIP有着严格的规范校验，我们必须掌握它的规则，否则会通不过，我们可以通过下面的校验工具测试，但最好是完全遵守以下规则。
MIP 校验规则
MIP页面会有严格的规范校验，不允许存在任何校验不通过的问题存在.
MIP校验工具地址：https://www.mipengine.org/validator/validate
本文档意在帮助开发者找到校验的内容和规则，快速定位校验不通过的原因
MIP HTML 标签和属性错误
1. 缺少强制性标签
| 说明 | 备注 |
|---|---|
| 错误说明 | 强制性标签'xxx'缺失或错误 |
| 错误说明 | 不使用布局 |
| 修复方法 | 添加（或者更正）强制性html标签 |
在MIP HTML中，强制性标签包括：
| 说明 | 备注 |
|---|---|
| <!doctype html> | 大小写均可 |
| <html mip> | 强制小写 |
| <head> | 强制小写 |
| <meta charset="utf-8"> | utf-8不区分大小写，无单引号或者双引号限制 |
| <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1"> | 强制小写，无单引号或者双引号限制 |
| < link rel="stylesheet" type="text/css" rel="nofollow" href="http://www.511yj.com/go?url=aHR0cHM6Ly9taXBjYWNoZS5iZHN0YXRpYy5jb20vc3RhdGljL21pcG1haW4tdjEuMS4xLmNzcw==" > | 强制小写，无单引号或者双引号限制，v1.1.1会根据版本不同而不同 |
| <script src="https://mipcache.bdstatic.com/static/mipmain-v1.1.2.js" ></script> | 强制小写，无单引号或者双引号限制，v1.1.2会根据版本不同而不同 |
| <body> | 强制小写 |
| <link rel="canonical" rel="nofollow" href="http://www.511yj.com/go?url=aHR0cChzKTovL3h4eA=="> | 强制小写 |
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'标签 |
| 修复方法 | 删除禁用标签 |
目前mip中标签使用规则：
禁止使用标签有：
- ◆ frame
- ◆ frameset
- ◆ object
- ◆ param
- ◆ applet
- ◆ embed
- ◆ form
- ◆ input
- ◆ textarea
- ◆ select
- ◆ option
如果有如下标签需要进行替换
| 标签 | 替换后标签 |
|---|---|
| img | mip-img |
| video | mip-video |
| audio | mip-video |
其他说明：
- ◆ style：仅允许在head标签中使用style标签，不允许在任何标签中单独使用 style 属性,详见自定义样式使用规范。
- ◆ script：仅允许外链 MIP 所需要的js脚本，或type是application/ld+json的情况
注意：
1. 可以把img/video/audio/iframe视为禁用标签
2. <p style="color: #000;"> 错
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:协议，
- ◆ a：target属性需要设置为_blank
- ◆ mip-img
○ src：必须是一个url
- ◆ mip-pix
○ src：必须是一个支持https的地址url，
○ 如果不支持https适用百度提供的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
○ minimum-scale的属性值1
○ 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
○ 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'." |
| 错误说明 | M标签'a'只能是标签'b'的子级标签 |
| 修复方法 | 删除标签或者给标签添加正确的父级标签 |
- ■ img 必须是noscript的子级标签
- ■ video 必须是noscript的子级标签
- ■ audio 必须是noscript的子级标签
- ■ noscript必须是body的子级标签
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=...> <link rel="standardhtml" href=...> <link rel="miphtml" href=...> <meta charset="utf-8"> <meta viewport> <style mip-custom> <body>