[a11y] When aria-disabled is set on SegmentedControl, don't allow action

.changeset/strong-mangos-rest.md

@@ -0,0 +1,6 @@
+---
+"@primer/react": minor
+---
+
+Remove the feature flag for `primer_react_segmented_control_tooltip` and GA tooltip by default behavior.
+- Ensure that when `disabled` is applied, the tooltip is still triggered.

e2e/components/SegmentedControl.test.ts

@@ -64,6 +64,10 @@ const stories = [
     title: 'Dev: With Css',
     id: 'components-segmentedcontrol-dev--with-css',
   },
+  {
+    title: 'With Disabled Buttons',
+    id: 'components-segmentedcontrol-examples--with-disabled-buttons',
+  },
 ] as const
 
 test.describe('SegmentedControl', () => {

packages/react/src/FeatureFlags/DefaultFeatureFlags.ts

@@ -4,7 +4,6 @@ export const DefaultFeatureFlags = FeatureFlagScope.create({
   primer_react_action_list_item_as_button: false,
   primer_react_breadcrumbs_overflow_menu: false,
   primer_react_overlay_overflow: false,
-  primer_react_segmented_control_tooltip: false,
   primer_react_select_panel_fullscreen_on_narrow: false,
   primer_react_select_panel_order_selected_at_top: false,
   primer_react_select_panel_remove_active_descendant: false,

packages/react/src/SegmentedControl/SegmentedControl.dev.stories.tsx

@@ -13,6 +13,82 @@ export default {
   parameters: {controls: {exclude: excludedControlKeys}},
 } as Meta<typeof SegmentedControl>
 
+export const WithAriaDisabled = () => {
+  const handleOnClick = () => {
+    alert('Button clicked!')
+  }
+
+  return (
+    <SegmentedControl aria-label="File view" className="testCustomClassnameMono">
+      <SegmentedControl.IconButton
+        onClick={handleOnClick}
+        aria-label={'Preview'}
+        aria-disabled={true}
+        icon={EyeIcon}
+        className="testCustomClassnameColor"
+      >
+        Preview
+      </SegmentedControl.IconButton>
+      <SegmentedControl.IconButton
+        aria-disabled={true}
+        onClick={handleOnClick}
+        aria-label={'Raw'}
+        icon={FileCodeIcon}
+        className="testCustomClassnameColor"
+      >
+        Raw
+      </SegmentedControl.IconButton>
+      <SegmentedControl.IconButton
+        aria-disabled={true}
+        onClick={handleOnClick}
+        aria-label={'Blame'}
+        icon={PeopleIcon}
+        className="testCustomClassnameColor"
+      >
+        Blame
+      </SegmentedControl.IconButton>
+    </SegmentedControl>
+  )
+}
+
+export const WithDisabled = () => {
+  const handleOnClick = () => {
+    alert('Button clicked!')
+  }
+
+  return (
+    <SegmentedControl aria-label="File view" className="testCustomClassnameMono">
+      <SegmentedControl.IconButton
+        onClick={handleOnClick}
+        aria-label={'Preview'}
+        disabled={true}
+        icon={EyeIcon}
+        className="testCustomClassnameColor"
+      >
+        Preview
+      </SegmentedControl.IconButton>
+      <SegmentedControl.IconButton
+        disabled={true}
+        onClick={handleOnClick}
+        aria-label={'Raw'}
+        icon={FileCodeIcon}
+        className="testCustomClassnameColor"
+      >
+        Raw
+      </SegmentedControl.IconButton>
+      <SegmentedControl.IconButton
+        disabled={true}
+        onClick={handleOnClick}
+        aria-label={'Blame'}
+        icon={PeopleIcon}
+        className="testCustomClassnameColor"
+      >
+        Blame
+      </SegmentedControl.IconButton>
+    </SegmentedControl>
+  )
+}
+
 export const WithCss = () => (
   <SegmentedControl aria-label="File view" className="testCustomClassnameMono">
     <SegmentedControl.Button

packages/react/src/SegmentedControl/SegmentedControl.examples.stories.tsx

@@ -0,0 +1,22 @@
+import type {Meta} from '@storybook/react-vite'
+import {SegmentedControl} from '.'
+import {EyeIcon, FileCodeIcon, PeopleIcon} from '@primer/octicons-react'
+
+export default {
+  title: 'Components/SegmentedControl/Examples',
+  component: SegmentedControl,
+} as Meta<typeof SegmentedControl>
+
+export const WithDisabledButtons = () => (
+  <SegmentedControl aria-label="File view">
+    <SegmentedControl.Button defaultSelected aria-label={'Preview'} leadingIcon={EyeIcon} disabled>
+      Preview
+    </SegmentedControl.Button>
+    <SegmentedControl.Button aria-label={'Raw'} leadingIcon={FileCodeIcon}>
+      Raw
+    </SegmentedControl.Button>
+    <SegmentedControl.Button aria-label={'Blame'} leadingIcon={PeopleIcon} aria-disabled={true}>
+      Blame
+    </SegmentedControl.Button>
+  </SegmentedControl>
+)

packages/react/src/SegmentedControl/SegmentedControl.module.css

@@ -259,6 +259,17 @@
     width: 0;
   }
 
+  &[aria-disabled='true']:not([aria-current='true']) {
+    cursor: not-allowed;
+    color: var(--fgColor-disabled);
+    background-color: transparent;
+
+    & svg {
+      fill: var(--fgColor-disabled);
+      color: var(--fgColor-disabled);
+    }
+  }
+
   @media (pointer: coarse) {
     &::before {
       position: absolute;
@@ -313,7 +324,7 @@
   }
 }
 
-.Button:not([aria-current='true']) {
+.Button:not([aria-current='true'], [aria-disabled='true']) {
   &:hover .Content {
     background-color: var(--controlTrack-bgColor-hover);
   }

packages/react/src/SegmentedControl/SegmentedControl.test.tsx

@@ -3,7 +3,6 @@ import {EyeIcon, FileCodeIcon, PeopleIcon} from '@primer/octicons-react'
 import userEvent from '@testing-library/user-event'
 import {describe, expect, it, vi} from 'vitest'
 import BaseStyles from '../BaseStyles'
-import {FeatureFlags} from '../FeatureFlags'
 import {SegmentedControl} from '../SegmentedControl'
 
 const segmentData = [
@@ -142,19 +141,13 @@ describe('SegmentedControl', () => {
     }
   })
 
-  it('renders icon button with tooltip as label when feature flag is enabled', () => {
+  it('renders icon button with tooltip as label', () => {
     const {getByRole, getByText} = render(
-      <FeatureFlags
-        flags={{
-          primer_react_segmented_control_tooltip: true,
-        }}
-      >
-        <SegmentedControl aria-label="File view">
-          {segmentData.map(({label, icon}) => (
-            <SegmentedControl.IconButton icon={icon} aria-label={label} key={label} />
-          ))}
-        </SegmentedControl>
-      </FeatureFlags>,
+      <SegmentedControl aria-label="File view">
+        {segmentData.map(({label, icon}) => (
+          <SegmentedControl.IconButton icon={icon} aria-label={label} key={label} />
+        ))}
+      </SegmentedControl>,
     )
 
     for (const datum of segmentData) {
@@ -165,41 +158,20 @@ describe('SegmentedControl', () => {
     }
   })
 
-  it('renders icon button with tooltip description when feature flag is enabled', () => {
+  it('renders icon button with tooltip description', () => {
     const {getByRole, getByText} = render(
-      <FeatureFlags
-        flags={{
-          primer_react_segmented_control_tooltip: true,
-        }}
-      >
-        <SegmentedControl aria-label="File view">
-          {segmentData.map(({label, icon, description}) => (
-            <SegmentedControl.IconButton icon={icon} aria-label={label} description={description} key={label} />
-          ))}
-        </SegmentedControl>
-      </FeatureFlags>,
-    )
-
-    for (const datum of segmentData) {
-      const labelledButton = getByRole('button', {name: datum.label})
-      const tooltipElement = getByText(datum.description)
-      expect(labelledButton).toHaveAttribute('aria-describedby', tooltipElement.id)
-      expect(labelledButton).toHaveAccessibleName(datum.label)
-      expect(labelledButton).toHaveAttribute('aria-label', datum.label)
-    }
-  })
-
-  it('renders icon button with aria-label and no tooltip', () => {
-    const {getByRole} = render(
       <SegmentedControl aria-label="File view">
-        {segmentData.map(({label, icon}) => (
-          <SegmentedControl.IconButton icon={icon} aria-label={label} key={label} />
+        {segmentData.map(({label, icon, description}) => (
+          <SegmentedControl.IconButton icon={icon} aria-label={label} description={description} key={label} />
         ))}
       </SegmentedControl>,
     )
 
     for (const datum of segmentData) {
       const labelledButton = getByRole('button', {name: datum.label})
+      const tooltipElement = getByText(datum.description)
+      expect(labelledButton).toHaveAttribute('aria-describedby', tooltipElement.id)
+      expect(labelledButton).toHaveAccessibleName(datum.label)
       expect(labelledButton).toHaveAttribute('aria-label', datum.label)
     }
   })

packages/react/src/SegmentedControl/SegmentedControl.tsx

@@ -177,13 +177,25 @@ const Root: React.FC<React.PropsWithChildren<SegmentedControlProps>> = ({
         const sharedChildProps = {
           onClick: onChange
             ? (event: React.MouseEvent<HTMLButtonElement>) => {
-                onChange(index)
-                isUncontrolled && setSelectedIndexInternalState(index)
-                child.props.onClick && child.props.onClick(event)
+                const isDisabled =
+                  child.props.disabled === true ||
+                  child.props['aria-disabled'] === 'true' ||
+                  child.props['aria-disabled'] === true
+                if (!isDisabled) {
+                  onChange(index)
+                  isUncontrolled && setSelectedIndexInternalState(index)
+                  child.props.onClick && child.props.onClick(event)
+                }
               }
             : (event: React.MouseEvent<HTMLButtonElement>) => {
-                child.props.onClick && child.props.onClick(event)
-                isUncontrolled && setSelectedIndexInternalState(index)
+                const isDisabled =
+                  child.props.disabled === true ||
+                  child.props['aria-disabled'] === 'true' ||
+                  child.props['aria-disabled'] === true
+                if (!isDisabled) {
+                  child.props.onClick && child.props.onClick(event)
+                  isUncontrolled && setSelectedIndexInternalState(index)
+                }
               },
           selected: index === selectedIndex,
           style: {

packages/react/src/SegmentedControl/SegmentedControlButton.tsx

@@ -21,6 +21,8 @@ export type SegmentedControlButtonProps = {
   /** @deprecated Use `leadingVisual` instead. The leading icon comes before item label */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   leadingIcon?: React.FunctionComponent<React.PropsWithChildren<IconProps>> | React.ReactElement<any>
+  /** Applies `aria-disabled` to the button. This will disable certain functionality, such as `onClick` events. */
+  disabled?: boolean
   /** Optional counter to display on the right side of the button */
   count?: number | string
 } & ButtonHTMLAttributes<HTMLButtonElement | HTMLLIElement>
@@ -31,17 +33,25 @@ const SegmentedControlButton: FCWithSlotMarker<React.PropsWithChildren<Segmented
   leadingIcon,
   selected,
   className,
+  disabled,
   // Note: this value is read in the `SegmentedControl` component to determine which button is selected but we do not need to apply it to an underlying element
   defaultSelected: _defaultSelected,
   count,
-  ...rest
+  ...props
 }) => {
+  const {'aria-disabled': ariaDisabled, ...rest} = props
   // Use leadingVisual if provided, otherwise fall back to leadingIcon for backwards compatibility
   const LeadingVisual = leadingVisual ?? leadingIcon
 
   return (
     <li className={clsx(classes.Item)} data-selected={selected ? '' : undefined}>
-      <button aria-current={selected} className={clsx(classes.Button, className)} type="button" {...rest}>
+      <button
+        aria-current={selected}
+        aria-disabled={disabled || ariaDisabled || undefined}
+        className={clsx(classes.Button, className)}
+        type="button"
+        {...rest}
+      >
         <span className={clsx(classes.Content, 'segmentedControl-content')}>
           {LeadingVisual && (
             <div className={classes.LeadingIcon}>{isElement(LeadingVisual) ? LeadingVisual : <LeadingVisual />}</div>

packages/react/src/SegmentedControl/SegmentedControlIconButton.stories.tsx

@@ -13,6 +13,7 @@ export default {
     icon: FileCodeIcon,
     selected: false,
     defaultSelected: false,
+    disabled: false,
   },
   argTypes: {
     icon: {
@@ -26,6 +27,9 @@ export default {
     defaultSelected: {
       type: 'boolean',
     },
+    disabled: {
+      type: 'boolean',
+    },
   },
   decorators: [
     Story => {