App下載

React如何實現(xiàn)一個Transition過渡動畫組件?實現(xiàn)一個Transition過渡動畫組件的方法分享!

猿友 2021-07-12 15:22:16 瀏覽數(shù) (4602)
反饋

有接觸過前端的小伙伴都知道,在不同的前端框架中使用框架的方式都大同小異。那么今天我們就來說說前端框架“React如何實現(xiàn)一個Transition過渡動畫組件?”這個問題吧!


一、基本實現(xiàn)

我們在實現(xiàn)基礎(chǔ)的過度動畫組件,需要通過切換CSS樣式實現(xiàn)簡單的動畫效果。

首先我們安裝 classnames 插件:

npm install classnames --save-dev

而且 classnaems 是一個簡單的JavaScript實用程序,用于有條件地將 ?classnames? 連接一起。那么我們將 ?component? 目錄新建一個 ?Transition? 文件夾,并在文件夾中新建一個 ?Transition.jsx?文件,代碼如下:

import React from 'react'
import classnames from 'classnames'

/**
 * css過渡動畫組件
 *
 * @visibleName Transition 過渡動畫
 */
class Transition extends React.Component {
  render() {
    const { children } = this.props
    const transition = (
      <div
        className={
          classnames({
            transition: true
          })
        }
        style={
          {
            position: 'relative',
            overflow: 'hidden'
          }
        }
      >
        <div
          className={
            classnames({
              'transition-wrapper': true
            })
          }
        >
          { children }
        </div>
      </div>
    )
    return transition
  }
}
export default Transition

在文件中我們通過使用小駝峰來定義屬性定義名稱;而且我們在文件中使用 JSX 語法,我們來看看如下案例代碼:

const name = 'Josh Perez';
const element = <h1>Hello, {name}</h1>;

這個代碼等價如下這串代碼:

const element = <h1>Hello, Josh Perez</h1>;

當(dāng)然在使用 JSX 語法的時候我們還是要注意的,因為在 JSX 語法中會更接近 ?JavaScript? 而不是 ?html? ,所以在 React DOM 中我們使用 小駝峰來進行命名,而不使用 ?html? 屬性名稱約定。

除此之外在 React 中的? props.children? 包含組件所有的子節(jié)點,即組件開始標(biāo)簽和結(jié)束標(biāo)簽之間的內(nèi)容,如下案例所示:

<Button>默認按鈕</Button>

在 ?Button? 組件中獲取? props.children?,就可以得到字符串“默認按鈕”。

那么接下來我們在 Transition 文件夾下新建一個 ?index.js? ,導(dǎo)出 ?Transition? 組件,代碼如下所示:

import Transition from './Transition.jsx'
export { Transition }
export default Transition

完成之后,在 ?Transition.jsx? 文件中為組件添加 ?props? 檢查并設(shè)置 ?action? 默認值,代碼如下所示:

import PropTypes from 'prop-types'
const propTypes = {
  /** 執(zhí)行動畫 */
  action: PropTypes.bool,
  /** 切換的css動畫的class名稱 */
  toggleClass: PropTypes.string
}
const defaultProps = {
  action: false
}

這時候我們使用 prop-ty.pes實現(xiàn)運行時類型檢查。但是需要注意的是 prop-ty.pes是一個運行時;類型檢查工具,我們來看看完整的 Transition 組件代碼如下所示:

import React from 'react'
import PropTypes from 'prop-types'
import classnames from 'classnames'
const propTypes = {
  /** 執(zhí)行動畫 */
  action: PropTypes.bool,
  /** 切換的css動畫的class名稱 */
  toggleClass: PropTypes.string
}
const defaultProps = {
  action: false
}
/**
 * css過渡動畫組件
 *
 * @visibleName Transition 過渡動畫
 */
class Transition extends React.Component {
  static propTypes = propTypes
  static defaultProps = defaultProps
  render() {
    const {
      className,
      action,
      toggleClass,
      children
    } = this.props
    const transition = (
      <div
        className={
          classnames({
            transition: true
          })
        }
        style={
          {
            position: 'relative',
            overflow: 'hidden'
          }
        }
      >
        <div
          className={
            classnames({
              'transition-wrapper': true,
              [className]: className,
              [toggleClass]: action && toggleClass
            })
          }
        >
          { children }
        </div>
      </div>
    )
    return transition
  }
}
export default Transition

