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>
尝试一下 »
結果は以下のようになります:
选项
data 属性または JavaScript で渡します。以下の表にこれらのオプションを示します。
| 选项名称 | 类型/默认值 | Data属性名 | 描述 |
|---|---|---|---|
| offset | number 默认值: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);">
×删除该部分</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);">
×删除该部分</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>
尝试一下 »
結果は以下のようになります:
事件
以下の表は、スクロールスパイで使用されるイベントを示しています。これらのイベントは関数内でフックとして使用できます。
| 事件 | 描述 | 实例 |
|---|---|---|
| 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);">
×删除该部分</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);">
×删除该部分</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>
尝试一下 »
結果は以下のようになります:
更多实例
水平スクロールスパイの作成
以下の例は、水平スクロールスパイの作成方法を示しています:
实例
<!-- 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>
<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>
<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>
尝试一下 »