DIV CSS 佈局教程網

Bootstrap 學習筆記(四):11 個 JavaScript 組件逐一拆解
編輯:關於JavaScript     

這篇來看 Bootstrap 的 JS 組件。內容偏長,建議慢慢看,收穫應該不少。寫的東西大多基礎,一方面是自身技術有限,另一方面是刻意把複雜的概念用最白話的方式講出來,若有理解之處還請指正。

一、JS 檔案的引用順序

注意:jQuery 一定要在其他 js 之前引入,因為所有插件都依賴它。

<!-- <script src="js/jquery-1.11.3.min.js"></script> 本地引入 -->
<script src="https://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
<!-- 必須放在 bootstrap.min.js 之前 -->
<script src="js/bootstrap.min.js"></script>

二、data 屬性的開關

作用:透過 data 屬性,可以完全不寫 JavaScript 就啟用任何 Bootstrap 插件,例如前面提過的 data-toggle="dropdown"。

那要如何關掉?在 JavaScript 中加上這一行即可:

<script type="text/javascript">
$(document).off('.data-api');
</script>

若只想關閉某個特定插件:

<script type="text/javascript">
// 關閉提示框的插件功能
$(document).off('.alert.data-api');
</script>

幾乎所有 Bootstrap JS 插件的使用步驟都是這三步:

1. 怎麼用?——對應的 class 或 data 屬性怎麼寫?
2. 怎麼呼叫?——寫好之後如何讓它生效?
3. 事件處理——動作觸發前與觸發後各發生什麼。

注意:所有「動作觸發之前」的事件,Bootstrap 都提供了 preventDefault 的做法,可以在動作真正執行前把它攔下來:

$('#myModal').on('show.bs.modal', function(e) {
  if (!data) return e.preventDefault();   // 阻止模態框顯示
});

另外:Bootstrap 並未針對停用 JavaScript 的瀏覽器做補救,這部分得自己處理,寫法大家都熟:

<noscript>您的瀏覽器不支援 JavaScript,請下載最新版本。</noscript>

三、模態框組件(modal.js)

注意點:不支援同時開啟多個模態框;模態框盡量放在 body 的直屬子元素位置,避免受其他組件影響;可透過 role 屬性增強可訪問性;模態框內可以嵌入影片。

點擊按鈕彈出一個模態框,屬性寫法如下:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<!-- 上述三個 meta 必須放在最前面 -->
<title>模態框示範</title>
<link href="css/bootstrap.css" rel="stylesheet">
<link href="css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
<button type="button" class="btn btn-primary btn-lg" data-toggle="modal" data-target=".bs-example-modal-lg">
  彈出大模態框
</button>

<div class="modal fade bs-example-modal-lg" id="myModalLg" tabindex="-1" role="dialog" aria-labelledby="myLargeModalLabel">
  <div class="modal-dialog modal-lg">  <!-- modal-lg 就是大尺寸 -->
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="close">
          <span aria-hidden="true">×</span>
        </button>
        <h4 class="modal-title">Modal title</h4>
      </div>
      <div class="modal-body"><p>一段內容……</p></div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">關閉</button>
        <button type="button" class="btn btn-primary">儲存變更</button>
      </div>
    </div>
  </div>
</div>

<!-- 把 modal-lg 換成 modal-sm 就是小尺寸;移掉 fade 則取消動畫 -->
<script src="https://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script type="text/javascript">
$("#myModalLg").modal("show");   // 呼叫這句話插件才會生效
</script>
</body>
</html>

模態框的事件:在 JavaScript 中掛上監聽即可,例如下面這段會在關閉模態框後跳出提示:

$('#myModal').on('hidden.bs.modal', function(e) {
  alert("模態框已關閉");
});

嵌入影片:做法是動態改寫 iframe 的 src,開啟時加上 autoplay 參數,關閉時還原。

function autoPlayModal() {
  var trigger = $("body").find('[data-toggle="modal"]');
  trigger.click(function() {
    var theModal = $(this).data("target");
    var videoSRC = $(this).attr("data-theVideo");
    var videoSRCauto = videoSRC + "?autoplay=1";
    $(theModal + ' iframe').attr('src', videoSRCauto);
    $(theModal + ' button.close').click(function() {
      $(theModal + ' iframe').attr('src', videoSRC);
    });
  });
}
$(document).ready(function() { autoPlayModal(); });

對應的觸發元素只需要多帶一個自訂屬性 data-theVideo,放影片網址即可。

四、滾動監聽組件(scrollspy)

最典型的應用是導覽列:隨著頁面滾動自動切換當前高亮的項目。

前提:頁面必須出現捲軸。接著在 body 上加 data-spy="scroll" 與 data-target,再用 data-offset 指定偏移量。

