這個系列會帶你走進jQuery的世界,裡頭有不少作者的實戰心得與疑難排解方案,就算你早已上手jQuery,讀起來也往往能挖到幾個實用的小技巧。
本文是實戰篇,示範如何用jQuery UI完成網站絕大多數常用功能。
我們在公司內部收集、整理了一批常用JavaScript功能清單。實現這些功能的主角,並非那些花俏的jQuery外掛,而是jQuery UI。
如果你還在為一個小小的特效去下載、安裝外掛,發現Bug卻無人修復,那請記住:外掛是我們無計可施時的最後選擇。使用外掛弊端不少:
1. 不利於維護;
2. 增加頁面體積;
3. 不利於團隊成員間交流共享,有學習成本;
4. 不夠健壯,無法保證外掛持續更新並修復所有問題。
下面就來請出今天的主角:jQuery UI。
jQuery UI是jQuery的一部分,是一套建立在jQuery之上、專門用於UI交互的類庫。用它可以實現底層交互、各種高級特效與動畫,還能定制主題,輕鬆構建高度交互的Web應用。
官方首頁:https://jqueryui.org/
下載:https://jqueryui.com/download
示例和文檔:https://jqueryui.com/demos/
皮膚:https://jqueryui.com/themeroller/
jQuery UI的在線網站非常強大。下載時可以按勾選組裝自己需要的功能,做定制下載:

而且針對每個控件,官網不只提供詳細的參數說明與實例,還能隨時更換實例皮膚:

本文主要講解實例,你可以透過示例代碼快速上手jQuery UI。借助它,我們在不用其他外掛的情況下就能完成大部分頁面應用,說它是「官方超級UI外掛」也不為過。包含全部功能的jQuery UI類庫約188K,啟用Gzip壓縮後約45K,體積雖不小,但一次加載、全站受益,45K在當今網路環境下也還算可接受。
我把所有相關檔案(含各類類庫與Theme模板)放在如下路徑:
https://www.dotnetapi.com/JSLib/
此路徑開通了目錄瀏覽,可直接查找所需檔案,目錄組織方式沿用本系列第八篇中介紹的方案。你也可以從Google CDN引用,速度更快更有保障。本文示例的引用統一透過WebConfig.ResourceServer這個屬性:
public class WebConfig {
public static string ResourceServer = @"https://www.dotnetapi.com/";
}
彈出框是最常用、最實用的功能。先看看藝龍網上的一些應用場景。



這裡使用jQuery UI的Dialog組件,輕鬆就能實現上述三種效果。Dialog的主要特點是可拖動(Draggable)、可縮放(Resizable)。完整代碼如下:
<%@ 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 id="Head1" runat="server">
<title>jQuery UI - 彈出層應用實例 Dialog</title>
<link rel="stylesheet" type="text/css" href="<%=WebConfig.ResourceServer +"/JsLib/jquery/themes/redmond/style.css"%>" />
<script type="text/javascript" src="<% =WebConfig.ResourceServer %>/JsLib/jquery/jquery-min-lastest.js"></script>
<script src="<% =WebConfig.ResourceServer %>/JsLib/jquery/ui/jquery-ui-all-min-lastest.js" type="text/javascript"></script>
<% if (false) {%><script src="~/js/jquery-vsdoc-lastest.js" type="text/javascript"></script>
<% }%>
</head>
<body>
<!-- 靜態提示類彈出層 -->
<div id="divTip" title="自定義標題"><p>彈出層</p></div>
<!-- 遮罩類彈出層 -->
<div id="divIframe" title="iFrame彈出層" style="text-align:center;">
<iframe src="https://www.elong.com" width="450px" height="230px"></iframe>
</div>
<script type="text/javascript">
$(function() {
//靜態提示類彈出層
$("span[id^=spanShowTip]").css("cursor", "pointer").click(function(event) {
$("*").stop();
event.stopPropagation();
var top = $(event.target).offset().top + 20;
var left = $(event.target).offset().left;
$("#divTip").dialog("option", "position", [left, top]);
$("#divTip").dialog("open");
});
//動態提示類彈出層
$("span[id^=spanShowDataTip]").css("cursor", "pointer").click(function(event) {
$("*").stop();
$("#divTip").dialog("close");
event.stopPropagation();
var top = $(event.target).offset().top + 20;
var left = $(event.target).offset().left;
$("#divTip").html($(event.target).attr("data"));
$("#divTip").dialog("option", "position", [left, top]);
$("#divTip").dialog("open");
});
//document對象單擊隱藏所有彈出層
$(document).bind("click", function(event) {
$("#divTip").dialog("close");
$("#divIframe").dialog("close");
});
});
$(function() {
//初始化提示類彈出層
$("#divTip").dialog({ show: null, bgiframe: false, autoOpen: false });
//初始化遮罩類彈出層
$("#divIframe").dialog({ show: null, bgiframe: false, autoOpen: false, width: 500, height: 300, draggable: true, resizable: false, modal: true });
});
</script>
</body>
</html>
效果如下:
靜態提示類彈出層

動態提示類彈出層:

遮罩類彈出層:

