微信小程序----swiper详解和组件开发

swiper详解

滑块视图容器。swiper的初始化高度为150px;swiper-item的初始高度和宽度为100%;都可通过css样式进行swiper、swiper-item的样式重置。swiper原生组件详解

swiper组件开发

如何使用

到 GitHub 下载 WX-RUI 的代码，将 component 目录拷贝到自己的项目中。然后按照如下的方式使用组件，以 swiper 为例，其它组件在对应的文档页查看：

1. 添加需要的组件。在页面的 json 中配置（路径根据自己项目位置配置）：

"usingComponents": {
  "rui-swiper": "../../component/swiper/swiper"
}

2. 在 wxml 中使用组件：

2.1 常规滑动轮播

<rui-swiper 
  swiperList="{{bannerList}}" 
  indicatorDots="true" 
  autoplay="true"
></rui-swiper>

2.2 衔接滑动轮播(循环滑动轮播)

<rui-swiper 
  swiperList="{{bannerList}}" 
  indicatorDots="true" 
  autoplay="true" 
  circular="true"
></rui-swiper>

效果图1 ---- 常规滑动轮播和循环滑动轮播

常规滑动轮播和循环滑动轮播

2.3 纵向滑动轮播

<rui-swiper 
  swiperList="{{bannerList}}" 
  indicatorDots="true" 
  autoplay="true" 
  vertical="true"
></rui-swiper>

2.4 纵向衔接滑动轮播(纵向循环滑动轮播)

<rui-swiper 
  swiperList="{{bannerList}}" 
  indicatorDots="true" 
  autoplay="true" 
  circular="true" 
  vertical="true"
></rui-swiper>

效果图2 ---- 纵向滑动轮播和纵向循环滑动轮播

纵向滑动轮播和纵向循环滑动轮播

2.5 后边距滑动

<rui-swiper 
  swiperList="{{bannerList}}" 
  indicatorDots="true" 
  autoplay="true" 
  imgwidth="90vw" 
  circular="true" 
  next-margin="30px"
></rui-swiper>

2.6 前后边距滑动轮播

<rui-swiper 
  swiperList="{{bannerList}}" 
  indicatorDots="true" 
  autoplay="true" 
  current='{{current}}' 
  isOpacity="true" 
  isScale="true"  
  imgwidth="82vw" 
  circular="true" 
  previous-margin="30px" 
  next-margin="30px" 
  rui-class="rui-banner-img" 
  bindswiperfinish='changeFun'
></rui-swiper>

效果图3 ---- 后边距滑动和前后边距滑动轮播

后边距滑动和前后边距滑动轮播

2.7 多图片滑动轮播

<rui-swiper 
  swiperList="{{bannerList}}" 
  circular="true" 
  autoplay="true" 
  display-multiple-items="2" 
  swiperheight="21.333vw" 
  imgheight="21.333vw" 
  imgwidth="50vw" 
  current='0'
></rui-swiper>

2.8 文字滑动导航

<rui-swiper 
  type="text" 
  class='rui-active' 
  swiperList="{{navList}}" 
  display-multiple-items="4" 
  swiperheight="12vw" 
  imgheight="12vw" 
  previous-margin="10px" 
  next-margin="10px" 
  current='{{current_text}}' 
  circular="true" 
  imgwidth="calc((100vw - 20px) / 4 - 40px)" 
  bindswipertap="getIndex"
></rui-swiper>

效果图4 ---- 多图片滑动轮播和文字滑动导航效果图

多图片滑动轮播和文字滑动导航效果图

参数说明

属性名	类型	默认值	说明
swiperwidth	String	‘’	swiper的宽度
swiperheight	String	‘’	swiper的高度
imgwidth	String	‘’	swiper中图片的宽度
imgheight	String	‘’	swiper中图片的高度
swiperList	Array	[]	swiper的内容数组
interval	Number	5000	自动切换时间间隔
duration	Number	500	滑动动画时长
displayMultipleItems	Number	1	同时显示的滑块数量
current	Number	0	当前所在滑块的 index
currentItemId	String	‘’	当前所在滑块的 item-id ，不能与 current 被同时指定
indicatorColor	String	‘’	指示点颜色
indicatorActiveColor	String	‘’	当前选中的指示点颜色
previousMargin	String	‘0px’	前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值
nextMargin	String	‘0px’	后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值
autoplay	Boolean	false	是否自动切换
circular	Boolean	false	是否采用衔接滑动
vertical	Boolean	false	滑动方向是否为纵向
indicatorDots	Boolean	false	是否显示面板指示点
isOpacity	Boolean	false	是否设置图片透明度
isScale	Boolean	false	是否设置图片缩放比例
skipHiddenItemLayout	Boolean	false	是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
bindswiperchange	EventHandle		current 改变时会触发 change 事件，event.detail = {current: current}
bindswiperfinish	EventHandle		动画结束时会触发 animationfinish 事件，event.detail 同上