這個系列會帶你走進jQuery的世界,裡頭有不少作者的實戰心得與疑難排解方案,就算你早已上手jQuery,讀起來也往往能挖到幾個實用的小技巧。
這篇屬於臨時插播,用來介紹我在公司內部推行jQuery的實施方案。
有了前幾章紮實的基礎,我們已經可以把jQuery正式投入專案了。在繼續深入之前,先插播一下我的落地方案。
每家公司的情況都不一樣。比如我們公司的頁面檔案都是使用者控制項,實體路徑與虛擬路徑之間沒有絕對對應關係,因此無法使用相對路徑(否則正式環境會找不到檔案);加上專案繁多,同一個虛擬目錄下不同資料夾還對應著不同工程等等。
這個方案並非通用範式,但其中有些做法值得借鑑,也希望藉此拋出話題,邀大家一起討論、指正。
存放根路徑:src\Assembly\resource.eLong.Web.Files\Resource\JSLib\jquery\
引用根路徑:https://resource.elong.com/JSLib/jquery/
壓縮版引用路徑:https://resource.elong.com/JSLib/jquery/jquery-min-lastest.js
根路徑檔案清單:

此外,每個Web工程專案下都建立一個js資料夾,用來放置jquery-vsdoc-lastest.js:

說明:
我們先把各版本的jQuery類庫都放到靜態伺服器上,並以資料夾分類存放,再從中挑出一個最新版本作為引用,放在根目錄。
根目錄下主要包含:
資料夾「1.3.2」:依版本號組織的jQuery類庫。從1.3.2起,每個新版本都按資料夾存放,並以最新穩定版覆蓋各lastest命名的js檔。
資料夾「plugin」:存放各種外掛,以資料夾形式歸置於此。
jquery.extend-lastest.js:我們自行擴展的jQuery方法。未來要打造屬於自己的JavaScript類庫,其中一些核心方法就放在這裡,相當於自製的工具庫,透過擴展jQuery實現,主要分為工具函數與包裝集函數兩類。
jquery-lastest.js:最新穩定版的jQuery未壓縮原始類庫。
jquery-min-lastest.js:最新穩定版的jQuery壓縮類庫。
jquery-vsdoc-lastest.js:最新穩定版的jQuery智能提示類庫。
為了在開發時獲得智能感知,還需要把智能提示版放到每個Web專案的js資料夾裡。由於專案眾多,就請第一位使用的人建立這個資料夾並放入檔案。
在所有頁面的head中,最先以絕對路徑引用jQuery類庫:
https://resource.elong.com/JSLib/jquery/jquery-min-lastest.js
接著用if(false)引入智能提示版的腳本塊,路徑以"~"從根目錄開始查找。我在各頻道的專案源碼裡統一建立js資料夾,並放入最新的jquery-vsdoc-lastest.js。要留意的是,這個檔案不需打包上傳,僅供開發時智能提示之用。如此一來,就能確保編譯後的頁面只引入了壓縮版的jQuery類庫。
示例代碼:
<head runat="server">
<title>jQuery 引用方案</title>
<script type="text/javascript" src="https://resource.elong.com/JSLib/jquery/jquery-min-lastest.js"></script>
<% if (false){%>
<script src="~/js/jquery-vsdoc-lastest.js" type="text/javascript"></script>
<% }%>
</head>
說明:
我們網站的靜態檔案存放在另一個二級域名resource.elong.com下,並接入了CDN。為確保測試環境與正式環境一致,只能以絕對路徑引用jQuery庫。但用絕對路徑引用jQuery智能提示版後不會出現腳本智能提示。於是,我們利用這個特性直接引用絕對路徑的壓縮版類庫,巧妙地解決了1.3.2壓縮版引入後智能提示系統出錯的問題。
雖然動態頁面能用if(false)取消智能提示版的引入,但HTML頁面上無法使用伺服器語句塊。因此對於HTML頁面,需要在程式發布前手動刪除智能提示版的引用。
jQuery是腳本庫而非腳本框架,無法約束使用者怎麼寫,所以頁面腳本很容易變得雜亂。在找到合適的腳本管理框架之前,我採用下面的方式在頁面上組織腳本:
1. 在頁面底部加入一個<script>區塊,用兩個function分別放置「事件綁定」與「加載時執行」的語句。即使是加載時執行的JavaScript,也要保證在DOM加載完成後才執行,所以兩個function都嵌套在$()裡,確保DOM就緒後才調用。
2. 盡量避免在head中加載腳本。若非得放在head,可在head裡單獨開一個script區塊。
3. 「自定義函數」要放在「事件綁定」與「加載時執行」區塊之上,且不需要包在$()裡。
下面是一個完整頁面的示例代碼:
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title>jQuery 引用方案</title>
<script type="text/javascript" src="https://resource.elong.com/JSLib/jquery/jquery-min-lastest.js"></script>
<% if (false){%>
<script src="~/js/jquery-vsdoc-lastest.js" type="text/javascript"></script>
<% }%>
<script type="text/javascript">
//必須放在頭部加載的語句塊,盡量避免使用
</script>
</head>
<body>
<div id="divMsg">Hello World!</div>
<input id="btnShow" type="button" value="顯示" />
<input id="btnHide" type="button" value="隱藏" /><br />
<input id="btnChange" type="button" value="修改內容為 Hello World, too!" />
<script type="text/javascript">
//用戶自定義方法
function demoMethod(event) {
$("#divMsg").hide(500);
}
//事件綁定
$(function() {
$("#btnShow").bind("click", function(event) {
$("#divMsg").show(500);
});
$("#btnHide").bind("click", demoMethod);
$("#btnChange").bind("click", function(event) {
$("#divMsg").html("Hello World, too!");
});
});
//加載時執行的語句
$(function() {
$("#btnShow").attr("value", "被修改後的顯示按鈕")
});
</script>
</body>
</html>
在確認沒有洩露任何機密資訊後,我才發表這篇文章。它技術含量不算高,主要是分享在公司內部推廣jQuery的具體落地做法。
另外,我一直想找一套成熟的腳本框架來組織管理各種js類庫與檔案,這還得靠日後的工作中慢慢探索。
作者:張子秋 出處:https://www.cnblogs.com/zhangziqiu/