AngularJS1.X学习笔记14-动画(解读文档)

  最近在看算法分析,那个大O啊,小o啊,分治法啊(目前就看到这里),真是搞死了。这回呢休息一下,学学AngularJS动画,上一篇文章根据自由男人的书简单谈到了动画的话题,发现反响很大(好吧,我说慌了,那篇文章的动画谈得太简单了),今天来看看官方文档。嗯,边看边写。

一、安装

  这个应该都知道了,和其他的扩展模块安装相同。这里为了文章完整性简单提一下。文档给到了获取动画扩展angular-animate.js的多种方式。

  1、cdn,自己去查

  2、npm install --save angular-animate@X.Y.Z   

  3、bower install angular-animate#X.Y.Z

  拿到这个文件后需要引入到我们要应用动画的页面,添加依赖ngAnimate。

二、使用

  动画的使用方式有两种,一是CSS,二是通过javascript。前者是通过纯粹的css来实现动画,后者通过脚本触发动画。两者都需要用到Angrular提供的一些特殊的类。

  1、支持动画的指令

  AngularJS1.X学习笔记14-动画(解读文档)_第1张图片

  最后两个指令属于一个扩展模块ngMessages,为了集中火力搞动画,先不管。

  2、基于CSS的动画

  CSS动画的特殊性在于你不需要写一行javascript就可以创建出炫酷的动画,这让我想到了Bootstrap,她只要在html元素上添加一些特定的属性就可以实现一些动画。Angularjs基于CSS实现动画的原理很简单,即,如果你为某个指令加上了一些类比如fade,而你在样式表中这样写.fade.ng-leave,这样如果元素没有ng-leave这个类,你加的fade的样式就不会被运用,但是Angularjs会监视我们的指令,当检测到指令进入某种状态时就会添加相应的类,从而你的样式就会被使用了,如此,动画就触发了。下面给个例子

  

DOCTYPE html>
<html lang="en" ng-app='myApp'>
<head>
    <meta charset="UTF-8">
    <title>animatetitle>
    <style type="text/css">
        #div{
            width: 300px;
            height: 300px;
            background:red;
        }
        .ani.ng-hide{
            transition: 6s linear all;
            opacity: 0;
            background: blue;
        }
    style>
head>
<body>
    <div ng-controller='animateCtrl'>
        <div id="div" class="ani" ng-show='show'>div>
        <button ng-click='clickHandler()'>changebutton>
    div>


    <script type="text/javascript" src="../node_modules/angular/angular.min.js">script>
    <script type="text/javascript" src="../node_modules/angular-animate/angular-animate.min.js">script>
    <script type="text/javascript">
        var myApp = angular.module("myApp",['ngAnimate']);
        myApp.controller("animateCtrl",function($scope){
            $scope.show = true;
            $scope.clickHandler = function(){
                $scope.show = !$scope.show;
            }
        })
    script>
body>
html>

  我们看一下当单击按钮隐藏时发生了什么。

AngularJS1.X学习笔记14-动画(解读文档)_第2张图片

  看到没,angular给我们动态添加了很多类,正是因为如此,我们的动画样式才能被应用。

  有开始有结束

/* The starting CSS styles for the enter animation */
.fade.ng-enter {
  transition:0.5s linear all;
  opacity:0;
}

/* The finishing CSS styles for the enter animation */
.fade.ng-enter.ng-enter-active {
  opacity:1;
}

 

  angularjs对动画元素的状态进行了管理,可以标识状态的开始如ng-enter 和状态的结束 ng-enter-active.我们可以在状态开始指定动画的初始状态,状态的结束指定动画的最终状态。

  另外,angular提供了自己加类的机制。

  

<div ng-class="{on:onOff}" class="highlight">
  Highlight this box
div>
<button ng-click="onOff=!onOff">Togglebutton>

