DIV CSS 佈局教程網

Bootstrap 按鈕(Button)插件:載入狀態、切換與單多選按鈕組
編輯:關於JavaScript     

靜態按鈕的樣式在「Bootstrap 按鈕」那一章已經談過,Button 插件補上的是「行為」:控制按鈕狀態、把它變成開關,或讓一整組按鈕化身為單選/多選控制項。若只想載入這個功能,引入 button.js 即可,或直接載入 bootstrap.js/bootstrap.min.js。

一、載入狀態

要在送出表單時讓按鈕進入「處理中」狀態,只需加上 data-loading-text 屬性:

<button id="fat-btn" class="btn btn-primary" data-loading-text="Loading..." type="button">
  載入狀態
</button>
<script>
$(function () {
  $(".btn").click(function () {
    $(this).button('loading').delay(1000).queue(function () {
      // $(this).button('reset');
    });
  });
});
</script>

它的運作原理是暫存按鈕原本的 HTML 內容,切換成 data-loading-text 指定的文字並加上 disabled,直到呼叫 reset 才還原。這能有效防止使用者重複點擊送出重複的請求。

二、單個切換

加上 data-toggle="button" 就能讓按鈕在正常狀態與按下狀態之間來回切換:

<button class="btn btn-primary" data-toggle="button" autocomplete="off">單個切換</button>

autocomplete="off" 這個看似多餘的屬性其實是必要的。Firefox 在多次載入同一頁面時會保留表單欄位的前次狀態,導致按鈕停留在 disabled 或 active 的外觀上,加上這個屬性可以避免該行為。

三、單選按鈕組

把 data-toggle="buttons" 加在 .btn-group 上,並在內部放入 radio,整組就會變成互斥的單選控制項:

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary active">
    <input type="radio" name="sex" autocomplete="off" checked>男
  </label>
  <label class="btn btn-primary">
    <input type="radio" name="sex" autocomplete="off">女
  </label>
</div>

注意這裡用的是 <label> 而非 <button>,因為底層仍然是原生的 radio 表單元素——這樣做的好處是表單送出時值會正常帶入後端,同時視覺上是按鈕。

四、複選按鈕組

把 radio 換成 checkbox,同樣加上 data-toggle="buttons",就變成多選的切換鈕群:

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary active">
    <input type="checkbox" name="fa" autocomplete="off" checked> 音樂
  </label>
  <label class="btn btn-primary">
    <input type="checkbox" name="fa" autocomplete="off"> 體育
  </label>
  <label class="btn btn-primary">
    <input type="checkbox" name="fa" autocomplete="off"> 美術
  </label>
  <label class="btn btn-primary">
    <input type="checkbox" name="fa" autocomplete="off"> 電腦
  </label>
</div>

五、方法

Button 插件的 button() 方法接受三種參數:toggle(切換狀態)、reset(還原為初始文字)、以及任意自訂字串(例如 loading、complete,會把按鈕文字換成該字串)。

// 可取代 data-toggle="button"
$('button').on('click', function () {
  $(this).button('toggle');
});

常見的組合寫法是在非同步請求的 both callback 中還原按鈕,形成完整的「按下 → 處理中 → 完成」流程:

$('#submit').on('click', function () {
  var $btn = $(this).button('loading');
  $.ajax({
    url: '/api/save',
    complete: function () { $btn.button('reset'); }
  });
});

更多 Bootstrap 內容可參考 Bootstrap 學習教程系列。

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