import{e as s,o as a,G as t}from"./vendor.f7062dc0.js";const n={class:"markdown-body"},l=[t('

Swiper 轮播

介绍

常用于一组图片或卡片轮播,当内容空间不足时,可以用走马灯的形式进行收纳,进行轮播展现。

安装

import { createApp } from 'vue';\nimport { Swiper } from '@nutui/nutui';\n\nconst app = createApp();\napp.use(Swiper);\n

代码演示

基础用法

auto-play 自动轮播的时长 init-page 初始索引值 pagination-visible 是否显示分页指示器 pagination-color 指示器颜色自定义

<nut-swiper :init-page="state.page" :pagination-visible="true" pagination-color="#426543" auto-play="3000">\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro34.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro2.jpg'" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/welcomenutui.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/fristfabu.jpg" alt="" />\n  </nut-swiper-item>\n</nut-swiper>\n

自定义大小

width 自定义轮播大小

<nut-swiper :init-page="state.page2" :loop="false" width="300">\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro34.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro2.jpg'" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/welcomenutui.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/fristfabu.jpg" alt="" />\n  </nut-swiper-item>\n</nut-swiper>\n

自定义分页指示器

v-slot:page 表示自定义指示器

<nut-swiper :init-page="state.page3" :loop="true" @change="change">\n    <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro34.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro2.jpg'" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/welcomenutui.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/fristfabu.jpg" alt="" />\n  </nut-swiper-item>\n  <template v-slot:page>\n    <div class="page"></div>\n  </template>\n</nut-swiper>\n

垂直方向

direction 自定义轮播方向

<nut-swiper :init-page="state.page4" :loop="true" auto-play="3000" direction="vertical" height="150" :pagination-visible="true" style="height: 150px">\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro34.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/NutUItaro2.jpg'" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/welcomenutui.jpg" alt="" />\n  </nut-swiper-item>\n  <nut-swiper-item>\n    <img src="https://storage.360buyimg.com/jdc-article/fristfabu.jpg" alt="" />\n  </nut-swiper-item>\n</nut-swiper>\n

API

Props

参数说明类型默认值
width轮播卡片的宽度Number、Stringwindow.innerWidth
height轮播卡片的高度String、Number0
direction轮播方向,可选值horizontal,verticalString‘horizontal’
pagination-visible分页指示器是否展示Booleanfalse
pagination-color分页指示器选中的颜色String‘#fff’
loop是否循环轮播Booleantrue
duration动画时长(单位是ms)Number、String500
auto-play自动轮播时长,0表示不会自动轮播Number、String0
init-page初始化索引值Number、String0
touchable是否可触摸滑动Booleantrue
is-preventDefault滑动过程中是否禁用默认事件Booleantrue
is-stopPropagation滑动过程中是否禁止冒泡Booleantrue

Events

事件名说明回调参数
change滑动之后的回调当前索引值index

API

事件名说明参数
prev切换到上一页-
next切换到下一页-
to切换到指定轮播index:number
',25)],p={setup:(t,{expose:p})=>(p({frontmatter:{}}),(t,p)=>(a(),s("div",n,l)))};export{p as default};