使用Javascript建立進度條-js教程-PHP中文網

進度列是新增至基於 jQuery 建置的優秀 UI 小工具和互動幫助程式庫中的最新元件之一。它是在庫的最新版本中引入的，在撰寫本文時為 1.7。

使用Javascript建立進度條

## 進度條目前只是確定的，這意味著當我們更新它時，我們必須明確地告訴它它的值是什麼，並且我們必須事先知道它用於測量的過程何時完成。對於需要不確定時間長度才能完成的流程，此小工具目前不是最佳選擇。

這是一個非常簡單的小部件，帶有一個小型 API，公開了有限數量的屬性和方法，但它仍然非常有效，並且非常適合向訪客提供有關流程完成前剩餘百分比的視覺回饋。

開始使用

我們需要 jQuery UI 目前版本的副本，可以從 http://jqueryui.com/download 上的下載建構器取得該副本。下載後，我們需要將其解壓，以便保留現有的目錄結構。我們應該在電腦上建立一個名為 jQuery UI 的新目錄，然後在其中建立另一個名為 jqueryui1.7 的新資料夾。然後應將存檔解壓縮到 jqueryui1.7 資料夾中。

檔案將包含我們開始所需的一切；所有庫檔案的縮小版和未壓縮版本、一些主題檔案（預設主題是恰當命名的 smoothness），甚至是底層 jQuery 庫的最新版本。

進度條依賴許多文件才能發揮作用；下面按添加到我們頁面的順序列出了這些內容：

ui.core.css
ui.theme.css
ui.progressbar.css
jquery[目前版本].js
#ui.core.js
ui.progressbar.js

前三個檔案是擴展 CSS 框架的一部分，用於為進度條提供獨特的外觀。我們不需要在現實世界的實現中堅持這個主題；我們有許多自訂選項，包括直接從Themeroller 獲得的大量預配置主題、我們可以使用Themeroller 自己設計的自訂主題，甚至是我們透過覆蓋預設樣式表中定義的規則手動建立的自訂主題。然而，在本教程中我們不會做任何這些事情，但我們可以利用框架提供的一些類別。

底層頁面

這個小部件只需要很少的底層標記；除了上面列出的庫資源之外，我們所需要的只是一個簡單的容器元素。在文字編輯器中，使用所需的資源和容器元素建立以下頁面 shell：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
  <head>
    <link rel="stylesheet" type="text/css" href="jqueryui1.7/development-bundle/themes/smoothness/ui.core.css">
    <link rel="stylesheet" type="text/css" href="jqueryui1.7/development-bundle/themes/smoothness/ui.theme.css">
    <link rel="stylesheet" type="text/css" href="jqueryui1.7/development-bundle/themes/smoothness/ui.progressbar.css">
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>jQuery UI Progress Bar</title>
  </head>
  <body>
    <div id="container"></div>
    <script type="text/javascript" src="jqueryui1.7/development-bundle/jquery-1.3.2.js"></script>
    <script type="text/javascript" src="jqueryui1.7/development-bundle/ui/ui.core.js"></script>
    <script type="text/javascript" src="jqueryui1.7/development-bundle/ui/ui.progressbar.js"></script>
    <script type="text/javascript">
	
    </script>
  </body>
</html>

登入後複製

將其儲存為 jQuery UI 根目錄中的 ProgressBar.html。我們將樣式表放在檔案的開頭，將腳本放在檔案的末尾；這是出於效能原因，因為當頁面不同時嘗試載入 JavaScript 時，它們會更快地載入內容。這是一個有據可查的績效實踐，最好遵守。我們在頁面底部留下了一個空的腳本標籤；接下來讓我們加入一些程式碼：

$(function() {

  //call progress bar constructor			
  $("#container").progressbar();
});

登入後複製

為了初始化預設進度條，我們所做的就是在小元件要渲染到的容器元素上呼叫其建構函式progressbar。當您在瀏覽器中執行此頁面時，您應該會看到進度列已建立並自動填入其容器的寬度，在本例中是頁面的主體：

使用Javascript建立進度條

#設定進度條的值

進度條的值預設為零，這就是為什麼它在上一個螢幕截圖中顯示為空的原因。為了填充進度條，我們需要設定 value 屬性；更改建構函數，使其顯示如下：

//call progress bar constructor
$("#container").progressbar({ value: 50 });