<style>
.highlight {
  transition:0.5s linear all;
}
.highlight.on-add {
  background:white;
}
.highlight.on {
  background:yellow;
}
.highlight.on-remove {
  background:black;
}
style>

 

  这个例子的意思是,如果onOff为真,那么给元素加上on这个类,在添加的过程中会添加on-add类,当onOff为false是,会为元素添加一个on-remove,当然,这个on-remove只存在与由true变为false的过程。

  有时候我们希望进入某个状态后并不立即执行动画,而是延迟执行,你一定想到了transition-delay或者animation-delay,ng也给我们提供了实现的方法。

  

.my-animation.ng-enter-stagger {
  /* this will have a 100ms delay between each successive leave animation */
  transition-delay: 0.1s;

  /* As of 1.4.4, this must always be set: it signals ngAnimate
    to not accidentally inherit a delay property from another CSS class */
  transition-duration: 0s;

  /* if you are using animations instead of transitions you should configure as follows:
    animation-delay: 0.1s;
    animation-duration: 0s; */
}

 

  就像这个样子,给我们的动画类加上一个叫.ng-xx-stagger的东东。

  介绍一个状态,在动画开始之前的状态,ng-xx-prepare,xx 可以是enter, move, and leave。用法如下:

.message.ng-enter-prepare {
  opacity: 0;
}

 

  这个可以给我们的元素在没有开始动画(或者叫即将开始吧)的情况下设置样式。

   3、基于javascript的动画

  ngAmination模块允许使用javascript使用其动画功能,方式与CSS类似,不同的是它需要调一个模块的animation()  方法,使用js的好处是我们可以用一些优秀的js动画库来设计动画。

DOCTYPE html>
<html lang="en" ng-app='myApp'>
<head>
    <meta charset="UTF-8">
    <title>animate3title>
    <style type="text/css">
        #hh{
            width: 100px;
            height: 50px;
            background: red;
        }
        
    style>
head>
<body>
    <div ng-controller='animateCtrl'>
        <div id="hh" ng-if="bool" class="slide">
          大家好!
        div>
        <button ng-click="handler()">点我button>
    div>

    <script type="text/javascript" src="../node_modules/jquery/dist/jquery.min.js">script>
    <script type="text/javascript" src="../node_modules/angular/angular.min.js">script>
    <script type="text/javascript" src="../node_modules/angular-animate/angular-animate.min.js">script>
    
    <script type="text/javascript">
        var myApp = angular.module("myApp",['ngAnimate']);
        myApp.controller("animateCtrl",function($scope){
            $scope.handler = function(){
                $scope.bool = !$scope.bool;
            }
        });

        myApp.animation('.slide', [function() {
          return {
            // make note that other events (like addClass/removeClass)
            // have different function input parameters
            enter: function(element, doneFn) {
              jQuery(element).fadeIn(1000, doneFn);

              // remember to call doneFn so that AngularJS
              // knows that the animation has concluded
            },

            leave: function(element, doneFn) {
              jQuery(element).fadeOut(10000, doneFn);
            }
          }
        }]);
    script>
body>
html>

   不同指令支持的动画有区别,可以参见本文最前面的图,本例中用到了enter,和leave。

  4、基于css的方式和基于javascript的方式可以混用吗

  文档讲:如果css方式和js方式使用了相同的css类,那么css方式将不能工作。但是,我们可以通过js去让我们用css方式定义的动画执行,这就需要一个新的服务叫做$animateCss

  

myModule.animation('.slide', ['$animateCss', function($animateCss) {
  return {
    enter: function(element) {
       // this will trigger `.slide.ng-enter` and `.slide.ng-enter-active`.
      return $animateCss(element, {
        event: 'enter',
        structural: true
      });
    }
  }
}]);

 

   下文中对$animateCss进行详细介绍,这里简单提示。

  5、锚动画

  


<div ng-view class="view-animation">
div>


<a href="#/banner-page">
  <img src="./banner.jpg" class="banner" ng-animate-ref="banner">
a>


<img src="./banner.jpg" class="banner" ng-animate-ref="banner">

 

 

