# 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 />
<h3-button
@click="
popupCenterModalShow = 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 />
<h3-button
@click="
popupCenterModalShow = 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"
popupWidth="240px"
maskClosable
popupDirection="left"
>
<div class="content-list content-list-wrap">
<div class="content-list-left">
<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>
<div class="content-item content-item-down">
<h3-button icon="IconFormEditStroke" otherType="option" size="medium">操作按钮</h3-button>
</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="popupUpModalShow = false" type="primary">
买入
</h3-button><br />
</div>
</div>
</h3-popup>
<h3-popup
v-model="popupCenterModalShow"
:round="round"
maskClosable
popupDirection="center"
popupHeight="120px"
popupWidth="50%"
>
<div class="content-list">
<span>弹出层内容</span>
</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';
import H3Icon from '@/components/h3-icon';
export default {
components: {
H3Popup,
H3Button,
H3Icon,
},
data () {
return {
popupModalShow: false,
popupLeftModalShow: false,
popupRightModalShow: false,
popupUpModalShow: false,
popupDownModalShow: false,
popupCenterModalShow: 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;
}
background: #F5F6F9;
.content-item {
padding: 12px 16px;
border-bottom: 1px solid rgba(209, 211, 228, 0.48);
min-height: 45px;
background: #fff;
align-items: center;
font-size: 16px;
display: flex;
}
}
.content-list-wrap {
width: 100%;
height: 100%;
}
.content-list-left {
background: #fff;
width: 100%;
.content-item {
margin-left: 16px;
width: 100%;
padding: 16px 16px 16px 0;
}
}
.content-item-down {
width: 100%;
position: absolute;
bottom: 0;
left:0;
padding-left: 16px;
button {
padding:0;
}
}
.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;
}
span {
position: absolute;
margin: 20px;
}
</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 | 关闭时回调 | - |
← Avatar 头像 NavBar 导航栏 →