<body data-spy="scroll" data-target=".navbar" data-offset="70">
  <nav class="navbar navbar-default navbar-fixed-top" role="navigation">
    <ul class="nav navbar-nav">
      <li class="active"><a href="#home">home</a></li>
      <li><a href="#message">message</a></li>
      <li><a href="#about">about</a></li>
      <li class="dropdown">
        <a href="#" class="btn btn-default dropdown-toggle" data-toggle="dropdown">
          下拉選單<b class="caret"></b>
        </a>
        <ul class="dropdown-menu">
          <li><a href="#one">one</a></li>
          <li><a href="#two">two</a></li>
          <li><a href="#three">three</a></li>
        </ul>
      </li>
    </ul>
  </nav>

  <h1 id="home">home</h1><p>……內容夠長以產生捲軸……</p><hr>
  <h1 id="message">message</h1><p>……</p><hr>
  <h1 id="about">about</a></h1><p>……</p><hr>
  <h1 id="one">one</h1><p>……</p>
  <h1 id="two">two</h1><p>……</p>
  <h1 id="three">three</h1><p>……</p>
</body>

data-offset 的意思:滾動到該區塊時,距離頂部的偏移量。因為固定定位的導覽列會遮住標題,所以要預留它的visory高度。事件用法與模態框類似,這裡不再重複。

五、提示框組件(tooltip)

注意:使用 data-toggle="tooltip";data-placement 決定方向,有 left、right、bottom、top 四種;data-animation="false" 可關掉動畫,滑鼠移入時瞬間出現而非漸入。

<div class="container">
  <p class="muted">
    this is a test title,
    <a href="#" id="clickEvent" data-toggle="tooltip" title=""
       data-placement="bottom" data-original-title="cnblog.com/jtjds"
       data-animation="false">click me, remember</a>
  </p>
</div>

<script src="https://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script type="text/javascript">
$('[data-toggle="tooltip"]').tooltip();   // 記得初始化
$('#clickEvent').tooltip('show');          // 主動顯示
$('#clickEvent').on('shown.bs.tooltip', function() {
  alert("顯示完成");
});
</script>

六、彈出框組件(popover)

注意:彈出框是在任意元素上加一小塊懸浮層,用來放非主要資訊;內容為空時不顯示;使用 data-toggle="popover";它依賴提示框插件,而且必須手動初始化。

<!-- 點擊按鈕彈出,再點擊隱藏 -->
<button type="button" class="btn btn-primary" data-toggle="popover" title="標題"
        data-content="這裡是一段說明內容,是不是很吸引人?">
  點我彈出/隱藏彈出框
</button>

若想改成「點擊任何空白處就能關閉」,加上 data-trigger="focus" 即可(trigger 就是觸發的意思)。這種寫法建議搭配 a 標籤並給 tabindex="0":

<a tabindex="0" id="myPopover" class="btn btn-lg btn-danger" role="button"
   data-toggle="popover" data-trigger="focus" title="Dismissible popover"
   data-content="這是一段更漂亮的心內容">點我可消失</a>

七、警告框組件(alert)

注意:使用 data-dismiss="alert";它讓警告訊息可以點擊關閉;關閉按鈕(close 類別)必須是 alert 的第一個子元素,前面不能有任何文字。

<div class="alert alert-info fade in" id="myalert">
  <button type="button" class="close" data-dismiss="alert" aria-label="close">
    <span aria-hidden="true">×</span>
  </button>
  <span>歡迎你</span>
  <button type="button" class="btn btn-primary">詳情</button>
</div>

若頁面上有多個警告框,想用 JS 關閉指定那一個:

$("#myalert").alert('close');   // 關閉第一個;換成 #myalert1 則關閉第二個

$('#myalert1').on('closed.bs.alert', function() {
  alert("已關閉");   // 點擊關閉鈕後觸發
});

八、按鈕組件

注意:可用 autocomplete="off" 控制按鈕狀態切換;可把多顆按鈕組成工具列;用 data-loading-text 設定載入中狀態。

<button type="button" id="myButton" data-loading-text="loading...."
        class="btn btn-primary" autocomplete="off">loading state</button>

<button type="button" class="btn btn-primary" data-toggle="button"
        aria-pressed="false" autocomplete="off">single toggle</button>

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary active"><input type="checkbox" autocomplete="off" checked>home</label>
  <label class="btn btn-primary"><input type="checkbox" autocomplete="off">message</label>
  <label class="btn btn-primary"><input type="checkbox" autocomplete="off">profile</label>
</div>

點擊後想改掉按鈕文字,加上 data-complete-text 並搭配 JS:

