[NavigationDrawer] Update demos to close drawers on esc key press and add guidance in docs

PiperOrigin-RevId: 780327427

Author: imhappi

catalog/java/io/material/catalog/navigationdrawer/CustomNavigationDrawerDemoActivity.java

@@ -25,6 +25,7 @@
 import android.os.Bundle;
 import androidx.appcompat.app.ActionBarDrawerToggle;
 import androidx.appcompat.widget.Toolbar;
+import android.view.KeyEvent;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.ViewGroup;
@@ -36,6 +37,7 @@
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import androidx.annotation.RequiresApi;
+import androidx.core.view.GravityCompat;
 import androidx.drawerlayout.widget.DrawerLayout;
 import androidx.drawerlayout.widget.DrawerLayout.LayoutParams;
 import androidx.drawerlayout.widget.DrawerLayout.SimpleDrawerListener;
@@ -192,4 +194,15 @@ public void onBackCancelled() {
       }
     };
   }
+
+  @Override
+  public boolean onKeyDown(int keyCode, KeyEvent keyEvent) {
+    if (keyCode == KeyEvent.KEYCODE_ESCAPE
+        && (drawerLayout.isDrawerOpen(GravityCompat.START)
+            || drawerLayout.isDrawerOpen(GravityCompat.END))) {
+      drawerLayout.closeDrawers();
+      return true;
+    }
+    return super.onKeyDown(keyCode, keyEvent);
+  }
 }

catalog/java/io/material/catalog/navigationdrawer/NavigationDrawerDemoActivity.java

@@ -21,6 +21,7 @@
 import android.os.Bundle;
 import androidx.appcompat.app.ActionBarDrawerToggle;
 import androidx.appcompat.widget.Toolbar;
+import android.view.KeyEvent;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.ViewGroup;
@@ -123,6 +124,17 @@ private void initNavigationView(NavigationView navigationView) {
         });
   }
 
+  @Override
+  public boolean onKeyDown(int keyCode, KeyEvent keyEvent) {
+    if (keyCode == KeyEvent.KEYCODE_ESCAPE
+        && (drawerLayout.isDrawerOpen(GravityCompat.START)
+            || drawerLayout.isDrawerOpen(GravityCompat.END))) {
+      drawerLayout.closeDrawers();
+      return true;
+    }
+    return super.onKeyDown(keyCode, keyEvent);
+  }
+
   @Override
   protected boolean shouldShowDefaultDemoActionBar() {
     return false;

docs/components/NavigationDrawer.md

@@ -494,6 +494,21 @@ optional but recommended.
 For more information on content labels, go to the
 [Android accessibility help guide](https://support.google.com/accessibility/android/answer/7158690).
 
+Important: Ensure that there is a way to close the navigation drawer through
+keyboard navigation by listening for the `esc` key in your activity and closing
+open drawers.
+
+```java
+  @Override
+  public boolean onKeyDown(int keyCode, KeyEvent keyEvent) {
+    if (keyCode == KeyEvent.KEYCODE_ESCAPE && drawerLayout.isDrawerOpen(navigationView)) {
+      drawerLayout.closeDrawer(navigationView);
+      return true;
+    }
+    return super.onKeyDown(keyCode, keyEvent);
+  }
+```
+
 </details>
 
 <details>