Bootstrap 滚动监听(Scrollspy)插件

スクロールスパイ(Scrollspy)プラグイン、つまり自動更新ナビゲーションプラグインは、スクロールバーの位置に応じて対応するナビゲーションターゲットを自動的に更新します。その基本的な実装は、スクロールに合わせてスクロールバーの位置に基づきナビゲーションバーに追加することです。.active class。

このプラグインの機能を単独で使用したい場合は、参照する必要がありますscrollspy.js。あるいは、まさにBootstrap 插件概览一章で述べたように、引用することができます。bootstrap.jsまたは圧縮版のbootstrap.min.js。

用法

上部ナビゲーションにスクロールスパイの動作を追加できます:

  • 通过 data 属性:監視したい要素(通常は body)に追加しますdata-spy="scroll"。そしてBootstrapを追加して.navコンポーネントの親要素の ID または class 属性data-target。正常に機能させるには、ページの本文に、監視したいリンクに対応する ID を持つ要素が存在することを確認する必要があります。
    <body data-spy="scroll" data-target=".navbar-example">
    ...
    <div class="navbar-example">
        <ul class="nav nav-tabs">
            ...
        </ul>
    </div>
    ...
    </body>
    
  • 通过 JavaScript:JavaScript でスクロールスパイを呼び出し、監視したい要素を選択して、呼び出します.scrollspy()函数:
    $('body').scrollspy({ target: '.navbar-example' })
    

实例

以下の例では、data属性を使用してスクロールスパイ(Scrollspy)プラグインを利用する方法を示しています:

实例

<nav id="navbar-example" class="navbar navbar-default navbar-static" role="navigation"> <div class="container-fluid"> <div class="navbar-header"> <button class="navbar-toggle" type="button" data-toggle="collapse" data-target=".bs-js-navbar-scrollspy"> <span class="sr-only">切换导航</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">教程名称</a> </div> <div class="collapse navbar-collapse bs-js-navbar-scrollspy"> <ul class="nav navbar-nav"> <li><a href="#ios">iOS</a></li> <li><a href="#svn">SVN</a></li> <li class="dropdown"> <a href="#" id="navbarDrop1" class="dropdown-toggle" data-toggle="dropdown">Java <b class="caret"></b> </a> <ul class="dropdown-menu" role="menu" aria-labelledby="navbarDrop1"> <li><a href="#jmeter" tabindex="-1">jmeter</a></li> <li><a href="#ejb" tabindex="-1">ejb</a></li> <li class="divider"></li> <li><a href="#spring" tabindex="-1">spring</a></li> </ul> </li> </ul> </div> </div> </nav> <div data-spy="scroll" data-target="#navbar-example" data-offset="0" style="height:200px;overflow:auto; position: relative;"> <h4 id="ios">iOS</h4> <p>iOSは、アップル社が開発・リリースしたモバイルオペレーティングシステムです。最初は2007年にiPhone、iPod Touch、Apple TVとともに初めてリリースされました。iOSはOS Xから派生しており、Darwin基盤を共有しています。OS Xはアップル社のコンピュータで使用され、iOSはアップル社のモバイル版です。</p> <h4 id="svn">SVN</h4> <p>Apache Subversionは、通常SVNと略され、オープンソースのバージョン管理システムソフトウェアです。SubversionはCollabNet社によって2000年に作成されました。しかし現在ではApache Software Foundationのプロジェクトとして発展しており、豊富な開発者とユーザーコミュニティを持っています。</p> <h4 id="jmeter">jMeter</h4> <p>jMeter はオープンソースのテストソフトウェアです。100% 純 Java アプリケーションで、負荷テストと性能テストに使用されます。</p> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans(EJB)は、高度にスケーラブルで強力なエンタープライズアプリケーションを作成するための開発アーキテクチャであり、互換性のあるアプリケーションサーバー(JBOSS、Web Logic など)上のJ2EEにデプロイされます。</p> <h4 id="spring">Spring</h4> <p>Springフレームワークは、強力なJavaアプリケーションを迅速に開発するための完全なインフラストラクチャサポートを提供する、オープンソースのJavaプラットフォームです。</p> <p>SpringフレームワークはもともとRod Johnsonによって書かれ、2003年6月にApache 2.0ライセンスの下で初めて公開されました。</p> </div>

尝试一下 »

結果は以下のようになります:

滚动监听(Scrollspy)插件

选项

data 属性または JavaScript で渡します。以下の表にこれらのオプションを示します。

选项名称类型/默认值Data属性名描述
offsetnumber
默认值:10
data-offsetスクロール位置を計算する際の、上部からのオフセットピクセル数。