提示類彈出框最關鍵的是算準位置。透過事件物件拿到事件源,用offset()算出它相對於document的位置:
var top = $(event.target).offset().top; var left = $(event.target).offset().left;
由於是相對於document(即頁面左上角),所以要把彈出層放在Body的第一層,父元素就是body;若放在其他元素裡,得確保某個父元素的position設為relative。算出的top、left正好是事件源的位置,直接顯示會把它遮住,所以通常要手動做點偏移,比如top+20。
若為document綁定了單擊關閉彈出層的事件,就一定要取消冒泡,用event.stopPropagation()即可:
event.stopPropagation();
對於有預設行為的元素(如提交按鈕的表單提交、<a>的超連結),在這些元素上綁事件時還要取消預設行為:
event.preventDefault();
透過設置dialog的show配置項,可指定顯示時的動畫效果:
$('.selector').dialog({ show: 'slide' });
show預設為null即無動畫,可選值有:
'blind', 'clip', 'drop', 'explode', 'fold', 'puff', 'slide', 'scale', 'size', 'pulsate'.
當動畫執行時,如果使用者又去操作該元素,容易出各種問題(如定位不準)。所以若用了動畫,操作前最好用stop()停止動畫,通常是停止所有元素的動畫:
$("*").stop();
不過即使停了動畫,操作太快仍可能出問題,所以要不要用動畫,得權衡決定。
動態提示的內容各不相同,本文示例把數據存在元素的data屬性上:
<span id="spanShowDataTip1" data="顏色是紅色">紅色</span>
這種方式簡單直觀,編程實現也容易(尤其在MVC模型下)。另一種常用方式是用JavaScript變數存數據。
注意示例中的彈出層沒寫任何樣式,顯示出來卻已經美化過了,這是因為我引用了jQuery UI的主題:
<!--black-tie,blitzer,dot-luv,excite-bike,hot-sneaks,humanity,mint-choc,redmond,smoothness,south-street,start,swanky-purse,trontastic,ui-darkness,ui-lightness,vader--> <link rel="stylesheet" type="text/css" href="<%=WebConfig.ResourceServer +"/JsLib/jquery/themes/redmond/style.css"%>" />
註釋裡列了很多主題,只要把路徑中的"redmond"換成其中任何一個,樣式立刻改變。各主題效果可在此查看:https://jqueryui.com/themeroller/#themeGallery
不刷新頁面,就能在不同標簽間切換:

本實例用jQuery UI的Tabs組件實現,用法和Dialog一樣簡單,預設配置即可做出最簡單的tab,多設些options則能實現更複雜的應用。
<div id="tabs1" style="width:300px;">
<ul>
<li><a href="#tabs1-1">One</a></li>
<!-- Ajax Tab -->
<li><a href="TabData.htm">Two</a></li>
<li><a href="#tabs1-3">Three</a></li>
</ul>
<div id="tabs1-1"><p>Tab1內容</p></div>
<div id="tabs1-3"><p>Tab3內容</p></div>
</div>
<script type="text/javascript">
$(function() {
$("#tabs1").tabs(); //默認Tabs
$("#tabs2").tabs({ collapsible: true }); //可折疊的Tabs
$("#tabs3").tabs({ event: "mouseover" }); //鼠標滑動即切換的Tabs
});
</script>
效果:
1. 默認設置的Tabs,Two標簽內容用Ajax獲取


2. 可折疊的Tab

3. 鼠標滑動即切換的Tab

用ul構建標簽,內容div一定要和標簽關聯,沒關聯的div不會被處理而直接顯示。
也可以把Ajax內容放入指定容器:
<li><a href="hello/world.html" title="Todo Overview">...</a></li> <div id="Todo_Overview">...</div>
tab有select、load、show、add、remove、enable、disable等事件,能完成不少複雜任務。要注意事件簽名:
$('#example').bind('tabsselect', function(event, ui) {
// ui.tab 選中標簽的anchor元素
// ui.panel 選中標簽內容所在的元素
// ui.index 選中標簽的索引(從0開始)
});
第一個是事件物件,第二個ui物件攜帶額外參數,我們能從中拿到tab物件、內容容器與索引值。比如在事件中做驗證:
$('#example').tabs({ select: function(event, ui) {
var isValid = ...; // 表單驗證,回傳true或false
return isValid;
} });
或者在新增tab後立刻切到選中狀態:
var $tabs = $('#example').tabs({ add: function(event, ui) {
$tabs.tabs('select', '#' + ui.panel.id);
} });
活學活用,更多應用可參考官方文檔:https://jqueryui.com/demos/tabs
用jQuery UI的accordion組件即可實現手風琴菜單,效果見下圖。文檔地址:https://jqueryui.com/demos/accordion/

<div id="accordion1">
<h3><a href="#">菜單1</a></h3>
<div>菜單1的內容</div>
<h3><a href="#">菜單2</a></h3>
<div>菜單2的內容</div>
<h3><a href="#">菜單3</a></h3>
<div>菜單3的內容</div>
</div>
<script type="text/javascript">
$(function() {
$("#accordion1").accordion(); //默認配置
$("#accordion2").accordion({ autoHeight:false, collapsible: true }); //取消自動高度、可折疊
$("#accordion3").accordion({ //鼠標滑動觸發、自定義圖標
icons: { header: "ui-icon-circle-arrow-e", headerSelected: "ui-icon-circle-arrow-s" },
event: "mouseover"
});
});
</script>
當容納accordion的容器高度設得太小時,Firefox 3中它後面的內容會被部分遮蓋,IE則無此問題,原因是容器高度小於菜單高度所致。所以使用時別把容器高度設得太小。
autoHeight:是否自動把內容高度設為容器高度。
collapsible:是否可折疊。
這兩個通常搭配使用,因為折疊後菜單高度會變,會讓autoHeight設為true失效。更多屬性與事件請參閱官方文檔。
本章簡單介紹了jQuery UI,並用它完成了彈出層、Tabs、手風琴菜單三個實例。借助jQuery UI,你不必再去四處尋找外掛,實現起來也簡單。當然,有些功能非得用外掛不可,下一章就講解兩個外掛實例:自動完成外掛AutoComplete與表單驗證外掛jQuery Validate。
本章源碼下載:https://xiazai.jb51.net/201101/yuanma/Code-jQueryStudy-10.rar