vue-scale-box

vue-scale-box

A vue scale box component, for browsing large image and content, support interaction by both mouse and touch.

一个简单的缩放盒子组件，支持鼠标和触摸操作，用于浏览尺寸较大的图片、文档等。

How to use / 如何使用

Install / 安装

npm install vue-scale-box
// or install from github reponsitory
npm install https://github.com/ferrinweb/vue-scale-box.git

// or use yarn / 推荐使用 yarn
yarn add vue-scale-box
// or install from github reponsitory
yarn add https://github.com/ferrinweb/vue-scale-box.git

Import / 引入

// global import / 全局引入
import scaleBox from 'vue-scale-box'
Vue.use(scaleBox)

// import on demand in your vue component file. / 按需引入
import scaleBox from 'vue-scale-box'
export default {
  components: {
    scaleBox
  },
  ...
}

Use and demo / 使用及示例

You can ckeckout this repository and try this demo.

你可以直接检出 vue-scale-box 源码到本地，查看示例。

<template>
  <div id="app">
    <scale-box ref="scaleBox">
      <img :style="'opacity: ' + (loaded - 0)" @load="sourceLoaded" :src="src">
    </scale-box>
  </div>
</template>

<script>
import scaleBox from './lib/scale-box'

export default {
  name: 'App',
  components: {
    scaleBox
  },
  data () {
    return {
      loaded: false,
      src: 'https://lorempixel.com/1440/900/nature'
    }
  },
  methods: {
    sourceLoaded () {
      this.loaded = true
      // If the content is an image or contains images,
      // execute the update method after all of images are loaded.
      this.$refs.scaleBox.update()
    }
  }
}
</script>

<style>
  html, body {
    margin: 0;
    width: 100%;
    height: 100%;
  }

  body{
    box-sizing: border-box;
    padding: 50px 0;
  }

  #app {
    width: 720px;
    height: 450px;
    margin: auto;
    background-color: #f9f9f9;
    box-shadow: rgba(0,0,0,.3) 0 2px 10px;
    border: #fff 1px solid;
  }
  img {
    display: block;
  }
</style>

Slots / 插槽

名称	说明	默认值
default	放置到缩放盒子的内容	无

Attributes / 属性

名称	说明	默认值
maxRatio	最大方法比例	3
minRatio	最小缩小比例	0.1
originalSizeText	原始尺寸按钮文本	Original Size
fitPageText	适应页面（当前容器）尺寸	Fit Page
initRatioType	默认初始化缩放模式和比率。 no-scaling：初始化时不进行缩放； fit-when-large：初始化时仅当内容尺寸大于容器尺寸条件下按照适应页面缩小； fit-when-small：初始化时仅当内容尺寸小于容器尺寸条件下按照适应页面放大； fit：初始化时总是按适应页面进行缩放； number：如果设置为正数数字，则初始化缩放比率设置为该值。	fit-when-large

Methods / 方法

名称	说明	参数
update	更新缩放盒子内容尺寸等参数	无

Lisence

MIT Lisence.