From ddb79f2fcd63e31cb33c5a248e578fe926e4ccad Mon Sep 17 00:00:00 2001 From: Wangder03 Date: Sat, 14 Dec 2024 20:28:15 +0800 Subject: [PATCH] wangd --- WebContent/js/bootstrap.js | 1829 ++++++++++++++++++++---------------- 1 file changed, 1024 insertions(+), 805 deletions(-) diff --git a/WebContent/js/bootstrap.js b/WebContent/js/bootstrap.js index 8a2e99a..e4e17cc 100644 --- a/WebContent/js/bootstrap.js +++ b/WebContent/js/bootstrap.js @@ -4,13 +4,16 @@ * Licensed under the MIT license */ +// 检查是否加载了jQuery，如果没有，则抛出错误 if (typeof jQuery === 'undefined') { throw new Error('Bootstrap\'s JavaScript requires jQuery') } +function ($) { 'use strict'; + // 获取当前页面加载的jQuery版本 var version = $.fn.jquery.split(' ')[0].split('.') + // 如果jQuery版本不符合要求（小于1.9.1或大于3），则抛出错误 if ((version[0] < 2 && version[1] < 9) || (version[0] == 1 && version[1] == 9 && version[2] < 1) || (version[0] > 3)) { throw new Error('Bootstrap\'s JavaScript requires jQuery version 1.9.1 or higher, but lower than version 4') } @@ -24,47 +27,50 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; - // CSS TRANSITION SUPPORT (Shoutout: http://www.modernizr.com/) + // 检查浏览器是否支持CSS过渡 // ============================================================ function transitionEnd() { var el = document.createElement('bootstrap') var transEndEventNames = { - WebkitTransition : 'webkitTransitionEnd', - MozTransition : 'transitionend', - OTransition : 'oTransitionEnd otransitionend', - transition : 'transitionend' + WebkitTransition : 'webkitTransitionEnd', // Safari浏览器 + MozTransition : 'transitionend', // Firefox浏览器 + OTransition : 'oTransitionEnd otransitionend', // Opera浏览器 + transition : 'transitionend' // 标准浏览器 } + // 遍历不同的浏览器前缀，检查支持的过渡事件 for (var name in transEndEventNames) { if (el.style[name] !== undefined) { return { end: transEndEventNames[name] } } } - return false // explicit for ie8 ( ._.) + return false // 如果浏览器不支持过渡（例如IE8），返回false } - // http://blog.alexmaccaw.com/css-transitions + // 模拟过渡结束事件 $.fn.emulateTransitionEnd = function (duration) { var called = false var $el = this + // 绑定过渡结束事件 $(this).one('bsTransitionEnd', function () { called = true }) var callback = function () { if (!called) $($el).trigger($.support.transition.end) } - setTimeout(callback, duration) + setTimeout(callback, duration) // 设置超时时间 return this } $(function () { $.support.transition = transitionEnd() + // 如果不支持过渡，直接返回 if (!$.support.transition) return + // 定义过渡结束事件 $.event.special.bsTransitionEnd = { bindType: $.support.transition.end, delegateType: $.support.transition.end, @@ -84,59 +90,60 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; - // ALERT CLASS DEFINITION + // 定义ALERT类 // ====================== - var dismiss = '[data-dismiss="alert"]' + var dismiss = '[data-dismiss="alert"]' // 关闭按钮的选择器 var Alert = function (el) { - $(el).on('click', dismiss, this.close) + $(el).on('click', dismiss, this.close) // 点击关闭按钮时调用close方法 } Alert.VERSION = '3.3.7' - Alert.TRANSITION_DURATION = 150 + Alert.TRANSITION_DURATION = 150 // 过渡时间 + // 关闭alert的实现 Alert.prototype.close = function (e) { var $this = $(this) - var selector = $this.attr('data-target') + var selector = $this.attr('data-target') // 获取目标元素 + // 如果没有定义target，尝试通过href获取目标 if (!selector) { selector = $this.attr('href') - selector = selector && selector.replace(/.*(?=#[^\s]*$)/, '') // strip for ie7 + selector = selector && selector.replace(/.*(?=#[^\s]*$)/, '') // 为兼容IE7做的处理 } var $parent = $(selector === '#' ? [] : selector) - if (e) e.preventDefault() + if (e) e.preventDefault() // 防止默认事件 if (!$parent.length) { - $parent = $this.closest('.alert') + $parent = $this.closest('.alert') // 如果没有找到目标元素，查找最近的.alert元素 } + // 触发关闭事件 $parent.trigger(e = $.Event('close.bs.alert')) - if (e.isDefaultPrevented()) return + if (e.isDefaultPrevented()) return // 如果关闭事件被取消，则返回 - $parent.removeClass('in') + $parent.removeClass('in') // 移除'in'类，开始过渡效果 function removeElement() { - // detach from parent, fire event then clean up data - $parent.detach().trigger('closed.bs.alert').remove() + $parent.detach().trigger('closed.bs.alert').remove() // 从DOM中移除该alert元素 } + // 如果支持过渡效果，则使用过渡动画移除元素，否则直接移除 $.support.transition && $parent.hasClass('fade') ? - $parent - .one('bsTransitionEnd', removeElement) - .emulateTransitionEnd(Alert.TRANSITION_DURATION) : - removeElement() + $parent + .one('bsTransitionEnd', removeElement) + .emulateTransitionEnd(Alert.TRANSITION_DURATION) : + removeElement() } - - // ALERT PLUGIN DEFINITION + // 定义Alert插件 // ======================= function Plugin(option) { @@ -145,7 +152,7 @@ if (typeof jQuery === 'undefined') { var data = $this.data('bs.alert') if (!data) $this.data('bs.alert', (data = new Alert(this))) - if (typeof option == 'string') data[option].call($this) + if (typeof option == 'string') data[option].call($this) // 调用Alert的方法 }) } @@ -154,7 +161,6 @@ if (typeof jQuery === 'undefined') { $.fn.alert = Plugin $.fn.alert.Constructor = Alert - // ALERT NO CONFLICT // ================= @@ -163,11 +169,10 @@ if (typeof jQuery === 'undefined') { return this } - // ALERT DATA-API // ============== - $(document).on('click.bs.alert.data-api', dismiss, Alert.prototype.close) + $(document).on('click.bs.alert.data-api', dismiss, Alert.prototype.close) // 绑定关闭事件 }(jQuery); @@ -179,36 +184,36 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; - // BUTTON PUBLIC CLASS DEFINITION + // BUTTON公共类定义 // ============================== var Button = function (element, options) { this.$element = $(element) this.options = $.extend({}, Button.DEFAULTS, options) - this.isLoading = false + this.isLoading = false // 按钮的加载状态 } Button.VERSION = '3.3.7' Button.DEFAULTS = { - loadingText: 'loading...' + loadingText: 'loading...' // 加载中的文字 } + // 设置按钮的状态 Button.prototype.setState = function (state) { - var d = 'disabled' + var d = 'disabled' // 禁用状态 var $el = this.$element - var val = $el.is('input') ? 'val' : 'html' + var val = $el.is('input') ? 'val' : 'html' // 判断按钮类型 var data = $el.data() state += 'Text' - if (data.resetText == null) $el.data('resetText', $el[val]()) + if (data.resetText == null) $el.data('resetText', $el[val]()) // 记录初始文本 - // push to event loop to allow forms to submit + // 延时更新按钮文本，并根据状态启用或禁用按钮 setTimeout($.proxy(function () { $el[val](data[state] == null ? this.options[state] : data[state]) @@ -222,6 +227,7 @@ if (typeof jQuery === 'undefined') { }, this), 0) } + // 切换按钮的状态（激活/取消激活） Button.prototype.toggle = function () { var changed = true var $parent = this.$element.closest('[data-toggle="buttons"]') @@ -244,8 +250,7 @@ if (typeof jQuery === 'undefined') { } } - - // BUTTON PLUGIN DEFINITION + // BUTTON插件定义 // ======================== function Plugin(option) { @@ -256,8 +261,8 @@ if (typeof jQuery === 'undefined') { if (!data) $this.data('bs.button', (data = new Button(this, options))) - if (option == 'toggle') data.toggle() - else if (option) data.setState(option) + if (option == 'toggle') data.toggle() // 切换按钮状态 + else if (option) data.setState(option) // 设置按钮状态 }) } @@ -266,8 +271,7 @@ if (typeof jQuery === 'undefined') { $.fn.button = Plugin $.fn.button.Constructor = Button - - // BUTTON NO CONFLICT + // BUTTON无冲突模式 // ================== $.fn.button.noConflict = function () { @@ -275,25 +279,24 @@ if (typeof jQuery === 'undefined') { return this } - // BUTTON DATA-API // =============== $(document) - .on('click.bs.button.data-api', '[data-toggle^="button"]', function (e) { - var $btn = $(e.target).closest('.btn') - Plugin.call($btn, 'toggle') - if (!($(e.target).is('input[type="radio"], input[type="checkbox"]'))) { - // Prevent double click on radios, and the double selections (so cancellation) on checkboxes - e.preventDefault() - // The target component still receive the focus - if ($btn.is('input,button')) $btn.trigger('focus') - else $btn.find('input:visible,button:visible').first().trigger('focus') - } - }) - .on('focus.bs.button.data-api blur.bs.button.data-api', '[data-toggle^="button"]', function (e) { - $(e.target).closest('.btn').toggleClass('focus', /^focus(in)?$/.test(e.type)) - }) + .on('click.bs.button.data-api', '[data-toggle^="button"]', function (e) { + var $btn = $(e.target).closest('.btn') + Plugin.call($btn, 'toggle') + if (!($(e.target).is('input[type="radio"], input[type="checkbox"]'))) { + // 防止单选框和复选框的双击和多选（取消选择） + e.preventDefault() + // 让目标组件接收到焦点 + if ($btn.is('input,button')) $btn.trigger('focus') + else $btn.find('input:visible,button:visible').first().trigger('focus') + } + }) + .on('focus.bs.button.data-api blur.bs.button.data-api', '[data-toggle^="button"]', function (e) { + $(e.target).closest('.btn').toggleClass('focus', /^focus(in)?$/.test(e.type)) // 添加焦点样式 + }) }(jQuery); @@ -304,232 +307,242 @@ if (typeof jQuery === 'undefined') { * Copyright 2011-2016 Twitter, Inc. * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - - +function ($) { 'use strict'; - // CAROUSEL CLASS DEFINITION + // CAROUSEL 类定义 // ========================= var Carousel = function (element, options) { - this.$element = $(element) - this.$indicators = this.$element.find('.carousel-indicators') - this.options = options - this.paused = null - this.sliding = null - this.interval = null - this.$active = null - this.$items = null - + this.$element = $(element) // 获取carousel元素 + this.$indicators = this.$element.find('.carousel-indicators') // 获取carousel指示器（例如：小圆点） + this.options = options // 存储配置选项 + this.paused = null // 暂停状态 + this.sliding = null // 滑动状态 + this.interval = null // 自动切换间隔 + this.$active = null // 当前活动项 + this.$items = null // 所有的carousel项 + + // 如果启用了键盘控制，监听按键事件 this.options.keyboard && this.$element.on('keydown.bs.carousel', $.proxy(this.keydown, this)) + // 如果暂停选项为'hover'，并且当前设备不支持触摸事件，设置鼠标悬停事件来暂停/恢复轮播 this.options.pause == 'hover' && !('ontouchstart' in document.documentElement) && this.$element - .on('mouseenter.bs.carousel', $.proxy(this.pause, this)) - .on('mouseleave.bs.carousel', $.proxy(this.cycle, this)) + .on('mouseenter.bs.carousel', $.proxy(this.pause, this)) // 鼠标进入时暂停 + .on('mouseleave.bs.carousel', $.proxy(this.cycle, this)) // 鼠标离开时恢复轮播 } - Carousel.VERSION = '3.3.7' + Carousel.VERSION = '3.3.7' // 版本信息 - Carousel.TRANSITION_DURATION = 600 + Carousel.TRANSITION_DURATION = 600 // 过渡持续时间（毫秒） Carousel.DEFAULTS = { - interval: 5000, - pause: 'hover', - wrap: true, - keyboard: true + interval: 5000, // 默认切换时间间隔（毫秒） + pause: 'hover', // 鼠标悬停时暂停 + wrap: true, // 是否循环轮播 + keyboard: true // 是否启用键盘控制 } + // 键盘事件处理 Carousel.prototype.keydown = function (e) { - if (/input|textarea/i.test(e.target.tagName)) return + if (/input|textarea/i.test(e.target.tagName)) return // 如果焦点在输入框或文本区域上，不处理 switch (e.which) { - case 37: this.prev(); break - case 39: this.next(); break + case 37: this.prev(); break // 左箭头 + case 39: this.next(); break // 右箭头 default: return } - e.preventDefault() + e.preventDefault() // 阻止默认行为 } + // 开始自动轮播 Carousel.prototype.cycle = function (e) { - e || (this.paused = false) + e || (this.paused = false) // 如果没有传入事件，恢复未暂停状态 + // 清除现有的interval this.interval && clearInterval(this.interval) + // 如果设置了自动切换并且没有暂停，重新启动自动轮播 this.options.interval - && !this.paused - && (this.interval = setInterval($.proxy(this.next, this), this.options.interval)) + && !this.paused + && (this.interval = setInterval($.proxy(this.next, this), this.options.interval)) return this } + // 获取当前项在所有项中的索引 Carousel.prototype.getItemIndex = function (item) { - this.$items = item.parent().children('.item') - return this.$items.index(item || this.$active) + this.$items = item.parent().children('.item') // 获取所有项 + return this.$items.index(item || this.$active) // 返回索引 } + // 获取用于切换方向的下一项 Carousel.prototype.getItemForDirection = function (direction, active) { - var activeIndex = this.getItemIndex(active) - var willWrap = (direction == 'prev' && activeIndex === 0) - || (direction == 'next' && activeIndex == (this.$items.length - 1)) - if (willWrap && !this.options.wrap) return active - var delta = direction == 'prev' ? -1 : 1 - var itemIndex = (activeIndex + delta) % this.$items.length - return this.$items.eq(itemIndex) + var activeIndex = this.getItemIndex(active) // 获取当前活动项的索引 + var willWrap = (direction == 'prev' && activeIndex === 0) // 是否回绕到最后一项 + || (direction == 'next' && activeIndex == (this.$items.length - 1)) // 是否回绕到第一项 + if (willWrap && !this.options.wrap) return active // 如果不循环，返回当前项 + var delta = direction == 'prev' ? -1 : 1 // 根据方向计算索引增量 + var itemIndex = (activeIndex + delta) % this.$items.length // 计算下一项的索引 + return this.$items.eq(itemIndex) // 返回下一项 } + // 跳转到指定位置 Carousel.prototype.to = function (pos) { var that = this - var activeIndex = this.getItemIndex(this.$active = this.$element.find('.item.active')) + var activeIndex = this.getItemIndex(this.$active = this.$element.find('.item.active')) // 获取当前活动项的索引 - if (pos > (this.$items.length - 1) || pos < 0) return + if (pos > (this.$items.length - 1) || pos < 0) return // 如果位置超出范围，返回 - if (this.sliding) return this.$element.one('slid.bs.carousel', function () { that.to(pos) }) // yes, "slid" - if (activeIndex == pos) return this.pause().cycle() + if (this.sliding) return this.$element.one('slid.bs.carousel', function () { that.to(pos) }) // 如果正在滑动，等待滑动完成后再跳转 + if (activeIndex == pos) return this.pause().cycle() // 如果目标位置是当前项，暂停并重新开始自动轮播 - return this.slide(pos > activeIndex ? 'next' : 'prev', this.$items.eq(pos)) + return this.slide(pos > activeIndex ? 'next' : 'prev', this.$items.eq(pos)) // 根据位置切换方向 } + // 暂停轮播 Carousel.prototype.pause = function (e) { - e || (this.paused = true) + e || (this.paused = true) // 如果没有传入事件，设置为暂停状态 + // 如果有过渡效果，触发过渡结束 if (this.$element.find('.next, .prev').length && $.support.transition) { this.$element.trigger($.support.transition.end) - this.cycle(true) + this.cycle(true) // 暂停后重新开始 } - this.interval = clearInterval(this.interval) + this.interval = clearInterval(this.interval) // 清除间隔 return this } + // 切换到下一项 Carousel.prototype.next = function () { - if (this.sliding) return - return this.slide('next') + if (this.sliding) return // 如果正在滑动，返回 + return this.slide('next') // 切换到下一项 } + // 切换到上一项 Carousel.prototype.prev = function () { - if (this.sliding) return - return this.slide('prev') + if (this.sliding) return // 如果正在滑动，返回 + return this.slide('prev') // 切换到上一项 } + // 执行滑动操作 Carousel.prototype.slide = function (type, next) { - var $active = this.$element.find('.item.active') - var $next = next || this.getItemForDirection(type, $active) - var isCycling = this.interval - var direction = type == 'next' ? 'left' : 'right' + var $active = this.$element.find('.item.active') // 当前活动项 + var $next = next || this.getItemForDirection(type, $active) // 获取下一项 + var isCycling = this.interval // 是否正在自动轮播 + var direction = type == 'next' ? 'left' : 'right' // 根据方向设置过渡方向 var that = this - if ($next.hasClass('active')) return (this.sliding = false) + if ($next.hasClass('active')) return (this.sliding = false) // 如果下一项已经是活动项，返回 var relatedTarget = $next[0] var slideEvent = $.Event('slide.bs.carousel', { relatedTarget: relatedTarget, direction: direction }) - this.$element.trigger(slideEvent) - if (slideEvent.isDefaultPrevented()) return + this.$element.trigger(slideEvent) // 触发slide事件 + if (slideEvent.isDefaultPrevented()) return // 如果事件被取消，返回 - this.sliding = true + this.sliding = true // 设置为滑动状态 - isCycling && this.pause() + isCycling && this.pause() // 如果正在轮播，先暂停 + // 更新指示器状态 if (this.$indicators.length) { this.$indicators.find('.active').removeClass('active') - var $nextIndicator = $(this.$indicators.children()[this.getItemIndex($next)]) + var $nextIndicator = $(this.$indicators.children()[this.getItemIndex($next)]) // 获取下一项的指示器 $nextIndicator && $nextIndicator.addClass('active') } - var slidEvent = $.Event('slid.bs.carousel', { relatedTarget: relatedTarget, direction: direction }) // yes, "slid" + var slidEvent = $.Event('slid.bs.carousel', { relatedTarget: relatedTarget, direction: direction }) // 滑动完成事件 if ($.support.transition && this.$element.hasClass('slide')) { - $next.addClass(type) - $next[0].offsetWidth // force reflow - $active.addClass(direction) - $next.addClass(direction) + $next.addClass(type) // 给下一项添加过渡类型 + $next[0].offsetWidth // 强制重排 + $active.addClass(direction) // 给当前项添加方向类 + $next.addClass(direction) // 给下一项添加方向类 $active - .one('bsTransitionEnd', function () { - $next.removeClass([type, direction].join(' ')).addClass('active') - $active.removeClass(['active', direction].join(' ')) - that.sliding = false - setTimeout(function () { - that.$element.trigger(slidEvent) - }, 0) - }) - .emulateTransitionEnd(Carousel.TRANSITION_DURATION) + .one('bsTransitionEnd', function () { + $next.removeClass([type, direction].join(' ')).addClass('active') // 移除过渡效果，设置为活动项 + $active.removeClass(['active', direction].join(' ')) // 移除活动状态 + that.sliding = false // 重置滑动状态 + setTimeout(function () { + that.$element.trigger(slidEvent) // 触发滑动完成事件 + }, 0) + }) + .emulateTransitionEnd(Carousel.TRANSITION_DURATION) // 模拟过渡结束 } else { - $active.removeClass('active') + $active.removeClass('active') // 直接切换，不使用过渡效果 $next.addClass('active') this.sliding = false - this.$element.trigger(slidEvent) + this.$element.trigger(slidEvent) // 触发滑动完成事件 } - isCycling && this.cycle() + isCycling && this.cycle() // 如果正在轮播，重新开始 return this } - - // CAROUSEL PLUGIN DEFINITION + // CAROUSEL 插件定义 // ========================== function Plugin(option) { return this.each(function () { var $this = $(this) - var data = $this.data('bs.carousel') - var options = $.extend({}, Carousel.DEFAULTS, $this.data(), typeof option == 'object' && option) - var action = typeof option == 'string' ? option : options.slide - - if (!data) $this.data('bs.carousel', (data = new Carousel(this, options))) - if (typeof option == 'number') data.to(option) - else if (action) data[action]() - else if (options.interval) data.pause().cycle() + var data = $this.data('bs.carousel') // 获取现有实例 + var options = $.extend({}, Carousel.DEFAULTS, $this.data(), typeof option == 'object' && option) // 合并配置 + var action = typeof option == 'string' ? option : options.slide // 获取操作类型 + + if (!data) $this.data('bs.carousel', (data = new Carousel(this, options))) // 如果没有实例，创建一个新的实例 + if (typeof option == 'number') data.to(option) // 如果是数字，跳转到指定位置 + else if (action) data[action]() // 如果是字符串，执行相应操作 + else if (options.interval) data.pause().cycle() // 如果有interval，暂停并启动自动轮播 }) } - var old = $.fn.carousel - - $.fn.carousel = Plugin - $.fn.carousel.Constructor = Carousel + var old = $.fn.carousel // 保存之前的插件定义 + $.fn.carousel = Plugin // 替换插件方法 + $.fn.carousel.Constructor = Carousel // 设置构造函数 - // CAROUSEL NO CONFLICT + // CAROUSEL 不冲突模式 // ==================== $.fn.carousel.noConflict = function () { - $.fn.carousel = old + $.fn.carousel = old // 恢复原来的插件定义 return this } - - // CAROUSEL DATA-API + // CAROUSEL 数据API // ================= var clickHandler = function (e) { var href var $this = $(this) - var $target = $($this.attr('data-target') || (href = $this.attr('href')) && href.replace(/.*(?=#[^\s]+$)/, '')) // strip for ie7 - if (!$target.hasClass('carousel')) return - var options = $.extend({}, $target.data(), $this.data()) - var slideIndex = $this.attr('data-slide-to') - if (slideIndex) options.interval = false + var $target = $($this.attr('data-target') || (href = $this.attr('href')) && href.replace(/.*(?=#[^\s]+$)/, '')) // 获取目标元素 + if (!$target.hasClass('carousel')) return // 如果目标不是carousel，返回 + var options = $.extend({}, $target.data(), $this.data()) // 合并配置选项 + var slideIndex = $this.attr('data-slide-to') // 获取数据属性中的slide索引 + if (slideIndex) options.interval = false // 禁用自动切换 - Plugin.call($target, options) + Plugin.call($target, options) // 调用插件 if (slideIndex) { - $target.data('bs.carousel').to(slideIndex) + $target.data('bs.carousel').to(slideIndex) // 跳转到指定位置 } - e.preventDefault() + e.preventDefault() // 阻止默认行为 } $(document) - .on('click.bs.carousel.data-api', '[data-slide]', clickHandler) - .on('click.bs.carousel.data-api', '[data-slide-to]', clickHandler) + .on('click.bs.carousel.data-api', '[data-slide]', clickHandler) // 监听点击事件 + .on('click.bs.carousel.data-api', '[data-slide-to]', clickHandler) // 监听点击事件 $(window).on('load', function () { $('[data-ride="carousel"]').each(function () { var $carousel = $(this) - Plugin.call($carousel, $carousel.data()) + Plugin.call($carousel, $carousel.data()) // 初始化所有的carousel元素 }) }) @@ -544,206 +557,215 @@ if (typeof jQuery === 'undefined') { * ======================================================================== */ /* jshint latedef: false */ - +function ($) { 'use strict'; - // COLLAPSE PUBLIC CLASS DEFINITION + // COLLAPSE 公共类定义 // ================================ var Collapse = function (element, options) { - this.$element = $(element) - this.options = $.extend({}, Collapse.DEFAULTS, options) - this.$trigger = $('[data-toggle="collapse"][href="#' + element.id + '"],' + - '[data-toggle="collapse"][data-target="#' + element.id + '"]') - this.transitioning = null + this.$element = $(element) // 获取目标元素 + this.options = $.extend({}, Collapse.DEFAULTS, options) // 合并默认配置和传入的配置 + this.$trigger = $('[data-toggle="collapse"][href="#' + element.id + '"],' + // 获取触发 collapse 的元素 + '[data-toggle="collapse"][data-target="#' + element.id + '"]') + this.transitioning = null // 初始化过渡状态 if (this.options.parent) { - this.$parent = this.getParent() + this.$parent = this.getParent() // 如果设置了 parent，获取父元素 } else { - this.addAriaAndCollapsedClass(this.$element, this.$trigger) + this.addAriaAndCollapsedClass(this.$element, this.$trigger) // 向元素和触发器添加 aria 属性和 collapsed 类 } - if (this.options.toggle) this.toggle() + if (this.options.toggle) this.toggle() // 如果 toggle 为 true，则自动调用 toggle 方法 } - Collapse.VERSION = '3.3.7' + Collapse.VERSION = '3.3.7' // 版本信息 - Collapse.TRANSITION_DURATION = 350 + Collapse.TRANSITION_DURATION = 350 // 过渡持续时间（毫秒） Collapse.DEFAULTS = { - toggle: true + toggle: true // 默认启用 toggle } + // 获取维度（宽度或高度） Collapse.prototype.dimension = function () { - var hasWidth = this.$element.hasClass('width') - return hasWidth ? 'width' : 'height' + var hasWidth = this.$element.hasClass('width') // 判断是否为宽度 + return hasWidth ? 'width' : 'height' // 返回宽度或高度 } + // 展开方法 Collapse.prototype.show = function () { - if (this.transitioning || this.$element.hasClass('in')) return + if (this.transitioning || this.$element.hasClass('in')) return // 如果正在过渡或已经展开，返回 var activesData - var actives = this.$parent && this.$parent.children('.panel').children('.in, .collapsing') + var actives = this.$parent && this.$parent.children('.panel').children('.in, .collapsing') // 获取所有正在展开或过渡中的元素 if (actives && actives.length) { - activesData = actives.data('bs.collapse') - if (activesData && activesData.transitioning) return + activesData = actives.data('bs.collapse') // 获取活动元素的 collapse 数据 + if (activesData && activesData.transitioning) return // 如果活动元素正在过渡，返回 } - var startEvent = $.Event('show.bs.collapse') + var startEvent = $.Event('show.bs.collapse') // 触发 show 事件 this.$element.trigger(startEvent) - if (startEvent.isDefaultPrevented()) return + if (startEvent.isDefaultPrevented()) return // 如果事件被取消，返回 + // 如果有其他活动项，先将它们隐藏 if (actives && actives.length) { Plugin.call(actives, 'hide') activesData || actives.data('bs.collapse', null) } - var dimension = this.dimension() + var dimension = this.dimension() // 获取维度（宽度或高度） this.$element - .removeClass('collapse') - .addClass('collapsing')[dimension](0) - .attr('aria-expanded', true) + .removeClass('collapse') // 移除 collapse 类 + .addClass('collapsing') // 添加 collapsing 类 + // 设置初始高度或宽度为 0 + .attr('aria-expanded', true) // 设置 aria-expanded 属性为 true this.$trigger - .removeClass('collapsed') - .attr('aria-expanded', true) + .removeClass('collapsed') // 移除 collapsed 类 + .attr('aria-expanded', true) // 设置 aria-expanded 属性为 true - this.transitioning = 1 + this.transitioning = 1 // 设置过渡状态为 1 var complete = function () { this.$element - .removeClass('collapsing') - .addClass('collapse in')[dimension]('') - this.transitioning = 0 + .removeClass('collapsing') // 移除 collapsing 类 + .addClass('collapse in') // 添加 collapse 和 in 类 + [dimension]('') // 恢复元素的原始维度 + this.transitioning = 0 // 重置过渡状态 this.$element - .trigger('shown.bs.collapse') + .trigger('shown.bs.collapse') // 触发 shown 事件 } - if (!$.support.transition) return complete.call(this) + if (!$.support.transition) return complete.call(this) // 如果不支持过渡，直接调用 complete - var scrollSize = $.camelCase(['scroll', dimension].join('-')) + var scrollSize = $.camelCase(['scroll', dimension].join('-')) // 获取滚动大小 this.$element - .one('bsTransitionEnd', $.proxy(complete, this)) - .emulateTransitionEnd(Collapse.TRANSITION_DURATION)[dimension](this.$element[0][scrollSize]) + .one('bsTransitionEnd', $.proxy(complete, this)) // 在过渡结束时触发 complete + .emulateTransitionEnd(Collapse.TRANSITION_DURATION) // 模拟过渡结束 + [dimension](this.$element[0][scrollSize]) // 设置滚动尺寸 } + // 收起方法 Collapse.prototype.hide = function () { - if (this.transitioning || !this.$element.hasClass('in')) return + if (this.transitioning || !this.$element.hasClass('in')) return // 如果正在过渡或没有展开，返回 - var startEvent = $.Event('hide.bs.collapse') + var startEvent = $.Event('hide.bs.collapse') // 触发 hide 事件 this.$element.trigger(startEvent) - if (startEvent.isDefaultPrevented()) return + if (startEvent.isDefaultPrevented()) return // 如果事件被取消，返回 - var dimension = this.dimension() + var dimension = this.dimension() // 获取维度（宽度或高度） - this.$element[dimension](this.$element[dimension]())[0].offsetHeight + this.$element[dimension](this.$element[dimension]())[0].offsetHeight // 强制重排 this.$element - .addClass('collapsing') - .removeClass('collapse in') - .attr('aria-expanded', false) + .addClass('collapsing') // 添加 collapsing 类 + .removeClass('collapse in') // 移除 collapse 和 in 类 + .attr('aria-expanded', false) // 设置 aria-expanded 属性为 false this.$trigger - .addClass('collapsed') - .attr('aria-expanded', false) + .addClass('collapsed') // 添加 collapsed 类 + .attr('aria-expanded', false) // 设置 aria-expanded 属性为 false - this.transitioning = 1 + this.transitioning = 1 // 设置过渡状态为 1 var complete = function () { - this.transitioning = 0 + this.transitioning = 0 // 重置过渡状态 this.$element - .removeClass('collapsing') - .addClass('collapse') - .trigger('hidden.bs.collapse') + .removeClass('collapsing') // 移除 collapsing 类 + .addClass('collapse') // 添加 collapse 类 + .trigger('hidden.bs.collapse') // 触发 hidden 事件 } - if (!$.support.transition) return complete.call(this) + if (!$.support.transition) return complete.call(this) // 如果不支持过渡，直接调用 complete this.$element - [dimension](0) - .one('bsTransitionEnd', $.proxy(complete, this)) - .emulateTransitionEnd(Collapse.TRANSITION_DURATION) + // 设置维度为 0 + .one('bsTransitionEnd', $.proxy(complete, this)) // 在过渡结束时触发 complete + .emulateTransitionEnd(Collapse.TRANSITION_DURATION) // 模拟过渡结束 } + // 切换展开和收起状态 Collapse.prototype.toggle = function () { - this[this.$element.hasClass('in') ? 'hide' : 'show']() + this[this.$element.hasClass('in') ? 'hide' : 'show']() // 如果已经展开则收起，否则展开 } + // 获取父元素（用于手风琴效果） Collapse.prototype.getParent = function () { - return $(this.options.parent) - .find('[data-toggle="collapse"][data-parent="' + this.options.parent + '"]') - .each($.proxy(function (i, element) { - var $element = $(element) - this.addAriaAndCollapsedClass(getTargetFromTrigger($element), $element) - }, this)) - .end() + return $(this.options.parent) // 获取父元素 + .find('[data-toggle="collapse"][data-parent="' + this.options.parent + '"]') // 查找子元素 + .each($.proxy(function (i, element) { + var $element = $(element) + this.addAriaAndCollapsedClass(getTargetFromTrigger($element), $element) // 为目标元素添加 aria 和 collapsed 类 + }, this)) + .end() } + // 向元素和触发器添加 aria 属性和 collapsed 类 Collapse.prototype.addAriaAndCollapsedClass = function ($element, $trigger) { - var isOpen = $element.hasClass('in') + var isOpen = $element.hasClass('in') // 判断元素是否展开 - $element.attr('aria-expanded', isOpen) + $element.attr('aria-expanded', isOpen) // 设置 aria-expanded 属性 $trigger - .toggleClass('collapsed', !isOpen) - .attr('aria-expanded', isOpen) + .toggleClass('collapsed', !isOpen) // 如果元素未展开，添加 collapsed 类 + .attr('aria-expanded', isOpen) // 设置 aria-expanded 属性 } + // 获取触发器对应的目标元素 function getTargetFromTrigger($trigger) { var href - var target = $trigger.attr('data-target') - || (href = $trigger.attr('href')) && href.replace(/.*(?=#[^\s]+$)/, '') // strip for ie7 - - return $(target) + var target = $trigger.attr('data-target') // 获取 data-target 属性 + || (href = $trigger.attr('href')) && href.replace(/.*(?=#[^\s]+$)/, '') // 如果没有 data-target，使用 href + return $(target) // 返回目标元素 } - // COLLAPSE PLUGIN DEFINITION + // COLLAPSE 插件定义 // ========================== function Plugin(option) { return this.each(function () { var $this = $(this) - var data = $this.data('bs.collapse') - var options = $.extend({}, Collapse.DEFAULTS, $this.data(), typeof option == 'object' && option) + var data = $this.data('bs.collapse') // 获取现有的 collapse 实例 + var options = $.extend({}, Collapse.DEFAULTS, $this.data(), typeof option == 'object' && option) // 合并默认配置和传入的配置 - if (!data && options.toggle && /show|hide/.test(option)) options.toggle = false - if (!data) $this.data('bs.collapse', (data = new Collapse(this, options))) - if (typeof option == 'string') data[option]() + if (!data && options.toggle && /show|hide/.test(option)) options.toggle = false // 如果没有实例且 option 是 'show' 或 'hide'，则禁用 toggle + if (!data) $this.data('bs.collapse', (data = new Collapse(this, options))) // 如果没有实例，创建新实例 + if (typeof option == 'string') data[option]() // 如果 option 是字符串，调用对应的方法 }) } - var old = $.fn.collapse + var old = $.fn.collapse // 保存原始的 collapse 方法 - $.fn.collapse = Plugin - $.fn.collapse.Constructor = Collapse + $.fn.collapse = Plugin // 替换为新的 Plugin 方法 + $.fn.collapse.Constructor = Collapse // 设置构造函数为 Collapse - // COLLAPSE NO CONFLICT + // COLLAPSE 不冲突模式 // ==================== $.fn.collapse.noConflict = function () { - $.fn.collapse = old + $.fn.collapse = old // 恢复原来的 collapse 方法 return this } - // COLLAPSE DATA-API + // COLLAPSE 数据API // ================= $(document).on('click.bs.collapse.data-api', '[data-toggle="collapse"]', function (e) { var $this = $(this) - if (!$this.attr('data-target')) e.preventDefault() + if (!$this.attr('data-target')) e.preventDefault() // 如果没有 data-target，阻止默认行为 - var $target = getTargetFromTrigger($this) - var data = $target.data('bs.collapse') - var option = data ? 'toggle' : $this.data() + var $target = getTargetFromTrigger($this) // 获取目标元素 + var data = $target.data('bs.collapse') // 获取 collapse 数据 + var option = data ? 'toggle' : $this.data() // 如果已有实例，则执行 toggle，否则使用传入的配置 - Plugin.call($target, option) + Plugin.call($target, option) // 调用 Plugin }) }(jQuery); @@ -756,161 +778,164 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; - // DROPDOWN CLASS DEFINITION + // DROPDOWN 类定义 // ========================= - var backdrop = '.dropdown-backdrop' - var toggle = '[data-toggle="dropdown"]' + var backdrop = '.dropdown-backdrop' // 定义背景遮罩类名 + var toggle = '[data-toggle="dropdown"]' // 定义触发 dropdown 的元素选择器 var Dropdown = function (element) { - $(element).on('click.bs.dropdown', this.toggle) + $(element).on('click.bs.dropdown', this.toggle) // 为点击事件绑定 toggle 方法 } - Dropdown.VERSION = '3.3.7' + Dropdown.VERSION = '3.3.7' // 版本信息 + // 获取父元素 function getParent($this) { - var selector = $this.attr('data-target') + var selector = $this.attr('data-target') // 获取 data-target 属性 if (!selector) { - selector = $this.attr('href') - selector = selector && /#[A-Za-z]/.test(selector) && selector.replace(/.*(?=#[^\s]*$)/, '') // strip for ie7 + selector = $this.attr('href') // 如果没有 data-target，使用 href 属性 + selector = selector && /#[A-Za-z]/.test(selector) && selector.replace(/.*(?=#[^\s]*$)/, '') // 对 IE7 进行兼容处理 } - var $parent = selector && $(selector) + var $parent = selector && $(selector) // 获取目标元素 - return $parent && $parent.length ? $parent : $this.parent() + return $parent && $parent.length ? $parent : $this.parent() // 返回父元素，如果没有找到则返回当前元素的父级 } + // 清除菜单（关闭所有打开的下拉菜单） function clearMenus(e) { - if (e && e.which === 3) return - $(backdrop).remove() + if (e && e.which === 3) return // 如果点击的是右键，则不关闭菜单 + $(backdrop).remove() // 移除背景遮罩 $(toggle).each(function () { var $this = $(this) - var $parent = getParent($this) + var $parent = getParent($this) // 获取父元素 var relatedTarget = { relatedTarget: this } - if (!$parent.hasClass('open')) return + if (!$parent.hasClass('open')) return // 如果菜单没有展开，返回 - if (e && e.type == 'click' && /input|textarea/i.test(e.target.tagName) && $.contains($parent[0], e.target)) return + if (e && e.type == 'click' && /input|textarea/i.test(e.target.tagName) && $.contains($parent[0], e.target)) return // 点击在输入框或文本区内，则不关闭 - $parent.trigger(e = $.Event('hide.bs.dropdown', relatedTarget)) + $parent.trigger(e = $.Event('hide.bs.dropdown', relatedTarget)) // 触发隐藏事件 - if (e.isDefaultPrevented()) return + if (e.isDefaultPrevented()) return // 如果默认行为被阻止，则返回 - $this.attr('aria-expanded', 'false') - $parent.removeClass('open').trigger($.Event('hidden.bs.dropdown', relatedTarget)) + $this.attr('aria-expanded', 'false') // 更新 aria-expanded 属性 + $parent.removeClass('open').trigger($.Event('hidden.bs.dropdown', relatedTarget)) // 移除 open 类，并触发 hidden 事件 }) } + // 切换下拉菜单的显示状态 Dropdown.prototype.toggle = function (e) { var $this = $(this) - if ($this.is('.disabled, :disabled')) return + if ($this.is('.disabled, :disabled')) return // 如果元素被禁用，返回 - var $parent = getParent($this) - var isActive = $parent.hasClass('open') + var $parent = getParent($this) // 获取父元素 + var isActive = $parent.hasClass('open') // 判断当前菜单是否处于打开状态 - clearMenus() + clearMenus() // 关闭其他打开的菜单 if (!isActive) { if ('ontouchstart' in document.documentElement && !$parent.closest('.navbar-nav').length) { - // if mobile we use a backdrop because click events don't delegate + // 如果是移动端设备，则使用背景遮罩，因为点击事件无法委托 $(document.createElement('div')) - .addClass('dropdown-backdrop') - .insertAfter($(this)) - .on('click', clearMenus) + .addClass('dropdown-backdrop') // 创建背景遮罩 + .insertAfter($(this)) // 插入到当前元素后面 + .on('click', clearMenus) // 点击遮罩时关闭菜单 } var relatedTarget = { relatedTarget: this } - $parent.trigger(e = $.Event('show.bs.dropdown', relatedTarget)) + $parent.trigger(e = $.Event('show.bs.dropdown', relatedTarget)) // 触发显示事件 - if (e.isDefaultPrevented()) return + if (e.isDefaultPrevented()) return // 如果默认行为被阻止，返回 $this - .trigger('focus') - .attr('aria-expanded', 'true') + .trigger('focus') // 触发 focus 事件 + .attr('aria-expanded', 'true') // 设置 aria-expanded 属性为 true $parent - .toggleClass('open') - .trigger($.Event('shown.bs.dropdown', relatedTarget)) + .toggleClass('open') // 切换 open 类，控制下拉菜单的显示与隐藏 + .trigger($.Event('shown.bs.dropdown', relatedTarget)) // 触发 shown 事件 } - return false + return false // 阻止事件冒泡 } + // 处理键盘事件（上、下、Esc、空格） Dropdown.prototype.keydown = function (e) { - if (!/(38|40|27|32)/.test(e.which) || /input|textarea/i.test(e.target.tagName)) return + if (!/(38|40|27|32)/.test(e.which) || /input|textarea/i.test(e.target.tagName)) return // 只处理上、下箭头、Esc 和空格键，且不在输入框或文本区内处理 var $this = $(this) - e.preventDefault() - e.stopPropagation() + e.preventDefault() // 阻止默认事件 + e.stopPropagation() // 阻止事件冒泡 - if ($this.is('.disabled, :disabled')) return + if ($this.is('.disabled, :disabled')) return // 如果元素被禁用，返回 - var $parent = getParent($this) - var isActive = $parent.hasClass('open') + var $parent = getParent($this) // 获取父元素 + var isActive = $parent.hasClass('open') // 判断当前菜单是否处于打开状态 if (!isActive && e.which != 27 || isActive && e.which == 27) { - if (e.which == 27) $parent.find(toggle).trigger('focus') - return $this.trigger('click') + if (e.which == 27) $parent.find(toggle).trigger('focus') // 如果按下 Esc 键，聚焦触发器 + return $this.trigger('click') // 触发 click 事件 } - var desc = ' li:not(.disabled):visible a' - var $items = $parent.find('.dropdown-menu' + desc) + var desc = ' li:not(.disabled):visible a' // 查找可见且不被禁用的菜单项 + var $items = $parent.find('.dropdown-menu' + desc) // 获取所有有效的菜单项 - if (!$items.length) return + if (!$items.length) return // 如果没有菜单项，返回 - var index = $items.index(e.target) + var index = $items.index(e.target) // 获取当前选中的菜单项的索引 - if (e.which == 38 && index > 0) index-- // up - if (e.which == 40 && index < $items.length - 1) index++ // down - if (!~index) index = 0 + if (e.which == 38 && index > 0) index-- // 上箭头，索引减一 + if (e.which == 40 && index < $items.length - 1) index++ // 下箭头，索引加一 + if (!~index) index = 0 // 如果索引无效，则从第一个开始 - $items.eq(index).trigger('focus') + $items.eq(index).trigger('focus') // 聚焦到选中的菜单项 } - // DROPDOWN PLUGIN DEFINITION + // DROPDOWN 插件定义 // ========================== function Plugin(option) { return this.each(function () { var $this = $(this) - var data = $this.data('bs.dropdown') + var data = $this.data('bs.dropdown') // 获取现有的 dropdown 实例 - if (!data) $this.data('bs.dropdown', (data = new Dropdown(this))) - if (typeof option == 'string') data[option].call($this) + if (!data) $this.data('bs.dropdown', (data = new Dropdown(this))) // 如果没有实例，创建一个新的实例 + if (typeof option == 'string') data[option].call($this) // 如果传入的参数是字符串，则调用对应的方法 }) } - var old = $.fn.dropdown + var old = $.fn.dropdown // 保存原始的 dropdown 方法 - $.fn.dropdown = Plugin - $.fn.dropdown.Constructor = Dropdown + $.fn.dropdown = Plugin // 替换为新的 Plugin 方法 + $.fn.dropdown.Constructor = Dropdown // 设置构造函数为 Dropdown - // DROPDOWN NO CONFLICT + // DROPDOWN 不冲突模式 // ==================== $.fn.dropdown.noConflict = function () { - $.fn.dropdown = old + $.fn.dropdown = old // 恢复原来的 dropdown 方法 return this } - // APPLY TO STANDARD DROPDOWN ELEMENTS + // 应用到标准的 DROPDOWN 元素 // =================================== $(document) - .on('click.bs.dropdown.data-api', clearMenus) - .on('click.bs.dropdown.data-api', '.dropdown form', function (e) { e.stopPropagation() }) - .on('click.bs.dropdown.data-api', toggle, Dropdown.prototype.toggle) - .on('keydown.bs.dropdown.data-api', toggle, Dropdown.prototype.keydown) - .on('keydown.bs.dropdown.data-api', '.dropdown-menu', Dropdown.prototype.keydown) + .on('click.bs.dropdown.data-api', clearMenus) // 点击时清除菜单 + .on('click.bs.dropdown.data-api', '.dropdown form', function (e) { e.stopPropagation() }) // 阻止 form 元素点击时冒泡 + .on('click.bs.dropdown.data-api', toggle, Dropdown.prototype.toggle) // 点击触发下拉菜单的切换 + .on('keydown.bs.dropdown.data-api', toggle, Dropdown.prototype.keydown) // 键盘事件处理 + .on('keydown.bs.dropdown.data-api', '.dropdown-menu', Dropdown.prototype.keydown) // 键盘事件处理（在下拉菜单内） }(jQuery); @@ -922,192 +947,208 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; - // MODAL CLASS DEFINITION + // MODAL 类定义 // ====================== var Modal = function (element, options) { - this.options = options - this.$body = $(document.body) - this.$element = $(element) - this.$dialog = this.$element.find('.modal-dialog') - this.$backdrop = null - this.isShown = null - this.originalBodyPad = null - this.scrollbarWidth = 0 - this.ignoreBackdropClick = false - + this.options = options // 配置项 + this.$body = $(document.body) // 获取文档的 body 元素 + this.$element = $(element) // 当前 modal 元素 + this.$dialog = this.$element.find('.modal-dialog') // 获取 modal 对话框元素 + this.$backdrop = null // 背景遮罩 + this.isShown = null // 模态框是否已显示 + this.originalBodyPad = null // 原始 body padding + this.scrollbarWidth = 0 // 滚动条宽度 + this.ignoreBackdropClick = false // 是否忽略背景点击事件 + + // 如果有 remote 配置项，加载远程内容 if (this.options.remote) { this.$element - .find('.modal-content') - .load(this.options.remote, $.proxy(function () { - this.$element.trigger('loaded.bs.modal') - }, this)) + .find('.modal-content') + .load(this.options.remote, $.proxy(function () { + this.$element.trigger('loaded.bs.modal') // 内容加载完成后触发事件 + }, this)) } } - Modal.VERSION = '3.3.7' + Modal.VERSION = '3.3.7' // 版本号 + // 定义模态框过渡时间 Modal.TRANSITION_DURATION = 300 Modal.BACKDROP_TRANSITION_DURATION = 150 + // 默认配置项 Modal.DEFAULTS = { - backdrop: true, - keyboard: true, - show: true + backdrop: true, // 背景是否显示 + keyboard: true, // 是否响应键盘事件 + show: true // 是否显示模态框 } + // 切换显示或隐藏模态框 Modal.prototype.toggle = function (_relatedTarget) { - return this.isShown ? this.hide() : this.show(_relatedTarget) + return this.isShown ? this.hide() : this.show(_relatedTarget) // 如果模态框已显示，隐藏，否则显示 } + // 显示模态框 Modal.prototype.show = function (_relatedTarget) { var that = this - var e = $.Event('show.bs.modal', { relatedTarget: _relatedTarget }) + var e = $.Event('show.bs.modal', { relatedTarget: _relatedTarget }) // 触发 show 事件 - this.$element.trigger(e) + this.$element.trigger(e) // 触发模态框的 show 事件 - if (this.isShown || e.isDefaultPrevented()) return + if (this.isShown || e.isDefaultPrevented()) return // 如果已显示或事件被阻止，返回 - this.isShown = true + this.isShown = true // 标记为已显示 - this.checkScrollbar() - this.setScrollbar() - this.$body.addClass('modal-open') + this.checkScrollbar() // 检查是否有滚动条 + this.setScrollbar() // 设置滚动条 + this.$body.addClass('modal-open') // 在 body 上添加类 modal-open - this.escape() - this.resize() + this.escape() // 响应键盘 Escape 键 + this.resize() // 响应窗口大小变化 + // 绑定点击事件，点击关闭按钮时隐藏模态框 this.$element.on('click.dismiss.bs.modal', '[data-dismiss="modal"]', $.proxy(this.hide, this)) + // 处理模态框对话框的鼠标事件 this.$dialog.on('mousedown.dismiss.bs.modal', function () { that.$element.one('mouseup.dismiss.bs.modal', function (e) { - if ($(e.target).is(that.$element)) that.ignoreBackdropClick = true + if ($(e.target).is(that.$element)) that.ignoreBackdropClick = true // 如果点击了模态框，忽略背景点击 }) }) + // 处理背景遮罩 this.backdrop(function () { - var transition = $.support.transition && that.$element.hasClass('fade') + var transition = $.support.transition && that.$element.hasClass('fade') // 判断是否支持过渡动画 if (!that.$element.parent().length) { - that.$element.appendTo(that.$body) // don't move modals dom position + that.$element.appendTo(that.$body) // 不移动模态框的 DOM 位置 } that.$element - .show() - .scrollTop(0) + .show() // 显示模态框 + .scrollTop(0) // 滚动到顶部 - that.adjustDialog() + that.adjustDialog() // 调整模态框的位置 + // 如果需要过渡动画 if (transition) { - that.$element[0].offsetWidth // force reflow + that.$element[0].offsetWidth // 强制重新计算 DOM 样式 } - that.$element.addClass('in') + that.$element.addClass('in') // 添加显示类 in - that.enforceFocus() + that.enforceFocus() // 强制模态框聚焦 - var e = $.Event('shown.bs.modal', { relatedTarget: _relatedTarget }) + var e = $.Event('shown.bs.modal', { relatedTarget: _relatedTarget }) // 触发 shown 事件 transition ? - that.$dialog // wait for modal to slide in - .one('bsTransitionEnd', function () { - that.$element.trigger('focus').trigger(e) - }) - .emulateTransitionEnd(Modal.TRANSITION_DURATION) : - that.$element.trigger('focus').trigger(e) + that.$dialog // 等待模态框过渡完成 + .one('bsTransitionEnd', function () { + that.$element.trigger('focus').trigger(e) + }) + .emulateTransitionEnd(Modal.TRANSITION_DURATION) : + that.$element.trigger('focus').trigger(e) }) } + // 隐藏模态框 Modal.prototype.hide = function (e) { - if (e) e.preventDefault() + if (e) e.preventDefault() // 阻止默认事件 - e = $.Event('hide.bs.modal') + e = $.Event('hide.bs.modal') // 触发 hide 事件 - this.$element.trigger(e) + this.$element.trigger(e) // 触发模态框的 hide 事件 - if (!this.isShown || e.isDefaultPrevented()) return + if (!this.isShown || e.isDefaultPrevented()) return // 如果未显示或事件被阻止，返回 - this.isShown = false + this.isShown = false // 标记为未显示 - this.escape() - this.resize() + this.escape() // 取消响应 Escape 键 + this.resize() // 取消响应窗口大小变化 - $(document).off('focusin.bs.modal') + $(document).off('focusin.bs.modal') // 解除焦点事件监听 this.$element - .removeClass('in') - .off('click.dismiss.bs.modal') - .off('mouseup.dismiss.bs.modal') + .removeClass('in') // 移除显示类 in + .off('click.dismiss.bs.modal') + .off('mouseup.dismiss.bs.modal') this.$dialog.off('mousedown.dismiss.bs.modal') + // 如果需要过渡动画 $.support.transition && this.$element.hasClass('fade') ? - this.$element - .one('bsTransitionEnd', $.proxy(this.hideModal, this)) - .emulateTransitionEnd(Modal.TRANSITION_DURATION) : - this.hideModal() + this.$element + .one('bsTransitionEnd', $.proxy(this.hideModal, this)) + .emulateTransitionEnd(Modal.TRANSITION_DURATION) : + this.hideModal() // 隐藏模态框 } + // 强制模态框聚焦 Modal.prototype.enforceFocus = function () { $(document) - .off('focusin.bs.modal') // guard against infinite focus loop - .on('focusin.bs.modal', $.proxy(function (e) { - if (document !== e.target && - this.$element[0] !== e.target && - !this.$element.has(e.target).length) { - this.$element.trigger('focus') - } - }, this)) + .off('focusin.bs.modal') // 防止无限循环聚焦 + .on('focusin.bs.modal', $.proxy(function (e) { + if (document !== e.target && + this.$element[0] !== e.target && + !this.$element.has(e.target).length) { + this.$element.trigger('focus') // 如果点击的不是模态框内部元素，强制聚焦到模态框 + } + }, this)) } + // 响应键盘 Escape 键 Modal.prototype.escape = function () { if (this.isShown && this.options.keyboard) { this.$element.on('keydown.dismiss.bs.modal', $.proxy(function (e) { - e.which == 27 && this.hide() + e.which == 27 && this.hide() // 如果按下 Escape 键，隐藏模态框 }, this)) } else if (!this.isShown) { - this.$element.off('keydown.dismiss.bs.modal') + this.$element.off('keydown.dismiss.bs.modal') // 移除键盘事件监听 } } + // 响应窗口大小变化 Modal.prototype.resize = function () { if (this.isShown) { $(window).on('resize.bs.modal', $.proxy(this.handleUpdate, this)) } else { - $(window).off('resize.bs.modal') + $(window).off('resize.bs.modal') // 移除窗口大小变化事件监听 } } + // 隐藏模态框并移除背景 Modal.prototype.hideModal = function () { var that = this this.$element.hide() this.backdrop(function () { - that.$body.removeClass('modal-open') - that.resetAdjustments() - that.resetScrollbar() - that.$element.trigger('hidden.bs.modal') + that.$body.removeClass('modal-open') // 移除 modal-open 类 + that.resetAdjustments() // 重置样式 + that.resetScrollbar() // 重置滚动条 + that.$element.trigger('hidden.bs.modal') // 触发 hidden 事件 }) } + // 移除背景遮罩 Modal.prototype.removeBackdrop = function () { this.$backdrop && this.$backdrop.remove() this.$backdrop = null } + // 创建背景遮罩 Modal.prototype.backdrop = function (callback) { var that = this - var animate = this.$element.hasClass('fade') ? 'fade' : '' + var animate = this.$element.hasClass('fade') ? 'fade' : '' // 判断是否需要过渡效果 if (this.isShown && this.options.backdrop) { - var doAnimate = $.support.transition && animate + var doAnimate = $.support.transition && animate // 判断是否支持过渡动画 this.$backdrop = $(document.createElement('div')) - .addClass('modal-backdrop ' + animate) - .appendTo(this.$body) + .addClass('modal-backdrop ' + animate) + .appendTo(this.$body) this.$element.on('click.dismiss.bs.modal', $.proxy(function (e) { if (this.ignoreBackdropClick) { @@ -1116,55 +1157,57 @@ if (typeof jQuery === 'undefined') { } if (e.target !== e.currentTarget) return this.options.backdrop == 'static' - ? this.$element[0].focus() - : this.hide() + ? this.$element[0].focus() // 如果配置为 static，聚焦到模态框 + : this.hide() // 否则隐藏模态框 }, this)) - if (doAnimate) this.$backdrop[0].offsetWidth // force reflow + if (doAnimate) this.$backdrop[0].offsetWidth // 强制重新计算样式 - this.$backdrop.addClass('in') + this.$backdrop.addClass('in') // 显示背景 if (!callback) return doAnimate ? - this.$backdrop - .one('bsTransitionEnd', callback) - .emulateTransitionEnd(Modal.BACKDROP_TRANSITION_DURATION) : - callback() + this.$backdrop + .one('bsTransitionEnd', callback) + .emulateTransitionEnd(Modal.BACKDROP_TRANSITION_DURATION) : + callback() } else if (!this.isShown && this.$backdrop) { - this.$backdrop.removeClass('in') + this.$backdrop.removeClass('in') // 隐藏背景 var callbackRemove = function () { that.removeBackdrop() callback && callback() } $.support.transition && this.$element.hasClass('fade') ? - this.$backdrop - .one('bsTransitionEnd', callbackRemove) - .emulateTransitionEnd(Modal.BACKDROP_TRANSITION_DURATION) : - callbackRemove() + this.$backdrop + .one('bsTransitionEnd', callbackRemove) + .emulateTransitionEnd(Modal.BACKDROP_TRANSITION_DURATION) : + callbackRemove() } else if (callback) { callback() } } - // these following methods are used to handle overflowing modals + // 以下方法用于处理溢出的模态框 Modal.prototype.handleUpdate = function () { - this.adjustDialog() + this.adjustDialog() // 调整模态框位置 } + // 调整模态框的位置 Modal.prototype.adjustDialog = function () { - var modalIsOverflowing = this.$element[0].scrollHeight > document.documentElement.clientHeight + var modalIsOverflowing = this.$element[0].scrollHeight > document.documentElement.clientHeight // 判断模态框是否溢出 this.$element.css({ - paddingLeft: !this.bodyIsOverflowing && modalIsOverflowing ? this.scrollbarWidth : '', + paddingLeft: !this.bodyIsOverflowing && modalIsOverflowing ? this.scrollbarWidth : '', // 如果有滚动条，调整 padding paddingRight: this.bodyIsOverflowing && !modalIsOverflowing ? this.scrollbarWidth : '' }) } + // 重置模态框样式 Modal.prototype.resetAdjustments = function () { this.$element.css({ paddingLeft: '', @@ -1172,37 +1215,41 @@ if (typeof jQuery === 'undefined') { }) } + // 检查是否有滚动条 Modal.prototype.checkScrollbar = function () { var fullWindowWidth = window.innerWidth - if (!fullWindowWidth) { // workaround for missing window.innerWidth in IE8 + if (!fullWindowWidth) { // IE8 的兼容性处理 var documentElementRect = document.documentElement.getBoundingClientRect() fullWindowWidth = documentElementRect.right - Math.abs(documentElementRect.left) } - this.bodyIsOverflowing = document.body.clientWidth < fullWindowWidth - this.scrollbarWidth = this.measureScrollbar() + this.bodyIsOverflowing = document.body.clientWidth < fullWindowWidth // 判断 body 是否有溢出 + this.scrollbarWidth = this.measureScrollbar() // 获取滚动条宽度 } + // 设置滚动条样式 Modal.prototype.setScrollbar = function () { var bodyPad = parseInt((this.$body.css('padding-right') || 0), 10) this.originalBodyPad = document.body.style.paddingRight || '' - if (this.bodyIsOverflowing) this.$body.css('padding-right', bodyPad + this.scrollbarWidth) + if (this.bodyIsOverflowing) this.$body.css('padding-right', bodyPad + this.scrollbarWidth) // 如果有滚动条，设置 padding } + // 重置滚动条样式 Modal.prototype.resetScrollbar = function () { this.$body.css('padding-right', this.originalBodyPad) } + // 测量滚动条宽度 Modal.prototype.measureScrollbar = function () { // thx walsh var scrollDiv = document.createElement('div') scrollDiv.className = 'modal-scrollbar-measure' this.$body.append(scrollDiv) - var scrollbarWidth = scrollDiv.offsetWidth - scrollDiv.clientWidth + var scrollbarWidth = scrollDiv.offsetWidth - scrollDiv.clientWidth // 获取滚动条宽度 this.$body[0].removeChild(scrollDiv) return scrollbarWidth } - // MODAL PLUGIN DEFINITION + // MODAL 插件定义 // ======================= function Plugin(option, _relatedTarget) { @@ -1211,45 +1258,45 @@ if (typeof jQuery === 'undefined') { var data = $this.data('bs.modal') var options = $.extend({}, Modal.DEFAULTS, $this.data(), typeof option == 'object' && option) - if (!data) $this.data('bs.modal', (data = new Modal(this, options))) - if (typeof option == 'string') data[option](_relatedTarget) - else if (options.show) data.show(_relatedTarget) + if (!data) $this.data('bs.modal', (data = new Modal(this, options))) // 创建 Modal 实例 + if (typeof option == 'string') data[option](_relatedTarget) // 如果传入方法名，执行对应方法 + else if (options.show) data.show(_relatedTarget) // 默认显示模态框 }) } - var old = $.fn.modal + var old = $.fn.modal // 保存旧的插件定义 - $.fn.modal = Plugin - $.fn.modal.Constructor = Modal + $.fn.modal = Plugin // 定义 jQuery 插件 + $.fn.modal.Constructor = Modal // 导出构造函数 - // MODAL NO CONFLICT + // MODAL 无冲突处理 // ================= $.fn.modal.noConflict = function () { - $.fn.modal = old + $.fn.modal = old // 恢复旧的插件定义 return this } - // MODAL DATA-API + // MODAL 数据 API // ============== $(document).on('click.bs.modal.data-api', '[data-toggle="modal"]', function (e) { var $this = $(this) var href = $this.attr('href') - var $target = $($this.attr('data-target') || (href && href.replace(/.*(?=#[^\s]+$)/, ''))) // strip for ie7 - var option = $target.data('bs.modal') ? 'toggle' : $.extend({ remote: !/#/.test(href) && href }, $target.data(), $this.data()) + var $target = $($this.attr('data-target') || (href && href.replace(/.*(?=#[^\s]+$)/, ''))) // 获取目标元素 + var option = $target.data('bs.modal') ? 'toggle' : $.extend({ remote: !/#/.test(href) && href }, $target.data(), $this.data()) // 获取选项 - if ($this.is('a')) e.preventDefault() + if ($this.is('a')) e.preventDefault() // 阻止默认行为 $target.one('show.bs.modal', function (showEvent) { - if (showEvent.isDefaultPrevented()) return // only register focus restorer if modal will actually get shown + if (showEvent.isDefaultPrevented()) return // 如果模态框不会显示，取消焦点恢复操作 $target.one('hidden.bs.modal', function () { - $this.is(':visible') && $this.trigger('focus') + $this.is(':visible') && $this.trigger('focus') // 隐藏时恢复焦点 }) }) - Plugin.call($target, option, this) + Plugin.call($target, option, this) // 调用插件 }) }(jQuery); @@ -1262,479 +1309,577 @@ if (typeof jQuery === 'undefined') { * Copyright 2011-2016 Twitter, Inc. * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - - +function ($) { 'use strict'; - // TOOLTIP PUBLIC CLASS DEFINITION + // TOOLTIP 公共类定义 // =============================== var Tooltip = function (element, options) { - this.type = null - this.options = null - this.enabled = null - this.timeout = null - this.hoverState = null - this.$element = null - this.inState = null + this.type = null; // Tooltip 类型 + this.options = null; // Tooltip 配置 + this.enabled = null; // Tooltip 是否启用 + this.timeout = null; // 延时变量 + this.hoverState = null; // 鼠标悬停状态 + this.$element = null; // 绑定的 DOM 元素 + this.inState = null; // 状态对象 {click, hover, focus} - this.init('tooltip', element, options) + this.init('tooltip', element, options); // 初始化 Tooltip 实例 } - Tooltip.VERSION = '3.3.7' - - Tooltip.TRANSITION_DURATION = 150 + Tooltip.VERSION = '3.3.7'; // Tooltip 版本 + Tooltip.TRANSITION_DURATION = 150; // 动画过渡时间 + // 默认配置 Tooltip.DEFAULTS = { - animation: true, - placement: 'top', - selector: false, - template: '', - trigger: 'hover focus', - title: '', - delay: 0, - html: false, - container: false, + animation: true, // 是否启用动画 + placement: 'top', // 提示框的位置（默认为顶部） + selector: false, // 是否启用选择器 + template: '', // 提示框的 HTML 模板 + trigger: 'hover focus', // 触发事件（默认是 hover 和 focus） + title: '', // 提示框标题 + delay: 0, // 延时显示/隐藏 + html: false, // 是否支持 HTML 内容 + container: false, // 提示框容器 viewport: { - selector: 'body', - padding: 0 + selector: 'body', // 视口选择器 + padding: 0 // 视口内边距 } } + // 初始化方法 Tooltip.prototype.init = function (type, element, options) { - this.enabled = true - this.type = type - this.$element = $(element) - this.options = this.getOptions(options) - this.$viewport = this.options.viewport && $($.isFunction(this.options.viewport) ? this.options.viewport.call(this, this.$element) : (this.options.viewport.selector || this.options.viewport)) - this.inState = { click: false, hover: false, focus: false } - + this.enabled = true; // 启用 Tooltip + this.type = type; // Tooltip 类型 + this.$element = $(element); // 绑定元素 + this.options = this.getOptions(options); // 获取配置 + this.$viewport = this.options.viewport && $($.isFunction(this.options.viewport) ? this.options.viewport.call(this, this.$element) : (this.options.viewport.selector || this.options.viewport)); // 视口 + this.inState = { click: false, hover: false, focus: false }; // 初始化状态 + + // 如果元素是文档对象且没有选择器，抛出错误 if (this.$element[0] instanceof document.constructor && !this.options.selector) { - throw new Error('`selector` option must be specified when initializing ' + this.type + ' on the window.document object!') + throw new Error('`selector` option must be specified when initializing ' + this.type + ' on the window.document object!'); } - var triggers = this.options.trigger.split(' ') + var triggers = this.options.trigger.split(' '); // 获取触发事件 + // 为每个触发事件绑定相应的事件处理函数 for (var i = triggers.length; i--;) { - var trigger = triggers[i] + var trigger = triggers[i]; if (trigger == 'click') { - this.$element.on('click.' + this.type, this.options.selector, $.proxy(this.toggle, this)) + this.$element.on('click.' + this.type, this.options.selector, $.proxy(this.toggle, this)); // 点击事件 } else if (trigger != 'manual') { - var eventIn = trigger == 'hover' ? 'mouseenter' : 'focusin' - var eventOut = trigger == 'hover' ? 'mouseleave' : 'focusout' + var eventIn = trigger == 'hover' ? 'mouseenter' : 'focusin'; // 鼠标进入或获取焦点事件 + var eventOut = trigger == 'hover' ? 'mouseleave' : 'focusout'; // 鼠标离开或失去焦点事件 - this.$element.on(eventIn + '.' + this.type, this.options.selector, $.proxy(this.enter, this)) - this.$element.on(eventOut + '.' + this.type, this.options.selector, $.proxy(this.leave, this)) + this.$element.on(eventIn + '.' + this.type, this.options.selector, $.proxy(this.enter, this)); // 鼠标进入或获取焦点 + this.$element.on(eventOut + '.' + this.type, this.options.selector, $.proxy(this.leave, this)); // 鼠标离开或失去焦点 } } - this.options.selector ? - (this._options = $.extend({}, this.options, { trigger: 'manual', selector: '' })) : - this.fixTitle() + this.options.selector ? // 如果存在选择器，更新配置 + (this._options = $.extend({}, this.options, { trigger: 'manual', selector: '' })) : + this.fixTitle(); // 修复标题 } + // 返回默认配置 Tooltip.prototype.getDefaults = function () { - return Tooltip.DEFAULTS + return Tooltip.DEFAULTS; } + // 获取合并后的配置 Tooltip.prototype.getOptions = function (options) { - options = $.extend({}, this.getDefaults(), this.$element.data(), options) + options = $.extend({}, this.getDefaults(), this.$element.data(), options); // 合并配置 + // 如果延时是数字类型，则转换为对象形式 if (options.delay && typeof options.delay == 'number') { options.delay = { show: options.delay, hide: options.delay - } + }; } - return options + return options; } + // 获取代理选项 Tooltip.prototype.getDelegateOptions = function () { - var options = {} - var defaults = this.getDefaults() + var options = {}; + var defaults = this.getDefaults(); + // 合并不同于默认值的配置 this._options && $.each(this._options, function (key, value) { - if (defaults[key] != value) options[key] = value - }) + if (defaults[key] != value) options[key] = value; + }); - return options + return options; } + // 鼠标进入事件 Tooltip.prototype.enter = function (obj) { var self = obj instanceof this.constructor ? - obj : $(obj.currentTarget).data('bs.' + this.type) + obj : $(obj.currentTarget).data('bs.' + this.type); // 获取当前实例 + // 如果实例不存在，则创建一个新的实例 if (!self) { - self = new this.constructor(obj.currentTarget, this.getDelegateOptions()) - $(obj.currentTarget).data('bs.' + this.type, self) + self = new this.constructor(obj.currentTarget, this.getDelegateOptions()); + $(obj.currentTarget).data('bs.' + this.type, self); // 保存实例 } if (obj instanceof $.Event) { - self.inState[obj.type == 'focusin' ? 'focus' : 'hover'] = true + self.inState[obj.type == 'focusin' ? 'focus' : 'hover'] = true; // 更新悬停或焦点状态 } + // 如果 Tooltip 已经显示或当前为悬停状态，则直接返回 if (self.tip().hasClass('in') || self.hoverState == 'in') { - self.hoverState = 'in' - return + self.hoverState = 'in'; + return; } - clearTimeout(self.timeout) + clearTimeout(self.timeout); // 清除超时 - self.hoverState = 'in' + self.hoverState = 'in'; // 设置悬停状态 - if (!self.options.delay || !self.options.delay.show) return self.show() + // 如果没有延时，立即显示；否则设置延时显示 + if (!self.options.delay || !self.options.delay.show) return self.show(); self.timeout = setTimeout(function () { - if (self.hoverState == 'in') self.show() - }, self.options.delay.show) + if (self.hoverState == 'in') self.show(); // 延时显示 + }, self.options.delay.show); } + // 判断是否有激活状态 Tooltip.prototype.isInStateTrue = function () { for (var key in this.inState) { - if (this.inState[key]) return true + if (this.inState[key]) return true; // 如果有激活状态，返回 true } - return false + return false; // 否则返回 false } + // 鼠标离开事件 Tooltip.prototype.leave = function (obj) { var self = obj instanceof this.constructor ? - obj : $(obj.currentTarget).data('bs.' + this.type) + obj : $(obj.currentTarget).data('bs.' + this.type); // 获取当前实例 + // 如果实例不存在，则创建一个新的实例 if (!self) { - self = new this.constructor(obj.currentTarget, this.getDelegateOptions()) - $(obj.currentTarget).data('bs.' + this.type, self) + self = new this.constructor(obj.currentTarget, this.getDelegateOptions()); + $(obj.currentTarget).data('bs.' + this.type, self); // 保存实例 } if (obj instanceof $.Event) { - self.inState[obj.type == 'focusout' ? 'focus' : 'hover'] = false + self.inState[obj.type == 'focusout' ? 'focus' : 'hover'] = false; // 更新焦点或悬停状态 } - if (self.isInStateTrue()) return + // 如果有其他激活状态，则不执行隐藏 + if (self.isInStateTrue()) return; - clearTimeout(self.timeout) + clearTimeout(self.timeout); // 清除超时 - self.hoverState = 'out' + self.hoverState = 'out'; // 设置为离开状态 - if (!self.options.delay || !self.options.delay.hide) return self.hide() + // 如果没有延时，立即隐藏；否则设置延时隐藏 + if (!self.options.delay || !self.options.delay.hide) return self.hide(); self.timeout = setTimeout(function () { - if (self.hoverState == 'out') self.hide() - }, self.options.delay.hide) + if (self.hoverState == 'out') self.hide(); // 延时隐藏 + }, self.options.delay.hide); } + // 显示 Tooltip Tooltip.prototype.show = function () { - var e = $.Event('show.bs.' + this.type) + var e = $.Event('show.bs.' + this.type); // 创建显示事件 + // 如果 Tooltip 内容存在且启用，触发显示事件 if (this.hasContent() && this.enabled) { - this.$element.trigger(e) + this.$element.trigger(e); // 触发事件 - var inDom = $.contains(this.$element[0].ownerDocument.documentElement, this.$element[0]) - if (e.isDefaultPrevented() || !inDom) return - var that = this + var inDom = $.contains(this.$element[0].ownerDocument.documentElement, this.$element[0]); // 判断元素是否在 DOM 中 + if (e.isDefaultPrevented() || !inDom) return; // 如果事件被阻止或元素不在 DOM 中，返回 - var $tip = this.tip() + var that = this; - var tipId = this.getUID(this.type) + var $tip = this.tip(); // 获取 Tooltip DOM 元素 - this.setContent() - $tip.attr('id', tipId) - this.$element.attr('aria-describedby', tipId) + var tipId = this.getUID(this.type); // 获取唯一 ID - if (this.options.animation) $tip.addClass('fade') + this.setContent(); // 设置内容 + $tip.attr('id', tipId); // 设置 ID + this.$element.attr('aria-describedby', tipId); // 设置 ARIA 属性 - var placement = typeof this.options.placement == 'function' ? - this.options.placement.call(this, $tip[0], this.$element[0]) : - this.options.placement + if (this.options.animation) $tip.addClass('fade'); // 如果启用动画，添加 'fade' 类 - var autoToken = /\s?auto?\s?/i - var autoPlace = autoToken.test(placement) - if (autoPlace) placement = placement.replace(autoToken, '') || 'top' + var placement = typeof this.options.placement == 'function' ? // 获取位置 + this.options.placement.call(this, $tip[0], this.$element[0]) : + this.options.placement; + var autoToken = /\s?auto?\s?/i; // 自动位置标记 + var autoPlace = autoToken.test(placement); // 是否需要自动位置 + if (autoPlace) placement = placement.replace(autoToken, '') || 'top'; // 处理自动位置 + + // 移除旧的 Tooltip，设置新的显示位置 $tip - .detach() - .css({ top: 0, left: 0, display: 'block' }) - .addClass(placement) - .data('bs.' + this.type, this) + .detach() + .css({ top: 0, left: 0, display: 'block' }) + .addClass(placement) + .data('bs.' + this.type, this); - this.options.container ? $tip.appendTo(this.options.container) : $tip.insertAfter(this.$element) - this.$element.trigger('inserted.bs.' + this.type) + // 如果指定了容器，则将 Tooltip 插入到容器中，否则直接插入到元素之后 + this.options.container ? $tip.appendTo(this.options.container) : $tip.insertAfter(this.$element); + this.$element.trigger('inserted.bs.' + this.type); // 触发插入事件 - var pos = this.getPosition() - var actualWidth = $tip[0].offsetWidth - var actualHeight = $tip[0].offsetHeight + var pos = this.getPosition(); // 获取位置 + var actualWidth = $tip[0].offsetWidth; // 获取实际宽度 + var actualHeight = $tip[0].offsetHeight; // 获取实际高度 + // 根据位置调整 Tooltip 的显示位置 if (autoPlace) { - var orgPlacement = placement - var viewportDim = this.getPosition(this.$viewport) + var orgPlacement = placement; // 保存原始位置 + var viewportDim = this.getPosition(this.$viewport); // 获取视口尺寸 - placement = placement == 'bottom' && pos.bottom + actualHeight > viewportDim.bottom ? 'top' : - placement == 'top' && pos.top - actualHeight < viewportDim.top ? 'bottom' : - placement == 'right' && pos.right + actualWidth > viewportDim.width ? 'left' : - placement == 'left' && pos.left - actualWidth < viewportDim.left ? 'right' : - placement + // 计算 Tooltip 应该显示的位置 + placement = placement == 'bottom' && pos.bottom + actualHeight > viewportDim.bottom ? 'top' : + placement == 'top' && pos.top - actualHeight < viewportDim.top ? 'bottom' : + placement == 'right' && pos.right + actualWidth > viewportDim.width ? 'left' : + placement == 'left' && pos.left - actualWidth < viewportDim.left ? 'right' : + placement; $tip - .removeClass(orgPlacement) - .addClass(placement) + .removeClass(orgPlacement) + .addClass(placement); // 设置新的位置 } + var calculatedOffset = this.getCalculatedOffset(placement, pos, actualWidth, actualHeight) +// 应用计算出的偏移量来定位tooltip this.applyPlacement(calculatedOffset, placement) +// 完成动画后的回调函数 var complete = function () { + // 保存当前hover状态 var prevHoverState = that.hoverState + + // 触发tooltip显示事件 that.$element.trigger('shown.bs.' + that.type) + + // 重置hoverState状态 that.hoverState = null + // 如果之前的hover状态是'out'，则调用leave方法来隐藏tooltip if (prevHoverState == 'out') that.leave(that) } +// 检查是否支持过渡动画，且tooltip有fade类 +// 如果支持过渡，监听过渡结束事件 $.support.transition && this.$tip.hasClass('fade') ? - $tip - .one('bsTransitionEnd', complete) - .emulateTransitionEnd(Tooltip.TRANSITION_DURATION) : - complete() + // 在过渡结束时执行complete函数 + $tip + .one('bsTransitionEnd', complete) // 监听过渡结束事件 + .emulateTransitionEnd(Tooltip.TRANSITION_DURATION) : // 模拟过渡效果 + complete() } } Tooltip.prototype.applyPlacement = function (offset, placement) { - var $tip = this.tip() + // 获取tooltip元素 + var $tip = this.tip() + + // 获取tooltip的实际宽度和高度 var width = $tip[0].offsetWidth var height = $tip[0].offsetHeight - // manually read margins because getBoundingClientRect includes difference + // 手动读取tooltip的margin值，因为getBoundingClientRect包含了边距 var marginTop = parseInt($tip.css('margin-top'), 10) var marginLeft = parseInt($tip.css('margin-left'), 10) - // we must check for NaN for ie 8/9 + // 兼容IE8/9，检查margin值是否为NaN if (isNaN(marginTop)) marginTop = 0 if (isNaN(marginLeft)) marginLeft = 0 + // 更新偏移量，考虑到margin offset.top += marginTop offset.left += marginLeft - // $.fn.offset doesn't round pixel values - // so we use setOffset directly with our own function B-0 + // 使用setOffset方法直接应用计算出的偏移量 + // $.fn.offset()不会四舍五入像素值，因此我们使用setOffset进行自定义 $.offset.setOffset($tip[0], $.extend({ using: function (props) { + // 四舍五入计算的top和left值 $tip.css({ top: Math.round(props.top), left: Math.round(props.left) }) } }, offset), 0) - $tip.addClass('in') - // check to see if placing tip in new offset caused the tip to resize itself - var actualWidth = $tip[0].offsetWidth - var actualHeight = $tip[0].offsetHeight +// 检查重新定位后的tooltip是否因偏移量变化而导致尺寸改变 + var actualWidth = $tip[0].offsetWidth // 获取tooltip实际宽度 + var actualHeight = $tip[0].offsetHeight // 获取tooltip实际高度 +// 如果placement是'top'且tooltip的实际高度与原始高度不同，调整top偏移量 if (placement == 'top' && actualHeight != height) { offset.top = offset.top + height - actualHeight } +// 获取根据视口调整后的偏移量，考虑到可能的边界限制 var delta = this.getViewportAdjustedDelta(placement, offset, actualWidth, actualHeight) +// 根据delta值调整位置，优先调整left，如果没有，则调整top if (delta.left) offset.left += delta.left else offset.top += delta.top - var isVertical = /top|bottom/.test(placement) - var arrowDelta = isVertical ? delta.left * 2 - width + actualWidth : delta.top * 2 - height + actualHeight +// 判断placement是否是垂直方向的（top或bottom） + var isVertical = /top|bottom/.test(placement) + +// 计算箭头的位置偏移量，delta值的2倍减去宽度/高度差值 + var arrowDelta = isVertical ? delta.left * 2 - width + actualWidth : delta.top * 2 - height + actualHeight + +// 确定箭头应该参考的维度，是宽度还是高度 var arrowOffsetPosition = isVertical ? 'offsetWidth' : 'offsetHeight' +// 根据计算出的偏移量设置tooltip的位置 $tip.offset(offset) + +// 调用replaceArrow方法来调整箭头的指向 this.replaceArrow(arrowDelta, $tip[0][arrowOffsetPosition], isVertical) - } + javascript + 复制代码 +// 替换箭头的位置 + Tooltip.prototype.replaceArrow = function (delta, dimension, isVertical) { + this.arrow() + // 根据是否是垂直方向设置箭头的位置（left或top） + .css(isVertical ? 'left' : 'top', 50 * (1 - delta / dimension) + '%') + // 清空另一个方向的样式 + .css(isVertical ? 'top' : 'left', '') + } + javascript + 复制代码 +// 设置tooltip的内容 + Tooltip.prototype.setContent = function () { + var $tip = this.tip() // 获取tooltip元素 + var title = this.getTitle() // 获取tooltip的标题 + + // 根据options设置tooltip的内容，支持html或text + $tip.find('.tooltip-inner')[this.options.html ? 'html' : 'text'](title) + // 移除所有位置相关的class + $tip.removeClass('fade in top bottom left right') + } + javascript + 复制代码 +// 隐藏tooltip并执行回调函数 + Tooltip.prototype.hide = function (callback) { + var that = this + var $tip = $(this.$tip) + var e = $.Event('hide.bs.' + this.type) + + function complete() { + // 如果hoverState不是'in'，移除tooltip + if (that.hoverState != 'in') $tip.detach() + // 如果$element存在，移除aria-describedby属性并触发'hidden'事件 + if (that.$element) { + that.$element + .removeAttr('aria-describedby') + .trigger('hidden.bs.' + that.type) + } + // 执行回调函数 + callback && callback() + } - Tooltip.prototype.replaceArrow = function (delta, dimension, isVertical) { - this.arrow() - .css(isVertical ? 'left' : 'top', 50 * (1 - delta / dimension) + '%') - .css(isVertical ? 'top' : 'left', '') - } + // 触发'event'事件 + this.$element.trigger(e) - Tooltip.prototype.setContent = function () { - var $tip = this.tip() - var title = this.getTitle() + // 如果事件被阻止，直接返回 + if (e.isDefaultPrevented()) return - $tip.find('.tooltip-inner')[this.options.html ? 'html' : 'text'](title) - $tip.removeClass('fade in top bottom left right') - } + // 移除'in'类 + $tip.removeClass('in') - Tooltip.prototype.hide = function (callback) { - var that = this - var $tip = $(this.$tip) - var e = $.Event('hide.bs.' + this.type) - - function complete() { - if (that.hoverState != 'in') $tip.detach() - if (that.$element) { // TODO: Check whether guarding this code with this `if` is really necessary. - that.$element - .removeAttr('aria-describedby') - .trigger('hidden.bs.' + that.type) - } - callback && callback() + // 如果支持过渡效果且有fade类，使用过渡效果，否则直接执行complete函数 + $.support.transition && $tip.hasClass('fade') ? + $tip + .one('bsTransitionEnd', complete) // 在过渡结束后执行complete + .emulateTransitionEnd(Tooltip.TRANSITION_DURATION) : // 模拟过渡时间 + complete() // 直接执行complete } - this.$element.trigger(e) - - if (e.isDefaultPrevented()) return - - $tip.removeClass('in') - - $.support.transition && $tip.hasClass('fade') ? - $tip - .one('bsTransitionEnd', complete) - .emulateTransitionEnd(Tooltip.TRANSITION_DURATION) : - complete() + javascript +// 将hoverState设置为nul this.hoverState = null return this } - Tooltip.prototype.fixTitle = function () { var $e = this.$element if ($e.attr('title') || typeof $e.attr('data-original-title') != 'string') { + // 如果title存在，则将其存入data-original-title中，并清空title属性 $e.attr('data-original-title', $e.attr('title') || '').attr('title', '') } } - + javascript + 复制代码 +// 判断tooltip是否有内容 Tooltip.prototype.hasContent = function () { - return this.getTitle() + return this.getTitle() // 通过getTitle()方法获取title } - + javascript + 复制代码 +// 获取元素的位置信息 Tooltip.prototype.getPosition = function ($element) { $element = $element || this.$element var el = $element[0] var isBody = el.tagName == 'BODY' - var elRect = el.getBoundingClientRect() + var elRect = el.getBoundingClientRect() // 获取元素的矩形边界 if (elRect.width == null) { - // width and height are missing in IE8, so compute them manually; see https://github.com/twbs/bootstrap/issues/14093 + // 如果IE8没有width和height，手动计算 elRect = $.extend({}, elRect, { width: elRect.right - elRect.left, height: elRect.bottom - elRect.top }) } var isSvg = window.SVGElement && el instanceof window.SVGElement - // Avoid using $.offset() on SVGs since it gives incorrect results in jQuery 3. - // See https://github.com/twbs/bootstrap/issues/20280 + // 对SVG元素使用$.offset()会有问题，避免在SVG上使用 var elOffset = isBody ? { top: 0, left: 0 } : (isSvg ? null : $element.offset()) var scroll = { scroll: isBody ? document.documentElement.scrollTop || document.body.scrollTop : $element.scrollTop() } var outerDims = isBody ? { width: $(window).width(), height: $(window).height() } : null - return $.extend({}, elRect, scroll, outerDims, elOffset) + return $.extend({}, elRect, scroll, outerDims, elOffset) // 返回合并后的位置信息 } - + javascript + 复制代码 +// 根据placement、位置、实际宽高计算偏移量 Tooltip.prototype.getCalculatedOffset = function (placement, pos, actualWidth, actualHeight) { return placement == 'bottom' ? { top: pos.top + pos.height, left: pos.left + pos.width / 2 - actualWidth / 2 } : - placement == 'top' ? { top: pos.top - actualHeight, left: pos.left + pos.width / 2 - actualWidth / 2 } : - placement == 'left' ? { top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left - actualWidth } : - /* placement == 'right' */ { top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left + pos.width } - + placement == 'top' ? { top: pos.top - actualHeight, left: pos.left + pos.width / 2 - actualWidth / 2 } : + placement == 'left' ? { top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left - actualWidth } : + /* placement == 'right' */ { top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left + pos.width } } - + javascript + 复制代码 +// 获取视口调整后的偏移量，避免溢出视口 Tooltip.prototype.getViewportAdjustedDelta = function (placement, pos, actualWidth, actualHeight) { var delta = { top: 0, left: 0 } - if (!this.$viewport) return delta + if (!this.$viewport) return delta // 如果没有viewport，返回默认的delta var viewportPadding = this.options.viewport && this.options.viewport.padding || 0 var viewportDimensions = this.getPosition(this.$viewport) if (/right|left/.test(placement)) { + // 处理左右位置溢出的情况 var topEdgeOffset = pos.top - viewportPadding - viewportDimensions.scroll var bottomEdgeOffset = pos.top + viewportPadding - viewportDimensions.scroll + actualHeight - if (topEdgeOffset < viewportDimensions.top) { // top overflow + if (topEdgeOffset < viewportDimensions.top) { // top溢出 delta.top = viewportDimensions.top - topEdgeOffset - } else if (bottomEdgeOffset > viewportDimensions.top + viewportDimensions.height) { // bottom overflow + } else if (bottomEdgeOffset > viewportDimensions.top + viewportDimensions.height) { // bottom溢出 delta.top = viewportDimensions.top + viewportDimensions.height - bottomEdgeOffset } } else { + // 处理上下位置溢出的情况 var leftEdgeOffset = pos.left - viewportPadding var rightEdgeOffset = pos.left + viewportPadding + actualWidth - if (leftEdgeOffset < viewportDimensions.left) { // left overflow + if (leftEdgeOffset < viewportDimensions.left) { // left溢出 delta.left = viewportDimensions.left - leftEdgeOffset - } else if (rightEdgeOffset > viewportDimensions.right) { // right overflow + } else if (rightEdgeOffset > viewportDimensions.right) { // right溢出 delta.left = viewportDimensions.left + viewportDimensions.width - rightEdgeOffset } } - return delta + return delta // 返回调整后的delta } - + javascript + 复制代码 +// 获取tooltip的标题 Tooltip.prototype.getTitle = function () { var title var $e = this.$element var o = this.options + // 获取data-original-title或options中的title title = $e.attr('data-original-title') - || (typeof o.title == 'function' ? o.title.call($e[0]) : o.title) + || (typeof o.title == 'function' ? o.title.call($e[0]) : o.title) - return title + return title // 返回title } - + javascript + 复制代码 +// 生成唯一的ID Tooltip.prototype.getUID = function (prefix) { - do prefix += ~~(Math.random() * 1000000) - while (document.getElementById(prefix)) - return prefix + do prefix += ~~(Math.random() * 1000000) // 生成随机数并拼接前缀 + while (document.getElementById(prefix)) // 确保ID唯一 + return prefix // 返回生成的唯一ID } - + javascript + 复制代码 +// 获取tooltip元素 Tooltip.prototype.tip = function () { if (!this.$tip) { - this.$tip = $(this.options.template) + this.$tip = $(this.options.template) // 根据template选项生成tooltip元素 if (this.$tip.length != 1) { throw new Error(this.type + ' `template` option must consist of exactly 1 top-level element!') } } - return this.$tip + return this.$tip // 返回tooltip元素 } - + javascript + 复制代码 +// 获取tooltip的箭头元素 Tooltip.prototype.arrow = function () { return (this.$arrow = this.$arrow || this.tip().find('.tooltip-arrow')) } - + javascript + 复制代码 +// 启用tooltip Tooltip.prototype.enable = function () { this.enabled = true } - + javascript + 复制代码 +// 禁用tooltip Tooltip.prototype.disable = function () { this.enabled = false } - + javascript + 复制代码 +// 切换tooltip的启用状态 Tooltip.prototype.toggleEnabled = function () { this.enabled = !this.enabled } - + javascript + 复制代码 +// 切换tooltip的显示状态 Tooltip.prototype.toggle = function (e) { var self = this if (e) { - self = $(e.currentTarget).data('bs.' + this.type) + self = $(e.currentTarget).data('bs.' + this.type) // 获取当前实例 if (!self) { - self = new this.constructor(e.currentTarget, this.getDelegateOptions()) + self = new this.constructor(e.currentTarget, this.getDelegateOptions()) // 创建新实例 $(e.currentTarget).data('bs.' + this.type, self) } } if (e) { + // 切换click状态并根据状态显示或隐藏tooltip self.inState.click = !self.inState.click if (self.isInStateTrue()) self.enter(self) else self.leave(self) } else { - self.tip().hasClass('in') ? self.leave(self) : self.enter(self) + self.tip().hasClass('in') ? self.leave(self) : self.enter(self) // 根据是否显示切换tooltip状态 } } - + javascript + 复制代码 +// 销毁tooltip实例 Tooltip.prototype.destroy = function () { var that = this - clearTimeout(this.timeout) + clearTimeout(this.timeout) // 清除超时 this.hide(function () { + // 移除事件监听和数据 that.$element.off('.' + that.type).removeData('bs.' + that.type) if (that.$tip) { - that.$tip.detach() + that.$tip.detach() // 从DOM中移除tooltip } that.$tip = null that.$arrow = null @@ -1743,37 +1888,39 @@ if (typeof jQuery === 'undefined') { }) } - // TOOLTIP PLUGIN DEFINITION // ========================= - +// 定义Plugin函数，接受option参数，用于在每个元素上执行tooltip插件 function Plugin(option) { return this.each(function () { - var $this = $(this) - var data = $this.data('bs.tooltip') - var options = typeof option == 'object' && option + var $this = $(this) // 获取当前元素的jQuery对象 + var data = $this.data('bs.tooltip') // 获取当前元素的tooltip实例 + var options = typeof option == 'object' && option // 如果传入的是对象，则赋值给options - if (!data && /destroy|hide/.test(option)) return - if (!data) $this.data('bs.tooltip', (data = new Tooltip(this, options))) - if (typeof option == 'string') data[option]() + if (!data && /destroy|hide/.test(option)) return // 如果没有tooltip实例且option是destroy或hide，则直接返回 + if (!data) $this.data('bs.tooltip', (data = new Tooltip(this, options))) // 如果没有tooltip实例，创建新的tooltip实例并绑定到元素 + if (typeof option == 'string') data[option]() // 如果option是字符串，调用对应的tooltip方法 }) } +// 保存之前的tooltip插件实现 var old = $.fn.tooltip +// 将Plugin函数赋值给jQuery的tooltip插件，使其生效 $.fn.tooltip = Plugin - $.fn.tooltip.Constructor = Tooltip + $.fn.tooltip.Constructor = Tooltip // 将Tooltip构造函数挂载到jQuery对象上 +// TOOLTIP NO CONFLICT +// =================== - // TOOLTIP NO CONFLICT - // =================== - +// 恢复之前的tooltip插件实现，避免与其他插件冲突 $.fn.tooltip.noConflict = function () { - $.fn.tooltip = old - return this + $.fn.tooltip = old // 恢复原插件 + return this // 返回当前jQuery对象 } -}(jQuery); +}(jQuery); // 结束jQuery的闭包 + /* ======================================================================== * Bootstrap: popover.js v3.3.7 @@ -1783,71 +1930,81 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; // POPOVER PUBLIC CLASS DEFINITION // =============================== + // 定义Popover类，继承自tooltip类 var Popover = function (element, options) { - this.init('popover', element, options) + this.init('popover', element, options) // 调用初始化方法，传入popover类型 } + // 检查是否存在tooltip，如果不存在则抛出错误 if (!$.fn.tooltip) throw new Error('Popover requires tooltip.js') + // 设置Popover的版本号 Popover.VERSION = '3.3.7' + // 定义Popover的默认配置项，继承tooltip的默认配置，并自定义一些属性 Popover.DEFAULTS = $.extend({}, $.fn.tooltip.Constructor.DEFAULTS, { - placement: 'right', - trigger: 'click', - content: '', - template: '' + placement: 'right', // 设置默认的显示位置为右侧 + trigger: 'click', // 设置触发方式为点击 + content: '', // 设置默认内容为空 + template: '' // 默认的Popover模板 }) - - // NOTE: POPOVER EXTENDS tooltip.js + // 说明Popover继承了tooltip.js的功能 // ================================ + // 使用extend方法继承tooltip的构造函数原型 Popover.prototype = $.extend({}, $.fn.tooltip.Constructor.prototype) + // 设置Popover构造函数 Popover.prototype.constructor = Popover + // 获取Popover的默认配置 Popover.prototype.getDefaults = function () { return Popover.DEFAULTS } + // 设置Popover的内容 Popover.prototype.setContent = function () { - var $tip = this.tip() - var title = this.getTitle() - var content = this.getContent() + var $tip = this.tip() // 获取Popover元素 + var title = this.getTitle() // 获取Popover的标题 + var content = this.getContent() // 获取Popover的内容 + // 设置Popover的标题和内容 $tip.find('.popover-title')[this.options.html ? 'html' : 'text'](title) - $tip.find('.popover-content').children().detach().end()[ // we use append for html objects to maintain js events - this.options.html ? (typeof content == 'string' ? 'html' : 'append') : 'text' - ](content) + $tip.find('.popover-content').children().detach().end()[ + this.options.html ? (typeof content == 'string' ? 'html' : 'append') : 'text' + ](content) + // 移除不需要的CSS类 $tip.removeClass('fade top bottom left right in') - // IE8 doesn't accept hiding via the `:empty` pseudo selector, we have to do - // this manually by checking the contents. + // 兼容IE8的处理：如果Popover的标题为空，手动隐藏标题 if (!$tip.find('.popover-title').html()) $tip.find('.popover-title').hide() } + // 检查Popover是否有内容 Popover.prototype.hasContent = function () { return this.getTitle() || this.getContent() } + // 获取Popover的内容 Popover.prototype.getContent = function () { var $e = this.$element var o = this.options - return $e.attr('data-content') - || (typeof o.content == 'function' ? + return $e.attr('data-content') // 首先检查data-content属性 + || (typeof o.content == 'function' ? // 如果配置项content是一个函数，调用该函数 o.content.call($e[0]) : - o.content) + o.content) // 否则返回配置项content的值 } + // 获取Popover的箭头元素 Popover.prototype.arrow = function () { return (this.$arrow = this.$arrow || this.tip().find('.arrow')) } @@ -1856,33 +2013,39 @@ if (typeof jQuery === 'undefined') { // POPOVER PLUGIN DEFINITION // ========================= + // 定义Popover插件 function Plugin(option) { return this.each(function () { - var $this = $(this) - var data = $this.data('bs.popover') - var options = typeof option == 'object' && option + var $this = $(this) // 获取当前元素的jQuery对象 + var data = $this.data('bs.popover') // 获取Popover实例 + var options = typeof option == 'object' && option // 如果传入的option是对象，则赋值给options + // 如果没有Popover实例，并且传入的option是destroy或hide，则直接返回 if (!data && /destroy|hide/.test(option)) return - if (!data) $this.data('bs.popover', (data = new Popover(this, options))) - if (typeof option == 'string') data[option]() + if (!data) $this.data('bs.popover', (data = new Popover(this, options))) // 如果没有Popover实例，创建新的Popover实例并绑定到元素 + if (typeof option == 'string') data[option]() // 如果option是字符串，调用对应的方法 }) } + // 保存原有的Popover插件实现 var old = $.fn.popover + // 将Plugin函数赋值给jQuery的popover插件 $.fn.popover = Plugin - $.fn.popover.Constructor = Popover + $.fn.popover.Constructor = Popover // 将Popover构造函数挂载到jQuery对象上 // POPOVER NO CONFLICT // =================== + // 恢复原有的Popover插件实现，避免与其他插件冲突 $.fn.popover.noConflict = function () { - $.fn.popover = old - return this + $.fn.popover = old // 恢复原插件 + return this // 返回当前jQuery对象 } -}(jQuery); +}(jQuery); // 结束jQuery的闭包 + /* ======================================================================== * Bootstrap: scrollspy.js v3.3.7 @@ -1892,170 +2055,188 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; // SCROLLSPY CLASS DEFINITION // ========================== + // ScrollSpy类的构造函数 function ScrollSpy(element, options) { - this.$body = $(document.body) - this.$scrollElement = $(element).is(document.body) ? $(window) : $(element) - this.options = $.extend({}, ScrollSpy.DEFAULTS, options) - this.selector = (this.options.target || '') + ' .nav li > a' - this.offsets = [] - this.targets = [] - this.activeTarget = null - this.scrollHeight = 0 - + this.$body = $(document.body) // 获取document.body + this.$scrollElement = $(element).is(document.body) ? $(window) : $(element) // 设置滚动元素，如果是body则使用window + this.options = $.extend({}, ScrollSpy.DEFAULTS, options) // 合并默认配置和用户配置 + this.selector = (this.options.target || '') + ' .nav li > a' // 目标选择器 + this.offsets = [] // 存储偏移量 + this.targets = [] // 存储目标元素 + this.activeTarget = null // 当前激活的目标 + this.scrollHeight = 0 // 当前滚动区域的高度 + + // 绑定滚动事件 this.$scrollElement.on('scroll.bs.scrollspy', $.proxy(this.process, this)) - this.refresh() - this.process() + this.refresh() // 初始化时刷新偏移量和目标元素 + this.process() // 初始化时调用处理函数 } + // 设置ScrollSpy的版本号 ScrollSpy.VERSION = '3.3.7' + // ScrollSpy的默认配置 ScrollSpy.DEFAULTS = { - offset: 10 + offset: 10 // 设置偏移量，默认为10 } + // 获取滚动区域的总高度 ScrollSpy.prototype.getScrollHeight = function () { return this.$scrollElement[0].scrollHeight || Math.max(this.$body[0].scrollHeight, document.documentElement.scrollHeight) } + // 刷新偏移量和目标元素 ScrollSpy.prototype.refresh = function () { var that = this - var offsetMethod = 'offset' - var offsetBase = 0 + var offsetMethod = 'offset' // 默认使用offset获取位置 + var offsetBase = 0 // 初始偏移量 - this.offsets = [] - this.targets = [] - this.scrollHeight = this.getScrollHeight() + this.offsets = [] // 清空偏移量数组 + this.targets = [] // 清空目标数组 + this.scrollHeight = this.getScrollHeight() // 获取当前滚动区域高度 - if (!$.isWindow(this.$scrollElement[0])) { + if (!$.isWindow(this.$scrollElement[0])) { // 如果不是window，使用position方法 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) - - return ($href - && $href.length - && $href.is(':visible') - && [[$href[offsetMethod]().top + offsetBase, href]]) || null - }) - .sort(function (a, b) { return a[0] - b[0] }) - .each(function () { - that.offsets.push(this[0]) - that.targets.push(this[1]) - }) + .find(this.selector) + .map(function () { + var $el = $(this) // 当前元素 + var href = $el.data('target') || $el.attr('href') // 获取目标的ID + 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 () { + that.offsets.push(this[0]) // 存储偏移量 + that.targets.push(this[1]) // 存储目标 + }) } + // 处理滚动事件，检查当前滚动位置并激活相应目标 ScrollSpy.prototype.process = function () { - var scrollTop = this.$scrollElement.scrollTop() + this.options.offset - var scrollHeight = this.getScrollHeight() - var maxScroll = this.options.offset + scrollHeight - this.$scrollElement.height() - var offsets = this.offsets - var targets = this.targets - var activeTarget = this.activeTarget + var scrollTop = this.$scrollElement.scrollTop() + this.options.offset // 获取当前滚动位置 + var scrollHeight = this.getScrollHeight() // 获取滚动区域总高度 + var maxScroll = this.options.offset + scrollHeight - this.$scrollElement.height() // 计算最大滚动高度 + var offsets = this.offsets // 偏移量数组 + var targets = this.targets // 目标数组 + var activeTarget = this.activeTarget // 当前激活的目标 var i - if (this.scrollHeight != scrollHeight) { + if (this.scrollHeight != scrollHeight) { // 如果滚动区域高度发生变化，刷新 this.refresh() } - if (scrollTop >= maxScroll) { + if (scrollTop >= maxScroll) { // 如果滚动到达最大位置，激活最后一个目标 return activeTarget != (i = targets[targets.length - 1]) && this.activate(i) } - if (activeTarget && scrollTop < offsets[0]) { + if (activeTarget && scrollTop < offsets[0]) { // 如果当前激活的目标在最上方，清除激活状态 this.activeTarget = null return this.clear() } + // 检查每个目标元素，判断是否需要激活 for (i = offsets.length; i--;) { - activeTarget != targets[i] - && scrollTop >= offsets[i] - && (offsets[i + 1] === undefined || scrollTop < offsets[i + 1]) - && this.activate(targets[i]) + activeTarget != targets[i] // 如果目标不等于当前激活的目标 + && scrollTop >= offsets[i] // 且滚动位置大于目标的偏移量 + && (offsets[i + 1] === undefined || scrollTop < offsets[i + 1]) // 且滚动位置小于下一个目标的偏移量 + && this.activate(targets[i]) // 激活该目标 } } + // 激活目标 ScrollSpy.prototype.activate = function (target) { - this.activeTarget = target + this.activeTarget = target // 设置当前激活的目标 - this.clear() + this.clear() // 清除其他目标的激活状态 var selector = this.selector + - '[data-target="' + target + '"],' + - this.selector + '[href="' + target + '"]' + '[data-target="' + target + '"],' + + this.selector + '[href="' + target + '"]' // 根据目标生成选择器 - var active = $(selector) - .parents('li') - .addClass('active') + var active = $(selector) // 查找对应目标的元素 + .parents('li') // 获取父级li元素 + .addClass('active') // 给父级li添加active类 + // 如果父级是dropdown-menu，则激活最近的父级li.dropdown if (active.parent('.dropdown-menu').length) { active = active - .closest('li.dropdown') - .addClass('active') + .closest('li.dropdown') + .addClass('active') } - active.trigger('activate.bs.scrollspy') + active.trigger('activate.bs.scrollspy') // 触发激活事件 } + // 清除所有激活状态 ScrollSpy.prototype.clear = function () { $(this.selector) - .parentsUntil(this.options.target, '.active') - .removeClass('active') + .parentsUntil(this.options.target, '.active') + .removeClass('active') // 移除所有激活的类 } // SCROLLSPY PLUGIN DEFINITION // =========================== + // 定义ScrollSpy插件 function Plugin(option) { return this.each(function () { - var $this = $(this) - var data = $this.data('bs.scrollspy') - var options = typeof option == 'object' && option + var $this = $(this) // 获取当前元素 + var data = $this.data('bs.scrollspy') // 获取ScrollSpy实例 + var options = typeof option == 'object' && option // 如果option是对象，则赋值给options - if (!data) $this.data('bs.scrollspy', (data = new ScrollSpy(this, options))) - if (typeof option == 'string') data[option]() + if (!data) $this.data('bs.scrollspy', (data = new ScrollSpy(this, options))) // 如果没有ScrollSpy实例，创建新的实例并绑定 + if (typeof option == 'string') data[option]() // 如果option是字符串，调用对应的方法 }) } + // 保存原有的ScrollSpy插件实现 var old = $.fn.scrollspy + // 将Plugin函数赋值给jQuery的scrollspy插件 $.fn.scrollspy = Plugin - $.fn.scrollspy.Constructor = ScrollSpy + $.fn.scrollspy.Constructor = ScrollSpy // 将ScrollSpy构造函数挂载到jQuery对象上 // SCROLLSPY NO CONFLICT // ===================== + // 恢复原有的ScrollSpy插件实现，避免与其他插件冲突 $.fn.scrollspy.noConflict = function () { - $.fn.scrollspy = old - return this + $.fn.scrollspy = old // 恢复原插件 + return this // 返回当前jQuery对象 } // SCROLLSPY DATA-API // ================== + // 当页面加载完毕，初始化所有data-spy="scroll"的元素 $(window).on('load.bs.scrollspy.data-api', function () { $('[data-spy="scroll"]').each(function () { var $spy = $(this) - Plugin.call($spy, $spy.data()) + Plugin.call($spy, $spy.data()) // 调用插件 }) }) -}(jQuery); +}(jQuery); // 结束jQuery的闭包 + /* ======================================================================== * Bootstrap: tab.js v3.3.7 @@ -2065,36 +2246,41 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; // TAB CLASS DEFINITION // ==================== + // Tab类的构造函数 var Tab = function (element) { // jscs:disable requireDollarBeforejQueryAssignment - this.element = $(element) + this.element = $(element) // 将元素封装成jQuery对象 // jscs:enable requireDollarBeforejQueryAssignment } + // 设置Tab版本 Tab.VERSION = '3.3.7' + // Tab的过渡时长 Tab.TRANSITION_DURATION = 150 + // 显示Tab Tab.prototype.show = function () { - var $this = this.element - var $ul = $this.closest('ul:not(.dropdown-menu)') - var selector = $this.data('target') + var $this = this.element // 获取Tab元素 + var $ul = $this.closest('ul:not(.dropdown-menu)') // 获取Tab所在的ul元素 + var selector = $this.data('target') // 获取目标选择器 + // 如果没有指定目标选择器，从href属性获取 if (!selector) { selector = $this.attr('href') - selector = selector && selector.replace(/.*(?=#[^\s]*$)/, '') // strip for ie7 + selector = selector && selector.replace(/.*(?=#[^\s]*$)/, '') // 去掉前缀（兼容ie7） } + // 如果当前Tab已激活，则不进行任何操作 if ($this.parent('li').hasClass('active')) return - var $previous = $ul.find('.active:last a') + var $previous = $ul.find('.active:last a') // 获取当前激活Tab var hideEvent = $.Event('hide.bs.tab', { relatedTarget: $this[0] }) @@ -2102,15 +2288,19 @@ if (typeof jQuery === 'undefined') { relatedTarget: $previous[0] }) + // 触发hide和show事件 $previous.trigger(hideEvent) $this.trigger(showEvent) + // 如果有任何一个事件被取消，停止执行 if (showEvent.isDefaultPrevented() || hideEvent.isDefaultPrevented()) return - var $target = $(selector) + var $target = $(selector) // 获取目标Tab元素 + // 激活Tab this.activate($this.closest('li'), $ul) this.activate($target, $target.parent(), function () { + // 触发Tab切换后的事件 $previous.trigger({ type: 'hidden.bs.tab', relatedTarget: $this[0] @@ -2122,51 +2312,59 @@ if (typeof jQuery === 'undefined') { }) } + // 激活指定的Tab Tab.prototype.activate = function (element, container, callback) { - var $active = container.find('> .active') + var $active = container.find('> .active') // 获取当前激活的Tab var transition = callback - && $.support.transition - && ($active.length && $active.hasClass('fade') || !!container.find('> .fade').length) + && $.support.transition + && ($active.length && $active.hasClass('fade') || !!container.find('> .fade').length) + // 激活Tab的函数 function next() { + // 清除当前Tab的激活状态 $active - .removeClass('active') - .find('> .dropdown-menu > .active') .removeClass('active') - .end() - .find('[data-toggle="tab"]') + .find('> .dropdown-menu > .active') + .removeClass('active') + .end() + .find('[data-toggle="tab"]') .attr('aria-expanded', false) + // 设置目标Tab为激活状态 element - .addClass('active') - .find('[data-toggle="tab"]') + .addClass('active') + .find('[data-toggle="tab"]') .attr('aria-expanded', true) + // 如果有过渡效果，添加'in'类以触发过渡动画 if (transition) { - element[0].offsetWidth // reflow for transition + element[0].offsetWidth // 强制回流以触发过渡 element.addClass('in') } else { element.removeClass('fade') } + // 如果Tab在dropdown菜单中，则处理父级元素 if (element.parent('.dropdown-menu').length) { element - .closest('li.dropdown') + .closest('li.dropdown') .addClass('active') - .end() - .find('[data-toggle="tab"]') + .end() + .find('[data-toggle="tab"]') .attr('aria-expanded', true) } - callback && callback() + callback && callback() // 调用回调函数 } + // 如果存在过渡效果，绑定'bsTransitionEnd'事件来完成动画 $active.length && transition ? - $active - .one('bsTransitionEnd', next) - .emulateTransitionEnd(Tab.TRANSITION_DURATION) : - next() + $active + .one('bsTransitionEnd', next) + .emulateTransitionEnd(Tab.TRANSITION_DURATION) : + next() + // 移除过渡的'in'类 $active.removeClass('in') } @@ -2174,45 +2372,55 @@ if (typeof jQuery === 'undefined') { // TAB PLUGIN DEFINITION // ===================== + // 定义Tab插件 function Plugin(option) { return this.each(function () { - var $this = $(this) - var data = $this.data('bs.tab') + var $this = $(this) // 获取当前元素 + var data = $this.data('bs.tab') // 获取Tab实例 + var options = typeof option == 'object' && option // 如果option是对象，则赋值给options + // 如果没有Tab实例，则创建一个新的Tab实例 if (!data) $this.data('bs.tab', (data = new Tab(this))) + // 如果option是字符串，调用对应的方法 if (typeof option == 'string') data[option]() }) } + // 保存原来的Tab插件实现 var old = $.fn.tab + // 将Plugin函数赋值给jQuery的tab插件 $.fn.tab = Plugin - $.fn.tab.Constructor = Tab + $.fn.tab.Constructor = Tab // 将Tab构造函数挂载到jQuery对象上 // TAB NO CONFLICT // =============== + // 恢复原有的Tab插件实现，避免与其他插件冲突 $.fn.tab.noConflict = function () { - $.fn.tab = old - return this + $.fn.tab = old // 恢复原插件 + return this // 返回当前jQuery对象 } // TAB DATA-API // ============ + // 处理Tab的点击事件，触发show方法 var clickHandler = function (e) { - e.preventDefault() - Plugin.call($(this), 'show') + e.preventDefault() // 阻止默认事件 + Plugin.call($(this), 'show') // 调用show方法显示对应Tab } + // 绑定事件：点击Tab时触发相应的show事件 $(document) - .on('click.bs.tab.data-api', '[data-toggle="tab"]', clickHandler) - .on('click.bs.tab.data-api', '[data-toggle="pill"]', clickHandler) + .on('click.bs.tab.data-api', '[data-toggle="tab"]', clickHandler) + .on('click.bs.tab.data-api', '[data-toggle="pill"]', clickHandler) }(jQuery); + /* ======================================================================== * Bootstrap: affix.js v3.3.7 * http://getbootstrap.com/javascript/#affix @@ -2221,44 +2429,50 @@ if (typeof jQuery === 'undefined') { * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) * ======================================================================== */ - +function ($) { 'use strict'; // AFFIX CLASS DEFINITION // ====================== + // Affix类的构造函数 var Affix = function (element, options) { this.options = $.extend({}, Affix.DEFAULTS, options) - this.$target = $(this.options.target) - .on('scroll.bs.affix.data-api', $.proxy(this.checkPosition, this)) - .on('click.bs.affix.data-api', $.proxy(this.checkPositionWithEventLoop, this)) + this.$target = $(this.options.target) // 绑定目标（通常是window或document） + .on('scroll.bs.affix.data-api', $.proxy(this.checkPosition, this)) // 监听滚动事件 + .on('click.bs.affix.data-api', $.proxy(this.checkPositionWithEventLoop, this)) // 监听点击事件 - this.$element = $(element) - this.affixed = null - this.unpin = null - this.pinnedOffset = null + this.$element = $(element) // 绑定目标元素 + this.affixed = null // 当前固定状态 + this.unpin = null // 存储解除固定的偏移量 + this.pinnedOffset = null // 存储固定偏移量 - this.checkPosition() + this.checkPosition() // 初始化时检查位置 } + // 设置Affix版本 Affix.VERSION = '3.3.7' + // Affix的重置类名 Affix.RESET = 'affix affix-top affix-bottom' + // Affix的默认配置 Affix.DEFAULTS = { - offset: 0, - target: window + offset: 0, // 偏移量 + target: window // 监听目标，默认是window } + // 获取元素的状态（例如是否需要固定） Affix.prototype.getState = function (scrollHeight, height, offsetTop, offsetBottom) { - var scrollTop = this.$target.scrollTop() - var position = this.$element.offset() - var targetHeight = this.$target.height() + var scrollTop = this.$target.scrollTop() // 获取滚动距离 + var position = this.$element.offset() // 获取元素位置 + var targetHeight = this.$target.height() // 获取目标高度 + // 判断是否固定在顶部 if (offsetTop != null && this.affixed == 'top') return scrollTop < offsetTop ? 'top' : false + // 判断是否固定在底部 if (this.affixed == 'bottom') { if (offsetTop != null) return (scrollTop + this.unpin <= position.top) ? false : 'bottom' return (scrollTop + targetHeight <= scrollHeight - offsetBottom) ? false : 'bottom' @@ -2274,6 +2488,7 @@ if (typeof jQuery === 'undefined') { return false } + // 获取固定偏移量 Affix.prototype.getPinnedOffset = function () { if (this.pinnedOffset) return this.pinnedOffset this.$element.removeClass(Affix.RESET).addClass('affix') @@ -2282,10 +2497,12 @@ if (typeof jQuery === 'undefined') { return (this.pinnedOffset = position.top - scrollTop) } + // 定期检查位置 Affix.prototype.checkPositionWithEventLoop = function () { setTimeout($.proxy(this.checkPosition, this), 1) } + // 检查元素的固定位置 Affix.prototype.checkPosition = function () { if (!this.$element.is(':visible')) return @@ -2315,9 +2532,9 @@ if (typeof jQuery === 'undefined') { this.unpin = affix == 'bottom' ? this.getPinnedOffset() : null this.$element - .removeClass(Affix.RESET) - .addClass(affixType) - .trigger(affixType.replace('affix', 'affixed') + '.bs.affix') + .removeClass(Affix.RESET) + .addClass(affixType) + .trigger(affixType.replace('affix', 'affixed') + '.bs.affix') } if (affix == 'bottom') { @@ -2360,6 +2577,7 @@ if (typeof jQuery === 'undefined') { // AFFIX DATA-API // ============== + // 初始化affix功能，绑定到窗口加载事件 $(window).on('load', function () { $('[data-spy="affix"]').each(function () { var $spy = $(this) @@ -2375,3 +2593,4 @@ if (typeof jQuery === 'undefined') { }) }(jQuery); +