From a31592bb6e4473f8d7689eff1a6f6508f735de8d Mon Sep 17 00:00:00 2001
From: 07akioni <07akioni2@gmail.com>
Date: Wed, 27 Jul 2022 00:26:18 +0800
Subject: [PATCH] feat(dialog): useDialog supports `onEsc` prop

---
 CHANGELOG.en-US.md                        | 1 +
 CHANGELOG.zh-CN.md                        | 1 +
 src/dialog/demos/enUS/index.demo-entry.md | 3 ++-
 src/dialog/demos/zhCN/index.demo-entry.md | 1 +
 src/dialog/src/DialogEnvironment.tsx      | 1 +
 5 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.en-US.md b/CHANGELOG.en-US.md
index 00a46e103..0c5fea6a1 100644
--- a/CHANGELOG.en-US.md
+++ b/CHANGELOG.en-US.md
@@ -33,6 +33,7 @@
 - `n-transfer` add `render-target-label` prop.
 - `n-transfer` add `render-source-list` prop.
 - `n-scrollbar` supports RTL.
+- `useDialog` supports `onEsc` prop.
 
 ## 2.31.0
 
diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md
index 3d5cd7b19..c3ea45d68 100644
--- a/CHANGELOG.zh-CN.md
+++ b/CHANGELOG.zh-CN.md
@@ -33,6 +33,7 @@
 - `n-transfer` 新增 `render-target-label` 属性
 - `n-transfer` 新增 `render-source-list` 属性
 - `n-scrollbar` 支持 RTL
+- `useDialog` 支持 `onEsc` 属性
 
 ## 2.31.0
 
diff --git a/src/dialog/demos/enUS/index.demo-entry.md b/src/dialog/demos/enUS/index.demo-entry.md
index 3b4d485e8..37398f82c 100644
--- a/src/dialog/demos/enUS/index.demo-entry.md
+++ b/src/dialog/demos/enUS/index.demo-entry.md
@@ -58,7 +58,7 @@ action.vue
 ### DialogOptions Properties
 
 | Name | Type | Default | Description | Version |
-| --- | --- | --- | --- | --- |
+| --- | --- | --- | --- | --- | --- |
 | action | `() => VNodeChild` | `undefined` | Content of the operation area, must be a `render` function. |  |
 | autoFocus | `boolean` | `true` | Whether to focus the first focusable element inside modal. | 2.28.3 |
 | blockScroll | `boolean` | `true` | Whether to disabled body scrolling when it's active. | 2.28.3 |
@@ -106,6 +106,7 @@ All the properties can be modified dynamically.
 | title | `string \| (() => VNodeChild)` | Can be a `render` function. |  |
 | type | `'error \| 'success' \| 'warning'` | Dialog type. |  |
 | onClose | `() => boolean \| Promise<boolean> \| any` | The default behavior is closing the confirm. Return `false` or `resolve false` or `Promise rejected` will prevent the default behavior. |  |
+| onEsc | `() => void` | Callback fired when the escape key is pressed and focus is within dialog. | NEXT_VERSION |
 | onNegativeClick | `(e: MouseEvent) => boolean \| Promise<boolean> \| any` | The default behavior is closing the confirm. Return `false` or `resolve false` or `Promise rejected` will prevent the default behavior. |  |
 | onPositiveClick | `(e: MouseEvent) => boolean \| Promise<boolean> \| any` | The default behavior is closing the confirm. Return `false` or `resolve false` or `Promise rejected` will prevent the default behavior. |  |
 
diff --git a/src/dialog/demos/zhCN/index.demo-entry.md b/src/dialog/demos/zhCN/index.demo-entry.md
index bcfae5103..492ddeb71 100644
--- a/src/dialog/demos/zhCN/index.demo-entry.md
+++ b/src/dialog/demos/zhCN/index.demo-entry.md
@@ -108,6 +108,7 @@ focus-debug.vue
 | title | `string \| (() => VNodeChild)` | 可以是 `render` 函数 |  |
 | type | `'error \| 'success' \| 'warning'` | 对话框类型 |  |
 | onClose | `() => boolean \| Promise<boolean> \| any` | 默认行为是关闭确认框。返回 `false` 或者 resolve `false` 或者 `Promise` 被 `reject` 会避免默认行为 |  |
+| onEsc | `() => void` | 焦点在 dialog 内部时按下 Esc 键的回调 | NEXT_VERSION |
 | onNegativeClick | `(e: MouseEvent) => boolean \| Promise<boolean> \| any` | 默认行为是关闭确认框。返回 `false` 或者 resolve `false` 或者 `Promise` 被 `reject` 会避免默认行为 |  |
 | onPositiveClick | `(e: MouseEvent) => boolean \| Promise<boolean> \| any` | 默认行为是关闭确认框。返回 `false` 或者 resolve `false` 或者 `Promise` 被 `reject` 会避免默认行为 |  |
 
diff --git a/src/dialog/src/DialogEnvironment.tsx b/src/dialog/src/DialogEnvironment.tsx
index 212c59e34..ed5978944 100644
--- a/src/dialog/src/DialogEnvironment.tsx
+++ b/src/dialog/src/DialogEnvironment.tsx
@@ -10,6 +10,7 @@ export const exposedDialogEnvProps = {
   ...dialogProps,
   blockScroll: { type: Boolean, default: true },
   closeOnEsc: { type: Boolean, default: true },
+  onEsc: Function as PropType<() => void>,
   autoFocus: {
     type: Boolean,
     default: true