vue + ts 如何封装轮播图组件

功能

控制是否自动轮播，当鼠标悬停的时候停止自动轮播，鼠标离开继续自动轮播；可以设置轮播时长

1. 轮播图组件

<script lang="ts" setup name="GlCarousel">
export type slideItem = {
  id: string
  imgUrl: string
  hrefUrl: string
  type: string
}

import { ref, PropType, Ref, onMounted, onUnmounted } from 'vue'
const props = defineProps({
  slides: {
    type: Array as PropType<slideItem[]>,
    required: true
  },
  duration: {
    type: Number,
    default: 3000
  },
  autoPlay: {
    type: Boolean,
    default: false
  }
})

let active = ref(0)
let timer: Ref<any> = ref(null)

const prev = () => {
  active.value--
  if (active.value < 0) {
    active.value = props.slides.length - 1
  }
}

const next = () => {
  active.value++
  if (active.value >= props.slides.length) {
    active.value = 0
  }
}

const play = () => {
  if (!props.autoPlay) return
  // 防止开启多个定时器
  clearInterval(timer.value)
  timer.value = setInterval(next, props.duration)
}

const stop = () => {
  timer && clearInterval(timer.value)
}

onMounted(() => {
  play()
})

onUnmounted(() => {
  stop()
})
</script>

<template>
  <div class="carousel" @mouseleave="play()" @mouseenter="stop()">
    <ul class="carousel-body">
      <li
        v-for="(item, index) in slides"
        :key="item.id"
        :class="{ fade: active === index }"
        class="carousel-item"
      >
        <RouterLink :to="item.hrefUrl">
          <img :src="item.imgUrl" alt="" />
        </RouterLink>
      </li>
    </ul>
    <a href="javascript:;" @click="prev()" class="carousel-btn prev">
      <i class="iconfont icon-angle-left"></i>
    </a>
    <a href="javascript:;" @click="next()" class="carousel-btn next">
      <i class="iconfont icon-angle-right"></i>
    </a>
    <div class="carousel-indicator">
      <span
        v-for="(item, index) in slides"
        :key="item.id"
        :class="{ active: active === index }"
        @mouseenter="active = index"
      ></span>
    </div>
  </div>
</template>

<style scoped lang="less">
.carousel {
  width: 100%;
  height: 100%;
  min-width: 300px;
  min-height: 150px;
  position: relative;
  .carousel {
    &-body {
      width: 100%;
      height: 100%;
    }
    &-item {
      width: 100%;
      height: 100%;
      position: absolute;
      left: 0;
      top: 0;
      opacity: 0;
      transition: opacity 0.5s linear;
      &.fade {
        opacity: 1;
        z-index: 1;
      }
      img {
        width: 100%;
        height: 100%;
      }
    }
    &-indicator {
      position: absolute;
      left: 0;
      bottom: 20px;
      z-index: 2;
      width: 100%;
      text-align: center;
      span {
        display: inline-block;
        width: 12px;
        height: 12px;
        background: rgba(0, 0, 0, 0.2);
        border-radius: 50%;
        cursor: pointer;
        ~ span {
          margin-left: 12px;
        }
        &.active {
          background: #fff;
        }
      }
    }
    &-btn {
      width: 44px;
      height: 44px;
      background: rgba(0, 0, 0, 0.2);
      color: #fff;
      border-radius: 50%;
      position: absolute;
      top: 228px;
      z-index: 2;
      text-align: center;
      line-height: 44px;
      opacity: 0;
      transition: all 0.5s;
      &.prev {
        left: 20px;
      }
      &.next {
        right: 20px;
      }
    }
  }
  &:hover {
    .carousel-btn {
      opacity: 1;
    }
  }
}
</style>

2. 注册成全局组件

import glCarousel from './carousel/index.vue'
import { App } from 'vue'

const components = [glCarousel]

export default {
  install(app: App) {
    components.forEach((component) => {
      app.component(component.name, component)
    })
  },
}

3. 使用