1.1.2 • Published 2 years ago

@wanyanyan/slider.js v1.1.2

Weekly downloads
-
License
ISC
Repository
github
Last release
2 years ago

介绍

一个简单的轮播组件,纯js实现,不依赖任何前端框架。

使用方法

在使用slider.js之前,应该确保html页面有如下Dom结构,'container'为轮播组件的容器,不要改变其子元素的class和结构。

<div id="container">
  <div class="sld-viewport">
    <div class="sld-wrapper">
      <div class="sld-item">
        <!-- your content -->
      </div>
      <div class="sld-item">
        <!-- your content -->
      </div>
    </div>
  </div>
</div>

通过cdn引入

<script src="/dist/slider.min.js"></script>
<script>
  const slider = new sliderjs.Slider({
    container: 'container',
    visible_items: 1
  })
</script>

通过npm

npm install @wanyanyan/slider.js
import {Slider} from '@wanyanyan/slider.js'
const slider = new Slider({
  container: 'container',
  visible_items: 1
})

API

new sliderjs.Slider(options)会初始化轮播组件并返回一个Slider实例。options选项:

选项类型功能
containerString | HTMLElement指定轮播组件的容器
visible_itemsNumber可见的条目数 - 默认:1
scrolling_itemsNumber一次滚动的条目数 - 默认: 1
orientationString滚动方向,"horizontal"或者"vertical" - 默认: horizontal
autoplayboolean是否自动开始滚动 - 默认: true
intervalNumber每次滚动间隔,单位:ms - 默认:3000
onClickFunction点击事件的回调函数,事件参数为{index: 0, originalEvent: mouseEvent} - 默认:null

Slider实例具有以下方法:

.pre()

切换上一个滚动条目

.next()

切换下一个滚动条目

.play()

开始自动播放

.stop()

停止自动播放

开发指南

安装所有依赖:

npm install

进入开发模式:

npm run start

通过浏览器打开"http://localhost:8080/debug/index.html"可进入测试页面

打包代码:

npm run build