方法

.scrollspy('refresh'):当通过 JavaScript 调用 scrollspy 方法时,您需要调用.refreshDOMを更新するメソッドです。これは、DOMの任意の要素が変更されたとき(つまり、要素を追加または削除したとき)に非常に便利です。以下は、このメソッドの使用構文です。
$('[data-spy="scroll"]').each(function () {
  var $spy = $(this).scrollspy('refresh')
})

实例

以下の例では、.scrollspy('refresh')メソッドの使用方法を示しています:

实例

<nav id="myScrollspy" class="navbar navbar-default navbar-static" role="navigation"> <div class="container-fluid"> <div class="navbar-header"> <button class="navbar-toggle" type="button" data-toggle="collapse" data-target=".bs-js-navbar-scrollspy"> <span class="sr-only">切换导航</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">教程名称</a> </div> <div class="collapse navbar-collapse bs-js-navbar-scrollspy"> <ul class="nav navbar-nav"> <li class="active"><a href="#ios">iOS</a></li> <li><a href="#svn">SVN</a></li> <li class="dropdown"> <a href="#" id="navbarDrop1" class="dropdown-toggle" data-toggle="dropdown">Java <b class="caret"></b> </a> <ul class="dropdown-menu" role="menu" aria-labelledby="navbarDrop1"> <li><a href="#jmeter" tabindex="-1">jmeter</a></li> <li><a href="#ejb" tabindex="-1">ejb</a></li> <li class="divider"></li> <li><a href="#spring" tabindex="-1">spring</a></li> </ul> </li> </ul> </div> </div> </nav> <div data-spy="scroll" data-target="#myScrollspy" data-offset="0" style="height:200px;overflow:auto; position: relative;"> <div class="section"> <h4 id="ios">iOS<small><a href="#" onclick="removeSection(this);"> &times;删除该部分</a></small> </h4> <p>iOSはアップル社によって開発・リリースされたモバイルオペレーティングシステムです。当初は2007年にiPhone、iPod Touch、Apple TVで初めてリリースされました。iOSはOS Xから派生しており、共通のDarwin基盤を共有しています。OS Xオペレーティングシステムはアップル製コンピュータで使用され、iOSはアップルのモバイル版です。</p> </div> <div class="section"> <h4 id="svn">SVN<small></small></h4> <p>Apache Subversionは、通常SVNと略され、オープンソースのバージョン管理システムソフトウェアです。SubversionはCollabNet社によって2000年に作成されました。しかし現在ではApache Software Foundationのプロジェクトとして発展しており、豊富な開発者とユーザーコミュニティを持っています。</p> </div> <div class="section"> <h4 id="jmeter">jMeter<small><a href="#" onclick="removeSection(this);"> &times;删除该部分</a></small> </h4> <p>jMeter はオープンソースのテストソフトウェアです。100% 純 Java アプリケーションで、負荷テストと性能テストに使用されます。</p> </div> <div class="section"> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans(EJB)は、高度にスケーラブルで強力なエンタープライズアプリケーションを作成するための開発アーキテクチャであり、互換性のあるアプリケーションサーバー(JBOSS、Web Logic など)上のJ2EEにデプロイされます。</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>Springフレームワークは、強力なJavaアプリケーションを迅速に開発するための完全なインフラストラクチャサポートを提供する、オープンソースのJavaプラットフォームです。</p> <p>SpringフレームワークはもともとRod Johnsonによって書かれ、2003年6月にApache 2.0ライセンスの下で初めて公開されました。</p> </div> </div> <script> $(function(){ removeSection = function(e) { $(e).parents(".section").remove(); $('[data-spy="scroll"]').each(function () { var $spy = $(this).scrollspy('refresh') }); } $("#myScrollspy").scrollspy(); }); </script>

尝试一下 »

結果は以下のようになります:

滚动监听(Scrollspy)插件方法

事件

以下の表は、スクロールスパイで使用されるイベントを示しています。これらのイベントは関数内でフックとして使用できます。

事件描述实例
activate.bs.scrollspyスクロールスパイによって新しい項目がアクティブになるたびに、このイベントが発生します。
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // 执行一些动作...
})

实例

以下の例では、activate.bs.scrollspyイベントの使用方法を示しています:

实例

