From c1b869d7ce6d8f70dd3f4d1c006e70986e63a7fd Mon Sep 17 00:00:00 2001
From: hetech <dengzhiyang123@126.com>
Date: Wed, 14 Nov 2018 12:25:41 +0800
Subject: [PATCH] Cascader: add visible-change event (#13415)

---
 examples/docs/en-US/cascader.md | 1 +
 examples/docs/es/cascader.md    | 1 +
 examples/docs/zh-CN/cascader.md | 1 +
 examples/docs/zh-CN/steps.md    | 6 +++---
 packages/cascader/src/main.vue  | 1 +
 5 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/examples/docs/en-US/cascader.md b/examples/docs/en-US/cascader.md
index e8582b945..b063a1d7d 100644
--- a/examples/docs/en-US/cascader.md
+++ b/examples/docs/en-US/cascader.md
@@ -1697,3 +1697,4 @@ Search and select options with a keyword.
 | active-item-change | triggers when active option of its parent changes, only works when `change-on-select` is `false` | an array of active options |
 | blur | triggers when Cascader blurs | (event: Event) |
 | focus | triggers when Cascader focuses | (event: Event) |
+| visible-change | triggers when the dropdown appears/disappears | true when it appears, and false otherwise |
diff --git a/examples/docs/es/cascader.md b/examples/docs/es/cascader.md
index 2ece17d59..8cec8024e 100644
--- a/examples/docs/es/cascader.md
+++ b/examples/docs/es/cascader.md
@@ -1702,4 +1702,5 @@ Buscar y seleccionar opciones con una palabra clave.
 | active-item-change | se dispara cuando la opcion activa del parent cambia, sólo funciona cuando `change-on-select` es `false`. | array de opciones activas |
 | blur               | se dispara cuando Cascader pierde el foco                    | (event: Event)            |
 | focus              | se dispara cuando Cascader obtiene el foco                   | (event: Event)            |
+| visible-change     | se dispara cuando el menu desplegable aparece o desaparece   | true cuando aparece, y false en otro caso |
 
diff --git a/examples/docs/zh-CN/cascader.md b/examples/docs/zh-CN/cascader.md
index 6dd3a6ffd..88126071b 100644
--- a/examples/docs/zh-CN/cascader.md
+++ b/examples/docs/zh-CN/cascader.md
@@ -1697,3 +1697,4 @@
 | active-item-change | 当父级选项变化时触发的事件，仅在 `change-on-select` 为 `false` 时可用 | 各父级选项组成的数组 |
 | blur | 在 Cascader 失去焦点时触发 | (event: Event) |
 | focus | 在 Cascader 获得焦点时触发 | (event: Event) |
+| visible-change | 下拉框出现/隐藏时触发 | 出现则为 true，隐藏则为 false |
diff --git a/examples/docs/zh-CN/steps.md b/examples/docs/zh-CN/steps.md
index f6eede7f0..2117d8549 100644
--- a/examples/docs/zh-CN/steps.md
+++ b/examples/docs/zh-CN/steps.md
@@ -165,6 +165,6 @@
 ### Step Slot
 | name | 说明  |
 |----|----|
-| icon | 图标 |
-| title | 标题 |
-| description | 描述性文字 |
+| icon | 自定义图标 |
+| title | 自定义标题 |
+| description | 自定义描述性文字 |
diff --git a/packages/cascader/src/main.vue b/packages/cascader/src/main.vue
index 8254d5f1c..099c35e22 100644
--- a/packages/cascader/src/main.vue
+++ b/packages/cascader/src/main.vue
@@ -231,6 +231,7 @@ export default {
     menuVisible(value) {
       this.$refs.input.$refs.input.setAttribute('aria-expanded', value);
       value ? this.showMenu() : this.hideMenu();
+      this.$emit('visible-change', value);
     },
     value(value) {
       this.currentValue = value;