Giter VIP home page Giter VIP logo

vue-active-preview's Introduction

vue-active-preview

NPM

img img img img

vue-active-preview 是一个面向移动端、无依赖、轻量级的 vue放大预览组件(image gallery)

img

English | 简体中文

示例

安装

npm install vue-active-preview --save

导入

全局导入

// 样式引用
import 'vue-active-preview/dist/VueActivePreview.css'

import Vue from 'vue'
import VueActivePreview from 'vue-active-preview'

Vue.use(VueActivePreview)

局部导入

// 样式引用
import 'vue-active-preview/dist/VueActivePreview.css'

// in ES6 modules
import VueActivePreview from 'vue-active-preview'

// in CommonJS
const VueActivePreview = require('vue-active-preview')

export default {
  components: {
    VueActivePreview
  }
}

script 脚本形式导入

<link rel="stylesheet" href="../node-modules/vue-active-preview/dist/VueActivePreview.css" charset="utf-8">
<script src="../node-modules/vue-active-preview/dist/VueActivePreview.umd.min.js"></script>
new Vue({
  el: '#app',
  components: {
    VueActivePreview
  }
})

用法

Vue组件实例中使用:

<VueActivePreview :urlList="[
  'https://dummyimage.com/375x100/FB8A80?text=1',
  'https://dummyimage.com/375x100/29A90F?text=2',
  'https://dummyimage.com/375x100/6F9DFF?text=3'
]" />

Props

参数 类型 描述 默认值 是否必须
urlList Array 传入的图片数组 []
backgroundSize String 图片以何种缩放的形式铺在滑动容器框(Swiper)内,取值及效果都与 CSS background-size一致
只有当指定了 urlList 时才有效
contain
maxScaleValue Number 最大放大倍数,如果设置为 0,表示不限制最大放大倍数 5
showCounter Boolean 是否需要默认的计数器 false
counterStyle Object 自定义默认计数器的样式
只有当 showCountertrue时才有效
null
startIndex Number 起始渲染显示的previewItem index 0
criticalValue Number 临界点的比例值,当超过此值代表的临界点,则将自动滑动到下一张图片 1/3
autoPlayDelay Number 如果指定了此参数,并且值 >= 0,则将会将此值当做 自动轮播delay的时间(单位为 ms)进行自动轮播;不指定则不自动轮播
如果想要指定此值,一般建议设置为 3000
null
duration Number 自动滚动到稳定位置所需的时间,单位是秒(ms) 350
noDragWhenSingle Boolean 如果只有一个 swipeItem,是否禁止拖动 true
changeCallback Function 每次滚动结束后的回调,回调参数为当前的 activeIndex -

额外的能力

slot

VueActivePreview组件还可以接收一个 slot,方便开发者更加自由地定制化组件,但请注意的是,此 slot只是作为 VueActivePreview组件的一个普通子元素,而不是可缩放预览的图片组件

<VueActivePreview :urlList="urlList">
  <p>slot content</p>
</VueActivePreview>

License

MIT

vue-active-preview's People

Contributors

accforgit avatar

Stargazers

 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.