DIV CSS 佈局教程網

Vue.js 實戰(一):從零建構專案並用 Vue 渲染列表資料
編輯:關於JavaScript     

前言

我的 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> 

用 Ajax 取得資料

 $(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 程式碼不長,但每次重寫仍然惱人,因此封裝成通用方法:

 // 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 裡就好。

用 Vue 渲染列表

模板部分:

 <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 前端元件學習教程》。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved