DIV CSS 佈局教程網

從零開始學jQuery(十):jQuery UI常用功能實戰
編輯:JQuery特效代碼     

一、本文概要

這個系列會帶你走進jQuery的世界,裡頭有不少作者的實戰心得與疑難排解方案,就算你早已上手jQuery,讀起來也往往能挖到幾個實用的小技巧。

本文是實戰篇,示範如何用jQuery UI完成網站絕大多數常用功能。

二、前言

我們在公司內部收集、整理了一批常用JavaScript功能清單。實現這些功能的主角,並非那些花俏的jQuery外掛,而是jQuery UI。

如果你還在為一個小小的特效去下載、安裝外掛,發現Bug卻無人修復,那請記住:外掛是我們無計可施時的最後選擇。使用外掛弊端不少:

1. 不利於維護;

2. 增加頁面體積;

3. 不利於團隊成員間交流共享,有學習成本;

4. 不夠健壯,無法保證外掛持續更新並修復所有問題。

下面就來請出今天的主角:jQuery UI。

三、認識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/";
}

五、彈出層對話框

彈出框是最常用、最實用的功能。先看看藝龍網上的一些應用場景。

1. 藝龍網應用場景舉例

(1) 靜態提示類彈出層——內容固定。

(2) 動態提示類彈出層——內容隨事件源變化。

(3) 遮罩類彈出層——彈出時背景變灰且不可點擊。

2. 應用實例

這裡使用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>

效果如下:

靜態提示類彈出層

動態提示類彈出層:

遮罩類彈出層:

3. 關鍵點講解

(1) 計算彈出層位置

提示類彈出框最關鍵的是算準位置。透過事件物件拿到事件源,用offset()算出它相對於document的位置:

var top = $(event.target).offset().top;
var left = $(event.target).offset().left;

由於是相對於document(即頁面左上角),所以要把彈出層放在Body的第一層,父元素就是body;若放在其他元素裡,得確保某個父元素的position設為relative。算出的top、left正好是事件源的位置,直接顯示會把它遮住,所以通常要手動做點偏移,比如top+20。

(2) 取消冒泡與瀏覽器預設行為

若為document綁定了單擊關閉彈出層的事件,就一定要取消冒泡,用event.stopPropagation()即可:

event.stopPropagation();

對於有預設行為的元素(如提交按鈕的表單提交、<a>的超連結),在這些元素上綁事件時還要取消預設行為:

event.preventDefault();

(3) 設置動畫效果與取消動畫

透過設置dialog的show配置項,可指定顯示時的動畫效果:

$('.selector').dialog({ show: 'slide' });

show預設為null即無動畫,可選值有:

'blind', 'clip', 'drop', 'explode', 'fold', 'puff', 'slide', 'scale', 'size', 'pulsate'.

當動畫執行時,如果使用者又去操作該元素,容易出各種問題(如定位不準)。所以若用了動畫,操作前最好用stop()停止動畫,通常是停止所有元素的動畫:

$("*").stop();

不過即使停了動畫,操作太快仍可能出問題,所以要不要用動畫,得權衡決定。

(4) 動態提示類彈出層的數據傳遞

動態提示的內容各不相同,本文示例把數據存在元素的data屬性上:

<span id="spanShowDataTip1" data="顏色是紅色">紅色</span>

這種方式簡單直觀,編程實現也容易(尤其在MVC模型下)。另一種常用方式是用JavaScript變數存數據。

(5) 更換主題

注意示例中的彈出層沒寫任何樣式,顯示出來卻已經美化過了,這是因為我引用了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

六、Tab標簽

不刷新頁面,就能在不同標簽間切換:

本實例用jQuery UI的Tabs組件實現,用法和Dialog一樣簡單,預設配置即可做出最簡單的tab,多設些options則能實現更複雜的應用。

1. 應用實例

<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

2. 要點講解

(1) 注意Tabs的HTML結構

用ul構建標簽,內容div一定要和標簽關聯,沒關聯的div不會被處理而直接顯示。

(2) 用Ajax時可不指定內容容器

也可以把Ajax內容放入指定容器:

<li><a href="hello/world.html" title="Todo Overview">...</a></li>
<div id="Todo_Overview">...</div>

(3) 活用事件

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/

1. 實例效果

2. 實例代碼

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

3. 關鍵點講解

(1) 注意高度設置過小的問題

當容納accordion的容器高度設得太小時,Firefox 3中它後面的內容會被部分遮蓋,IE則無此問題,原因是容器高度小於菜單高度所致。所以使用時別把容器高度設得太小。

(2) 部分關鍵屬性

autoHeight:是否自動把內容高度設為容器高度。

collapsible:是否可折疊。

這兩個通常搭配使用,因為折疊後菜單高度會變,會讓autoHeight設為true失效。更多屬性與事件請參閱官方文檔。

八、總結

本章簡單介紹了jQuery UI,並用它完成了彈出層、Tabs、手風琴菜單三個實例。借助jQuery UI,你不必再去四處尋找外掛,實現起來也簡單。當然,有些功能非得用外掛不可,下一章就講解兩個外掛實例:自動完成外掛AutoComplete與表單驗證外掛jQuery Validate。

本章源碼下載:https://xiazai.jb51.net/201101/yuanma/Code-jQueryStudy-10.rar

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