.banner.ng-anchor {
  /* this animation will last for 1 second since there are
         two phases to the animation (an `in` and an `out` phase) */
  transition:0.5s linear all;
}
.view-animation.ng-enter, .view-animation.ng-leave {
  transition:0.5s linear all;
  position:fixed;
  left:0;
  top:0;
  width:100%;
}
.view-animation.ng-enter {
  transform:translateX(100%);
}
.view-animation.ng-leave,
.view-animation.ng-enter.ng-enter-active {
  transform:translateX(0%);
}
.view-animation.ng-leave.ng-leave-active {
  transform:translateX(-100%);
}

 

  这里贴出文档的例子,ng-animate-ref的意思是将表明组件的关系,这样在写动画是就可以只用一个类是两个组件效果相同,.ng-anchor-in .ng-anchor-out .ng-anchor分别是在某组件显示,某组件卸载,显示卸载时添加的类,这样可以在不同的状态运用动画。你可以看看文档的一个DEMO:https://plnkr.co/edit/?p=preview

  关于angular是如何实现变形的,如何实现移动的感兴趣可以看看https://docs.angularjs.org/api/ngAnimate

三、$animate服务

  $animate服务提供了一些实现动画的工具方法,官方建议是只应该将其用在与dom相关的动画指令中。这翻译的自己都不明白了,英语太差了,如果你想了解更多自己去官网看看,别看我瞎扯了。

  1、on(event, container, callback)

  这个方法的目的是设置事件侦听器,一旦某元素上触发动画事件(前文有提到的enter,leave等),其中的回调函数将被调用。

  这个方法接受三个参数:event表示要侦听的动画事件类型,container是一个dom元素,表示要侦听的dom元素(注意他是有事件代理功能的,及子元素的事件会冒泡到该元素被捕获),callback是个回调函数,当事件被触发是执行,可以有两个参数,第一个表示触发事件的元素,第二个表示动画阶段个:值start表动画开始,值close表动画结束。

  2、off(event, [container], [callback])

  这个方法是移出元素的侦听器,参数与上一个方法的类似。

  3、pin(element, parentElement)

  不太能够理解这个方法。文档说这个方法能够让angular应用之外的元素能够执行动画,一般来将我们的angular应用的dom元素都是包含在ng-app内的,也就是说没有元素跑到angular应用之外,所以这个方法很让我费解。

  4、enabled([element], [enabled])

  此方法用于启用或禁用动画。有四种使用方法。

  

// returns true or false
$animate.enabled();

// changes the enabled state for all animations
$animate.enabled(false);
$animate.enabled(true);

// returns true or false if animations are enabled for an element
$animate.enabled(element);

// changes the enabled state for an element and its children
$animate.enabled(element, true);
$animate.enabled(element, false);

 

  5、cancel(animationPromise)

  用于取消动画执行。

  6、enter(element, parent, [after], [options])

  将element作为parent的第一个子元素或者after元素后面的元素。options是一个对象可有下面这几个属性:

  • addClass - 添加到element的类
  • from - {Object} - 表示动画开始时的css样式
  • removeClass - {string} -移除element类
  • to - {Object} - 表示动画结束时的css样式

  这个方法返回一个promise对象,动画完成时变为resolved状态。

  7、move(element, parent, [after], [options])

  将element移动到一个新的位置。返回一个promise,与enter()类似。

  8、leave(element, [options])

  触发动画然后删除element

  9、addClass(element, className, [options])

  将className类加到element上并触发addClass事件。

  10、removeClass(element, className, [options])

  移出className类并触发removeClass事件。

  11、setClass(element, add, remove, [options])

  12、animate(element, from, to, [className], [options])

  本文给到了一个angular动画的一个参考,涉及到ngAnimate的一些个用法,包括如何用CSS指定动画,如何用js触发动画等,然后讲到了$animate服务,不过感觉官网讲的也不够详细(也可能是我的英语太差了)。与angular动画相关的还有$aniamteCss服务,本文没有讲,防止越讲越乱,感觉上面讲的已经够乱了。

  参考:

  • https://docs.angularjs.org/api/ng/service/$animate
  • https://docs.angularjs.org/api/ngAnimate/service/$animateCss
  • https://docs.angularjs.org/api/ngAnimate

你可能感兴趣的:(AngularJS1.X学习笔记14-动画(解读文档))