Bootstrap transition.js 插件详解

Bootstrap 自带的 JavaScript 插件的动画效果几乎都是使用 CSS 过渡实现的，而其中的 transition.js 就是为了判断当前使用的浏览器是否支持 CSS 过渡。下面先来简单了解下 CSS 过渡。

CSS 过渡

CSS 过渡是指在 CSS 属性发生改变时在一段时间内平滑地过渡，使用 CSS 伪类可以很方便地使用：

a {
  color: #333;
  transition: color 1s linear;
}

a:hover {
  color: #36f;
}

这里给链接设置了一个 1秒的颜色过渡效果，当鼠标经过链接激活链接 :hover 状态的时候文字的颜色会从黑色平滑地变化为蓝色，鼠标移开时又平滑地变回来。

仅仅依靠伪类来使用过渡显得太单调了，使用 JavaScript 来动态添加删除 class 才能尽情地玩弄过渡：

/* 这是一个圆 */
.circle {
  background-color: red;
  border-radius: 50%;
  height: 100px;
  margin-left: 220px;
  transition: transform 1s linear;
  width: 100px;
}

/* 添加 left 类水平向左偏移 200 像素 */
.circle.left {
  transform: translateX(-200px);
}

/* 添加 right 类水平向右偏移 200 像素 */
.circle.right {
  transform: translateX(200px);
}

JavaScript 的工作就是简单的删除和添加 class：

function toLeft() {
  $('.circle').removeClass('right').addClass('left');
}

function toRight() {
  $('.circle').removeClass('left').addClass('right');
}

你让它往左，它不敢往右！demo上面的例子展示了当元素状态改变或者添加了某个 class 的时候过渡就开始发生了，那么如何知道过渡什么时候结束呢？

Transitionend 事件

想要知道过渡什么时候结束，就要监听 transitionend 事件(事件名称全是小写字母)。

$('.circle').one('transitionend', function() {
  alert('过渡结束啦!');
});

这里使用 one 方法而不是 on 方法是为了避免 transitionend 事件多次执行。one 方法添加的事件回调只会执行一次，更多信息参考官方 API。

不过这只是标准的事件名称写法，在标准之前浏览器有各自的实现方式以及不同的事件名称(比如低版本的 Chrome 和 Safari 的该事件名称就叫 webkitTransitionEnd)，所以为了兼容更多的浏览器，一种比较笨拙的方式可以写成像下面这样：

$('.circle').one('transitionend webkitTransitionEnd oTransitionEnd otransitionend', function() {});

很长一串，而且这种写法还有一点问题！

在这里可以看到为什么是上面这些事件名称，而没有 msTransitionEnd 之类。

为了根据浏览器更有针对性地添加 transitionend 事件回调，而不是像上面那样一骨碌地全加上，就需要先判断一下该浏览器到底支持哪种 transitionend 事件名称，判断方法则是根据浏览器支持 CSS 过渡的属性名称而定：

var el = document.createElement('bootstrap'); // 创建一个元素用于测试

if (el.style.transition !== undefined) {
  // 判断元素的 style.transition 属性如果存在
  // 则以此类推该浏览器支持标准的 CSS transition 属性以及标准的 transitionend 事件
} else if (el.style.WebkitTransition !== undefined) {
  // 判断元素的 style.WebkitTransition 属性如果存在
  // 则该浏览器支持替代的 webkitTransitionEnd 事件
} else {...}

按照当前的主流浏览器趋势总共需要判断四种不同前缀的属性名称：

el.style.transition
el.style.WebkitTransition
el.style.MozTransition
el.style.OTransition

判断方式就是这样，废话就说到这里，直接上正牌代码，Bootstrap transition.js 内部的判断函数：

function transitionEnd() {
  // 创建一个元素用于测试
  var el = document.createElement('bootstrap');

  // 将所有主流浏览器实现方式整合成一个对象，用于遍历
  // key   是属性名称
  // value 是事件名称
  var transEndEventNames = {
    WebkitTransition : 'webkitTransitionEnd',
    MozTransition    : 'transitionend',
    OTransition      : 'oTransitionEnd otransitionend',
    transition       : 'transitionend'
  };

  // 循环遍历上面那个对象，判断 CSS 属性是否存在
  for (var name in transEndEventNames) {
    if (el.style[name] !== undefined) {
      return { end: transEndEventNames[name] };
    }
  }

  return false;
}

执行该函数可以得到一个对象 {end: 'transitionend'} 或者 false (表示浏览器不支持 CSS 过渡)，该对象的 end 属性保存着浏览器所支持的 transitionend 事件对应的名称：

var transition = transitionEnd();

比如我使用低版本的 Chrome 浏览器的话，那么得到的对象就是 {end: 'webkitTransitionEnd'} 这样；如果使用 IE 8 则是 false，然后就可以添加该事件的回调函数了：

// 如果 transition 为 false 则不添加事件回调
transition && $('.circle').one(transition.end, function() {});

为了与 jQuery 保持一致，将该返回结果赋值到 $.support.transition 上：

$.support.transition = transitionEnd();

// 使用方式是类似的
$.support.transition && $('.circle').one($.support.transition.end, function() {});

EmulateTransitionEnd

事件名称的问题基本上解决了，但是这个事件有个问题就是有时根本不会触发，这是因为属性值没有发生变化或没有绘制行为发生。要确保每次回调都会被调用，我们增加一个定时器即可：

$.fn.emulateTransitionEnd = function(duration) {
  var called = false; // transitionend 事件是否已触发标识
  var $el = this;
  $(this).one($.support.transition.end, function () {
    called = true; // 表示已触发
  });
  var callback = function() {
    if (!called) {
      $($el).trigger($.support.transition.end); // 未触发，强制其触发
    }
  };
  setTimeout(callback, duration); // 一段时间后检测是否触发
  return this;
};

该方法的作用是一段时间(就是过渡持续的时间 transition-duration )过后如果 transitionend 事件没有发生则强制在该元素上触发这个事件。

$('.circle').one($.support.transition.end, function() {});
$('.circle').emulateTransitionEnd(1000); // 这个时间是过渡持续的时间

这样确保过渡之后一定会有回调。到这里，基本上就差不多了，不过 $.support.transition.end 好恶心啊！能不能像添加其它事件回调一样使用事件名称字符串的形式，比如 'click'，当然可以。

自定义事件

$(function () {
  $.support.transition = transitionEnd();

  // 支持过渡的时候才执行后面的代码
  if (!$.support.transition) {return;}

  $.event.special.bsTransitionEnd = {
    bindType: $.support.transition.end,
    delegateType: $.support.transition.end,
    handle: function (e) {
      if ($(e.target).is(this)) {
        return e.handleObj.handler.apply(this, arguments);
      }
    }
  };
});

添加事件回调的时候就可以像这样：

$('.circle').one('bsTransitionEnd', function() {})
  .emulateTransitionEnd(1000);

其它

CSS 动画同样也有一个 animationend 事件，同时还有 animationstart 和 animationiteration 事件，可以参考这种方式自己写一个。

参考资料

• All you need to know about CSS Transitions
• Using CSS transitions
• Detecting CSS Animation Completion with JavaScript