From 63227201ff79f96c34dc2e26b1e811ca7e5ff07e Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan@youzan.com>
Date: Sun, 31 Jan 2021 18:43:18 +0800
Subject: [PATCH] feat(Popover): add click-overlay event (#8050)

---
 src/popover/README.md          | 13 +++++++------
 src/popover/README.zh-CN.md    | 15 ++++++++-------
 src/popover/demo/index.vue     |  1 -
 src/popover/test/index.spec.js | 15 +++++++++++++++
 4 files changed, 30 insertions(+), 14 deletions(-)

diff --git a/src/popover/README.md b/src/popover/README.md
index e9cf5946e..6209630fc 100644
--- a/src/popover/README.md
+++ b/src/popover/README.md
@@ -227,13 +227,14 @@ export default {
 
 ### Events
 
-| Event  | Description                       | Arguments                       |
-| ------ | --------------------------------- | ------------------------------- |
+| Event | Description | Arguments |
+| --- | --- | --- |
 | select | Emitted when an action is clicked | _action: Action, index: number_ |
-| open   | Emitted when opening Popover      | -                               |
-| close  | Emitted when closing Popover      | -                               |
-| opened | Emitted when Popover is opened    | -                               |
-| closed | Emitted when Popover is closed    | -                               |
+| open | Emitted when opening Popover | - |
+| close | Emitted when closing Popover | - |
+| opened | Emitted when Popover is opened | - |
+| closed | Emitted when Popover is closed | - |
+| click-overlay | Emitted when overlay is clicked | - |
 
 ### Slots
 
diff --git a/src/popover/README.zh-CN.md b/src/popover/README.zh-CN.md
index a4e108dae..8d791ddfb 100644
--- a/src/popover/README.zh-CN.md
+++ b/src/popover/README.zh-CN.md
@@ -243,13 +243,14 @@ export default {
 
 ### Events
 
-| 事件名 | 说明                     | 回调参数                        |
-| ------ | ------------------------ | ------------------------------- |
-| select | 点击选项时触发           | _action: Action, index: number_ |
-| open   | 打开菜单时触发           | -                               |
-| close  | 关闭菜单时触发           | -                               |
-| opened | 打开菜单且动画结束后触发 | -                               |
-| closed | 关闭菜单且动画结束后触发 | -                               |
+| 事件名        | 说明                     | 回调参数                        |
+| ------------- | ------------------------ | ------------------------------- |
+| select        | 点击选项时触发           | _action: Action, index: number_ |
+| open          | 打开菜单时触发           | -                               |
+| close         | 关闭菜单时触发           | -                               |
+| opened        | 打开菜单且动画结束后触发 | -                               |
+| closed        | 关闭菜单且动画结束后触发 | -                               |
+| click-overlay | 点击遮罩层时触发         | -                               |
 
 ### Slots
 
diff --git a/src/popover/demo/index.vue b/src/popover/demo/index.vue
index 57aa539c8..a36269ccd 100644
--- a/src/popover/demo/index.vue
+++ b/src/popover/demo/index.vue
@@ -4,7 +4,6 @@
       v-model:show="show.lightTheme"
       :actions="t('actions')"
       placement="bottom-start"
-      class="foo"
       @select="onSelect"
     >
       <template #reference>
diff --git a/src/popover/test/index.spec.js b/src/popover/test/index.spec.js
index 8f1fa4053..0dba113f8 100644
--- a/src/popover/test/index.spec.js
+++ b/src/popover/test/index.spec.js
@@ -148,3 +148,18 @@ test('should close popover when touch outside content', async () => {
   trigger(document.body, 'touchstart');
   expect(wrapper.emitted('update:show')[0][0]).toEqual(false);
 });
+
+test('should emit click-overlay event when overlay is clicked', () => {
+  const onClickOverlay = jest.fn();
+  const wrapper = mount(Popover, {
+    props: {
+      show: true,
+      overlay: true,
+      teleport: null,
+      onClickOverlay,
+    },
+  });
+
+  wrapper.find('.van-overlay').trigger('click');
+  expect(onClickOverlay).toHaveBeenCalledTimes(1);
+});