Bootstrap Плагин Scrollspy

Плагин Scrollspy, то есть плагин автоматически обновляющейся навигации, автоматически обновляет соответствующую цель навигации в зависимости от положения полосы прокрутки. Его базовая реализация заключается в добавлении в панель навигации в зависимости от положения полосы прокрутки при прокрутке..active класс。

Если вы хотите отдельно использовать функциональность этого плагина, вам нужно подключитьscrollspy.js. Или, какОбзор плагинов Bootstrapупомянуто в главе, вы можете подключитьbootstrap.jsили сжатую версиюbootstrap.min.js。

Использование

Вы можете добавить поведение Scrollspy к верхней навигации:

  • Через атрибуты данных: добавьте к элементу, который вы хотите отслеживать (обычно body)data-spy="scroll". Затем добавьте с помощью Bootstrap.navID или атрибут class родительского элемента компонентаdata-target. Чтобы это работало правильно, вы должны убедиться, что элемент, соответствующий ID ссылки, за которой вы хотите следить, существует в body страницы.
    <body data-spy="scroll" data-target=".navbar-example">
    ...
    <div class="navbar-example">
        <ul class="nav nav-tabs">
            ...
        </ul>
    </div>
    ...
    </body>
    
  • Через JavaScript: вы можете вызвать Scrollspy через JavaScript, выбрать элемент для отслеживания, а затем вызвать.scrollspy()функцию:
    $('body').scrollspy({ target: '.navbar-example' })
    

Пример

В следующем примере показано использование плагина 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 — это мобильная операционная система, разработанная и выпущенная Apple Inc. Впервые она была выпущена в 2007 году вместе с оригинальными iPhone, iPod Touch и Apple TV. iOS происходит от OS X, и они разделяют основу Darwin. OS X используется на компьютерах Apple, а iOS — это мобильная версия Apple.</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) — это архитектура разработки для создания высокомасштабируемых и мощных приложений корпоративного уровня, развёртываемых на совместимых с J2EE серверах приложений (таких как JBOSS, Web Logic и т. д.).</p> <h4 id="spring">Spring</h4> <p>Spring Framework — это Java-платформа с открытым исходным кодом, которая обеспечивает комплексную поддержку инфраструктуры для быстрой разработки мощных Java-приложений.</p> <p>Spring Framework был изначально написан Родом Джонсоном и впервые выпущен под лицензией Apache 2.0 в июне 2003 года.</p> </div>

Попробуйте »

Результат показан ниже:

滚动监听(Scrollspy)插件

Параметры

Их можно передавать через атрибуты data или JavaScript. В таблице ниже перечислены эти параметры:

Название параметраТип/Значение по умолчаниюИмя атрибута данныхОписание
offsetчисло
Значение по умолчанию: 10
data-offsetКоличество пикселей для смещения сверху при вычислении позиции прокрутки.

Методы

.scrollspy('refresh'): При вызове метода scrollspy через JavaScript нужно вызвать.refreshметод для обновления DOM. Это очень полезно, когда любой элемент в 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 — мобильная операционная система, разработанная и выпущенная Apple Inc. Изначально выпущена в 2007 году для iPhone, iPod Touch и Apple TV. iOS основана на OS X, и они используют общую основу Darwin. OS X используется на компьютерах Apple, а iOS — мобильная версия Apple.</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) — это архитектура разработки для создания высокомасштабируемых и мощных приложений корпоративного уровня, развертываемых на J2EE с совместимыми серверами приложений (такими как JBOSS, Web Logic и т. д.).</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>Фреймворк Spring — это Java-платформа с открытым исходным кодом, которая обеспечивает полную инфраструктурную поддержку для быстрой разработки мощных Java-приложений.</p> <p>Фреймворк Spring был первоначально написан Родом Джонсоном и впервые выпущен под лицензией Apache 2.0 в июне 2003 года.</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)插件方法

Events

В следующей таблице перечислены события, используемые при отслеживании прокрутки. Эти события можно использовать в качестве хуков в функциях.

EventsОписаниеПример
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 — мобильная операционная система, разработанная и выпущенная Apple Inc. Изначально выпущена в 2007 году для iPhone, iPod Touch и Apple TV. iOS основана на OS X, и они используют общую основу Darwin. OS X используется на компьютерах Apple, а iOS — мобильная версия Apple.</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) — это архитектура разработки для создания высокомасштабируемых и мощных приложений корпоративного уровня, развертываемых на J2EE с совместимыми серверами приложений (такими как JBOSS, Web Logic и т. д.).</p> </div> <div class="section"> <h4 id="spring">Spring</h4> <p>Фреймворк Spring — это Java-платформа с открытым исходным кодом, которая обеспечивает полную инфраструктурную поддержку для быстрой разработки мощных Java-приложений.</p> <p>Фреймворк Spring был первоначально написан Родом Джонсоном и впервые выпущен под лицензией Apache 2.0 в июне 2003 года.</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>

Попробуйте сами »

Результат следующий:

滚动监听(Scrollspy)插件事件


Другие примеры

Создание горизонтального Scrollspy

В следующем примере показано, как создать горизонтальный scrollspy:

Пример

<!-- Панель навигации: используется для перехода к разделу в прокручиваемой области -->
<nav class="navbar navbar-inverse navbar-fixed-top">
...
  <ul class="nav navbar-nav">
    <li><a href="#section1">Раздел 1</a></li>
    ...
</nav>

<!-- Прокручиваемая область -->
<div data-spy="scroll" data-target=".navbar" data-offset="12">
  <!-- Раздел 1 -->
  <div id="section1">
    <h1>Раздел 1</h1>
    <p>Попробуйте прокрутить эту страницу и посмотрите на панель навигации во время прокрутки!</p>
  </div>
  ...
</div>

Попробуйте сами »

Как создать вертикальный Scrollspy

В следующем примере показано, как создать вертикальный scrollspy:

Пример

<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">Раздел 1</a></li>
          ...
        </ul>
      </nav>
      <div class="col-sm-9">
        <div id="section1">
          <h1>Раздел 1</h1>
          <p>Попробуйте прокрутить эту страницу и посмотреть на список навигации во время прокрутки!</p>
        </div>
        ...
      </div>
    </div>
  </div>

</body>

Попробуйте сами »
Другие расширения