更新记录

1.0.0(2024-08-18) 下载此版本

初始发布

1.0.0 (2024-08-16)


平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.7.12 × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × ×

SY-StackedCarousel

该组件一般用于导航轮播,广告展示等场景,可开箱即用,具有如下特点:

  • 3D 轮播图效果,满足不同的开发需求
  • 可配置显示标题,涵盖不同的应用场景
  • 功能属性齐全丰富
  • 轻量级,支持小程序、H5 等平台(支持 vue2、vue3)

使用方式

<template>
  <view class="container">
    <SYStackedCarousel
      height="480rpx"
      autoplay
      :images="images"
      :current="3"
      :interval="2000"
      @click="clickHandler"
      @change="changeHandler"
    >
    </SYStackedCarousel>
  </view>
</template>

<script>
  import SYStackedCarousel from "@/uni_modules/SY-StackedCarousel/components/SY-StackedCarousel.vue";
  export default {
    components: {
      SYStackedCarousel,
    },
    data() {
      return {
        images: [
          {
            url: "../../static/images/1.jpg",
            desc: "星辰大海任我行,风雨兼程志更坚。星辰大海任我行,风雨兼程志更坚。星辰大海任我行,风雨兼程志更坚。星辰大海任我行,风雨兼程志更坚。",
          },
          {
            url: "../../static/images/2.jpg",
            desc: "晨曦微露破晓时,梦想起航正当时。",
          },
          {
            url: "../../static/images/3.jpg",
            desc: "千锤百炼钢更强,逆境之中显真章。",
          },
          {
            url: "../../static/images/4.jpg",
            desc: "心有猛虎细嗅蔷薇,勇者无畏亦柔情。",
          },
          {
            url: "../../static/images/5.jpg",
            desc: "高山仰止景行行,志士仁人共长天。",
          },
        ],
      };
    },
    onLoad() {},
    methods: {
      clickHandler(item, index) {
        console.log("item: ", item);
        console.log("index: ", index);
      },
      changeHandler(index) {
        console.log("当前触发change事件,返回索引: ", index);
      },
    },
  };
</script>

属性说明

属性名 类型 默认值 说明
images Array [] 图片数组
height [String, Number] 300rpx 轮播图高度
autoplay Boolean true 是否自动播放
padding String 10px 轮播内边距
radius [String, Number] 4 组件圆角值
bgColor String #ffffff 容器背景色
interval Number 2000 滑块自动切换时间间隔(ms)
current Number 0 当前显示的图片索引
easing String ease-in-out 动画类型
enableOpacity Boolean true 是否启用不透明度设定(堆叠每一层逐渐变透明)
baseOpacity Number 0.8 最顶层图片的不透明度,每一层会根据这个值自动缩小 opacity值
duration Number 500 滑块切换过程所需时间(ms)
horizontalMargin [String, Number] 10 横向间距
verticalMargin [String, Number] 10 纵向间距
showButton Boolean false 是否显示操作按钮
buttonSize [String, Number] 24 按钮大小以及按钮图标大小
buttonBgColor String rgba(0, 0, 0, 0.26) 按钮背景颜色
imgMode String aspectFill 图片裁剪模式,详情见微信原生 imageMode
showFirstImageOnly Boolean false 是否只显示第一张图片,其他图片被蒙版遮住
maskBgColor String #ffffff 遮住蒙版的颜色
showDesc Boolean true 是否显示图片描述(需要 images 传递的数据中存在 desc 属性)
descBgColor String rgba(0, 0, 0, 0.5) 底部描述的背景颜色
descColor String #ffffff 底部描述字体颜色
descSize [String, Number] 10 底部描述字体大小
descNoWrap Boolean false 描述是否不换行,超出后用...省略
slideRadius [String, Number] 10 图片的圆角值

事件说明

事件名 说明 回调参数
click 点击图片触发 item:当前图片对象信息, index:当前是第几张图片,从 0 开始
change 轮播图切换时触发(自动或者手动切换) index:当前是第几张图片,从 0 开始

插槽

插槽名称 说明
left-button 翻页按钮左侧图标
right-button 翻页按钮右侧图标

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问