스크롤 청취 플러그인은 스크롤 막대의 위치에 따라 탐색 항목을 자동으로 업데이트하는 데 사용됩니다. 탐색 표시줄 아래 영역을 스크롤하고 탐색 항목의 변경 사항에 주의하세요. 드롭다운 메뉴의 항목도 자동으로 강조 표시됩니다. 이 글에서는 부트스트랩 스크롤 모니터의 기본 사용법을 자세히 소개합니다
스크롤 모니터링 플러그인은 스크롤 위치에 따라 탐색 모음의 해당 탐색 항목을 자동으로 업데이트합니다. 도달한 후 필요할 때 강조 표시 메뉴 상위 요소에 활성 스타일이 추가됩니다
내비게이션에 드롭다운 메뉴가 있고 스크롤 영역의 내용이 드롭다운에 해당하는 영역에 도달하는 경우 메뉴 하위 항목은 하위 메뉴 강조 표시 외에도 하위 메뉴의 상위 요소(드롭다운 버튼)도 강조 표시됩니다.
일반적인 사용에서 스크롤 모니터링은 일반적으로 두 가지 방법으로 사용됩니다. 요소를 스크롤한 후 해당 메뉴를 강조 표시하고, 다른 하나는 전체 페이지(본문)를 강조 표시하여 스크롤 모니터링을 수행합니다. 두 방법의 사용법은 동일하며 다음 세 단계가 필요합니다:
1. 스크롤 컨테이너를 설정합니다. 즉, 요소에 data-target="#selector" data-spy="scroll" 속성을 설정합니다. 모니터링하려는 경우
2, 메뉴 링크 컨테이너를 설정하고, 컨테이너의 ID(또는 스타일)와 data-target 속성에 해당하는 선택기가 일치해야 합니다
3. 메뉴 컨테이너에는 . nav 스타일 요소가 있어야 하며 콘텐츠에 li 요소가 있어야 하며 li에 포함된 a 요소는 강조 표시된 메뉴 링크도 감지할 수 있습니다. 즉, .nav li > a 선택기
4의 조건을 충족합니다. 구현 방법에서 스크롤 모니터링을 위해 모니터링해야 하는 구성 요소는 position:relative;
즉, 상대 위치 지정 방법 position: relative;
即相对定位方式
【固定元素高度】
<div id="myNavbar" class="navbar navbar-default navbar-fixed-top" role="navigation" style="position:relative"> <ul class="nav navbar-nav"><li><a href="#html" tabindex="-1">HTML</a></li><li><a href="#css" tabindex="-1">CSS</a></li><li><a href="#javascript" tabindex="-1">javascript</a></li> </ul></div><div data-spy="scroll" data-target="#myNavbar" style="margin-top:150px;height:250px;overflow:auto;position:relative"><h4 id="html">Html</h4><p>Html内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="css">CSS</h4><p>CSS内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="javascript">javascript</h4><p>javascript内容</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p></div>
【body元素】
<body data-spy="scroll" data-target="#myNavbar" style="height:300px;position:relative"><div id="myNavbar" class="navbar navbar-default navbar-fixed-top" role="navigation"> <ul class="nav navbar-nav"><li><a href="#html" tabindex="-1">HTML</a></li><li><a href="#css" tabindex="-1">CSS</a></li><li><a href="#javascript" tabindex="-1">javascript</a></li> </ul></div><h4 id="html" style="margin-top:150px">Html</h4><p>Html内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="css">CSS</h4><p>CSS内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="javascript">javascript</h4><p>javascript内容</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p></body>
在Bootstrap框架中,使用JavaScript方法触发滚动监控器相对来说较为简单,只需要指定两个容器的名称即可
<div id="myNavbar" class="navbar navbar-default navbar-fixed-top" role="navigation"> <ul class="nav navbar-nav"><li><a href="#html" tabindex="-1">HTML</a></li><li><a href="#css" tabindex="-1">CSS</a></li><li><a href="#javascript" tabindex="-1">javascript</a></li> </ul></div><div id="scrollspy" style="margin-top:150px;height:250px;overflow:auto;position:relative"><h4 id="html">Html</h4><p>Html内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="css">CSS</h4><p>CSS内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="javascript">javascript</h4><p>javascript内容</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p></div><script>$('#scrollspy').scrollspy({ target: '#myNavbar' }) </script>
当使用滚动监听插件的同时在 DOM 中添加或删除元素后,需要像下面这样调用此刷新( refresh) 方法
$('[data-spy="scroll"]').each(function () { var $spy = $(this).scrollspy('refresh') })
要注意的是,这种refresh方法只对声明式用法有效。如果使用的是JS触发,并且需要刷新DOM,则需要重新应用该插件;或者从data-scrollspy属性上获取该实例,然后再调用refresh方法
【参数】
可以通过 data 属性或 JavaScript 传递参数。对于 data 属性,其名称是将参数名附着到 data-
后面组成,例如 data-offset=""
activate.bs.scrollspy 每当一个新条目被激活后都将由滚动监听插件触发此事件。
<div id="myNavbar" class="navbar navbar-default navbar-fixed-top" role="navigation"> <ul class="nav navbar-nav"><li><a href="#html" tabindex="-1">HTML</a></li><li><a href="#css" tabindex="-1">CSS</a></li><li><a href="#javascript" tabindex="-1">javascript</a></li> </ul></div><div id="scrollspy" data-spy="scroll" data-target="#myNavbar" data-offset="0" style="margin-top:150px;height:250px;overflow:auto;position;relative"><h4 id="html">Html</h4><p>Html内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="css">CSS</h4><p>CSS内容</p><br><p>...</p><br><p>...</p><br><p>...</p><h4 id="javascript">javascript</h4><p>javascript内容</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p><br><p>...</p></div><script>$(function(){ $("#myNavbar").on('activate.bs.scrollspy',function(e){ $(e.target).siblings().css('outline','none') .end().css('outline','1px solid black'); }) }) </script>
in Bootstrap 프레임워크에서는 JavaScript 메서드를 사용하여 스크롤 모니터를 트리거하는 것이 비교적 간단합니다. 두 개의 컨테이너 이름만 지정하면 됩니다
+function ($) {//使用es5严格模式'use strict';//}(window.jQuery);
function ScrollSpy(element, options) {this.$body = $(document.body)//判断滚动容器是否是body,如果是则使用window,如果不是则使用该元素本身this.$scrollElement = $(element).is(document.body) ? $(window) : $(element)//将默认值和传进来的options参数合并,后者优先级高this.options = $.extend({}, ScrollSpy.DEFAULTS, options)//如果option里设置了target,即data-target有值,则优先使用//如果没有,则查找通过.nav样式的子元素,即.nav样式内的li子元素内的a链接,作为菜单容器this.selector = (this.options.target || '') + ' .nav li > a'this.offsets = []this.targets = []//高亮显示的菜单this.activeTarget = nullthis.scrollHeight = 0//给滚动容器绑定滚动事件this.$scrollElement.on('scroll.bs.scrollspy', $.proxy(this.process, this))//计算当前页面内所有滚动容器内的id集合和每个id元素距离浏览器顶部的像素距离this.refresh()//开始正式处理this.process() } //版本是3.3.7 ScrollSpy.VERSION = '3.3.7' //默认值为offset:10 ScrollSpy.DEFAULTS = { offset: 10 }
data-
에 매개변수 이름을 추가하여 구성됩니다. 예를 들어 data-offset=""
스크롤링 모니터링은 오프셋 매개변수를 제공합니다. 이 매개변수의 기본값은 10입니다. 기본적으로 스크롤 내용이 스크롤 컨테이너의 10px 이내에 있으면 해당 메뉴 항목이 강조 표시됩니다[이벤트] 스크롤 모니터링은 이벤트 구독 및 트리거 기능도 지원합니다. 현재는 이벤트 활성화
//获取滚动容器的滚动高度 ScrollSpy.prototype.getScrollHeight = function () {//获取特定滚动容器的滚动高度,如果没有则获取body元素的滚动高度return this.$scrollElement[0].scrollHeight || Math.max(this.$body[0].scrollHeight, document.documentElement.scrollHeight) } ScrollSpy.prototype.refresh = function () {var that = thisvar offsetMethod = 'offset'var offsetBase = 0this.offsets = []this.targets = []this.scrollHeight = this.getScrollHeight()if (!$.isWindow(this.$scrollElement[0])) { offsetMethod = 'position' offsetBase = this.$scrollElement.scrollTop() }this.$body .find(this.selector) .map(function () {var $el = $(this)var href = $el.data('target') || $el.attr('href')var $href = /^#./.test(href) && $(href)//返回一个二维数组,每个滚动容器内的id对象到页面顶部的距离以及高亮菜单容器里所对应的href值return ($href && $href.length && $href.is(':visible') && [[$href[offsetMethod]().top + offsetBase, href]]) || null }) .sort(function (a, b) { return a[0] - b[0] }) .each(function () {//收集所有的偏移值,也就是距离top的距离that.offsets.push(this[0])//收集菜单容器里的所有href值,也就是滚动容器里的id值that.targets.push(this[1]) }) } ScrollSpy.prototype.process = function () {//获取滚动容器的scrollTop,再加上设置的offset值var scrollTop = this.$scrollElement.scrollTop() + this.options.offset//获取滚动高度var scrollHeight = this.getScrollHeight()//最大滚动=总scrollheight + 设置的offset值 - 设置高度heightvar maxScroll = this.options.offset + scrollHeight - this.$scrollElement.height()var offsets = this.offsetsvar targets = this.targetsvar activeTarget = this.activeTargetvar iif (this.scrollHeight != scrollHeight) { this.refresh() }//如果超过了最大滚动,说明已经滚动到底了if (scrollTop >= maxScroll) { //如果最后一个元素还没有高亮,则设置最后一个元素高亮 return activeTarget != (i = targets[targets.length - 1]) && this.activate(i) }if (activeTarget && scrollTop < offsets[0]) { this.activeTarget = null return this.clear() }//倒序遍历所有元素的offsetfor (i = offsets.length; i--;) { //如果i元素不等于当前高亮元素 activeTarget != targets[i]//滚动高度 大于 i元素的offsets&& scrollTop >= offsets[i]//i+1元素不存在,或者i+1元素大于滚动高度&& (offsets[i + 1] === undefined || scrollTop < offsets[i + 1])//则设置i为高亮元素&& this.activate(targets[i]) } } //设置高亮菜单元素 ScrollSpy.prototype.activate = function (target) {//赋值实例属性this.activeTarget = targetthis.clear()//查找菜单中符合[data-target+"#' + 所高亮元素的id + '"]属性的元素//或者href值是#' + 所高亮元素的id + '的话,也可以var selector = this.selector + '[data-target="' + target + '"],' + this.selector + '[href="' + target + '"]'//查找父元素li,然后添加active高亮样式var active = $(selector) .parents('li') .addClass('active')//如果li元素的父元素有dropdown-menu样式,则表示是一个dropdown下拉菜单if (active.parent('.dropdown-menu').length) { active = active .closest('li.dropdown')//则需要给dropdown的li元素也加上active高亮样式.addClass('active') }//触发自定义高亮事件active.trigger('activate.bs.scrollspy') } //删除其他高亮元素的active样式 ScrollSpy.prototype.clear = function () { $(this.selector) .parentsUntil(this.options.target, '.active') .removeClass('active') }
function Plugin(option) {//根据选择器,遍历所有符合规则的元素return this.each(function () { var $this = $(this) //获取自定义属性bs.scrollspy的值 var data = $this.data('bs.scrollspy') //如果option参数是对象,则作为ScrollSpy的参数传入 var options = typeof option == 'object' && option //如果值不存在,则将ScrollSpy实例设置为bs.scrollSpy值 if (!data) $this.data('bs.scrollspy', (data = new ScrollSpy(this, options))) //如果option传递了string,则表示要执行某个方法 if (typeof option == 'string') data[option]() }) } var old = $.fn.scrollspy //保留其他库的$.fn.scrollspy代码(如果定义的话),以便在noConflict之后可以继续使用该老代码 $.fn.scrollspy = Plugin //重设插件构造器,可以通过该属性获取插件的真实类函数 $.fn.scrollspy.Constructor = ScrollSpy
$.fn.scrollspy.noConflict = function () { //恢复以前的旧代码$.fn.scrollspy = old//将$.fn.scrollspy.noConflict()设置为Bootstrap的Scrollspy插件return this }
$(window).on('load.bs.scrollspy.data-api', function () {//遍历所有符合条件的滚动容器$('[data-spy="scroll"]').each(function () { var $spy = $(this) //执行scrollspy插件,并传入滚动容器上设置的自定义参数(data-开头) Plugin.call($spy, $spy.data()) }) })
위 내용은 Bootstrap에서 스크롤 모니터 기능 구현의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!