Vue中轻松使模态框支持类窗口操作的增强组件

Vue
376
0
0
2022-03-28

介绍

今天要介绍的是一个Vue的增强组件——vue-directive-window,它让你的模态框轻而易举地支持类窗口操作,也就是说不仅仅对话框,还将具备一些窗口化的特性,诸如拖拽、最大化、缩放等增强型功能!



Vue中轻松使模态框支持类窗口操作的增强组件


Github

https://gitee.com/mirrors/vue-directive-window

特性

  • 节约成本

旨在以极少的改造成本,让一个现有的模态框或任何合适的HTMLElement轻松支持拖拽移动、调整大小、最大化等类视窗操作。

  • 使用便捷

同时提供Vue自定义指令以及一般js类库两种调用方式。

  • 可插拔

可以随时为某个系统里已存在的模块添上/去除类视窗操作的功能,而不会影响该模块原有的功能。

快速开始

  • 安装使用npm

也可以使用其它包管理工具,如yarn

npm install vue-directive-window

vue-directive-window支持Vue自定义指令及一般js类两种方式来使用。

  • 自定义指令方式
<template>
  <div v-window="windowParams">
    <!-- 容器内容 -->
  </div>
</template>
<script>
import VueDirectiveWindow from 'vue-directive-window';
Vue.use(VueDirectiveWindow); // 如果是以静态文件方式引入的话,则不需要 import,直接使用Vue.use(window['vue-directive-window'])
export default {
  data() {
    return {
      windowParams: {
        movable: false,
        resizable: ['left', 'left-top'],
      },
    };
  },
}
</script
  • 一般使用
<div class="demo-window" v-window="windowParams">
  <!-- 容器内容 -->
</div>
import { enhanceWindow } from 'vue-directive-window'; // 如果是以静态文件方式引入的话,则是const enhanceWindow = window['vue-directive-window'].enhanceWindow;

const windowParams = {
  movable: false
  resizable: ['left', 'left-top']
};

enhanceWindow(document.querySelector('.demo-window'), windowParams);

vue-directive-window支持IE10以及以后的浏览器

案例

本文只展示官方的一个案例,其它案例参考官方文档

<template>
  <div class="container">
    <div class="window window1" v-show="ifShowWindow" v-window="windowParams">
      <div class="window__header">
        一般窗口
        <button class="maximize-btn" type="button">
          <template v-if="!isMaximize"
            >点这放大</template
          >
          <template v-else
            >点这缩小</template
          >
        </button>
      </div>
      <div class="window__body">
        <iframe height="100%" width="100%" frameborder="0" src="https://array-huang.github.io/vue-directive-window/">
      </div>
    </div>

    <button type="button" @click="ifShowWindow = true" v-if="!ifShowWindow">
      显示窗口
    </button>
    <button type="button" @click="ifShowWindow = false" v-else>隐藏窗口</button>
  </div>
</template>
<script>
  Vue.use(window['vue-directive-window']);

  function maximizeCb(isMaximize) {
    this.isMaximize = isMaximize;
  }

  export default {
    data() {
      return {
        windowParams: {
          minWidth: 10,
          maxWidth: 800,
          minHeight: 100,
          maxHeight: 800,
          customMaximizeHandler: '.maximize-btn',
          maximizeCallback: maximizeCb.bind(this),
        },
        ifShowWindow: false,
        isMaximize: false,
      };
    },
  };
</script>
<style>
  .container {
    padding: 30px;
  }
  .window1 {
    width: 400px;
    position: fixed;
    top: 60px;
    left: 0;
  }
</style>

效果如下

Vue中轻松使模态框支持类窗口操作的增强组件