V3DragZoom

一个基于 vue3 开发的轻量、高效缩放拖拽组件,方便开发者快速实现缩放拖拽功能。

在线演示和使用手册(DEMO)

GIT地址

https://gitee.com/ericfang/v3-drag-zoom

安装

使用以下命令安装 v3-drag-zoom

npm install v3-drag-zoom
# 或
yarn add v3-drag-zoom

导入组件

全局导入

main.js 中全局引入 v3-drag-zoom

import {createApp} from "vue";
import App from "./App.vue";
// v3-drag-zoom 组件
import V3DragZoom from "v3-drag-zoom";
// v3-drag-zoom 全局样式(必须导入,否则无法正常使用)
import "v3-drag-zoom/dist/style.css";

createApp(App).use(V3DragZoom).mount("#app");

按需导入

在需要的组件中导入 v3-drag-zoom

<script setup lang="ts">
  import {V3DragZoomContainer} from "v3-drag-zoom";
</script>

<template>
  <v3-drag-zoom-container>
    <div>需要缩放与拖拽的元素</div>
  </v3-drag-zoom-container>
</template>

API参数

v3-drag-zoom-container

Props
参数名类型默认值说明
alignStringcontain内容对齐方式,可选值有 autocontaincover
autoResizeBooleantrue是否自动重置尺寸,当容器尺寸为百分比的时候,会根据父容器变化而自动变化
followPointerBooleantrue缩放时是否跟随鼠标
maxZoomFloat100最大缩放倍数
minZoomFloat0.01最小缩放倍数
zoomFactorFloat0.1鼠标滚轮一次的缩放比例
loadingBooleanfalse是否加载中
animateDurationNumber200缩放时候的过度动画时长,单位 ms
Slots
Slot说明
default直接填写需要放置的内容
Exposed
参数名类型说明
zoom(zoom:Float) => void手动缩放 zoom: 为缩放倍数
reset() => void重置缩放

v3-drag-zoom-item

Props
参数名类型默认值是否必须说明
offsetArray<Integer>[-50,-50]偏移量,默认值代表横向和纵向均偏移 -50%,也就是对齐中心点位置,偏移量单位为 %, 不支持 px
fixedSizeBooleanfalse是否固定大小, true代表在缩放过程中该item内容尺寸不变
rotateFloat0旋转角度单位 deg (360度)
draggableBooleanfalse是否可以拖拽移动
position(v-model)CurPosition该 item 在内容中的位置(百分比位置)
Slots
Slot说明
default直接填写需要放置的内容
Events
事件名参数说明
onMove( pos :Position)=> void每移动一点距离触发,返回当前位置
onMoveFinished( pos :Position)=> void移动结束(鼠标抬起或超出范围)触发, 返回当前位置

CurPosition

参数名类型默认值是否必须说明
xFloat横向位置 %
yFloat纵向位置 %

Position extend CurPosition

参数名类型默认值是否必须说明
xFloat横向位置 %
yFloat纵向位置 %
sub(pos:Position)=>Position计算当前 Position 与 pos 之间的差值 new Position(this.x - pos.x, this.y - pos.y);
add(pos:Position)=>Position计算当前 Position 与 pos 之间的和值 new Position(this.x + pos.x, this.y + pos.y);
GitHub 加速计划 / vu / vue
207.54 K
33.66 K
下载
vuejs/vue: 是一个用于构建用户界面的 JavaScript 框架,具有简洁的语法和丰富的组件库,可以用于开发单页面应用程序和多页面应用程序。
最近提交(Master分支:2 个月前 )
73486cb5 * chore: fix link broken Signed-off-by: snoppy <michaleli@foxmail.com> * Update packages/template-compiler/README.md [skip ci] --------- Signed-off-by: snoppy <michaleli@foxmail.com> Co-authored-by: Eduardo San Martin Morote <posva@users.noreply.github.com> 4 个月前
e428d891 Updated Browser Compatibility reference. The previous currently returns HTTP 404. 5 个月前
Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