@carbon/vue 3.0.27 → 3.0.30

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "framework": "vue",
   "name": "@carbon/vue",
-  "version": "3.0.26",
+  "version": "3.0.29",
   "contributions": {
     "html": {
       "description-markup": "markdown",
@@ -770,6 +770,14 @@
                 "type": "string"
               },
               "default": "'main'"
+            },
+            {
+              "name": "id",
+              "value": {
+                "kind": "expression",
+                "type": "string"
+              },
+              "default": "'main-content'"
             }
           ],
           "slots": [
@@ -2280,7 +2288,7 @@
                 "kind": "expression",
                 "type": "string"
               },
-              "default": "undefined"
+              "default": "'menuitem'"
             }
           ],
           "slots": [
@@ -2320,6 +2328,14 @@
           "name": "CvHeaderNav",
           "description": "",
           "attributes": [
+            {
+              "name": "ariaLabel",
+              "value": {
+                "kind": "expression",
+                "type": "string"
+              },
+              "default": "undefined"
+            },
             {
               "name": "ariaLabelledBy",
               "value": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/vue",
   "license": "Apache-2.0",
-  "version": "3.0.27",
+  "version": "3.0.30",
   "description": "A collection of components for the Carbon Design System built using Vue.js",
   "packageManager": "yarn@3.2.0",
   "main": "dist/carbon-vue-3.umd.min.js",

package/src/components/CvDropdown/CvDropdown.vue

@@ -36,8 +36,9 @@
           `${carbonPrefix}--label`,
           { [`${carbonPrefix}--label--disabled`]: disabled },
         ]"
-        >{{ label }}</label
       >
+        {{ label }}
+      </label>
 
       <div
         ref="listBox"
@@ -110,7 +111,10 @@
           ref="dropList"
           :aria-hidden="!open ? 'true' : 'false'"
           :aria-labelledby="`${uid}-label`"
-          :class="`${carbonPrefix}--list-box__menu`"
+          :class="[
+            `${carbonPrefix}--list-box__menu`,
+            { 'cv-dropdown__menu--transition-done': transitionDone },
+          ]"
           role="menu"
           tabindex="-1"
         >
@@ -268,6 +272,7 @@ provide('dropdown-caption', dataCaption);
 const itemsList = ref([]);
 provide('dropdown-items', itemsList);
 const open = ref(false);
+const transitionDone = ref(false);
 const data = reactive({
   isHelper: false,
   isInvalid: undefined,
@@ -301,6 +306,15 @@ watch(dataValue, () => {
 });
 watch(open, () => {
   focusItem.value = '';
+  if (open.value) {
+    // Wait for the transition to complete before allowing overflow
+    transitionDone.value = false;
+    setTimeout(() => {
+      transitionDone.value = true;
+    }, 200); // Increase delay to ensure animation completes
+  } else {
+    transitionDone.value = false;
+  }
 });
 const ariaLabeledBy = computed(() => {
   if (props.label) {
@@ -323,6 +337,13 @@ const wrapperStyleOverride = computed(() => {
 });
 const el = ref(null);
 function onClickOut() {
+  // Move focus to button if focus is inside dropdown list
+  const dropListEl = dropList.value;
+  if (dropListEl && dropListEl.contains(document.activeElement)) {
+    if (button.value && typeof button.value.focus === 'function') {
+      button.value.focus();
+    }
+  }
   open.value = false;
 }
 onClickOutside(el, onClickOut);
@@ -372,8 +393,14 @@ function onUp() {
   }
 }
 function onEsc() {
+  // Move focus to button if focus is inside dropdown list
+  const dropListEl = dropList.value;
+  if (dropListEl && dropListEl.contains(document.activeElement)) {
+    if (button.value && typeof button.value.focus === 'function') {
+      button.value.focus();
+    }
+  }
   open.value = false;
-  doFocus();
 }
 const button = ref(null);
 const listBox = ref(null);
@@ -384,8 +411,10 @@ function onTab(ev) {
       open.value = false;
     } else if (ev.target === null || listBox.value?.contains(ev.target)) {
       // list has focus, close and return focus to dropdown
+      if (button.value && typeof button.value.focus === 'function') {
+        button.value.focus();
+      }
       open.value = false;
-      doFocus();
       ev.preventDefault();
     }
   }
@@ -394,9 +423,6 @@ function onClick(ev) {
   if (props.disabled) {
     ev.preventDefault();
   } else {
-    open.value = !open.value;
-    doFocus(); // open or close (Some browsers do not focus on button when clicked)
-
     let target = ev.target;
     while (
       !target.classList.contains(`${carbonPrefix}--dropdown-link`) &&
@@ -408,7 +434,25 @@ function onClick(ev) {
     if (target.classList.contains(`${carbonPrefix}--dropdown-link`)) {
       const targetItemEl = target.parentNode;
       dataValue.value = targetItemEl.getAttribute('data-value');
+      // Move focus to button before closing
+      if (button.value && typeof button.value.focus === 'function') {
+        button.value.focus();
+      }
+      open.value = false;
+    } else {
+      open.value = !open.value;
+      doFocus(); // open or close (Some browsers do not focus on button when clicked)
     }
   }
 }
 </script>
+
+<style lang="scss">
+.bx--list-box .bx--list-box__menu {
+  overflow-y: hidden !important;
+}
+
+.bx--list-box--expanded .bx--list-box__menu.cv-dropdown__menu--transition-done {
+  overflow-y: auto !important;
+}
+</style>

package/src/components/CvOverflowMenu/CvOverflowMenu.vue

@@ -229,7 +229,8 @@ function doFocus() {
         !(
           tryOn.classList.contains('cv-overflow-menu__before-content') ||
           tryOn.classList.contains('cv-overflow-menu__after-content') ||
-          tryOn.tabindex < 0
+          tryOn.tabindex < 0 ||
+          tryOn.disabled
         )
       ) {
         focusOn = tryOn;

package/src/components/CvTabs/CvTabs.vue

@@ -11,14 +11,16 @@
         },
       ]"
       role="navigation"
-      v-bind="$attrs"
+      :aria-label="attrs['aria-label'] || 'Tabs'"
+      v-bind="attrsWithoutAriaLabel"
       @keydown.right.prevent.stop="onRight"
       @keydown.left.prevent.stop="onLeft"
     >
       <button
         ref="elLeftOverflow"
-        aria-hidden="true"
-        aria-label="scroll left"
+        :aria-label="
+          leftOverflowNavButtonHidden ? undefined : 'Scroll tabs left'
+        "
         :class="[
           {
             [`${carbonPrefix}--tab--overflow-nav-button`]: horizontalOverflow,
@@ -26,7 +28,7 @@
               leftOverflowNavButtonHidden,
           },
         ]"
-        tabIndex="-1"
+        :tabIndex="leftOverflowNavButtonHidden ? -1 : 0"
         type="button"
         @click.stop.prevent="e => onOverflowClick(e, { direction: -1 })"
         @mousedown.stop.prevent="e => onOverflowMouseDown(e, { direction: -1 })"
@@ -89,8 +91,9 @@
       />
       <button
         ref="elRightOverflow"
-        aria-hidden="true"
-        aria-label="scroll right"
+        :aria-label="
+          rightOverflowNavButtonHidden ? undefined : 'Scroll tabs right'
+        "
         :class="[
           {
             [`${carbonPrefix}--tab--overflow-nav-button`]: horizontalOverflow,
@@ -98,7 +101,7 @@
               rightOverflowNavButtonHidden,
           },
         ]"
-        tabIndex="-1"
+        :tabIndex="rightOverflowNavButtonHidden ? -1 : 0"
         type="button"
         @click="e => onOverflowClick(e, { direction: 1 })"
         @mousedown="e => onOverflowMouseDown(e, { direction: 1 })"
@@ -117,15 +120,21 @@
 import { carbonPrefix } from '../../global/settings';
 import { ChevronLeft16, ChevronRight16 } from '@carbon/icons-vue';
 import {
+  computed,
   nextTick,
   onBeforeUnmount,
   onMounted,
   onUpdated,
   provide,
   ref,
+  useAttrs,
   watch,
 } from 'vue';
 
+defineOptions({
+  inheritAttrs: false,
+});
+
 const OVERFLOW_BUTTON_OFFSET = 40;
 
 const props = defineProps({
@@ -152,6 +161,12 @@ const props = defineProps({
 });
 const emit = defineEmits(['tab-selected', 'tab-selected-id']);
 
+const attrs = useAttrs();
+const attrsWithoutAriaLabel = computed(() => {
+  const { 'aria-label': _, ...rest } = attrs;
+  return rest;
+});
+
 const selectedId = ref('');
 provide('tab-selected', selectedId);
 /**

package/src/components/CvTabs/__tests__/__snapshots__/CvTabs.spec.js.snap

@@ -1,8 +1,8 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`CvTabs CvTabs - test slotted tab buttons to match snapshot 1`] = `
-<div class="cv-tabs ABC-class-123" style="width: 100%;" aria-label="ABC-aria-label-123">
-  <div data-tabs="" class="cv-tab bx--tabs--scrollable ABC-class-123" role="navigation" aria-label="ABC-aria-label-123"><button aria-hidden="true" aria-label="scroll left" class="bx--tab--overflow-nav-button--hidden" tabindex="-1" type="button"><svg focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true">
+<div class="cv-tabs" style="width: 100%;">
+  <div data-tabs="" class="cv-tab bx--tabs--scrollable ABC-class-123" role="navigation" aria-label="ABC-aria-label-123"><button class="bx--tab--overflow-nav-button--hidden" tabindex="-1" type="button"><svg focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true">
         <path d="M5 8L10 3 10.7 3.7 6.4 8 10.7 12.3 10 13z"></path>
       </svg></button>
     <!--v-if-->
@@ -11,7 +11,7 @@ exports[`CvTabs CvTabs - test slotted tab buttons to match snapshot 1`] = `
       <li class="cv-tabs-button  bx--tabs--scrollable__nav-item" role="presentation"><button id="tab-2-link" class="bx--tabs--scrollable__nav-link" role="tab" aria-controls="tab-2" aria-selected="false" tabindex="-1" type="button">Origin<strong style="color: orange;">(!)</strong></button></li>
       <li class="cv-tabs-button  bx--tabs--scrollable__nav-item" role="presentation"><button id="tab-3-link" class="bx--tabs--scrollable__nav-link" role="tab" aria-controls="tab-3" aria-selected="false" tabindex="-1" type="button">Tab 3 label</button></li>
     </ul>
-    <!--v-if--><button aria-hidden="true" aria-label="scroll right" class="bx--tab--overflow-nav-button--hidden" tabindex="-1" type="button"><svg focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true">
+    <!--v-if--><button class="bx--tab--overflow-nav-button--hidden" tabindex="-1" type="button"><svg focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true">
         <path d="M11 8L6 13 5.3 12.3 9.6 8 5.3 3.7 6 3z"></path>
       </svg></button>
   </div>

package/src/components/CvUIShell/CvContent.vue

@@ -2,11 +2,17 @@
 import { carbonPrefix } from '../../global/settings';
 defineProps({
   tagType: { type: String, default: 'main' },
+  id: { type: String, default: 'main-content' },
 });
 </script>
 
 <template>
-  <component :is="tagType" :class="`${carbonPrefix}--content`">
+  <component
+    :is="tagType"
+    :id="id"
+    :class="`${carbonPrefix}--content`"
+    tabindex="-1"
+  >
     <slot />
   </component>
 </template>

package/src/components/CvUIShell/CvHeaderMenu.vue

@@ -2,6 +2,7 @@
   <li
     ref="el"
     :class="`cv-header-menu ${carbonPrefix}--header__submenu`"
+    role="menuitem"
     @mouseenter="doHoverToggle(true)"
     @mouseleave="doHoverToggle(false)"
   >
@@ -10,9 +11,9 @@
       :aria-expanded="data.expanded ? 'true' : 'false'"
       :class="`${carbonPrefix}--header__menu-item ${carbonPrefix}--header__menu-title`"
       href="javascript:void(0)"
-      role="menuitem"
       tabindex="0"
       :aria-label="$attrs.ariaLabel"
+      role="button"
       @click="doToggle"
       @keydown.space.prevent
       @keyup.space.prevent="doToggle"

package/src/components/CvUIShell/CvHeaderMenuItem.vue

@@ -1,5 +1,5 @@
 <template>
-  <li class="cv-header-menu-item" :role="role">
+  <li class="cv-header-menu-item" role="none">
     <component
       :is="tagType"
       v-bind="{ ...$attrs, ...linkProps }"
@@ -7,8 +7,9 @@
         `${carbonPrefix}--header__menu-item`,
         { [`${carbonPrefix}--header__menu-item--current`]: activePage },
       ]"
-      role="menuitem"
       :aria-current="ariaCurrent"
+      :role="role"
+      :tabindex="tabindex"
     >
       <span :class="`${carbonPrefix}--text-truncate--end`">
         <slot />
@@ -25,7 +26,7 @@ import { computed } from 'vue';
 const props = defineProps({
   active: Boolean,
   ariaCurrent: { type: String, default: undefined },
-  role: { type: String, default: undefined },
+  role: { type: String, default: 'menuitem' },
   ...propsLink,
 });
 
@@ -35,4 +36,8 @@ const linkProps = useLinkProps(props);
 const activePage = computed(() => {
   return props.active && props.ariaCurrent !== 'page';
 });
+
+const tabindex = computed(() => {
+  return props.role === 'menuitem' ? '0' : undefined;
+});
 </script>

package/src/components/CvUIShell/CvHeaderNav.vue

@@ -3,16 +3,25 @@
     <ul
       :class="`${carbonPrefix}--header__menu-bar`"
       role="menubar"
-      :ariaLabeldBy="ariaLabelledBy"
+      aria-orientation="horizontal"
+      :aria-label="ariaLabel || $attrs['aria-label']"
+      :aria-labelledby="ariaLabelledBy || $attrs['aria-labelledby']"
     >
       <slot />
     </ul>
   </nav>
 </template>
 
+<script>
+export default {
+  inheritAttrs: false,
+};
+</script>
+
 <script setup>
 import { carbonPrefix } from '../../global/settings';
 defineProps({
+  ariaLabel: { type: String, default: undefined },
   ariaLabelledBy: { type: String, default: undefined },
 });
 </script>

package/src/components/CvUIShell/CvHeaderPanel.vue

@@ -8,6 +8,7 @@
       { [`${carbonPrefix}--header-panel--expanded`]: panelExpanded },
     ]"
     :aria-hidden="!panelExpanded ? 'true' : 'false'"
+    :inert="!panelExpanded"
     @focusout="onFocusout"
     @mousedown="onMouseDown"
   >
@@ -20,6 +21,7 @@ import { carbonPrefix } from '../../global/settings';
 import {
   computed,
   inject,
+  nextTick,
   onBeforeUnmount,
   onMounted,
   reactive,
@@ -99,9 +101,49 @@ watch(
   }
 );
 
+function manageFocusableElements(isExpanded) {
+  if (!el.value) return;
+
+  const focusableElements = el.value.querySelectorAll(
+    'a, button, input, textarea, select, details, [tabindex]:not([tabindex="-1"])'
+  );
+
+  focusableElements.forEach(element => {
+    if (isExpanded) {
+      // Restore original tabindex when expanded
+      const originalTabindex = element.getAttribute('data-original-tabindex');
+      if (originalTabindex !== null) {
+        if (originalTabindex === 'null') {
+          element.removeAttribute('tabindex');
+        } else {
+          element.setAttribute('tabindex', originalTabindex);
+        }
+        element.removeAttribute('data-original-tabindex');
+      }
+    } else {
+      // Store original tabindex and set to -1 when collapsed
+      const currentTabindex = element.getAttribute('tabindex');
+      element.setAttribute('data-original-tabindex', currentTabindex || 'null');
+      element.setAttribute('tabindex', '-1');
+    }
+  });
+}
+
 const emit = defineEmits(['update:expanded', 'panel-resize']);
 watch(panelExpanded, current => {
   emit('update:expanded', current);
   emit('panel-resize', { id: props.id, expanded: current });
+
+  // Manage focusable elements
+  nextTick(() => {
+    manageFocusableElements(current);
+  });
+});
+
+// Initial setup of focusable elements
+onMounted(() => {
+  nextTick(() => {
+    manageFocusableElements(panelExpanded.value);
+  });
 });
 </script>

package/src/components/CvUIShell/CvSideNav.vue

@@ -14,6 +14,7 @@
       },
     ]"
     :aria-hidden="!panelExpanded && !fixed ? 'true' : 'false'"
+    :inert="!panelExpanded && !fixed"
     @focusout="onFocusout"
     @mousedown="onMouseDown"
     @mouseenter="onHoverToggle(true)"
@@ -33,6 +34,7 @@
 import {
   computed,
   inject,
+  nextTick,
   onBeforeUnmount,
   onMounted,
   reactive,
@@ -110,6 +112,35 @@ watch(
     panelExpanded.value = props.expanded;
   }
 );
+// Manage focusable elements when panel visibility changes
+function manageFocusableElements(isExpanded, isFixed) {
+  if (!el.value || isFixed) return;
+
+  const focusableElements = el.value.querySelectorAll(
+    'a, button, input, textarea, select, details, [tabindex]:not([tabindex="-1"])'
+  );
+
+  focusableElements.forEach(element => {
+    if (isExpanded) {
+      // Restore original tabindex when expanded
+      const originalTabindex = element.getAttribute('data-original-tabindex');
+      if (originalTabindex !== null) {
+        if (originalTabindex === 'null') {
+          element.removeAttribute('tabindex');
+        } else {
+          element.setAttribute('tabindex', originalTabindex);
+        }
+        element.removeAttribute('data-original-tabindex');
+      }
+    } else {
+      // Store original tabindex and set to -1 when collapsed
+      const currentTabindex = element.getAttribute('tabindex');
+      element.setAttribute('data-original-tabindex', currentTabindex || 'null');
+      element.setAttribute('tabindex', '-1');
+    }
+  });
+}
+
 const emit = defineEmits(['update:expanded', 'panel-resize']);
 const isPanelExpanded = computed(
   () => panelExpanded.value || expandedViaHoverState.value
@@ -117,6 +148,11 @@ const isPanelExpanded = computed(
 watch(isPanelExpanded, current => {
   emit('update:expanded', current);
   emit('panel-resize', { id: props.id, expanded: current });
+
+  // Manage focusable elements for non-fixed nav
+  nextTick(() => {
+    manageFocusableElements(current, props.fixed);
+  });
 });
 
 const isChildOfHeader = computed(() => {

package/src/components/CvUIShell/CvUIShell.stories.mdx

@@ -19,6 +19,7 @@ import CvSideNavLink from './CvSideNavLink.vue';
 import CvSideNavMenu from './CvSideNavMenu.vue';
 import CvSideNavMenuDivider from './CvSideNavMenuDivider.vue';
 import CvSideNavMenuItem from './CvSideNavMenuItem.vue';
+import CvContent from './CvContent.vue';
 import {
   Notification20,
   UserAvatar20,
@@ -55,6 +56,7 @@ export const Template = args => ({
     CvSideNavMenu,
     CvSideNavMenuDivider,
     CvSideNavMenuItem,
+    CvContent,
     Notification20,
     UserAvatar20,
     Login20,
@@ -89,22 +91,12 @@ const defaultTemplate = `
     [Platform]
   </cv-header-name>
   <cv-header-nav aria-label="Carbon nav">
-    <cv-header-menu-item href="javascript:void(0)">
-      Link 1
-    </cv-header-menu-item>
-    <cv-header-menu-item href="javascript:void(0)">
-      Link 2
-    </cv-header-menu-item>
+    <cv-header-menu-item href="javascript:void(0)">Link 1</cv-header-menu-item>
+    <cv-header-menu-item href="javascript:void(0)">Link 2</cv-header-menu-item>
     <cv-header-menu aria-label="Link 3" title="Link 3">
-      <cv-header-menu-item href="javascript:void(0)">
-        Submenu Link 1
-      </cv-header-menu-item>
-      <cv-header-menu-item href="javascript:void(0)">
-        Submenu Link 2
-      </cv-header-menu-item>
-      <cv-header-menu-item href="javascript:void(0)">
-        Submenu Link 3
-      </cv-header-menu-item>
+      <cv-header-menu-item href="javascript:void(0)">Submenu Link 1</cv-header-menu-item>
+      <cv-header-menu-item href="javascript:void(0)">Submenu Link 2</cv-header-menu-item>
+      <cv-header-menu-item href="javascript:void(0)">Submenu Link 3</cv-header-menu-item>
     </cv-header-menu>
   </cv-header-nav>
   <template v-slot:header-global>
@@ -162,6 +154,10 @@ const defaultTemplate = `
     </cv-header-panel>
   </template>
 </cv-header>
+<cv-content>
+  <h1>Main Content</h1>
+  <p>This is the main content area that the skip link targets.</p>
+</cv-content>
 `;
 const railTemplate = `
 <cv-header aria-label="Carbon header">
@@ -196,6 +192,10 @@ const railTemplate = `
     </cv-side-nav>
   </template>
 </cv-header>
+<cv-content>
+  <h1>Main Content</h1>
+  <p>This is the main content area that the skip link targets.</p>
+</cv-content>
 `;
 const fixedSideNavTemplate = `
 <cv-header aria-label="Carbon header">
@@ -231,6 +231,10 @@ const fixedSideNavTemplate = `
     </cv-side-nav-link>
   </cv-side-nav-items>
 </cv-side-nav>
+<cv-content>
+  <h1>Main Content</h1>
+  <p>This is the main content area that the skip link targets.</p>
+</cv-content>
 `;
 
 # UI Shell components