React 附件动画API ReactCSSTransitionGroup

React为卡通提供了一个外加组件ReactTransitionGroup,这么些附加组件是卡通的底层API,并且还提供了一个附件组件ReactCSSTransitionGroup,ReactCSSTransitionGroup可以简单的落实基于css的卡通片和转移

高级API ReactCSSTransitionGroup

ReactCSSTransitionGroup是一个基于ReactTransitionGroup的API,当一个React组件插入或者移除DOM时,它是一种简易的去执行css转换和卡通的法门

以一个demo举例

ReactCSSTransitionGroup是ReactTransitions的接口,可以把它看做一个简易的因素,它包裹着富有想添加动画效率的React组件。下边有一个例子:

var ReactCSSTransitionGroup = require('react-addons-css-transition-group');
    var React = require('react');
    var ReactDOM = require('react-dom');
    var data = ['one','two','three'];
    var Control = React.createClass({
        getInitialState:function(){
            return {
                'items':this.props.data
            }
        },
        addItem:function(){
            var newItems = this.state.items.concat('four');
            this.setState({
                'items':newItems
            });
        },
        removeItem:function(i){
            var newItems = this.state.items;
            newItems.splice(i,1);
            this.setState({
                'items':newItems
            });
        },
        render:function(){
            var $this = this;
            var List = this.state.items.map(function(value,index){
                return <div key={value} onClick = {$this.removeItem.bind($this,index)}> { value}</div>
            });
            return (
                <div>
                    <button onClick={this.addItem}>add Item</button>
                    <ReactCSSTransitionGroup
                        transitionName='example'
                        transitionEnterTimeout={500}
                        transitionLeaveTimeout={300}>
                        {List}
                    </ReactCSSTransitionGroup>
                </div>
            )
        }
    });
    ReactDOM.render(<Control data={data}/> ,document.getElementById('content'));

 

对例子的表达:

(1)你须求用npm安装react-addons-css-transition-group,然后经过require在文件中引入,然后赋给一个变量,在此间将以此变量命名为ReactCSSTransitionGroup,也可以不取其余名字
(2)为每一个ReactCSSTransitionGroup组件的子元素设置一个key属性,即使它唯有一个子元素。key值必须是唯一的。设置一个key属性是为着让react确定卓殊子元素插入了,移除了,或者保持。

(3)在这一个demo中,当一个新的子元素被添加到ReactCSSTransitionGroup中,它就会收获一个example-enter
CSS类名,随后它又会收获一个example-enter-active
CSS类名。那些类名基于transitionName属性值。你可见接纳那一个类名去落到实处css动画。添加如下的css样式:

.example-enter {
      opacity: 0.01;
    }

    .example-enter.example-enter-active {
      opacity: 1;
      transition: opacity 500ms ease-in;
    }

    .example-leave {
      opacity: 1;
    }

    .example-leave.example-leave-active {
      opacity: 0.01;
      transition: opacity 300ms ease-in;
    }

 

这么些样式中transition-duration值必须与ReactCSSTransitionGroup组件的transitionEnter提姆eout和transitionLeave提姆eout属性值一一对应

(4)那些时候你点击’add
Item’按钮将会以一种淡入的法子丰盛一个新的子元素,点击一个曾经存在的子元素,那几个被点击的子元素将会以一种退出的点子被移除。

Animate Initial Mounting

ReactCSSTransitionGroup提供了一个可选的特性transitionAppear,倘若将这么些特性设置为true,在组件的开头化装置就会添加一个外加的更换阶段。默许情形下transitionAppear为false,如下:

 

render: function() {
        return (
          <ReactCSSTransitionGroup transitionName="example" transitionAppear={true} transitionAppearTimeout={500}>
            {list}
          </ReactCSSTransitionGroup>
        );
      }

如此在初始化装载ReactCSSTransitionGroup时,它的种种子元素都会有一个example-appear
CSS类接着会有一个example-appear-active
CSS类,借使添加如下的样式:

    .example-appear {
        opacity: 0.01;
      }

      .example-appear.example-appear-active {
        opacity: 1;
        transition: opacity .5s ease-in;
      }

在ReactCSSTransitionGroup的装载阶段就会有一个淡入的卡通片。在初阶化装载阶段,每一个ReactCSSTransitionGroup子元素都是appear而不是enter,可是,子元素进入一个一度存在的ReactCSSTransitionGroup,这些子元素是enter而不是appear

自定义类名

在上边的demo中,大家给transitionName属性设置了一个字符串example,所以,每一个阶段涉及的CSS类名都是以example开端的。大家也可以给transitionName设置一个字符串,这样能够为每一个品级自定义类名,如下有三种设置方式:

<ReactCSSTransitionGroup
    transitionName={ {
      enter: 'enter',
      enterActive: 'enterActive',
      leave: 'leave',
      leaveActive: 'leaveActive',
      appear: 'appear',
      appearActive: 'appearActive'
    } }>
    {item}
  </ReactCSSTransitionGroup>

  <ReactCSSTransitionGroup
    transitionName={ {
      enter: 'enter',
      leave: 'leave',
      appear: 'appear'
    } }>
    {item2}
  </ReactCSSTransitionGroup>

Animation Group Must Be Mounted To Work

为了让每一个子元素都有一个淡入和退出的职能,子元素必须进入或离开一个曾经被装载的ReactCSSTransitionGroup组件中,或者ReactCSSTransitionGroup的transitionAppear属性为true,上边这些事例就不会有淡入和剥离的功力,因为,ReactCSSTransitionGroup和一个新的子元素被单独装载,而不是子元素载入一个一度存在的ReactCSSTransitionGroup中。

render: function() {
        var items = this.state.items.map(function(item, i) {
          return (
            <div key={item} onClick={this.handleRemove.bind(this, i)}>
              <ReactCSSTransitionGroup transitionName="example">
                {item}
              </ReactCSSTransitionGroup>
            </div>
          );
        }, this);
        return (
          <div>
            <button onClick={this.handleAdd}>Add Item</button>
            {items}
          </div>
        );
      }

 

一个要么0个子元素

在上头的例证中ReactCSSTransitionGroup有多少个子元素,实际上,ReactCSSTransitionGroup可以唯有一个或者没有子元素,如下所示:

var ReactCSSTransitionGroup = require('react-addons-css-transition-group');

    var ImageCarousel = React.createClass({
      propTypes: {
        imageSrc: React.PropTypes.string.isRequired
      },
      render: function() {
        return (
          <div>
            <ReactCSSTransitionGroup transitionName="carousel" transitionEnterTimeout={300} transitionLeaveTimeout={300}>
              <img src={this.props.imageSrc} key={this.props.imageSrc} />
            </ReactCSSTransitionGroup>
          </div>
        );
      }
    });

 

剥夺动画

假如你愿意,你能够禁用leave或者enter动画。例如,你想让子元素有一个enter动画而从未一个leave动画,不过在默认情形下,在您移除DOM节点以前,ReactCSSTransitionGroup会等待一个卡通去做到。你能给ReactCSSTransitionGroup设置transitionEnter={false}
或者 transitionLeave={false}去禁用那一个动画片

 

 

 

 

 

发表评论

电子邮件地址不会被公开。 必填项已用*标注