$('.mybtn').on('click', function() {
  $(this).button('complete');   // 文字會變成 data-complete-text 的值
});

想模擬「載入中 → 3 秒後恢復」的效果:

$('#myButton').on('click', function(e) {
  var btn = $(this).button('loading');
  setTimeout(function() {
    btn.button('reset');   // 恢復原始狀態
  }, 3000);
});

九、折疊組件(collapse)

使用 data-toggle="collapse":

<a class="btn btn-primary" role="button" data-toggle="collapse"
   href="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
  Link with href
</a>
<div class="collapse" id="collapseExample">
  <div class="well">hello, this is a test!</div>
</div>

也可以與面板組搭配,做成手風琴:

<div class="panel-group" id="mypanel" role="tablist">
  <div class="panel panel-default">
    <div class="panel-heading" role="tab" id="headingone">
      <h4 class="panel-title">
        <a data-toggle="collapse" data-parent="#mypanel" href="#collapseone"
           class="btn btn-primary">home</a>
      </h4>
    </div>
    <div id="collapseone" class="panel-collapse collapse in" role="tabpanel">
      <div class="panel-body">關於我、你好啊、碎碎念</div>
    </div>
  </div>
</div>

點 home 之所以能控制對應的內容,靠的就是 href="#collapseone" 指向內容區塊的 id。事件寫法與前面一致:

$('#mypanel').on('hidden.bs.collapse', function() {
  alert("折疊完成");
});

十、輪播組件(carousel)

使用 data-ride="carousel",最常見的就是首頁輪播圖。

<div class="container">
  <div id="carousel1" class="carousel slide" data-ride="carousel">
    <ol class="carousel-indicators">   <!-- 下方的小圓點 -->
      <li data-target="#carousel1" data-slide-to="0" class="active"></li>
      <li data-target="#carousel1" data-slide-to="1"></li>
      <li data-target="#carousel1" data-slide-to="2"></li>
    </ol>

    <div class="carousel-inner" role="listbox">
      <div class="item active">
        <img src="bg.jpeg" style="width:600px;height:600px;">
        <div class="carousel-caption">   <!-- 圖片上的文字 -->
          <h3>綠色陽光</h3>
          <p>陽光心情,你我同行</p>
        </div>
      </div>
      <div class="item"><img src="timg.jpg" style="width:600px;height:600px;"></div>
      <div class="item"><img src="xx.jpg" style="width:600px;height:600px;"></div>
    </div>

    <a class="left carousel-control" href="#carousel1" role="button" data-slide="prev">
      <span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>
      <span class="sr-only">previous</span>
    </a>
    <a class="right carousel-control" href="#carousel1" role="button" data-slide="next">
      <span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
      <span class="sr-only">next</span>
    </a>
  </div>
</div>

切換速度怎麼設?可以在 div 上直接寫 data-interval="2000",但這種做法有個毛病:重新整理瀏覽器之後,必須手動點一下左右箭頭才會開始播放。比較可靠的方式是在 JavaScript 中設定:

$(".carousel").carousel({ interval: 2000 });

十一、Affix 組件

用 position: fixed 做定位,搭配 data-spy="affix" 與 data-offset 做滾動監聽,讓元素在到達某個位置時固定住。

<div class="container">
  <div class="col-md-3">
    <ul class="list-group affixed-element-top js-affixed-element-top">
      <li class="list-group-item">項目一</li>
      <li class="list-group-item">項目二</li>
      <li class="list-group-item">項目三</li>
    </ul>
  </div>

  <div class="js-content col-md-6">
    <!-- 這裡放大量內容,讓頁面產生足夠的捲動距離 -->
    <p>……</p>
    <p>……</p>
  </div>

  <div class="col-md-3">
    <ul class="list-group affixed-element-bottom js-affixed-element-bottom">
      <li class="list-group-item">項目一</li>
      <li class="list-group-item">項目二</li>
    </ul>
  </div>
</div>

<script src="https://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script type="text/javascript">
$('.js-affixed-element-top').affix({ offset: {} });

// 滾到最底部時,該 div 會固定在距底部 200px 處
$('.js-affixed-element-bottom').affix({ offset: { bottom: 200 } });
</script>

以上就是 Bootstrap 11 個 JS 組件的要點整理。學習這個框架到這裡大致告一段落,接下來可以用它實際做一個完整頁面來驗收成果。

最後補一句現實狀況:Bootstrap 3 已於 2019 年停止維護,jQuery 依賴的架構在今日專案中多半已被 React、Vue 等方案取代。上面這些內容仍有理解價值——尤其是「data 屬性宣告式觸發」與「事件命名空間」這兩個設計思路,在現代的前端框架裡依然看得到影子。

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