From b276fb5a78a862ca20f91596d85b9ea4783d54fc Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan@youzan.com>
Date: Tue, 1 Sep 2020 20:29:55 +0800
Subject: [PATCH 1/3] docs: add axure resource (#7077)

---
 docs/markdown/design.zh-CN.md | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/docs/markdown/design.zh-CN.md b/docs/markdown/design.zh-CN.md
index 0372b52bd..4b63121a6 100644
--- a/docs/markdown/design.zh-CN.md
+++ b/docs/markdown/design.zh-CN.md
@@ -4,24 +4,32 @@
 
 这里提供了 Vant 现有的设计资源，更多资源还在整理中。
 
-### 组件
+### 组件设计稿（Sketch）
 
 包含 Sketch 格式的组件设计规范、色彩规范。
 
-<img src="https://img.yzcdn.cn/vant/design-components-0321.png" style="width: 80%;">
+<img src="https://img.yzcdn.cn/vant/design-components-0321.png" style="width: 80%; box-shadow: 0 1px 2px rgba(0,0,0,.2)">
 
 <a class="design-download" href="https://github.com/youzan/vant/blob/dev/docs/assets/design.sketch?raw=true">下载</a>
 
 > 提示：目前 Sketch 中部分组件仍为旧版样式，我们正在梳理新版设计规范，尽请期待！
 
-### 图标
+### 图标设计稿（Sketch）
 
 包含 Sketch 格式的图标库资源。
 
-<img src="https://img.yzcdn.cn/vant/design-icons-0321.png" style="width: 80%;">
+<img src="https://img.yzcdn.cn/vant/design-icons-0321.png" style="width: 80%; box-shadow: 0 1px 2px rgba(0,0,0,.2)">
 
 <a class="design-download" href="https://github.com/youzan/vant-icons/blob/master/assets/icons.sketch?raw=true">下载</a>
 
+### Axure 元件库
+
+Axure 元件库，由社区的 [@axure-tczy](https://github.com/axure-tczy) 同学贡献。
+
+<img src="https://img.yzcdn.cn/vant/vant-axure-0901-2.png" style="width: 80%; box-shadow: 0 1px 2px rgba(0,0,0,.2)">
+
+<a class="design-download" href="https://b.yzcdn.cn/vant/vant-axure-20200901.zip">下载</a>
+
 <style>
 a.design-download {
   display: inline-block;
@@ -34,6 +42,7 @@ a.design-download {
 }
 
 a.design-download:hover {
+  color: #fff;
   opacity: .9;
 }
 

From d55585314fc1f98901dd1e773238127a4e10a777 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan@youzan.com>
Date: Wed, 2 Sep 2020 11:45:11 +0800
Subject: [PATCH 2/3] feat(Tabbar): add before-change prop (#7081)

---
 src/tabbar/README.md               |  1 +
 src/tabbar/README.zh-CN.md         |  1 +
 src/tabbar/index.js                | 14 +++++++--
 src/utils/interceptor.ts           | 27 ++++++++++++++++
 src/utils/test/interceptor.spec.js | 50 ++++++++++++++++++++++++++++++
 5 files changed, 90 insertions(+), 3 deletions(-)
 create mode 100644 src/utils/interceptor.ts
 create mode 100644 src/utils/test/interceptor.spec.js

diff --git a/src/tabbar/README.md b/src/tabbar/README.md
index 7fca5e380..d38fe1a86 100644
--- a/src/tabbar/README.md
+++ b/src/tabbar/README.md
@@ -160,6 +160,7 @@ export default {
 | route | Whether to enable route mode | _boolean_ | `false` |
 | placeholder `v2.6.0` | Whether to generage a placeholder element when fixed | _boolean_ | `false` |
 | safe-area-inset-bottom | Whether to enable bottom safe area adaptation | _boolean_ | `false` |
+| before-change `v2.10.4` | Callback function before changing tabs，return `false` to prevent change，support return Promise | _(name) => boolean \| Promise_ | - |
 
 ### Tabbar Events
 
diff --git a/src/tabbar/README.zh-CN.md b/src/tabbar/README.zh-CN.md
index 634a66137..2578c0109 100644
--- a/src/tabbar/README.zh-CN.md
+++ b/src/tabbar/README.zh-CN.md
@@ -168,6 +168,7 @@ export default {
 | route | 是否开启路由模式 | _boolean_ | `false` |
 | placeholder `v2.6.0` | 固定在底部时，是否在标签位置生成一个等高的占位元素 | _boolean_ | `false` |
 | safe-area-inset-bottom | 是否开启[底部安全区适配](#/zh-CN/quickstart#di-bu-an-quan-qu-gua-pei)，设置 fixed 时默认开启 | _boolean_ | `false` |
+| before-change `v2.10.4` | 切换标签前的回调函数，返回 `false` 可阻止切换，支持返回 Promise | _(name) => boolean \| Promise_ | - |
 
 ### Tabbar Events
 
diff --git a/src/tabbar/index.js b/src/tabbar/index.js
index 27b5d445b..b1c4af25e 100644
--- a/src/tabbar/index.js
+++ b/src/tabbar/index.js
@@ -1,6 +1,7 @@
 import { createNamespace } from '../utils';
-import { ParentMixin } from '../mixins/relation';
 import { BORDER_TOP_BOTTOM } from '../utils/constant';
+import { callInterceptor } from '../utils/interceptor';
+import { ParentMixin } from '../mixins/relation';
 
 const [createComponent, bem] = createNamespace('tabbar');
 
@@ -12,6 +13,7 @@ export default createComponent({
     zIndex: [Number, String],
     placeholder: Boolean,
     activeColor: String,
+    beforeChange: Function,
     inactiveColor: String,
     value: {
       type: [Number, String],
@@ -67,8 +69,14 @@ export default createComponent({
 
     onChange(active) {
       if (active !== this.value) {
-        this.$emit('input', active);
-        this.$emit('change', active);
+        callInterceptor({
+          interceptor: this.beforeChange,
+          args: [active],
+          done: () => {
+            this.$emit('input', active);
+            this.$emit('change', active);
+          },
+        });
       }
     },
 
diff --git a/src/utils/interceptor.ts b/src/utils/interceptor.ts
new file mode 100644
index 000000000..96cb63481
--- /dev/null
+++ b/src/utils/interceptor.ts
@@ -0,0 +1,27 @@
+import { isPromise, noop } from '.';
+
+export function callInterceptor(options: {
+  interceptor?: (...args: any[]) => Promise<boolean> | boolean;
+  done: () => void;
+  args: any[];
+}) {
+  const { interceptor, args, done } = options;
+
+  if (interceptor) {
+    const returnVal = interceptor(...args);
+
+    if (isPromise(returnVal)) {
+      returnVal
+        .then((value) => {
+          if (value) {
+            done();
+          }
+        })
+        .catch(noop);
+    } else if (returnVal) {
+      done();
+    }
+  } else {
+    done();
+  }
+}
diff --git a/src/utils/test/interceptor.spec.js b/src/utils/test/interceptor.spec.js
new file mode 100644
index 000000000..cd7c92552
--- /dev/null
+++ b/src/utils/test/interceptor.spec.js
@@ -0,0 +1,50 @@
+import { later } from '../../../test';
+import { callInterceptor } from '../interceptor';
+
+test('#callInterceptor', async () => {
+  const done = jest.fn();
+  callInterceptor({ done });
+  expect(done).toHaveBeenCalledTimes(1);
+
+  callInterceptor({
+    interceptor: () => false,
+    done,
+  });
+  expect(done).toHaveBeenCalledTimes(1);
+
+  callInterceptor({
+    interceptor: () => true,
+    done,
+  });
+  expect(done).toHaveBeenCalledTimes(2);
+
+  callInterceptor({
+    interceptor: () => Promise.resolve(false),
+    done,
+  });
+  await later();
+  expect(done).toHaveBeenCalledTimes(2);
+
+  callInterceptor({
+    interceptor: () => Promise.resolve(true),
+    done,
+  });
+  await later();
+  expect(done).toHaveBeenCalledTimes(3);
+
+  callInterceptor({
+    interceptor: () => Promise.reject(),
+    done,
+  });
+  await later();
+  expect(done).toHaveBeenCalledTimes(3);
+
+  callInterceptor({
+    interceptor: (...args) => {
+      expect(args).toEqual(['foo']);
+    },
+    args: ['foo'],
+    done,
+  });
+  expect(done).toHaveBeenCalledTimes(3);
+});

From 438d34caf17b8a92234d31c4e201ad8901b5eb00 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan@youzan.com>
Date: Wed, 2 Sep 2020 11:57:44 +0800
Subject: [PATCH 3/3] chore(Tab): use callInterceptor (#7082)

---
 src/tabs/index.js | 32 ++++++++++----------------------
 1 file changed, 10 insertions(+), 22 deletions(-)

diff --git a/src/tabs/index.js b/src/tabs/index.js
index 69a7c9b96..ddafe2556 100644
--- a/src/tabs/index.js
+++ b/src/tabs/index.js
@@ -1,10 +1,11 @@
 // Utils
-import { createNamespace, isDef, addUnit, isPromise } from '../utils';
+import { createNamespace, isDef, addUnit } from '../utils';
 import { scrollLeftTo, scrollTopTo } from './utils';
 import { route } from '../utils/router';
 import { isHidden } from '../utils/dom/style';
 import { on, off } from '../utils/dom/event';
 import { BORDER_TOP_BOTTOM } from '../utils/constant';
+import { callInterceptor } from '../utils/interceptor';
 import {
   getScroller,
   getVisibleTop,
@@ -263,34 +264,21 @@ export default createComponent({
       }
     },
 
-    callBeforeChange(name, done) {
-      if (this.beforeChange) {
-        const returnVal = this.beforeChange(name);
-
-        if (isPromise(returnVal)) {
-          returnVal.then((value) => {
-            if (value) {
-              done();
-            }
-          });
-        } else if (returnVal) {
-          done();
-        }
-      } else {
-        done();
-      }
-    },
-
     // emit event when clicked
     onClick(item, index) {
       const { title, disabled, computedName } = this.children[index];
       if (disabled) {
         this.$emit('disabled', computedName, title);
       } else {
-        this.callBeforeChange(computedName, () => {
-          this.setCurrentIndex(index);
-          this.scrollToCurrentContent();
+        callInterceptor({
+          interceptor: this.beforeChange,
+          args: [computedName],
+          done: () => {
+            this.setCurrentIndex(index);
+            this.scrollToCurrentContent();
+          },
         });
+
         this.$emit('click', computedName, title);
         route(item.$router, item);
       }