Bootstrap Plugin Scrollspy

El plugin Scrollspy, es decir, el plugin de navegación de actualización automática, actualiza automáticamente el destino de navegación correspondiente según la posición de la barra de desplazamiento. Su implementación básica es agregar a la barra de navegación, a medida que usted se desplaza, según la posición de la barra de desplazamiento,.active class。

Si desea citar la funcionalidad de este plugin por separado, entonces necesita referenciarscrollspy.js. O, como se menciona enDescripción general de los plugins de Bootstrapel capítulo, puede referenciarbootstrap.jso la versión comprimida debootstrap.min.js。

Uso

Puede agregar el comportamiento de scrollspy a la navegación superior:

  • Mediante el atributo data: Agregue al elemento que desea monitorear (normalmente body)data-spy="scroll". Luego agregue el atributo con.navla ID o clase del elemento padre del componente Bootstrapdata-target. Para que funcione correctamente, debe asegurarse de que en el cuerpo de la página exista un elemento con la ID que coincida con los enlaces que desea monitorear.
    <body data-spy="scroll" data-target=".navbar-example">
    ...
    <div class="navbar-example">
        <ul class="nav nav-tabs">
            ...
        </ul>
    </div>
    ...
    </body>
    
  • Mediante JavaScript: Puede invocar el scrollspy mediante JavaScript, seleccionar el elemento a monitorear y luego llamar a la.scrollspy()función:
    $('body').scrollspy({ target: '.navbar-example' })
    

Ejemplo

El siguiente ejemplo demuestra el uso del plugin Scrollspy mediante el atributo data:

Ejemplo

<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">Alternar navegación</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">Nombre del tutorial</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 es un sistema operativo móvil desarrollado y publicado por Apple Inc. Fue lanzado por primera vez en 2007 para iPhone, iPod Touch y Apple TV. iOS deriva de OS X, con el que comparte la base Darwin. OS X es el sistema operativo utilizado en las computadoras Apple, e iOS es la versión móvil de Apple.</p> <h4 id="svn">SVN</h4> <p>Apache Subversion, a menudo abreviado como SVN, es un software de sistema de control de versiones de código abierto. Subversion fue creado por CollabNet en 2000. Pero ahora se ha convertido en un proyecto de Apache Software Foundation, por lo que cuenta con una amplia comunidad de desarrolladores y usuarios.</p> <h4 id="jmeter">jMeter</h4> <p>jMeter es un software de pruebas de código abierto. Es una aplicación 100% Java pura, utilizada para pruebas de carga y rendimiento.</p> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans (EJB) es un marco de desarrollo para crear aplicaciones empresariales altamente escalables y potentes, desplegado en J2EE sobre servidores de aplicaciones compatibles (como JBOSS, Web Logic, etc.).</p> <h4 id="spring">Spring</h4> <p>El framework Spring es una plataforma Java de código abierto que proporciona soporte integral de infraestructura para el desarrollo rápido de aplicaciones Java potentes.</p> <p>El framework Spring fue escrito originalmente por Rod Johnson y se lanzó por primera vez en junio de 2003 bajo la licencia Apache 2.0.</p> </div>

Pruébalo »

El resultado se muestra a continuación:

滚动监听(Scrollspy)插件

Opciones

Se pasan mediante el atributo data o JavaScript. La siguiente tabla enumera estas opciones:

Nombre de la opciónTipo/Valor predeterminadoNombre del atributo dataDescripción
offsetnumber
Valor predeterminado: 10
data-offsetEl desplazamiento en píxeles desde la parte superior al calcular la posición de desplazamiento.

Métodos

.scrollspy('refresh'): Cuando invoque el método scrollspy mediante JavaScript, necesita llamar al.refreshmétodo para actualizar el DOM. Esto es muy útil cuando cambia cualquier elemento del DOM (es decir, agrega o elimina ciertos elementos). A continuación se muestra la sintaxis para usar este método.
$('[data-spy="scroll"]').each(function () {
  var $spy = $(this).scrollspy('refresh')
})

Ejemplo

El siguiente ejemplo demuestra.scrollspy('refresh')el uso del método:

Ejemplo

