Bootstrap Scrollspy Plugin

Das Scrollspy-Plugin, d. h. das automatisch aktualisierende Navigationsplugin, aktualisiert das entsprechende Navigationsziel automatisch basierend auf der Scrollbar-Position. Seine grundlegende Implementierung besteht darin, beim Scrollen basierend auf der Scrollbar-Position zur Navigationsleiste hinzuzufügen..active class。

Wenn Sie die Funktionalität dieses Plugins separat referenzieren möchten, müssen Siescrollspy.jsreferenzieren. Oder, wie im KapitelBootstrap Plugins Overviewerwähnt, können Sie referenzierenbootstrap.jsoder die komprimierte Version vonbootstrap.min.js。

Nutzung

Sie können der oberen Navigation Scrollspy-Verhalten hinzufügen:

  • Über Datenattribute: Zum zu überwachenden Element hinzufügen (normalerweise den Body)data-spy="scroll". Fügen Sie dann mit Bootstrap.navdie ID oder das Klassenattribut des Elternelements der Komponente hinzudata-target. Damit dies ordnungsgemäß funktioniert, müssen Sie sicherstellen, dass ein Element im Body der Seite vorhanden ist, das der ID des Links entspricht, den Sie überwachen möchten.
    <body data-spy="scroll" data-target=".navbar-example">
    ...
    <div class="navbar-example">
        <ul class="nav nav-tabs">
            ...
        </ul>
    </div>
    ...
    </body>
    
  • Über JavaScript: Sie können das Scrollspy über JavaScript aufrufen, das zu überwachende Element auswählen und dann die Funktion.scrollspy()aufrufen:
    $('body').scrollspy({ target: '.navbar-example' })
    

Beispiel

Das folgende Beispiel demonstriert die Verwendung des Scrollspy-Plugins über Datenattribute:

Beispiel

<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">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">Tutorial Name</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 ist ein von Apple Inc. entwickeltes und veröffentlichtes mobiles Betriebssystem. Es wurde erstmals 2007 mit dem ursprünglichen iPhone, iPod Touch und Apple TV veröffentlicht. iOS leitet sich von OS X ab, mit dem sie sich das Darwin-Fundament teilen. OS X wird auf Apple-Computern verwendet, und iOS ist Apples mobile Version.</p> <h4 id="svn">SVN</h4> <p>Apache Subversion, oft als SVN abgekürzt, ist eine Open-Source-Software für Versionskontrollsysteme. Subversion wurde im Jahr 2000 von CollabNet erstellt. Es hat sich jedoch inzwischen zu einem Projekt der Apache Software Foundation entwickelt und verfügt daher über eine reichhaltige Community von Entwicklern und Benutzern.</p> <h4 id="jmeter">jMeter</h4> <p>jMeter ist eine Open-Source-Testsoftware. Es ist eine zu 100 % reine Java-Anwendung, die für Last- und Leistungstests verwendet wird.</p> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans (EJB) ist eine Entwicklungsarchitektur zum Erstellen hochskalierbarer und leistungsstarker Anwendungen auf Unternehmensebene, die auf J2EE-kompatiblen Anwendungsservern (wie JBOSS, Web Logic usw.) bereitgestellt werden.</p> <h4 id="spring">Spring</h4> <p>Das Spring Framework ist eine Open-Source-Java-Plattform, die umfassende Infrastrukturunterstützung für die schnelle Entwicklung leistungsstarker Java-Anwendungen bietet.</p> <p>Das Spring Framework wurde ursprünglich von Rod Johnson geschrieben und im Juni 2003 erstmals unter der Apache 2.0-Lizenz veröffentlicht.</p> </div>

Ausprobieren »

Das Ergebnis wird unten angezeigt:

滚动监听(Scrollspy)插件

Optionen

Sie können über Datenattribute oder JavaScript übergeben werden. Die folgende Tabelle listet diese Optionen auf:

OptionsnameTyp / StandardwertDatenattribut-NameBeschreibung
offsetnumber
Standardwert: 10
data-offsetDie Anzahl der Pixel, um die beim Berechnen der Scrollposition von oben versetzt werden soll.

Methoden

.scrollspy('refresh'): Wenn Sie die Scrollspy-Methode über JavaScript aufrufen, müssen Sie die Methode.refreshaufrufen, um das DOM zu aktualisieren. Dies ist sehr nützlich, wenn sich ein Element im DOM ändert (d. h. Sie haben einige Elemente hinzugefügt oder entfernt). Das Folgende ist die Syntax für die Verwendung dieser Methode.
$('[data-spy="scroll"]').each(function () {
  var $spy = $(this).scrollspy('refresh')
})

Beispiel

Das folgende Beispiel demonstriert die Verwendung der Methode.scrollspy('refresh'):

Beispiel