登入後複製

value 屬性決定進度條被填滿的百分比，為訪客提供關於還剩下多少任務需要完成的良好視覺回饋。進度條現在應該是半滿的，如下面的螢幕截圖所示：

使用Javascript建立進度條

#取得進度條的值

取得小部件的當前值與設定它一樣簡單；我們可以使用它的方法之一來傳回目前值屬性。在初始建構函式之後，加入以下程式碼：

# //設定滑鼠懸停為進度條

$("#container").mouseover(function() {
				
  //display the current value
  $("<p>").attr("id", "percentage").text($("#container").progressbar("option", "value") + "% complete").appendTo("body");					
});
				
//set mouseout for progress bar
$("#container").mouseout(function() {
				  
  //hide value
  $("#percentage").remove();
});

登入後複製

我們新增了兩個簡單的匿名函數，它們在進度條觸發的 mouseover 和 mouseout 事件上觸發（請注意，這些是標準 DOM 事件而不是自訂進度條事件）。我們在第一個函數中所做的就是建立一個新段落，將進度條的當前值作為其內部文字並將其附加到頁面。

使用 option 方法檢索該值。傳遞給該方法的參數是我們要檢索的屬性的名稱。第二個函數只是再次刪除訊息。該訊息如以下螢幕截圖所示：

使用Javascript建立進度條

属性、事件和方法

value 属性或选项是当前进度条唯一可配置的属性；在此示例中，我们在初始化小部件时通过将其作为配置对象的属性传递来设置它。要在小部件初始化后设置此属性，我们将使用 option 方法。要在 setter 模式下使用此方法，我们需要传入第二个参数来指定新值，如下所示：

progressbar("option", "value", 75)

登入後複製

您可能想知道为什么我说“第二个参数”，而上面的代码行显然有三个参数。尽管我们使用了 option 方法，但我们实际上并没有直接调用它。相反，我们再次调用构造函数方法，但告诉它我们要调用选项方法。小部件将在内部调用该方法，并传入我们在方法名称之后传递给构造函数的两个参数（“value”和 75）。

进度条公开了一个事件，即更改事件，它为我们提供了一种挂钩机制，以便我们可以响应其值的变化。这是一个自定义事件，因此我们可以通过两种不同的方式检测它并对其做出反应。我们可以定义一个匿名函数作为配置对象中change属性的值，就像我们对value属性所做的那样，或者我们可以使用jQuery的bind方法来指定要执行的匿名函数。两者之间的一个细微差别是，使用bind方法指定的代码将首先执行。

进度条API公开了五个方法，如下所示：

销毁
禁用
启用
选项
value

所有这些方法的使用方式与我们所了解的选项方法完全相同；通过调用构造函数方法，指定方法的名称和我们想要传递的任何参数。其中大多数应该是不言自明的。

使用进度条

对于那些以前可能根本没有使用过 jQuery UI 的人来说，到目前为止这个示例非常基础。让我们稍微进步一点，将一些接近我们可能想要在正确的实现中做的事情放在一起。这个例子也很基础，但它应该可以让我们更好地了解如何使该小部件为我们工作。我们完成的页面将如下所示：

使用Javascript建立進度條

在文本编辑器的新文件中从以下基础页面开始：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
  <head>
    <link rel="stylesheet" type="text/css" href="jqueryui1.7/development-bundle/themes/smoothness/ui.core.css">
    <link rel="stylesheet" type="text/css" href="jqueryui1.7/development-bundle/themes/smoothness/ui.theme.css">
    <link rel="stylesheet" type="text/css" href="jqueryui1.7/development-bundle/themes/smoothness/ui.progressbar.css">
    <link rel="stylesheet" type="text/css" href="regForm.css">
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>jQuery UI Progress Bar</title>
  </head>
  <body>
    <div class="form-container ui-helper-clearfix ui-corner-all">
      <h1>Registration Form</h1>
      <p>Progress:</p>
      <div id="progress"></div><label id="amount">0%</label>
        <form action="serverScript.php">
          <div id="panel1" class="form-panel">
            <h2>Personal Details</h2>
              <fieldset class="ui-corner-all">
	<label>Name:</label><input type="text">
	<label>D.O.B:</label><input type="text">
	<label>Choose password:</label><input type="password">
	<label>Confirm password:</label><input type="password">
              </fieldset>
            </div>
            <div id="panel2" class="form-panel ui-helper-hidden">
              <h2>Contact Details</h2>
              <fieldset class="ui-corner-all">
                <label>Email:</label><input type="text">
	<label>Telephone:</label><input type="text">
	<label>Address:</label><textarea rows="3" cols="25"></textarea>
              </fieldset>
            </div>
            <div id="thanks" class="form-panel ui-helper-hidden">
              <h2>Registration Complete</h2>
              <fieldset class="ui-corner-all">
  	<p>Thanks for registering!</p>
              </fieldset>
            </div>
            <button id="next">Next ></button><button id="back" disabled="disabled">< Back</button>
          </form>
        </div>
        <script type="text/javascript" src="jqueryui1.7/development-bundle/jquery-1.3.2.js"></script>
        <script type="text/javascript" src="jqueryui1.7/development-bundle/ui/ui.core.js"></script>
        <script type="text/javascript" src="jqueryui1.7/development-bundle/ui/ui.progressbar.js"></script>
        <script type="text/javascript">

