data-component adr part 3 (#7819)

llastflowers · web-flow · commit 8ed6149b4509 · 2026-05-12T16:21:29.000Z
diff --git a/.changeset/tiny-hats-applaud.md b/.changeset/tiny-hats-applaud.md
@@ -0,0 +1,5 @@
+---
+"@primer/react": minor
+---
+
+Add `data-component` attributes for Details, Flash, FormControl (+ update InputValidation to forward from FormControl.Validation), Header, and Heading.
diff --git a/packages/react/src/Details/Details.tsx b/packages/react/src/Details/Details.tsx
@@ -27,7 +27,7 @@ const Root = React.forwardRef<HTMLDetailsElement, DetailsProps>(
     }, [])
 
     return (
-      <details className={clsx(className, classes.Details)} {...rest} ref={ref}>
+      <details className={clsx(className, classes.Details)} {...rest} ref={ref} data-component="Details">
         {children}
       </details>
     )
@@ -47,7 +47,7 @@ export type SummaryProps<As extends React.ElementType> = {
 function Summary<As extends React.ElementType>({as, children, ...props}: SummaryProps<As>) {
   const Component = as ?? 'summary'
   return (
-    <Component as={Component === 'summary' ? null : 'summary'} {...props}>
+    <Component as={Component === 'summary' ? null : 'summary'} {...props} data-component="Details.Summary">
       {children}
     </Component>
   )
diff --git a/packages/react/src/Details/__tests__/Details.test.tsx b/packages/react/src/Details/__tests__/Details.test.tsx
@@ -97,4 +97,17 @@ describe('Details', () => {
       expect(screen.getByText('test summary')).toHaveAttribute('data-testid', 'test')
     })
   })
+
+  describe('Details data-component attributes', () => {
+    it('renders data-component attributes', () => {
+      render(
+        <Details>
+          <Details.Summary>test summary</Details.Summary>
+        </Details>,
+      )
+
+      expect(screen.getByRole('group')).toHaveAttribute('data-component', 'Details')
+      expect(screen.getByText('test summary')).toHaveAttribute('data-component', 'Details.Summary')
+    })
+  })
 })
diff --git a/packages/react/src/Flash/Flash.tsx b/packages/react/src/Flash/Flash.tsx
@@ -20,6 +20,7 @@ const Flash = React.forwardRef(function Flash(
       className={clsx(classes.Flash, className)}
       data-full={full ? '' : undefined}
       data-variant={variant}
+      data-component="Flash"
     />
   )
 }) as PolymorphicForwardRefComponent<'div', FlashProps>
diff --git a/packages/react/src/Flash/__tests__/Flash.test.tsx b/packages/react/src/Flash/__tests__/Flash.test.tsx
@@ -37,4 +37,9 @@ describe('Flash', () => {
     const {container} = render(<Flash data-testid="test" />)
     expect(container.firstChild).toHaveAttribute('data-testid', 'test')
   })
+
+  it('renders data-component attribute', () => {
+    render(<Flash data-testid="flash" />)
+    expect(screen.getByTestId('flash')).toHaveAttribute('data-component', 'Flash')
+  })
 })
