/animate-text

animated-text 文字动画

Primary LanguageJavaScript

animate-text

文字动画和数字动画 animate text

查看DEMO

轻巧的文字动画库, 使用简单, 文件大小4k
可以给文字添加出现动画, 支持字符串打字效果和数字变化效果, 支持监听动画结束事件
项目持续更新和维护


安装方法

  • 方式一
npm install animate-text --save
  • 方式二
下载项目中的dist/animate-text.min.js, 然后用script标签插入到你的项目中, 如下
这种方式可以通过window.AnimateText访问
<script type="text/javascript" src="dist/animate-text.min.js"></script>


使用方法

import AnimateText from 'animate-text'

// 最简单的使用方法
new AnimateText('.text')

// 如果需要定义动画时间可以这样初始化
new AnimateText('.text', 1000)

// 如果还有其它设置 请这样写
new AnimateText('.text', {
  time: 1000, // 动画时长
  isNumber: true, // 是否渲染为数字动画
  startNumber: 0, // 渲染为数字动画时 动画的开始数字
  changeCount: 32, // 数字动画数字变化次数
  onAnimated: function () {console.log('动画结束')} // 动画结束事件回调
})

参数说明

AnimateText接收两个参数, 例如: new AnimateText(element, options)

参数 类型 是否必填 描述
element String or Object 可以是选择器或者dom节点对象(请保证这个节点内只有文本而没有其它节点)
options Number or Object 如果第二个参数是数字, 则当作动画时间处理, 如果有其他参数, 以对象格式传递, 具体每个属性的描述请看下方的 options说明

options说明

第二个参数options详细说明

参数 类型 默认值 是否必填 描述
time Number 500 动画持续的时间
isNumber Boolean false 是否渲染为数字动画
startNumber Number 0 数字动画的开始数字
changeCount Number 32 数字动画变化次数 也就是数字经过多少次跳动才变为最终数字
onAnimated Function null 动画结束监听函数

实例对象方法说明
// 实例化
var animateText = new AnimateText('.text')

// 实例化对象后 对象提供play方法重新播放动画
// 接受参数作为动画时间
// 不传递参数则使用实例化的时间
animateText.play(1000)