登入後複製

将其另存为 jQuery UI 文件夹中的 regForm.html。在页面顶部，我们链接到 CSS 框架；这主要是为了添加进度条所需的样式，但我们也可以在我们自己的元素上使用它提供的一些类。我们还添加了一个即将创建的自定义样式表。

页面的主体包含一些布局元素和一些文本节点，但主要元素是进度条和表单的容器。使用 div 和 fieldset 元素将表单分为几个不同的部分。这样做的原因是我们可以隐藏部分表单，使其看起来好像跨越多个页面。

我们在进度栏旁边添加了一个段落和一个标签，我们将放置它们，以便它们出现在进度栏内。该段落包含一个简单的文本字符串。该标签将用于显示当前进度值。

外部容器被赋予几个类名；第一个是我们可以对元素应用一些自定义样式，但第二个是针对 CSS 框架的不同功能。 ui-helper-clearfix 类用于自动清除浮动元素，是减少额外和不必要的 div 元素混乱的好方法。

ui-corner-all 类用于使用多种专有样式规则为容器元素（以及自动具有它们的进度条本身和我们的字段集元素）提供圆角。这些仅受基于 gecko 和 webkit 的浏览器支持，但就渐进增强的本质而言，使用它们是完全可以接受的。渐进增强意味着我们可以在网页上为能够显示它的浏览器提供增强的样式。其他浏览器只有一个方角容器。

我们在表单中使用 CSS 框架中的另一个类；页面首次加载时需要隐藏多个面板，因此我们可以使用 ui-helper-hidden 类来确保将它们设置为 display:none，当我们想要显示它们时，我们所要做的就是删除这个类名。

在正文的底部（出于性能原因；顺便说一下，这确实有效！）我们链接到库中所需的 JavaScript 资源。最后一个脚本元素是空的，正在等待使表单和进度条栩栩如生的代码。接下来我们添加一下：

$(function() {

  //call progress bar constructor
  $("#progress").progressbar({ change: function() {

    //update amount label when value changes
    $("#amount").text($("#progress").progressbar("option", "value") + "%");
  } });

  //set click handler for next button
  $("#next").click(function(e) {

  //stop form submission
  e.preventDefault();

  //look at each panel
  $(".form-panel").each(function() {

    //if it's not the first panel enable the back button
    ($(this).attr("id") != "panel1") ? null : $("#back").attr("disabled", "");

	//if the panel is visible fade it out
	($(this).hasClass("ui-helper-hidden")) ? null : $(this).fadeOut("fast", function() {

	  //add hidden class and show the next panel
	  $(this).addClass("ui-helper-hidden").next().fadeIn("fast", function() {

	    //if it's the last panel disable the next button
    	    ($(this).attr("id") != "thanks") ? null : $("#next").attr("disabled", "disabled");
								
	    //remove hidden class from new panel
	    $(this).removeClass("ui-helper-hidden");
								
	    //update progress bar
	    $("#progress").progressbar("option", "value", $("#progress").progressbar("option", "value") + 50);
	  });
      });
    });
  });

});

登入後複製

在外部 document.ready 快捷方式中，我们有进度条的构造函数；我们向构造函数传递一个包含单个属性的文字配置对象。这是更改属性，允许我们提供一个匿名函数，以便在每次检测到自定义更改事件时执行。我们可以使用此事件来更新要放置在进度条内的标签。