<nav id="myScrollspy" class="navbar navbar-default navbar-static" role="navigation"> <div class="container-fluid"> <div class="navbar-header"> <button class="navbar-toggle" type="button" data-toggle="collapse" data-target=".bs-js-navbar-scrollspy"> <span class="sr-only">切换导航</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">教程名称</a> </div> <div class="collapse navbar-collapse bs-js-navbar-scrollspy"> <ul class="nav navbar-nav"> <li class="active"><a href="#ios">iOS</a></li> <li><a href="#svn">SVN</a></li> <li class="dropdown"> <a href="#" id="navbarDrop1" class="dropdown-toggle" data-toggle="dropdown"> Java <b class="caret"></b> </a> <ul class="dropdown-menu" role="menu" aria-labelledby="navbarDrop1"> <li><a href="#jmeter" tabindex="-1">jmeter</a></li> <li><a href="#ejb" tabindex="-1">ejb</a></li> <li class="divider"></li> <li><a href="#spring" tabindex="-1">spring</a></li> </ul> </li> </ul> </div> </div> </nav> <div data-spy="scroll" data-target="#myScrollspy" data-offset="0" style="height:200px;overflow:auto; position: relative;"> <div class="section"> <h4 id="ios">iOS<small><a href="#" onclick="removeSection(this);"> &times;删除该部分</a></small> </h4> <p>iOSはアップル社によって開発・リリースされたモバイルオペレーティングシステムです。当初は2007年にiPhone、iPod Touch、Apple TVで初めてリリースされました。iOSはOS Xから派生しており、共通のDarwin基盤を共有しています。OS Xオペレーティングシステムはアップル製コンピュータで使用され、iOSはアップルのモバイル版です。</p> </div> <div class="section"> <h4 id="svn">SVN<small></small></h4> <p>Apache Subversionは、通常SVNと略され、オープンソースのバージョン管理システムソフトウェアです。SubversionはCollabNet社によって2000年に作成されました。しかし現在ではApache Software Foundationのプロジェクトとして発展しており、豊富な開発者とユーザーコミュニティを持っています。</p> </div> <div class="section"> <h4 id="jmeter">jMeter<small><a href="#" onclick="removeSection(this);"> &times;删除该部分</a></small> </h4> <p>jMeter はオープンソースのテストソフトウェアです。100% 純 Java アプリケーションで、負荷テストと性能テストに使用されます。</p> </div> <div class="section"> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans(EJB)は、高度にスケーラブルで強力なエンタープライズアプリケーションを作成するための開発アーキテクチャであり、互換性のあるアプリケーションサーバー(JBOSS、Web Logic など)上のJ2EEにデプロイされます。</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>Springフレームワークは、強力なJavaアプリケーションを迅速に開発するための完全なインフラストラクチャサポートを提供する、オープンソースのJavaプラットフォームです。</p> <p>SpringフレームワークはもともとRod Johnsonによって書かれ、2003年6月にApache 2.0ライセンスの下で初めて公開されました。</p> </div> </div> <span id="activeitem" style="color:red;"></span> <script>$(function(){ removeSection = function(e) { $(e).parents(".section").remove(); $('[data-spy="scroll"]').each(function () { var $spy = $(this).scrollspy('refresh') }); } $("#myScrollspy").scrollspy(); $('#myScrollspy').on('activate.bs.scrollspy', function () { var currentItem = $(".nav li.active > a").text(); $("#activeitem").html("目前您正に查看 - " + currentItem); }) });</script>

尝试一下 »

結果は以下のようになります:

滚动监听(Scrollspy)插件事件


更多实例

水平スクロールスパイの作成

以下の例は、水平スクロールスパイの作成方法を示しています:

实例

<!-- The navbar: used to jump to a section in the scrollable area -->
<nav class="navbar navbar-inverse navbar-fixed-top">
...
  <ul class="nav navbar-nav">
    <li><a href="#section1">Section 1</a></li>
    ...
</nav>

<!-- The scrollable area -->
<div data-spy="scroll" data-target=".navbar" data-offset="12">
  <!-- Section 1 -->
  <div id="section1">
    <h1>Section 1</h1>
    <p>Try to scroll this page and look at the navigation bar while scrolling!</p>
  </div>
  ...
</div>

尝试一下 »

垂直スクロールスパイの作成方法

以下の例は、垂直スクロールスパイの作成方法を示しています:

实例

<body data-spy="scroll" data-target="#myScrollspy" data-offset="20">

  <div class="container">
    <div class="row">
      <nav class="col-sm-3" id="myScrollspy">
        <ul class="nav nav-pills nav-stacked">
          <li><a href="#section1">Section 1</a></li>
          ...
        </ul>
      </nav>
      <div class="col-sm-9">
        <div id="section1">
          <h1>Section 1</h1>
          <p>Try to scroll this page and look at the navigation list while scrolling!</p>
        </div>
        ...
      </div>
    </div>
  </div>

</body>

尝试一下 »
其他扩展