diff --git a/packages/react/src/FormControl/FormControl.tsx b/packages/react/src/FormControl/FormControl.tsx
@@ -192,6 +192,7 @@ const FormControl = React.forwardRef<HTMLDivElement, FormControlProps>(
             data-has-leading-visual={slots.leadingVisual ? '' : undefined}
             className={clsx(className, classes.ControlHorizontalLayout)}
             style={style}
+            data-component="FormControl"
           >
             {InputChildren}
           </div>
@@ -201,6 +202,7 @@ const FormControl = React.forwardRef<HTMLDivElement, FormControlProps>(
             data-has-label={!isLabelHidden ? '' : undefined}
             className={clsx(className, classes.ControlVerticalLayout)}
             style={style}
+            data-component="FormControl"
           >
             {slots.label}
             {React.isValidElement(InputComponent) &&
diff --git a/packages/react/src/FormControl/FormControlCaption.tsx b/packages/react/src/FormControl/FormControlCaption.tsx
@@ -19,6 +19,7 @@ function FormControlCaption({id, children, className, style}: FormControlCaption
       className={clsx(className, classes.Caption)}
       data-control-disabled={disabled ? '' : undefined}
       style={style}
+      data-component="FormControl.Caption"
     >
       {children}
     </Text>
diff --git a/packages/react/src/FormControl/FormControlLabel.tsx b/packages/react/src/FormControl/FormControlLabel.tsx
@@ -50,7 +50,11 @@ const FormControlLabel: FCWithSlotMarker<
           ...props,
         }
 
-  return <InputLabel {...labelProps}>{children}</InputLabel>
+  return (
+    <InputLabel {...labelProps} data-component="FormControl.Label">
+      {children}
+    </InputLabel>
+  )
 }
 
 FormControlLabel.__SLOT__ = Symbol('FormControl.Label')
diff --git a/packages/react/src/FormControl/FormControlLeadingVisual.tsx b/packages/react/src/FormControl/FormControlLeadingVisual.tsx
@@ -14,6 +14,7 @@ const FormControlLeadingVisual: FCWithSlotMarker<React.PropsWithChildren<{style?
       data-control-disabled={disabled ? '' : undefined}
       style={style}
       data-has-caption={captionId ? '' : undefined}
+      data-component="FormControl.LeadingVisual"
     >
       {children}
     </div>
diff --git a/packages/react/src/FormControl/_FormControlValidation.tsx b/packages/react/src/FormControl/_FormControlValidation.tsx
@@ -25,6 +25,7 @@ const FormControlValidation: FCWithSlotMarker<React.PropsWithChildren<FormContro
       validationStatus={variant}
       id={id || validationMessageId || ''}
       style={style}
+      data-component="FormControl.Validation"
     >
       {children}
     </InputValidation>
diff --git a/packages/react/src/FormControl/__tests__/FormControl.test.tsx b/packages/react/src/FormControl/__tests__/FormControl.test.tsx
@@ -63,6 +63,43 @@ describe('FormControl', () => {
   implementsClassName(props => <FormControl {...props} layout="horizontal" />, classes.ControlHorizontalLayout)
   implementsClassName(FormControl.Caption, captionClasses.Caption)
   implementsClassName(FormControl.Label, inputClasses.Label)
+
+  it('renders data-component attributes (vertical, non-choice input)', () => {
+    const {container, getByText} = render(
+      <FormControl id="test-id">
+        <FormControl.Label>{LABEL_TEXT}</FormControl.Label>
+        <TextInput />
+        <FormControl.Caption>{CAPTION_TEXT}</FormControl.Caption>
+        <FormControl.Validation variant="error">{ERROR_TEXT}</FormControl.Validation>
+      </FormControl>,
+    )
+
+    expect(container.firstElementChild).toHaveAttribute('data-component', 'FormControl')
+    expect(getByText(LABEL_TEXT)).toHaveAttribute('data-component', 'FormControl.Label')
+    expect(getByText(CAPTION_TEXT)).toHaveAttribute('data-component', 'FormControl.Caption')
+
+    const validation = container.querySelector('[data-component="FormControl.Validation"]')
+    expect(validation).toHaveTextContent(ERROR_TEXT)
+  })
+
+  it('renders data-component attributes (choice input)', () => {
+    const {container, getByText} = render(
+      <FormControl id="test-id-choice">
+        <FormControl.Label>{LABEL_TEXT}</FormControl.Label>
+        <Checkbox />
+        <FormControl.LeadingVisual>
+          <MarkGithubIcon aria-label="Icon label" />
+        </FormControl.LeadingVisual>
+      </FormControl>,
+    )
+
+    expect(container.firstElementChild).toHaveAttribute('data-component', 'FormControl')
+    expect(getByText(LABEL_TEXT)).toHaveAttribute('data-component', 'FormControl.Label')
+
+    const leadingVisual = container.querySelector('[data-component="FormControl.LeadingVisual"]')
+    expect(leadingVisual).not.toBeNull()
+  })
+
   describe('vertically stacked layout (default)', () => {
     describe('rendering', () => {
       it('renders with a hidden label', () => {
diff --git a/packages/react/src/Header/Header.test.tsx b/packages/react/src/Header/Header.test.tsx
@@ -6,6 +6,16 @@ import classes from './Header.module.css'
 
 describe('Header', () => {
   implementsClassName(Header, classes.Header)
+  it('renders data-component attributes', () => {
+    const {container: headerContainer} = render(<Header />)
+    expect(headerContainer.firstChild).toHaveAttribute('data-component', 'Header')
+
+    const {container: itemContainer} = render(<Header.Item />)
+    expect(itemContainer.firstChild).toHaveAttribute('data-component', 'Header.Item')
+
+    const {container: linkContainer} = render(<Header.Link />)
+    expect(linkContainer.firstChild).toHaveAttribute('data-component', 'Header.Link')
+  })
   describe('Header.Item', () => {
     implementsClassName(Header.Item, classes.HeaderItem)
     it('accepts and applies className', () => {
diff --git a/packages/react/src/Header/Header.tsx b/packages/react/src/Header/Header.tsx
@@ -13,7 +13,7 @@ const Header = React.forwardRef<HTMLElement, HeaderProps>(function Header(
   forwardRef,
 ) {
   return (
-    <BaseComponent ref={forwardRef} className={clsx(className, classes.Header)} {...rest}>
+    <BaseComponent ref={forwardRef} className={clsx(className, classes.Header)} {...rest} data-component="Header">
       {children}
     </BaseComponent>
   )
@@ -26,7 +26,13 @@ const HeaderItem = React.forwardRef<HTMLDivElement, HeaderItemProps>(function He
   forwardRef,
 ) {
   return (
-    <div ref={forwardRef} className={clsx(className, classes.HeaderItem)} data-full={full} {...rest}>
+    <div
+      ref={forwardRef}
+      className={clsx(className, classes.HeaderItem)}
+      data-full={full}
+      {...rest}
+      data-component="Header.Item"
+    >
       {children}
     </div>
   )
@@ -39,7 +45,12 @@ const HeaderLink = React.forwardRef<HTMLAnchorElement, HeaderLinkProps>(function
   forwardRef,
 ) {
   return (
-    <BaseComponent ref={forwardRef} className={clsx(className, classes.HeaderLink)} {...rest}>
+    <BaseComponent
+      ref={forwardRef}
+      className={clsx(className, classes.HeaderLink)}
+      {...rest}
+      data-component="Header.Link"
+    >
       {children}
     </BaseComponent>
   )
diff --git a/packages/react/src/Heading/Heading.tsx b/packages/react/src/Heading/Heading.tsx
@@ -32,7 +32,15 @@ const Heading = forwardRef(({as: Component = 'h2', className, variant, ...props}
     }, [innerRef])
   }
 
-  return <Component className={clsx(className, classes.Heading)} data-variant={variant} {...props} ref={innerRef} />
+  return (
+    <Component
+      className={clsx(className, classes.Heading)}
+      data-variant={variant}
+      data-component="Heading"
+      {...props}
+      ref={innerRef}
+    />
+  )
 }) as PolymorphicForwardRefComponent<HeadingLevels, StyledHeadingProps>
 
 Heading.displayName = 'Heading'
diff --git a/packages/react/src/Heading/__tests__/Heading.test.tsx b/packages/react/src/Heading/__tests__/Heading.test.tsx
@@ -7,6 +7,11 @@ import {implementsClassName} from '../../utils/testing'
 describe('Heading', () => {
   implementsClassName(Heading, classes.Heading)
 
+  it('renders data-component attribute', () => {
+    const {container} = render(<Heading />)
+    expect(container.firstChild).toHaveAttribute('data-component', 'Heading')
+  })
+
   it('renders <h2> by default', () => {
     const {container} = render(<Heading />)
     const heading = container.firstChild as HTMLElement
diff --git a/packages/react/src/internal/components/InputValidation.tsx b/packages/react/src/internal/components/InputValidation.tsx
@@ -11,6 +11,7 @@ type Props = {
   id: string
   validationStatus?: FormValidationStatus
   style?: React.CSSProperties
+  'data-component'?: string
 }
 
 const validationIconMap: Record<
@@ -27,6 +28,7 @@ const InputValidation: React.FC<React.PropsWithChildren<Props>> = ({
   id,
   validationStatus,
   style,
+  'data-component': dataComponent,
 }) => {
   const IconComponent = validationStatus ? validationIconMap[validationStatus] : undefined
 
@@ -37,7 +39,12 @@ const InputValidation: React.FC<React.PropsWithChildren<Props>> = ({
   const iconBoxMinHeight = iconSize * captionLineHeight
 
   return (
-    <Text className={clsx(className, classes.InputValidation)} data-validation-status={validationStatus} style={style}>
+    <Text
+      className={clsx(className, classes.InputValidation)}
+      data-validation-status={validationStatus}
+      style={style}
+      data-component={dataComponent}
+    >
       {IconComponent ? (
         <span
           aria-hidden="true"

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"@primer/react": minor
 +---
++
 +Add `data-component` attributes for Details, Flash, FormControl (+ update InputValidation to forward from FormControl.Validation), Header, and Heading.
Original file line number	Diff line number	Diff line change
`@@ -20,6 +20,7 @@ const Flash = React.forwardRef(function Flash(`
`20`	`20`	`className={clsx(classes.Flash, className)}`
`21`	`21`	`data-full={full ? '' : undefined}`
`22`	`22`	`data-variant={variant}`
	`23`	`+ data-component="Flash"`
`23`	`24`	`/>`
`24`	`25`	`)`
`25`	`26`	`}) as PolymorphicForwardRefComponent<'div', FlashProps>`
Original file line number	Diff line number	Diff line change
`@@ -19,6 +19,7 @@ function FormControlCaption({id, children, className, style}: FormControlCaption`
`19`	`19`	`className={clsx(className, classes.Caption)}`
`20`	`20`	`data-control-disabled={disabled ? '' : undefined}`
`21`	`21`	`style={style}`
	`22`	`+ data-component="FormControl.Caption"`
`22`	`23`	`>`
`23`	`24`	`{children}`
`24`	`25`	`</Text>`
Original file line number	Diff line number	Diff line change
`@@ -50,7 +50,11 @@ const FormControlLabel: FCWithSlotMarker<`
`50`	`50`	`...props,`
`51`	`51`	`}`
`52`	`52`
`53`		`- return <InputLabel {...labelProps}>{children}</InputLabel>`
	`53`	`+ return (`
	`54`	`+ <InputLabel {...labelProps} data-component="FormControl.Label">`
	`55`	`+ {children}`
	`56`	`+ </InputLabel>`
	`57`	`+ )`
`54`	`58`	`}`
`55`	`59`
`56`	`60`	`FormControlLabel.__SLOT__ = Symbol('FormControl.Label')`
Original file line number	Diff line number	Diff line change
`@@ -14,6 +14,7 @@ const FormControlLeadingVisual: FCWithSlotMarker<React.PropsWithChildren<{style?`
`14`	`14`	`data-control-disabled={disabled ? '' : undefined}`
`15`	`15`	`style={style}`
`16`	`16`	`data-has-caption={captionId ? '' : undefined}`
	`17`	`+ data-component="FormControl.LeadingVisual"`
`17`	`18`	`>`
`18`	`19`	`{children}`
`19`	`20`	`</div>`
Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,7 @@ const FormControlValidation: FCWithSlotMarker<React.PropsWithChildren<FormContro`
`25`	`25`	`validationStatus={variant}`
`26`	`26`	`id={id \|\| validationMessageId \|\| ''}`
`27`	`27`	`style={style}`
	`28`	`+ data-component="FormControl.Validation"`
`28`	`29`	`>`
`29`	`30`	`{children}`
`30`	`31`	`</InputValidation>`