更新记录

1.0.3(2025-02-27)

更新为uni_modules插件

1.0.2(2021-01-20)

金字塔模式下一张图片,会导致主屏不显示

1.0.1(2020-07-27)

20200727:数字角标不变化bug

查看更多

平台兼容性

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

mosowe-swiper:适用于 uni-app 的轮播图插件

轮播组件,本插件兼容 H5、APP、微信小程序、支付宝小程序

组件功能

  1. 普通轮播(文本、图片,图文轮播,支持上下、左右轮播)
  2. 堆叠轮播(图片)
  3. 图片预览(图片)
  4. 数字角标

使用方式

page.json中配置了"easycom": true,则无需script引入就可以使用,没有则需要引入。

属性

名称 类型 默认值 说明
lists Array [] 轮播列表
current Number 0 初始化展示的索引
autoplay Boolean true 是否自动切换
interval Number 3000 自动切换时间间隔
duration Number 500 切换动画时长
vertical Boolean false 滑动方向是否为纵向
indicator String 指示点样式,可选:dots(点),number(数字右下角),空则不会显示
indicatorColor String rgba(255, 255, 255, 0.5) dot 点样式:默认颜色
indicatorActiveColor String #ffffff dot 点选中样式:高亮颜色
scene String 场景值
touchable Boolean false 是否禁用手动滑动
swiperType String image 轮播类型,可选:image(图片轮播),imageTextLine(图文一行轮播),text(文本轮播)
previewImage Boolean false 点击时开启图片预览,支付宝无预览
imageKey String 图片的 key 值,重复使用的组件可能遇到不同的 key,此处传图片的 key,若 lists 为字符串数组,不写即可
textKey String 文本的 key 值,重复使用的组件可能遇到不同的 key,此处传文本的 key,若 lists 为字符串数组,不写即可
height Number 300 轮播区的高度,单位 rpx
pyramid Boolean false 堆叠式,横向且纯图模式有效,开启金字塔模式时,active 初始化最少为 1,最大为 this.lists.length -2,支付宝小程序不堆叠
pyramidMargin String 堆叠式轮播,前后露出的距离,单位 rpx,px
itemNums String 同时展示个数,开启堆叠式轮播模式时, itemNums = 1

事件

名称 参数 说明
change index:当前索引 轮播时
bclick {item,index}:item 当前项,index 当前索引 点击时

示例

  1. 图片轮播
banner: [
    {
        image: 'https://ss1.bdstatic.com/70cFuXSh_Q1YnxGkpoWK1HF6hhy/it/u=3892521478,1695688217&fm=26&gp=0.jpg',
    },
    {
        image: 'https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1595526004030&di=4be554bfcbc76570e275724fd10cb11c&imgtype=0&src=http%3A%2F%2Fa2.att.hudong.com%2F36%2F48%2F19300001357258133412489354717.jpg',
    },
    {
        image: 'https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1595526004029&di=2feebadbbdcf7db486a58ce72d5a263b&imgtype=0&src=http%3A%2F%2Fp2.so.qhimgs1.com%2Ft01dfcbc38578dac4c2.jpg'
    }
],
<mosowe-swiper
  :lists="banner"
  :touchable="false"
  indicator="dots"
  imageKey="image"
  previewImage
  pyramid
  pyramidMargin="90rpx"
  @change="bannerChange" />

2. 文字轮播


text: [
    {
        title: '车静安寺客户嘎哈放框架傲胜'
    },
    {
        title: '任务的确认吧是发是对方是个地方个三四个'
    },
    {
        title: '接口环境看是否度萨芬,吧撒打发看了会焦点时发卡机撒打发'
    },
],
<view class="swiper">
  <mosowe-swiper
    :lists="text"
    :touchable="true"
    vertical
    swiperType="text"
    textKey="title"
    :height="80" />
</view>

文本文字的大小、颜色等可在调用的父级直接更改:

.swiper {
  height: 80rpx;
  font-size: 28rpx;
  line-height: 80rpx;
  padding: 0 30rpx;
  box-sizing: border-box;
  background-color: #fe8252;
  color: #fff;
}
  1. 不带 key 的文字
text2: [
    '车静安寺客户嘎哈放框架傲胜',
    '任务的确认吧是发是对方是个地方个三四个',
    '接口环境看是否度萨芬,吧撒打发看了会焦点时发卡机撒打发'
],
<mosowe-swiper
  :lists="text2"
  :touchable="false"
  vertical
  swiperType="text"
  :height="80" />

版本修复

1.0.2 1. 金字塔模式下一张图片,会导致主屏不显示

隐私、权限声明

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

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

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

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