新手指南

MIP (Mobile Instant Pages - 行動網頁加速器)主要用於行動裝置頁面加速。
這篇文件將帶你快速建立一個 MIP 頁面。

1. 建立HTML 檔案

先建立一個標準的HTML 檔案, 注意：

在<html>標籤中增加mip標識
編碼為utf-8
新增meta-viewport，用於行動端展現

##<! DOCTYPE html>

<html mip>
    <head>
        <meta charset="UTF-8">##view   <meta -width,minimum-scale=1,initial-scale=1">
        <title>Hello World</title& < h1>Hello World!</h1>
    </body>
#</html>

2. 添加MIP运行环境

在 HTML 代码中，添加MIP依赖的mip.js和mip.css。

<!DOCTYPE html>
<html mip>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
        <link rel="stylesheet" type="text/css" href="https://mipcache.bdstatic.com/static/v1/mip.css">
        <title>Hello World</title>
    </head>
    <body>
        <h1>Hello World!</h1>
        <script src="https://mipcache.bdstatic.com/static/v1/mip.js"></script>  
    </body>
</html>

3. 添加 MIP 关联标签

<link rel="miphtml">和<link rel="canonical">主要用于告知搜索引擎页面间的关系。添加关联标签后，MIP页的会继承原页面(移动端)的点击权重，同时MIP页将作为搜索引擎的首选导流页面。
使用规则：

<link rel="canonical">在MIP 页中使用，<link rel="miphtml">在原页面使用。
若原页面中已经存在<link rel="canonical">标签指向PC页，则MIP页<link rel="canonical">的 href 也指向PC页。
若 MIP页没有对应的原页面，则指向MIP页本身url。

<!DOCTYPE html>
<html mip>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
        <link rel="stylesheet" type="text/css" href="https://mipcache.bdstatic.com/static/v1/mip.css">
        <link rel="canonical" href="//www.mipengine.org/">
        <title>Hello World</title>
    </head>
    <body>
        <h1>Hello World!</h1>
        <script src="https://mipcache.bdstatic.com/static/v1/mip.js"></script>   
    </body>
</html>

4. 添加样式

出于速度考虑，建议內联使用 css 样式。所有样式写在<style mip-custom></style>中，注意：style 标签仅允许出现一次。

<!DOCTYPE html>
<html mip>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
        <link rel="stylesheet" type="text/css" href="https://mipcache.bdstatic.com/static/v1/mip.css">
        <link rel="canonical" href="//www.mipengine.org/">
        <title>Hello World</title>
        <style mip-custom>
            h1 { color: red;}
        </style>
    </head>
    <body>
        <h1>Hello World!</h1>
        <script src="https://mipcache.bdstatic.com/static/v1/mip.js"></script>   
    </body>
</html>

5. 替换禁用 HTML 标签

MIP十分关注页面速度，也因此禁用了一些引起拖慢速度的html标签（禁用列表）。例如，<img>标签会引起浏览器的repaint和reflow，为了避免这些，MIP提供了替代标签<mip-img>。详见<mip-img>使用文档

<!DOCTYPE html>
<html mip>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
        <link rel="stylesheet" type="text/css" href="https://mipcache.bdstatic.com/static/v1/mip.css">
        <link rel="canonical" href="//www.mipengine.org/">
        <title>Hello World</title>
        <style mip-custom>
            h1 { color: red;}
        </style>
    </head>
    <body>
        <h1>Hello World!</h1>
        <mip-img src="https://www.mipengine.org/static/img/mip_logo_3b722d7.png"></mip-img>
        <script src="https://mipcache.bdstatic.com/static/v1/mip.js"></script>   
    </body>
</html>

6. 使用MIP组件

出于对代码质量和性能的考虑，MIP页中不允许自定义javascript代码，所有的交互通过引入MIP组件实现。MIP组件可以理解为封装了js的自定义html标签。上一步中的<mip-img>也是一个MIP组件。点击这里查看更多组件。

我們以分享元件為例，根據分享元件文件，元件對應的html標籤為<mip-share>，需要依賴//mipcache.bdstatic .com/static/v1/mip-share/mip-share.js腳本，用在頁面裡就是這樣：

<!DOCTYPE html>
<html mip>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1">
        <link rel="stylesheet" type="text/css" href="https://mipcache.bdstatic.com/static/v1/mip.css">
        <link rel="canonical" href="//www.mipengine.org/">
        <title>Hello World</title>
        <style mip-custom>
            h1 { color: red;}
        </style>
    </head>
    <body>
        <h1>Hello World!</h1>
        <mip-img src="https://www.mipengine.org/static/img/mip_logo_3b722d7.png"></mip-img>
        <mip-share title="分享：我的第一个MIP页面"></mip-share>
        <script src="https://mipcache.bdstatic.com/static/v1/mip.js"></script>
        <script src="https://mipcache.bdstatic.com/static/v1/mip-share/mip-share.js"></script> 
    </body>
</html>

在使用元件時，請注意閱讀元件文檔，查看元件是否依賴額外腳本。如果依賴，請在mip.js之後引入腳本。

7.預覽

開發完成後，可以使用MIP校驗工具保證程式碼規格。

MIP頁檔案可以直接執行，你可以選擇如下方式，像預覽普通HTML網站一樣預覽MIP HTML 頁面：

直接在瀏覽器中開啟（由於XML Http Requests失敗可能會導致某些元素預覽失敗）
在本地部署一個服務，如apache，nginx等

8. 起飛

到目前為止，你已經建立好了一個MIP頁面。這個頁面有圖，有文，能分享，可以在瀏覽器中運作。

進階的內容，請參考

MIP HTML 規格
元件佈局
MIP 加速原理
擴充元件開發規格

完整 DEMO →