animation-list

简介

• animation-list 基于vue列表动画插件，支持vue3.0
• 支持每个元素的动画监听(start,update,end)

引用

• 安装

npm i animation-list

• 例子

<template>
  <AnimationList ref="animationListRef">
    <div class="item" v-for="item in 8" :key="item">{{ item }}</div>
  </AnimationList>
</template>

<script lang="ts" setup>
import { onMounted, ref } from 'vue'
import AnimationList from 'animation-list/AnimationList.vue'
const animationListRef = ref<InstanceType<typeof AnimationList>>()
onMounted(() => {
  animationListRef.value?.initHooks({
    end: () => {
        console.log('动画结束')
        animationListRef.value?.animationCall() // 重新触发动画
    }
  })
})
</script>

<style  scoped>
.animation-list {
  overflow: hidden;
}
</style>

参数

属性

参数	默认值	备注
firstShow	true	默认是否渲染动画
deep	false	是否深层查找
animationType	ANIMATION_TYPE.RIGHT_LEFT	默认从右到左动画

ANIMATION_TYPE默认动画

key	动画	效果	备注
BOTTOM_TOP	bottom-top	从下向上
TOP_BOTTOM	top-bottom	从上向下
RIGHT_LEFT	right-left	从右到左	默认
LEFT_RIGHT	left-right	从左到右
SAMLL_BIG	small-big	从小到大
BIG_SMALL	big-small	从大到小
CUSTOM	custom	自定义动画	根据例子自定义动画

异步渲染流程

// 1.设置属性取消默认渲染动画 firstShow
// 2.获取数据后重新触发
import { onMounted, ref,nextTick } from 'vue'
setTimeout(() => {
    // 获取数据
    nextTick(() => {
        animationListRef.value?.animationCall()
    })
}, 1500)

自定义动画

<template>
<AnimationList ref="animationListRef" :animationType="ANIMATION_TYPE.CUSTOM">
    <div class="item" v-for="item in 8" :key="item">{{ item }}</div>
    </AnimationList>
</template>
<script lang="ts" setup>
    import AnimationList from 'animation-list/AnimationList.vue'
    import { ANIMATION_TYPE } from "animation-list/uitls";

</script>

<style  scoped>
    .animation-list {
        overflow: hidden;
    }
    /** 自定义动画部分(必须) **/
    .ls-custom {
        display: block;
        opacity: 1 !important;
        animation: ls-custom ease 0.26s !important;
    }
    @keyframes ls-custom {
        0% {
            opacity: 0;
            transform: scale(1.6);
        }
        100% {
            opacity: 1;
            transform: scale(1);
        }
    }

</style>

• 在 style 样式加入
  • ls-custom 初始化
  • ls-custom 动画开始
  • keyframes 动画

hooks生命周期

animationListRef.value?.initHooks({
    start:()=>{},
    update:(params: { index: number; el: HTMLElement | Element }) => {},
    end:()=>{}
})

附

• 1.x.x - vue2 相关文档，请以该版本的 README 为准

• 2.x.x - vue3