Popup 弹出框

使用指南

基础弹出框，可以从屏幕的上下左右四个方向弹出，并自定义内容；

TIP

此组件属于Popup家族组件，查看这篇blogPopup家族, 了解更多

代码演示

查看代码

<template>
  <div class="list">
    <p class="sub-title">
      基础弹窗
    </p>
    <h3-button @click="popupModalShow = true" type="primary">
      basic
    </h3-button><br />
    <p class="sub-title">
      不同方向弹出
    </p>
    <h3-button
      @click="
        popupLeftModalShow = true;
        round = false;
      "
      type="primary"
    >
      左侧滑出
    </h3-button><br />
    <h3-button
      @click="
        popupRightModalShow = true;
        round = false;
      "
      type="primary"
    >
      右侧滑出
    </h3-button><br />
    <h3-button
      @click="
        popupUpModalShow = true;
        round = false;
      "
      type="primary"
    >
      向上滑出
    </h3-button><br />
    <h3-button
      @click="
        popupDownModalShow = true;
        round = false;
      "
      type="primary"
    >
      向下滑出
    </h3-button><br />
    <p class="sub-title">
      不同方向弹出 圆角
    </p>
    <h3-button
      @click="
        popupLeftModalShow = true;
        round = true;
      "
      type="primary"
    >
      左侧滑出
    </h3-button><br />
    <h3-button
      @click="
        popupRightModalShow = true;
        round = true;
      "
      type="primary"
    >
      右侧滑出
    </h3-button><br />
    <h3-button
      @click="
        popupUpModalShow = true;
        round = true;
      "
      type="primary"
    >
      向上滑出
    </h3-button><br />
    <h3-button
      @click="
        popupDownModalShow = true;
        round = true;
      "
      type="primary"
    >
      向下滑出
    </h3-button><br />
    <p class="sub-title">
      设置高度和宽度
    </p>
    <h3-button @click="popupW80Show = true" type="primary">
      宽度80
    </h3-button><br />
    <h3-button @click="popupW150Show = true" type="primary">
      宽度150px
    </h3-button><br />
    <h3-button @click="popupH40Show = true" type="primary">
      高度40%
    </h3-button><br />
    <h3-button @click="popupH80Show = true" type="primary">
      高度80%
    </h3-button><br />
    <div class="placeholder">
      占位测试滚动条
    </div>

    <h3-popup v-model="popupModalShow" maskClosable>
      <div class="content-list">
        <p>
          委托买入
        </p>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          <h3-button @click="popupModalShow = false" type="primary">
            买入
          </h3-button><br />
        </div>
      </div>
    </h3-popup>
    <h3-popup
      v-model="popupLeftModalShow"
      :round="round"
      maskClosable
      popupDirection="left"
    >
      <div class="content-list">
        <p>
          委托买入
        </p>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          <h3-button @click="popupLeftModalShow = false" type="primary">
            买入
          </h3-button><br />
        </div>
      </div>
    </h3-popup>
    <h3-popup
      v-model="popupRightModalShow"
      :round="round"
      maskClosable
      popupDirection="right"
    >
      <div class="content-list">
        <p>
          委托买入
        </p>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          <h3-button @click="popupRightModalShow = false" type="primary">
            买入
          </h3-button><br />
        </div>
      </div>
    </h3-popup>

    <h3-popup
      v-model="popupUpModalShow"
      :round="round"
      maskClosable
      popupDirection="up"
    >
      <div class="content-list">
        <p>
          委托买入
        </p>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          <h3-button @click="popupUpModalShow = false" type="primary">
            买入
          </h3-button><br />
        </div>
      </div>
    </h3-popup>

    <h3-popup
      v-model="popupDownModalShow"
      :round="round"
      maskClosable
      popupDirection="down"
    >
      <div class="content-list">
        <p>
          委托买入
        </p>
        <div class="content-item">
          股票名称
        </div>
        <div class="content-item">
          股票代码
        </div>
        <div class="content-item">
          股票价格
        </div>
        <div class="content-item">
          <h3-button @click="popupDownModalShow = false" type="primary">
            买入
          </h3-button><br />
        </div>
      </div>
    </h3-popup>

    <h3-popup
      v-model="popupW80Show"
      maskClosable
      popupWidth="80%"
      popupDirection="right"
    >
      <div style="padding: 20px">
        {{ longText }}
      </div>
    </h3-popup>
    <h3-popup
      v-model="popupW150Show"
      maskClosable
      popupWidth="150px"
      popupDirection="right"
    >
      <div style="padding: 20px">
        {{ longText }}
      </div>
    </h3-popup>
    <h3-popup
      v-model="popupH40Show"
      maskClosable
      popupHeight="40%"
      popupDirection="up"
    >
      <div style="padding: 20px">
        {{ longText }}
      </div>
    </h3-popup>
    <h3-popup
      v-model="popupH80Show"
      maskClosable
      popupHeight="80%"
      popupDirection="up"
    >
      <div style="padding: 20px">
        {{ longText }}
      </div>
    </h3-popup>
  </div>
</template>

<script>
import H3Popup from '@/components/h3-popup';
import H3Button from '@/components/h3-button';

