DIV CSS 佈局教程網

從零開始學jQuery(八):插播——jQuery落地實施方案
編輯:JQuery特效代碼     

一、本文概要

這個系列會帶你走進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/

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