前言
我的 JavaScript 底子只能算普通,面對新世代前端框架確實有點吃力,但工作需求擺在眼前,學習是唯一出路。
橫向比較了幾款主流框架後,我選擇了 Vue,理由很實際:
1. Angular 1.x 學習曲線陡、前景不明,2.x 當時尚未正式推出;
2. React 很不錯,但我沒接觸過;
3. Vue 上手簡單,比較貼合我的思維方式;
4. Vue 有完整的中文文件,閱讀障礙小。
既然決定學,最好的方式就是實戰。剛好 cNodeJs.Org 論壇公開了 API,於是就拿它來做練習專案。
這是 cNodeJs.Org 公開提供的 RESTful API,不只可用於前端練習,任何語言都能接入。文件網址:https://cnodejs.org/api

介面完整度很高,理論上足以支撐一個同類論壇。
專案規劃
1. 列表頁:讀取並呈現 cNodeJs 的 topics 資料;
2. 詳情頁:從列表點進去檢視單篇內容;
3. 用 SSI(shtml)技術複用 HTML 片段;
4. CSS 使用 Sass 預編譯。
檔案結構
├─index.shtml 渲染列表頁
├─content.shtml 渲染詳情頁
├─inc 碎片檔案
│ ├─bar.html 側邊欄
│ ├─footer.html 版權區
│ ├─head.html head 區域與 JS 引入
│ └─header.html 頁頭 logo 與導覽
└─res 資源目錄
├─image
├─js
│ ├─common (common.js 公共邏輯、method.js 自訂方法)
│ ├─jquery
│ ├─plugins (laypage 分頁外掛)
│ └─vue
└─style (style.scss、style.css、base、scss)
原始碼:https://github.com/fengcms/vue-cNodeJsOrgTest
先依上面的目錄規劃把檔案建起來,重點其實只有 index.shtml 與 content.shtml 兩個。
<!DOCTYPE html> <html lang="zh"> <head> <meta charset="UTF-8"> <title>title</title> <link rel="stylesheet" href="res/style/style.css"> </head> <body> <header class="header"> <h1 class="logo"> <a href="index.html" title="cnNodeJs.Org Home By FungLeo">cnNodeJs.Org Home By FungLeo</a> </h1> <nav class="nav"> <ul> <li>導航列表</li> </ul> </nav> </header> <section class="home"> <section class="main"> <ul class="list"> <li> <i class="user_ico"> <img src="#頭像url" alt="用戶名"> <span>用戶名</span> </i> <time class="time">發表於 5 天前</time> <a class="talk" href="content.html?鏈接ID">帖子標題</a> </li> </ul> <div class="page"></div> </section> <aside class="bar"> <h3>本頁說明</h3> ... </aside> </section> <footer class="copy"> 版權說明 </footer> <div class="go_top"></div> </body> </html>
搭配我寫的 CSS,靜態效果如下:

引入 Vue 與 jQuery
<script src="res/js/jquery/jquery-2.2.3.min.js"></script> <script src="res/js/vue/vue.min.js"></script> <script src="res/js/common/common.js"></script>
$(function(){ $.ajax({ type:'get', url:"https://cnodejs.org/api/v1/topics", dataType: 'json', success: function(data){ if (data.success){ console.log(data) }else{ alert(JSON.stringify(data)); } }, error: function(data){ alert(JSON.stringify(data)); } }); })
查看控制台:

資料結構分析:

每筆包含作者(頭像 URL、使用者名)、作者 ID、內文、發布時間、是否精華、帖子 ID、最後回覆時間、回覆數、分類標籤、標題、是否置頂、瀏覽量等欄位。
做完整論壇時這些都有用,但我的頁面只需要其中五項:
<li> <i class="user_ico"> <img src="#頭像url" alt="用戶名"> <span>用戶名</span> </i> <time class="time">發表於 5 天前</time> <a class="talk" href="content.html?鏈接ID">帖子標題</a> </li>
也就是頭像 URL、使用者名、發布時間、帖子 ID 與標題——這些介面全都有。
原始 Ajax 程式碼不長,但每次重寫仍然惱人,因此封裝成通用方法:
// ajax get json 方法 function getJson(url,func){ $.ajax({ type:'get', url:url, dataType: 'json', success: function(data){ if (data.success){ func(data); }else{ alert("接口調用失敗"); } }, error: function(data){ alert(JSON.stringify(data)); } }); }
呼叫處瞬間變乾淨:
$(function(){ var url = "https://cnodejs.org/api/v1/topics"; getJson(url,function(data){ console.log(data); }); });
再把回調也抽出去:
$(function(){ var url = "https://cnodejs.org/api/v1/topics"; getJson(url,pushDom); }); function pushDom(data){ console.log(data); }
這樣一來主流程只剩兩行,可讀性大幅提升,後續所有渲染邏輯都寫在 pushDom 裡就好。
模板部分:
<li v-for="info in data"> <i class="user_ico"> <img src="{{ info.author.avatar_url }}" alt="{{ info.author.loginname }}"> <span>{{ info.author.loginname }}</span> </i> <time class="time">{{ info.create_at }}</time> <a class="talk" href="content.html?{{ info.id }}">{{ info.title }}</a> </li>
Vue 知識點:v-for 迴圈 https://vuejs.org.cn/api/#v-for
JS 部分:
function pushDom(data){ var vm = new Vue({ el: '.list', data: data }); }
執行結果:

僅僅幾行程式碼,列表就渲染完成了。
小結
1. Ajax 取資料是整個流程的起點;
2. Vue 只需理解一小部分觀念就能上手;
3. 建專案時,檔案與程式碼組織一定要清楚,後續維護成本差很多。
附錄
Vue 官方網站、cNodeJs API 說明、系列教程原始碼下載。系列文章:第一章 建構基礎並渲染列表;第二章 修復錯誤並美化時間;第三章 用 laypage 外掛實作分頁。
本文由 FungLeo 原創,首發於 https://blog.csdn.net/FungLeo/article/details/51649074 ,並整理進《Vue.js 前端元件學習教程》。