CSS代碼如下所示:

.fade {
  transition: opacity 0.15s linear;
}
.fade:not(.show) {
  opacity: 0;
}

JS代碼如下所示:

import React from 'react';
import Transition from './Transition';

class Anime extends React.Component {
  constructor (props) {
    super(props)
    this.state = {
      action: true
    }
  }
  
  render () {
    const btnText = this.state.action ? '淡出' : '淡入'
    return (
      <div>
        <Transition
          className="fade"
          toggleClass="show"
          action={ this.state.action }
        >
          淡入淡出
        </Transition>
        <button
          style={{ marginTop: '20px' }}
          onClick={() => this.setState({ action: !this.state.action })}
        >
          { btnText }
        </button>
      </div>
    )
  }
}

這樣子我們就只需要在需要使用動畫的地方來進行使用 ?Anime? 組件就可以了。


二、實現(xiàn)Animate.css兼容

我們都知道? Animate.css ?是一款強大的預(yù)設(shè) CSS3 動畫庫。由于在進入動畫和離開動畫通常在使用這兩個效果相反的 ?class ?樣式,所以我們需要給我們的 ?Transition? 組件添加 ?enterClass? 和 ?leaveClass? 兩個屬性來實現(xiàn)動畫的切換,代碼如下所示:

import React from 'react'
import PropTypes from 'prop-types'
import classnames from 'classnames'

const propTypes = {
  /** 執(zhí)行動畫 */
  action: PropTypes.bool,
  /** 切換的css動畫的class名稱 */
  toggleClass: PropTypes.string,
  /** 進入動畫的class名稱,存在 toggleClass 時無效 */
  enterClass: PropTypes.string,
  /** 離開動畫的class名稱,存在 toggleClass 時無效 */
  leaveClass: PropTypes.string
}

const defaultProps = {
  action: false
}

/**
 * css過渡動畫組件
 *
 * @visibleName Transition 過渡動畫
 */
class Transition extends React.Component {

  static propTypes = propTypes

  static defaultProps = defaultProps

  render() {
    const {
      className,
      action,
      toggleClass,
      enterClass,
      leaveClass,
      children
    } = this.props
    return (
      <div
        className={
          classnames({
            transition: true
          })
        }
        style={
          {
            position: 'relative',
            overflow: 'hidden'
          }
        }
      >
        <div
          className={
            classnames({
              'transition-wrapper': true,
              [className]: className,
              [toggleClass]: action && toggleClass,
              [enterClass]: !toggleClass && action && enterClass,
              [leaveClass]: !toggleClass && !action && leaveClass,
            })
          }
        >
          { children }
        </div>
      </div>
    )
  }
}

export default Transition

當(dāng)然我們還是要注意一下,由于 ?toggleClass? 適用于那些進入動畫與離開動畫切換相同 ?class? 樣式的情況,而且 ?enterClass? 和 ?leaveClass? 使用那些進入動畫和離開動畫切換不同的 ?class? 樣式的情況,所以,他們和 ?toggleClass? 不能共存。

那么我們接下來就嘗試下加入?Animate.css? 后的 ?Transition? 組件,代碼如下所示:

import React from 'react';
import 'animate.css';

class Anime extends React.Component {
  constructor (props) {
    super(props)
    this.state = {
      action: true
    }
  }
  
  render () {
    return (
      <div>
        <Transition
          className="animated"
          enterClass="bounceInLeft"
          leaveClass="bounceOutLeft"
          action={ this.state.action }
        >
          彈入彈出
        </Transition>
        <utton
          style={{ marginTop: '20px' }}
          onClick={() => this.setState({ action: !this.state.action })}
        >
          { this.state.action ? '彈出' : '彈入' }
        </utton>
      </div>
    )
  }
}

三、功能擴展

通過上面的方法實現(xiàn)之后我們知道 ?Transition? 組件是可以適用在很多的場景中的,但是功能不是很豐富,所以就需要擴展 ?Transition? 的接口。首先我們來添加 ?props? 屬性,并設(shè)置默認值,代碼如下所示:

