[Menu] Add reason value and update documentation for on close reason

.size-limit.js

@@ -22,7 +22,7 @@ module.exports = [
     name: 'The size of the @material-ui/core modules',
     webpack: true,
     path: 'packages/material-ui/build/index.js',
-    limit: '95.5 KB',
+    limit: '95.2 KB',
   },
   {
     name: 'The size of the @material-ui/styles modules',
@@ -35,13 +35,13 @@ module.exports = [
     name: 'The size of the @material-ui/core/Popper component',
     webpack: true,
     path: 'packages/material-ui/build/Popper/index.js',
-    limit: '10.6 KB',
+    limit: '10.7 KB',
   },
   {
     name: 'The main docs bundle',
     webpack: false,
     path: main.path,
-    limit: '177 KB',
+    limit: '176 KB',
   },
   {
     name: 'The docs home page',

packages/material-ui/src/Dialog/Dialog.js

@@ -260,6 +260,7 @@ Dialog.propTypes = {
    * Callback fired when the component requests to be closed.
    *
    * @param {object} event The event source of the callback
+   * @param {string} reason Can be:`"escapeKeyDown"`, `"backdropClick"`
    */
   onClose: PropTypes.func,
   /**

packages/material-ui/src/Menu/Menu.js

@@ -88,7 +88,7 @@ class Menu extends React.Component {
       event.preventDefault();
 
       if (this.props.onClose) {
-        this.props.onClose(event);
+        this.props.onClose(event, 'tabKeyDown');
       }
     }
   };
@@ -161,6 +161,7 @@ Menu.propTypes = {
    * Callback fired when the component requests to be closed.
    *
    * @param {object} event The event source of the callback
+   * @param {string} reason Can be:`"escapeKeyDown"`, `"backdropClick"`, `"tabKeyDown"`
    */
   onClose: PropTypes.func,
   /**

packages/material-ui/src/Popover/Popover.js

@@ -444,6 +444,7 @@ Popover.propTypes = {
    * Callback fired when the component requests to be closed.
    *
    * @param {object} event The event source of the callback.
+   * @param {string} reason Can be:`"escapeKeyDown"`, `"backdropClick"`
    */
   onClose: PropTypes.func,
   /**

pages/api/dialog.md

@@ -26,7 +26,7 @@ Dialogs are overlaid modal paper based components with a backdrop.
 | <span class="prop-name">fullWidth</span> | <span class="prop-type">bool</span> | <span class="prop-default">false</span> | If `true`, the dialog stretches to `maxWidth`. |
 | <span class="prop-name">maxWidth</span> | <span class="prop-type">enum:&nbsp;'xs', 'sm', 'md', 'lg', 'xl', false<br></span> | <span class="prop-default">'sm'</span> | Determine the max width of the dialog. The dialog width grows with the size of the screen, this property is useful on the desktop where you might need some coherent different width size across your application. Set to `false` to disable `maxWidth`. |
 | <span class="prop-name">onBackdropClick</span> | <span class="prop-type">func</span> |   | Callback fired when the backdrop is clicked. |
-| <span class="prop-name">onClose</span> | <span class="prop-type">func</span> |   | Callback fired when the component requests to be closed.<br><br>**Signature:**<br>`function(event: object) => void`<br>*event:* The event source of the callback |
+| <span class="prop-name">onClose</span> | <span class="prop-type">func</span> |   | Callback fired when the component requests to be closed.<br><br>**Signature:**<br>`function(event: object, reason: string) => void`<br>*event:* The event source of the callback<br>*reason:* Can be:`"escapeKeyDown"`, `"backdropClick"` |
 | <span class="prop-name">onEnter</span> | <span class="prop-type">func</span> |   | Callback fired before the dialog enters. |
 | <span class="prop-name">onEntered</span> | <span class="prop-type">func</span> |   | Callback fired when the dialog has entered. |
 | <span class="prop-name">onEntering</span> | <span class="prop-type">func</span> |   | Callback fired when the dialog is entering. |

pages/api/menu.md

@@ -23,7 +23,7 @@ import Menu from '@material-ui/core/Menu';
 | <span class="prop-name">classes</span> | <span class="prop-type">object</span> |   | Override or extend the styles applied to the component. See [CSS API](#css-api) below for more details. |
 | <span class="prop-name">disableAutoFocusItem</span> | <span class="prop-type">bool</span> | <span class="prop-default">false</span> | If `true`, the selected / first menu item will not be auto focused. |
 | <span class="prop-name">MenuListProps</span> | <span class="prop-type">object</span> |   | Properties applied to the [`MenuList`](/api/menu-list/) element. |
-| <span class="prop-name">onClose</span> | <span class="prop-type">func</span> |   | Callback fired when the component requests to be closed.<br><br>**Signature:**<br>`function(event: object) => void`<br>*event:* The event source of the callback |
+| <span class="prop-name">onClose</span> | <span class="prop-type">func</span> |   | Callback fired when the component requests to be closed.<br><br>**Signature:**<br>`function(event: object, reason: string) => void`<br>*event:* The event source of the callback<br>*reason:* Can be:`"escapeKeyDown"`, `"backdropClick"`, `"tabKeyDown"` |
 | <span class="prop-name">onEnter</span> | <span class="prop-type">func</span> |   | Callback fired before the Menu enters. |
 | <span class="prop-name">onEntered</span> | <span class="prop-type">func</span> |   | Callback fired when the Menu has entered. |
 | <span class="prop-name">onEntering</span> | <span class="prop-type">func</span> |   | Callback fired when the Menu is entering. |

pages/api/popover.md

@@ -30,7 +30,7 @@ import Popover from '@material-ui/core/Popover';
 | <span class="prop-name">getContentAnchorEl</span> | <span class="prop-type">func</span> |   | This function is called in order to retrieve the content anchor element. It's the opposite of the `anchorEl` property. The content anchor element should be an element inside the popover. It's used to correctly scroll and set the position of the popover. The positioning strategy tries to make the content anchor element just above the anchor element. |
 | <span class="prop-name">marginThreshold</span> | <span class="prop-type">number</span> | <span class="prop-default">16</span> | Specifies how close to the edge of the window the popover can appear. |
 | <span class="prop-name">ModalClasses</span> | <span class="prop-type">object</span> |   | `classes` property applied to the [`Modal`](/api/modal/) element. |
-| <span class="prop-name">onClose</span> | <span class="prop-type">func</span> |   | Callback fired when the component requests to be closed.<br><br>**Signature:**<br>`function(event: object) => void`<br>*event:* The event source of the callback. |
+| <span class="prop-name">onClose</span> | <span class="prop-type">func</span> |   | Callback fired when the component requests to be closed.<br><br>**Signature:**<br>`function(event: object, reason: string) => void`<br>*event:* The event source of the callback.<br>*reason:* Can be:`"escapeKeyDown"`, `"backdropClick"` |
 | <span class="prop-name">onEnter</span> | <span class="prop-type">func</span> |   | Callback fired before the component is entering. |
 | <span class="prop-name">onEntered</span> | <span class="prop-type">func</span> |   | Callback fired when the component has entered. |
 | <span class="prop-name">onEntering</span> | <span class="prop-type">func</span> |   | Callback fired when the component is entering. |