<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">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">Tutorial Name</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;Diesen Abschnitt löschen</a></small> </h4> <p>iOS ist ein von Apple Inc. entwickeltes und veröffentlichtes mobiles Betriebssystem. Es wurde ursprünglich 2007 für iPhone, iPod Touch und Apple TV veröffentlicht. iOS leitet sich von OS X ab, und sie teilen sich das Darwin-Fundament. OS X wird auf Apple-Computern verwendet, während iOS Apples mobile Version ist.</p> </div> <div class="section"> <h4 id="svn">SVN<small></small></h4> <p>Apache Subversion, oft als SVN abgekürzt, ist eine Open-Source-Software für Versionskontrollsysteme. Subversion wurde im Jahr 2000 von CollabNet erstellt. Aber jetzt hat es sich zu einem Projekt der Apache Software Foundation entwickelt und hat somit eine reichhaltige Community von Entwicklern und Benutzern.</p> </div> <div class="section"> <h4 id="jmeter">jMeter<small><a href="#" onclick="removeSection(this);"> &times;Diesen Abschnitt löschen</a></small> </h4> <p>jMeter ist eine Open-Source-Testsoftware. Es ist eine zu 100 % reine Java-Anwendung, die für Last- und Leistungstests verwendet wird.</p> </div> <div class="section"> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans (EJB) ist eine Entwicklungsarchitektur zum Erstellen hochskalierbarer und leistungsstarker Anwendungen auf Unternehmensebene, die auf J2EE mit kompatiblen Anwendungsservern (wie JBOSS, Web Logic usw.) bereitgestellt werden.</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>Das Spring-Framework ist eine Open-Source-Java-Plattform, die vollständige Infrastrukturunterstützung für die schnelle Entwicklung leistungsstarker Java-Anwendungen bietet.</p> <p>Das Spring-Framework wurde ursprünglich von Rod Johnson geschrieben und im Juni 2003 erstmals unter der Apache 2.0-Lizenz veröffentlicht.</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>

Selbst ausprobieren »

Das Ergebnis ist wie folgt:

滚动监听(Scrollspy)插件方法

Ereignisse

Die folgende Tabelle listet die beim Scroll-Listening verwendeten Ereignisse auf. Diese Ereignisse können als Hooks in Funktionen verwendet werden.

EreignisseBeschreibungBeispiel
activate.bs.scrollspyDieses Ereignis wird immer dann ausgelöst, wenn ein neues Element durch Scroll-Listening aktiviert wird.
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // 执行一些动作...
})

Beispiel

Das folgende Beispiel demonstriert die Verwendung des Ereignissesactivate.bs.scrollspy:

Beispiel

<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">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">Tutorial Name</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;Diesen Abschnitt löschen</a></small> </h4> <p>iOS ist ein von Apple Inc. entwickeltes und veröffentlichtes mobiles Betriebssystem. Es wurde ursprünglich 2007 für iPhone, iPod Touch und Apple TV veröffentlicht. iOS leitet sich von OS X ab, und sie teilen sich das Darwin-Fundament. OS X wird auf Apple-Computern verwendet, während iOS Apples mobile Version ist.</p> </div> <div class="section"> <h4 id="svn">SVN<small></small></h4> <p>Apache Subversion, oft als SVN abgekürzt, ist eine Open-Source-Software für Versionskontrollsysteme. Subversion wurde im Jahr 2000 von CollabNet erstellt. Aber jetzt hat es sich zu einem Projekt der Apache Software Foundation entwickelt und hat somit eine reichhaltige Community von Entwicklern und Benutzern.</p> </div> <div class="section"> <h4 id="jmeter">jMeter<small><a href="#" onclick="removeSection(this);"> &times;Diesen Abschnitt löschen</a></small> </h4> <p>jMeter ist eine Open-Source-Testsoftware. Es ist eine zu 100 % reine Java-Anwendung, die für Last- und Leistungstests verwendet wird.</p> </div> <div class="section"> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans (EJB) ist eine Entwicklungsarchitektur zum Erstellen hochskalierbarer und leistungsstarker Anwendungen auf Unternehmensebene, die auf J2EE mit kompatiblen Anwendungsservern (wie JBOSS, Web Logic usw.) bereitgestellt werden.</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>Das Spring-Framework ist eine Open-Source-Java-Plattform, die vollständige Infrastrukturunterstützung für die schnelle Entwicklung leistungsstarker Java-Anwendungen bietet.</p> <p>Das Spring-Framework wurde ursprünglich von Rod Johnson geschrieben und im Juni 2003 erstmals unter der Apache 2.0-Lizenz veröffentlicht.</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("Currently you are viewing - " + currentItem); }) });</script>

Selbst ausprobieren »

Das Ergebnis ist wie folgt:

滚动监听(Scrollspy)插件事件


Weitere Beispiele

Erstellen eines horizontalen Scrollspy

Das folgende Beispiel zeigt, wie man einen horizontalen Scrollspy erstellt:

Beispiel

<!-- Die Navigationsleiste: wird verwendet, um zu einem Abschnitt im scrollbaren Bereich zu springen -->
<nav class="navbar navbar-inverse navbar-fixed-top">
...
  <ul class="nav navbar-nav">
    <li><a href="#section1">Abschnitt 1</a></li>
    ...
</nav>

<!-- Der scrollbare Bereich -->
<div data-spy="scroll" data-target=".navbar" data-offset="12">
  <!-- Abschnitt 1 -->
  <div id="section1">
    <h1>Abschnitt 1</h1>
    <p>Versuchen Sie, diese Seite zu scrollen und achten Sie während des Scrollens auf die Navigationsleiste!</p>
  </div>
  ...
</div>

Selbst ausprobieren »

So erstellen Sie einen vertikalen Scrollspy

Das folgende Beispiel zeigt, wie man einen vertikalen Scrollspy erstellt:

Beispiel

<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">Abschnitt 1</a></li>
          ...
        </ul>
      </nav>
      <div class="col-sm-9">
        <div id="section1">
          <h1>Abschnitt 1</h1>
          <p>Versuchen Sie, diese Seite zu scrollen und betrachten Sie die Navigationsliste während des Scrollens!</p>
        </div>
        ...
      </div>
    </div>
  </div>

</body>

Selbst ausprobieren »
Andere Erweiterungen