const propTypes = {
  ...,
  /** 動畫延遲執(zhí)行時間 */
  delay: PropTypes.string,
  /** 動畫執(zhí)行時間長度 */
  duration: PropTypes.string,
  /** 動畫執(zhí)行次數(shù),只在執(zhí)行 CSS3 動畫時有效 */
  count: PropTypes.number,
  /** 動畫緩動函數(shù) */
  easing: PropTypes.oneOf([
    'linear',
    'ease',
    'ease-in',
    'ease-out',
    'ease-in-out'
  ]),
  /** 是否強制輪流反向播放動畫,count 為 1 時無效 */
  reverse: PropTypes.bool
}

const defaultProps = {
  count: 1,
  reverse: false
}

根據(jù) props 設(shè)置樣式,代碼如下所示:

// 動畫樣式
const styleText = (() => {
  let style = {}
  // 設(shè)置延遲時長
  if (delay) {
    style.transitionDelay = delay
    style.animationDelay = delay
  }
  // 設(shè)置播放時長
  if (duration) {
    style.transitionDuration = duration
    style.animationDuration = duration
  }
  // 設(shè)置播放次數(shù)
  if (count) {
    style.animationIterationCount = count
  }
  // 設(shè)置緩動函數(shù)
  if (easing) {
    style.transitionTimingFunction = easing
    style.animationTimingFunction = easing
  }
  // 設(shè)置動畫方向
  if (reverse) {
    style.animationDirection = 'alternate'
  }
  return style
})()

完整代碼如下所示:

import React from 'react'
import PropTypes from 'prop-types'
import classnames from 'classnames'

const propTypes = {
  /** 執(zhí)行動畫 */
  action: PropTypes.bool,
  /** 切換的css動畫的class名稱 */
  toggleClass: PropTypes.string,
  /** 進入動畫的class名稱,存在 toggleClass 時無效 */
  enterClass: PropTypes.string,
  /** 離開動畫的class名稱,存在 toggleClass 時無效 */
  leaveClass: PropTypes.string,
  /** 動畫延遲執(zhí)行時間 */
  delay: PropTypes.string,
  /** 動畫執(zhí)行時間長度 */
  duration: PropTypes.string,
  /** 動畫執(zhí)行次數(shù),只在執(zhí)行 CSS3 動畫時有效 */
  count: PropTypes.number,
  /** 動畫緩動函數(shù) */
  easing: PropTypes.oneOf([
    'linear',
    'ease',
    'ease-in',
    'ease-out',
    'ease-in-out'
  ]),
  /** 是否強制輪流反向播放動畫,count 為 1 時無效 */
  reverse: PropTypes.bool
}

const defaultProps = {
  action: false,
  count: 1,
  reverse: false
}

/**
 * css過渡動畫組件
 *
 * @visibleName Transition 過渡動畫
 */
class Transition extends React.Component {

  static propTypes = propTypes

  static defaultProps = defaultProps

  render() {
    const {
      className,
      action,
      toggleClass,
      enterClass,
      leaveClass,
      delay,
      duration,
      count,
      easing,
      reverse,
      children
    } = this.props

    // 動畫樣式
    const styleText = (() => {
      let style = {}
      // 設(shè)置延遲時長
      if (delay) {
        style.transitionDelay = delay
        style.animationDelay = delay
      }
      // 設(shè)置播放時長
      if (duration) {
        style.transitionDuration = duration
        style.animationDuration = duration
      }
      // 設(shè)置播放次數(shù)
      if (count) {
        style.animationIterationCount = count
      }
      // 設(shè)置緩動函數(shù)
      if (easing) {
        style.transitionTimingFunction = easing
        style.animationTimingFunction = easing
      }
      // 設(shè)置動畫方向
      if (reverse) {
        style.animationDirection = 'alternate'
      }
      return style
    })()

    return (
      <div
        className={
          classnames({
            transition: true
          })
        }
        style={
          {
            position: 'relative',
            overflow: 'hidden'
          }
        }
      >
        <div
          className={
            classnames({
              'transition-wrapper': true,
              [className]: className,
              [toggleClass]: action && toggleClass,
              [enterClass]: !toggleClass && action && enterClass,
              [leaveClass]: !toggleClass && !action && leaveClass,
            })
          }
          style={ styleText }
        >
          { children }
        </div>
      </div>
    )
  }
}

export default Transition

在這里我們來看下相關(guān)的 Transition 增加的屬性:

  • delay:規(guī)定在動畫開始之前的延遲。
  • duration:規(guī)定完成動畫所花費的時間,以秒或毫秒計。
  • count:規(guī)定動畫應(yīng)該播放的次數(shù)。
  • easing:規(guī)定動畫的速度曲線。
  • reverse:規(guī)定是否應(yīng)該輪流反向播放動畫。