export default {
  components: {
    H3Popup,
    H3Button,
  },
  data () {
    return {
      popupModalShow: false,
      popupLeftModalShow: false,
      popupRightModalShow: false,
      popupUpModalShow: false,
      popupDownModalShow: false,
      popupW80Show: false,
      popupW150Show: false,
      popupH40Show: false,
      popupH80Show: false,
      round: false,
      longText: `
        本质上，webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。
        当 webpack 处理应用程序时，它会递归地构建一个依赖关系图(dependency graph)，其中包含应用程序需要的每个模块，然后将所有这些模块打包成一个或多个 bundle。

        可以从这里了解更多关于 JavaScript 模块和 webpack 模块的信息。
        从 webpack v4.0.0 开始，可以不用引入一个配置文件。然而，webpack 仍然还是高度可配置的。在开始前你需要先理解四个核心概念：

        入口(entry)
        输出(output)
        loader
        插件(plugins)
        本文档旨在给出这些概念的高度概述，同时提供具体概念的详尽相关用例。

        入口(entry)
        入口起点(entry point)指示 webpack 应该使用哪个模块，来作为构建其内部依赖图的开始。进入入口起点后，webpack 会找出有哪些模块和库是入口起点（直接和间接）依赖的。

        每个依赖项随即被处理，最后输出到称之为 bundles 的文件中，我们将在下一章节详细讨论这个过程。

        可以通过在 webpack 配置中配置 entry 属性，来指定一个入口起点（或多个入口起点）。默认值为 ./src。

        接下来我们看一个 entry 配置的最简单例子：

        webpack.config.js

        module.exports = {
          entry: './path/to/my/entry/file.js'
        };
        根据应用程序的特定需求，可以以多种方式配置 entry 属性。从入口起点章节可以了解更多信息。
        出口(output)
        output 属性告诉 webpack 在哪里输出它所创建的 bundles，以及如何命名这些文件，默认值为 ./dist。基本上，
        整个应用程序结构，都会被编译到你指定的输出路径的文件夹中。你可以通过在配置中指定一个 output 字段，来配置这些处理过程：

        webpack.config.js

        const path = require('path');

        module.exports = {
          entry: './path/to/my/entry/file.js',
          output: {
            path: path.resolve(__dirname, 'dist'),
            filename: 'my-first-webpack.bundle.js'
          }
        };
        在上面的示例中，我们通过 output.filename 和 output.path 属性，来告诉 webpack bundle 的名称，
        以及我们想要 bundle 生成(emit)到哪里。可能你想要了解在代码最上面导入的 path 模块是什么，它是一个 Node.js 核心模块，用于操作文件路径。

        你可能会发现术语生成(emitted 或 emit)贯穿了我们整个文档和插件 API。它是“生产(produced)”或“释放(discharged)”的特殊术语。
        output 属性还有更多可配置的特性，如果你想要了解更多关于 output 属性的概念，你可以通过阅读概念章节来了解更多。
        loader
        loader 让 webpack 能够去处理那些非 JavaScript 文件（webpack 自身只理解 JavaScript）。
        loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块，然后你就可以利用 webpack 的打包能力，对它们进行处理。

        本质上，webpack loader 将所有类型的文件，转换为应用程序的依赖图（和最终的 bundle）可以直接引用的模块。

        注意，loader 能够 import 导入任何类型的模块（例如 .css 文件），这是 webpack 特有的功能，
        其他打包程序或任务执行器的可能并不支持。我们认为这种语言扩展是有很必要的，因为这可以使开发人员创建出更准确的依赖关系图。
        在更高层面，在 webpack 的配置中 loader 有两个目标：

        test 属性，用于标识出应该被对应的 loader 进行转换的某个或某些文件。
        use 属性，表示进行转换时，应该使用哪个 loader。
        webpack.config.js
      `,
    };
  },
  watch: {
    show10 (val) {
      if (val) {
        setTimeout(() => {
          this.show10 = false;
        }, 1000);
      }
    },
  },
  methods: {
    log (str) {
      console.log(str);
    },
  },
};
</script>

<style lang="less" scoped>
.content-list {
  p {
    font-weight: 600;
    font-size: 16px;
    padding: 15px;
  }
  .content-item {
    padding: 12px 16px;
    border-bottom: 1px solid #ebedf2;
    min-height: 45px;
    background: #fff;
    align-items: center;
    font-size: 16px;
    display: flex;
  }
}
.list {
  background-color: #fff;
  padding: 0 15px;
  p {
    font-weight: 600;
    font-size: 16px;
    padding: 15px;
  }
}
.placeholder {
  padding: 20px;
  font-size: 16px;
  text-align: center;
  height: 600px;
}
</style>

API

Prop

属性	说明	类型	默认值
visible	是否显示，v-model绑定值	boolean	false
maskClosable	点击蒙层是否可触发关闭	boolean	false
mask	是否显示透明蒙层，防止触摸穿透	boolean	true
round	是否圆角	boolean	false
maskCls	mask蒙层自定义class	string	无
wrapCls	wrap弹窗内容区域的自定义class	string	无
getRenderContainer	把组件挂载某个地方,函数请返回节点,字符串默认通过document.querySelector查找	Function=> Node / String	document.body
popupDirection	弹出框滑入动画的方向	up|down|left|right	'up'
popupWidth	弹窗宽度，注意只在popupDirection为left或right时生效	String	无
popupHeight	弹窗高度，注意只在popupDirection为up或down时生效	String	无

Event

事件名	说明	参数
toggle	切换显示时触发，v-model绑定事件	value
maskClick	点击遮罩绑定事件	value
show	显示时回调	-
hide	关闭时回调	-