From 3a19c55d3a1dda9e0ea041d910bf31d1ddda7acd Mon Sep 17 00:00:00 2001
From: GitLab Bot <gitlab-bot@gitlab.com>
Date: Tue, 14 Nov 2023 12:09:51 +0000
Subject: Add latest changes from gitlab-org/gitlab@master

---
 .../super_sidebar/components/super_sidebar.vue     | 43 +++++++++++++++++++++-
 1 file changed, 41 insertions(+), 2 deletions(-)

(limited to 'app/assets/javascripts/super_sidebar/components')

diff --git a/app/assets/javascripts/super_sidebar/components/super_sidebar.vue b/app/assets/javascripts/super_sidebar/components/super_sidebar.vue
index 5f7cfce93b1..b8618e09761 100644
--- a/app/assets/javascripts/super_sidebar/components/super_sidebar.vue
+++ b/app/assets/javascripts/super_sidebar/components/super_sidebar.vue
@@ -1,6 +1,8 @@
 <script>
 import { GlButton } from '@gitlab/ui';
+import { GlBreakpointInstance, breakpoints } from '@gitlab/ui/dist/utils';
 import { Mousetrap } from '~/lib/mousetrap';
+import { TAB_KEY_CODE } from '~/lib/utils/keycodes';
 import { keysFor, TOGGLE_SUPER_SIDEBAR } from '~/behaviors/shortcuts/keybindings';
 import { __, s__ } from '~/locale';
 import Tracking from '~/tracking';
@@ -68,6 +70,13 @@ export default {
       };
     },
   },
+  watch: {
+    'sidebarState.isCollapsed': {
+      handler() {
+        this.setupFocusTrapListener();
+      },
+    },
+  },
   created() {
     const {
       is_logged_in: isLoggedIn,
@@ -80,9 +89,11 @@ export default {
     }
   },
   mounted() {
+    this.setupFocusTrapListener();
     Mousetrap.bind(keysFor(TOGGLE_SUPER_SIDEBAR), this.toggleSidebar);
   },
   beforeDestroy() {
+    document.removeEventListener('keydown', this.focusTrap);
     Mousetrap.unbind(keysFor(TOGGLE_SUPER_SIDEBAR));
   },
   methods: {
@@ -93,6 +104,17 @@ export default {
       });
       toggleSuperSidebarCollapsed(!isCollapsed(), true);
     },
+    setupFocusTrapListener() {
+      /**
+       * Only trap focus when sidebar displays over page content to avoid
+       * focus moving to page content and being obscured by the sidebar
+       */
+      if (GlBreakpointInstance.windowWidth() < breakpoints.xl && !this.sidebarState.isCollapsed) {
+        document.addEventListener('keydown', this.focusTrap);
+      } else {
+        document.removeEventListener('keydown', this.focusTrap);
+      }
+    },
     collapseSidebar() {
       toggleSuperSidebarCollapsed(true, false);
     },
@@ -122,6 +144,23 @@ export default {
         this.sidebarState.isCollapsed = true;
       }
     },
+    focusTrap(event) {
+      const { keyCode, shiftKey } = event;
+      const firstFocusableElement = this.$refs.userBar.$el.querySelector('a');
+      const lastFocusableElement = this.$refs.helpCenter.$el.querySelector('button');
+
+      if (keyCode !== TAB_KEY_CODE) return;
+
+      if (shiftKey) {
+        if (document.activeElement === firstFocusableElement) {
+          lastFocusableElement.focus();
+          event.preventDefault();
+        }
+      } else if (document.activeElement === lastFocusableElement) {
+        firstFocusableElement.focus();
+        event.preventDefault();
+      }
+    },
   },
 };
 </script>
@@ -152,7 +191,7 @@ export default {
       <h2 id="super-sidebar-heading" class="gl-sr-only">
         {{ $options.i18n.primaryNavigation }}
       </h2>
-      <user-bar :has-collapse-button="!showOverlay" :sidebar-data="sidebarData" />
+      <user-bar ref="userBar" :has-collapse-button="!showOverlay" :sidebar-data="sidebarData" />
       <div v-if="showTrialStatusWidget" class="gl-px-2 gl-py-2">
         <trial-status-widget
           class="gl-rounded-base gl-relative gl-display-flex gl-align-items-center gl-mb-1 gl-px-3 gl-line-height-normal gl-text-black-normal! gl-hover-bg-t-gray-a-08 gl-focus-bg-t-gray-a-08 gl-text-decoration-none! gl-py-3"
@@ -180,7 +219,7 @@ export default {
           <sidebar-portal-target />
         </div>
         <div class="gl-p-3">
-          <help-center :sidebar-data="sidebarData" />
+          <help-center ref="helpCenter" :sidebar-data="sidebarData" />
         </div>
       </div>
     </nav>
-- 
cgit v1.2.3