四、優(yōu)化

那么接下來我們來對 Transition 來進行一個優(yōu)化,我們主要的是動畫監(jiān)聽、卸載組件以及其他的相關(guān)兼容問題。那么我們在代碼中添加 props 屬性,并且設(shè)置默認值。代碼如下所示:

const propTypes = {
  ...,
  /** 動畫結(jié)束的回調(diào) */
  onEnd: PropTypes.func,
  /** 離開動畫結(jié)束時卸載元素 */
  exist: PropTypes.bool
}

const defaultProps = {
  ...,
  reverse: false,
  exist: false
}

接下來進行動畫結(jié)束監(jiān)聽的事件代碼:


/**
 * css過渡動畫組件
 *
 * @visibleName Transition 過渡動畫
 */
class Transition extends React.Component {

  ...

  onEnd = e => {
    const { onEnd, action, exist } = this.props
    if (onEnd) {
      onEnd(e)
    }
    // 卸載 DOM 元素
    if (!action && exist) {
      const node = e.target.parentNode
      node.parentNode.removeChild(node)
    }
  }

  /**
   * 對動畫結(jié)束事件 onEnd 回調(diào)的處理函數(shù)
   *
   * @param {string} type - 事件解綁定類型: add - 綁定事件,remove - 移除事件綁定
   */
  handleEndListener (type = 'add') {
    const el = ReactDOM.findDOMNode(this).querySelector('.transition-wrapper')
    const events = ['animationend', 'transitionend']
    events.forEach(ev => {
      el[`${type}EventListener`](ev, this.onEnd, false)
    })
  }

  componentDidMount () {
    this.handleEndListener()
  }

  componentWillUnmount () {
    const { action, exist } = this.props
    if (!action && exist) {
      this.handleEndListener('remove')
    }
  }

  render () {
    ...
  }
}

在代碼中我們可以知道使用到 componentDidMount 和 componentWillUnmount 這兩個生命周期函數(shù)。

react-dom 中還為我們提供了可以在 React 應(yīng)用中使用的 DOM 方法。我們通過獲取兼容性 animationend 和transitionend 事件。檢驗函數(shù)方法的代碼如下所示:

/**
 * 瀏覽器兼容事件檢測函數(shù)
 *
 * @param {node} el - 觸發(fā)事件的 DOM 元素
 * @param {array} events - 可能的事件類型
 * @returns {*}
 */
const whichEvent = (el, events) => {
  const len = events.length
  for (var i = 0; i < len; i++) {
    if (el.style[i]) {
      return events[i];
    }
  }
}

修改 handleEndListener 函數(shù)代碼如下所示:

/**
 * css過渡動畫組件
 *
 * @visibleName Transition 過渡動畫
 */
class Transition extends React.Component {

  ...

  /**
   * 對動畫結(jié)束事件 onEnd 回調(diào)的處理函數(shù)
   *
   * @param {string} type - 事件解綁定類型: add - 綁定事件,remove - 移除事件綁定
   */
  handleEndListener (type = 'add') {
    const el = ReactDOM.findDOMNode(this).querySelector('.transition-wrapper')
    const events = ['AnimationEnd', 'TransitionEnd']
    events.forEach(ev => {
      const eventType = whichEvent(el, [ev.toLowerCase(), `webkit${ev}`])
      el[`${type}EventListener`](eventType, this.onEnd, false)
    })
  }

  ...

}

那么到這里之后我們就完成了整個 Transition 組件的開發(fā),相關(guān)完整代碼如下所示:

import React from 'react'
import PropTypes from 'prop-types'
import classnames from 'classnames'
import ReactDOM from 'react-dom'