每次触发事件时，我们都会使用 option 方法获取进度条的当前值，并将该值设置为标签的文本。该事件在更改发生后触发，因此我们获得的值将始终是新值。

接下来我们有一个用于 next> 按钮的点击处理程序；单击此按钮时，将导致表单的当前“页面”通过一系列动画发生变化，并且进度条的值也会更新。我们还需要做一些其他的事情。表单内按钮的默认行为是提交表单，我们不想在这个阶段执行此操作，因此单击处理程序要做的第一件事就是使用 PreventDefault() JavaScript 函数阻止表单提交。这是在事件对象上调用的，该事件对象会自动传递给匿名函数。

然后，我们查看表单中的每个单独面板以确定当前面板；我们要做的第一件事是检查当前面板是否不是第一个面板，如果不是，我们启用默认情况下禁用的后退按钮。一次只会显示一个面板，因此我们找到没有 ui-helper-hidden 类的面板并将其淡出。我们指定一个匿名回调函数，在淡入淡出完成后执行。

在第二个函数中，我们选择下一个元素并显示它；如果下一个元素是最终面板，其 id 为Thanks，我们禁用 next> 按钮。尽管在此示例中我们并不担心表单的实际提交，但我们可以在这里将从表单收集的数据发送到服务器。我们删除了 ui-helper-hidden 类，因为面板现在可见。

最后，我们再次使用 option 方法，这次是在 setter 模式下，来设置进度条的新值。我们作为第二个参数传递给该方法的新值只是当前值加上 50，因为表单只有 2 个部分。最后一部分将触发更新标签的函数。

接下来，我们需要为

//set click handler for back button
$("#back").click(function(e) {
				  
  //stop form submission
  e.preventDefault();
					
  //look at each panel
  $(".form-panel").each(function() {
					  					
    //if it's not the last panel enable the next button
    ($(this).attr("id") != "thanks") ? null : $("#next").attr("disabled", "");
					  
    //if the panel is visible fade it out
    ($(this).hasClass("ui-helper-hidden")) ? null : $(this).fadeOut("fast", function() {
						  
      //add hidden class and show the next panel
      $(this).addClass("ui-helper-hidden").prev().fadeIn("fast", function() {
							
        //if it's the first panel disable the back button
    	  ($(this).attr("id") != "panel1") ? null : $("#back").attr("disabled", "disabled");
										
	  //remove hidden class from new panel
	  $(this).removeClass("ui-helper-hidden");
								
	  //update progress bar
	  $("#progress").progressbar("option", "value", $("#progress").progressbar("option", "value") - 50);
      });
    });
  });
});

登入後複製

这就是我们现在需要的所有代码，我们现在要做的就是添加一些基本的 CSS 来布置示例；在文本编辑器的新文件中添加以下代码：

h1, h2 { font-family:Georgia; font-size:140%; margin-top:0; }
h2 { font-size:100%; margin:20px 0 10px; text-align:left; }
.form-container {
  width:400px; margin:0 auto; position:relative; font-family:Verdana;
  font-size:80%; padding:20px; background-color:#e0e3e2;
  border:3px solid #abadac;
}
.form-panel { width:400px; height:241px; }
.form-panel fieldset {
  width:397px; height:170px; margin:0 auto; padding:22px 0 0;
  border:1px solid #abadac; background-color:#ffffff;
}
.form-panel label {
  width:146px; display:block; float:left; text-align:right;
  padding-top:2px; margin-right:10px;
}
.form-panel input, .form-panel textarea {
  float:left; width:200px; margin-bottom:13px;
}
.form-container button { float:right; }
p {
  margin:0; font-size:75%; position:absolute; left:30px; top:60px;
  font-weight:bold;
}
#amount {
  position:absolute; right:30px; top:60px; font-size:80%;
  font-weight:bold;
}
#thanks { text-align:center; }
#thanks p {
  margin-top:48px; font-size:160%; position:relative; left:0; top:0;
}

登入後複製

将其另存为 regForm.css，与 HTML 文件位于同一文件夹中。我们现在应该有一个带有有线进度条的工作页面。当我们运行该页面时，我们应该发现我们可以浏览表单的每个面板，并且进度条将相应地自行更新：

使用Javascript建立進度條