<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">Alternar navegación</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">Nombre del tutorial</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;Eliminar esta sección</a></small> </h4> <p>iOS es un sistema operativo móvil desarrollado y publicado por Apple Inc. Fue lanzado por primera vez en 2007 para iPhone, iPod Touch y Apple TV. iOS deriva de OS X, con el que comparte la base Darwin. OS X es el sistema operativo utilizado en las computadoras Apple, e iOS es la versión móvil de Apple.</p> </div> <div class="section"> <h4 id="svn">SVN<small></small></h4> <p>Apache Subversion, a menudo abreviado como SVN, es un software de sistema de control de versiones de código abierto. Subversion fue creado por CollabNet en 2000. Pero ahora se ha convertido en un proyecto de Apache Software Foundation, por lo que cuenta con una amplia comunidad de desarrolladores y usuarios.</p> </div> <div class="section"> <h4 id="jmeter">jMeter<small><a href="#" onclick="removeSection(this);"> &times;Eliminar esta sección</a></small> </h4> <p>jMeter es un software de pruebas de código abierto. Es una aplicación 100% Java pura, utilizada para pruebas de carga y rendimiento.</p> </div> <div class="section"> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans (EJB) es un marco de desarrollo para crear aplicaciones empresariales altamente escalables y potentes, desplegado en J2EE sobre servidores de aplicaciones compatibles (como JBOSS, Web Logic, etc.).</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>El framework Spring es una plataforma Java de código abierto que proporciona soporte integral de infraestructura para el desarrollo rápido de aplicaciones Java potentes.</p> <p>El framework Spring fue escrito originalmente por Rod Johnson y se lanzó por primera vez en junio de 2003 bajo la licencia 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>

Pruébalo »

El resultado se muestra a continuación:

滚动监听(Scrollspy)插件方法

Eventos

La siguiente tabla enumera los eventos utilizados en el scrollspy. Estos eventos se pueden usar como hooks en funciones.

EventoDescripciónEjemplo
activate.bs.scrollspyEste evento se dispara cada vez que un nuevo elemento es activado por el scrollspy.
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // 执行一些动作...
})

Ejemplo

El siguiente ejemplo demuestraactivate.bs.scrollspyel uso del evento:

Ejemplo

<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">Alternar navegación</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="#">Nombre del tutorial</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;Eliminar esta sección</a></small> </h4> <p>iOS es un sistema operativo móvil desarrollado y publicado por Apple Inc. Fue lanzado por primera vez en 2007 para iPhone, iPod Touch y Apple TV. iOS deriva de OS X, con el que comparte la base Darwin. OS X es el sistema operativo utilizado en las computadoras Apple, e iOS es la versión móvil de Apple.</p> </div> <div class="section"> <h4 id="svn">SVN<small></small></h4> <p>Apache Subversion, a menudo abreviado como SVN, es un software de sistema de control de versiones de código abierto. Subversion fue creado por CollabNet en 2000. Pero ahora se ha convertido en un proyecto de Apache Software Foundation, por lo que cuenta con una amplia comunidad de desarrolladores y usuarios.</p> </div> <div class="section"> <h4 id="jmeter">jMeter<small><a href="#" onclick="removeSection(this);"> &times;Eliminar esta sección</a></small> </h4> <p>jMeter es un software de pruebas de código abierto. Es una aplicación 100% Java pura, utilizada para pruebas de carga y rendimiento.</p> </div> <div class="section"> <h4 id="ejb">EJB</h4> <p>Enterprise Java Beans (EJB) es un marco de desarrollo para crear aplicaciones empresariales altamente escalables y potentes, desplegado en J2EE sobre servidores de aplicaciones compatibles (como JBOSS, Web Logic, etc.).</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>El framework Spring es una plataforma Java de código abierto que proporciona soporte integral de infraestructura para el desarrollo rápido de aplicaciones Java potentes.</p> <p>El framework Spring fue escrito originalmente por Rod Johnson y se lanzó por primera vez en junio de 2003 bajo la licencia 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("Actualmente estás viendo - " + currentItem); }) });</script>

Pruébalo »

El resultado se muestra a continuación:

滚动监听(Scrollspy)插件事件


Más ejemplos

Crear un scrollspy horizontal

El siguiente ejemplo demuestra cómo crear un scrollspy horizontal:

Ejemplo

<!-- 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>

Pruébalo »

Cómo crear un scrollspy vertical

El siguiente ejemplo demuestra cómo crear un scrollspy vertical:

Ejemplo

<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>

Pruébalo »
Otras extensiones