const propTypes = {
  /** 執(zhí)行動畫 */
  action: PropTypes.bool,
  /** 切換的css動畫的class名稱 */
  toggleClass: PropTypes.string,
  /** 進入動畫的class名稱,存在 toggleClass 時無效 */
  enterClass: PropTypes.string,
  /** 離開動畫的class名稱,存在 toggleClass 時無效 */
  leaveClass: PropTypes.string,
  /** 動畫延遲執(zhí)行時間 */
  delay: PropTypes.string,
  /** 動畫執(zhí)行時間長度 */
  duration: PropTypes.string,
  /** 動畫執(zhí)行次數(shù),只在執(zhí)行 CSS3 動畫時有效 */
  count: PropTypes.number,
  /** 動畫緩動函數(shù) */
  easing: PropTypes.oneOf([
    'linear',
    'ease',
    'ease-in',
    'ease-out',
    'ease-in-out'
  ]),
  /** 是否強制輪流反向播放動畫,count 為 1 時無效 */
  reverse: PropTypes.bool,
  /** 動畫結(jié)束的回調(diào) */
  onEnd: PropTypes.func,
  /** 離開動畫結(jié)束時卸載元素 */
  exist: PropTypes.bool
}

const defaultProps = {
  action: false,
  count: 1,
  reverse: false,
  exist: false
}

/**
 * 瀏覽器兼容事件檢測函數(shù)
 *
 * @param {node} el - 觸發(fā)事件的 DOM 元素
 * @param {array} events - 可能的事件類型
 * @returns {*}
 */
const whichEvent = (el, events) => {
  const len = events.length
  for (var i = 0; i < len; i++) {
    if (el.style[i]) {
      return events[i];
    }
  }
}

/**
 * css過渡動畫組件
 *
 * @visibleName Transition 過渡動畫
 */
class Transition extends React.Component {

  static propTypes = propTypes

  static defaultProps = defaultProps

  onEnd = e => {
    const { onEnd, action, exist } = this.props
    if (onEnd) {
      onEnd(e)
    }
    // 卸載 DOM 元素
    if (!action && exist) {
      const node = e.target.parentNode
      node.parentNode.removeChild(node)
    }
  }

  /**
   * 對動畫結(jié)束事件 onEnd 回調(diào)的處理函數(shù)
   *
   * @param {string} type - 事件解綁定類型: add - 綁定事件,remove - 移除事件綁定
   */
  handleEndListener (type = 'add') {
    const el = ReactDOM.findDOMNode(this).querySelector('.transition-wrapper')
    const events = ['AnimationEnd', 'TransitionEnd']
    events.forEach(ev => {
      const eventType = whichEvent(el, [ev.toLowerCase(), `webkit${ev}`])
      el[`${type}EventListener`](eventType, this.onEnd, false)
    })
  }

  componentDidMount () {
    this.handleEndListener()
  }

  componentWillUnmount() {
    const { action, exist } = this.props
    if (!action && exist) {
      this.handleEndListener('remove')
    }
  }

  render () {
    const {
      className,
      action,
      toggleClass,
      enterClass,
      leaveClass,
      delay,
      duration,
      count,
      easing,
      reverse,
      children
    } = this.props

    // 動畫樣式
    const styleText = (() => {
      let style = {}
      // 設(shè)置延遲時長
      if (delay) {
        style.transitionDelay = delay
        style.animationDelay = delay
      }
      // 設(shè)置播放時長
      if (duration) {
        style.transitionDuration = duration
        style.animationDuration = duration
      }
      // 設(shè)置播放次數(shù)
      if (count) {
        style.animationIterationCount = count
      }
      // 設(shè)置緩動函數(shù)
      if (easing) {
        style.transitionTimingFunction = easing
        style.animationTimingFunction = easing
      }
      // 設(shè)置動畫方向
      if (reverse) {
        style.animationDirection = 'alternate'
      }
      return style
    })()

    const transition = (
      <div
        className={
          classnames({
            transition: true
          })
        }
        style={
          {
            position: 'relative',
            overflow: 'hidden'
          }
        }
      >
        <div
          className={
            classnames({
              'transition-wrapper': true,
              [className]: className,
              [toggleClass]: action && toggleClass,
              [enterClass]: !toggleClass && action && enterClass,
              [leaveClass]: !toggleClass && !action && leaveClass,
            })
          }
          style={ styleText }
        >
          { children }
        </div>
      </div>
    )

    return transition
  }
}

export default Transition

總結(jié):

以上就是有關(guān)于“ React如何實現(xiàn)一個Transition過渡動畫組件?”這個問題的相關(guān)內(nèi)容,如果你有其他更好的方法和方式也可以和大家一同分享你的看法,更多有關(guān)于 React 這個框架的內(nèi)容我們都可以在W3Cschool中進行搜索和了解。


0 人點贊