@patternfly/react-core 6.3.0-prerelease.8 → 6.3.0

package/src/components/DualListSelector/DualListSelectorListWrapper.tsx

@@ -56,14 +56,17 @@ export const DualListSelectorListWrapperBase: React.FunctionComponent<DualListSe
     }
     event.stopImmediatePropagation();
     const validOptions = isTree
-      ? (Array.from(
-          menuRef.current.querySelectorAll(
-            `.${styles.dualListSelectorItemToggle}, .${styles.dualListSelectorItemCheck} > input`
-          )
-        ) as Element[])
+      ? (
+          Array.from(
+            menuRef.current.querySelectorAll(
+              `.${styles.dualListSelectorItemToggle}, .${styles.dualListSelectorItemCheck} > input`
+            )
+          ) as Element[]
+        ).filter((item) => !item.closest(`.${styles.dualListSelectorList}[inert]`))
       : (Array.from(menuRef.current.getElementsByTagName('LI')) as Element[]).filter(
           (el) => !el.classList.contains('pf-m-disabled')
         );
+
     const activeElement = document.activeElement;
     handleArrows(
       event,

package/src/components/DualListSelector/DualListSelectorTree.tsx

@@ -1,5 +1,7 @@
+import { useContext } from 'react';
 import { css } from '@patternfly/react-styles';
 import styles from '@patternfly/react-styles/css/components/DualListSelector/dual-list-selector';
+import { DualListSelectorContext } from './DualListSelectorContext';
 import { DualListSelectorTreeItem } from './DualListSelectorTreeItem';
 
 export interface DualListSelectorTreeItemData {
@@ -68,11 +70,13 @@ export const DualListSelectorTree: React.FunctionComponent<DualListSelectorTreeP
   isDisabled = false,
   ...props
 }: DualListSelectorTreeProps) => {
+  const { hasAnimations } = useContext(DualListSelectorContext);
   const dataToRender = typeof data === 'function' ? data() : data;
   const tree = dataToRender.map((item) => (
     <DualListSelectorTreeItem
       key={item.id}
       text={item.text}
+      hasAnimations={hasAnimations}
       id={item.id}
       defaultExpanded={item.defaultExpanded !== undefined ? item.defaultExpanded : defaultAllExpanded}
       onOptionCheck={onOptionCheck}

package/src/components/DualListSelector/DualListSelectorTreeItem.tsx

@@ -1,4 +1,4 @@
-import { memo, useContext, useEffect, useRef, useState } from 'react';
+import { memo, useContext, useEffect, useRef, useState, cloneElement, Children, isValidElement } from 'react';
 import styles from '@patternfly/react-styles/css/components/DualListSelector/dual-list-selector';
 import { css } from '@patternfly/react-styles';
 import { DualListSelectorTreeItemData } from './DualListSelectorTree';
@@ -38,6 +38,11 @@ export interface DualListSelectorTreeItemProps extends React.HTMLProps<HTMLLIEle
   isDisabled?: boolean;
   /** Flag indicating the DualListSelector tree should utilize memoization to help render large data sets. */
   useMemo?: boolean;
+  /** Flag indicating whether a tree dual list selector has animations. This will always render
+   * nested dual list selector items rather than dynamically rendering them. This prop will be removed in
+   * the next breaking change release in favor of defaulting to always-rendered items.
+   */
+  hasAnimations?: boolean;
 }
 
 const DualListSelectorTreeItemBase: React.FunctionComponent<DualListSelectorTreeItemProps> = ({
@@ -53,6 +58,7 @@ const DualListSelectorTreeItemBase: React.FunctionComponent<DualListSelectorTree
   badgeProps,
   itemData,
   isDisabled = false,
+  hasAnimations,
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   useMemo,
   ...props
@@ -65,6 +71,15 @@ const DualListSelectorTreeItemBase: React.FunctionComponent<DualListSelectorTree
     setIsExpanded(defaultExpanded);
   }, [defaultExpanded]);
 
+  const clonedChildren = Children.map(
+    children,
+    (child) =>
+      isValidElement(child) &&
+      cloneElement(child as React.ReactElement<any>, {
+        inert: isExpanded ? undefined : ''
+      })
+  );
+
   return (
     <li
       className={css(
@@ -156,7 +171,7 @@ const DualListSelectorTreeItemBase: React.FunctionComponent<DualListSelectorTree
           </span>
         </div>
       </div>
-      {isExpanded && children}
+      {(isExpanded || hasAnimations) && clonedChildren}
     </li>
   );
 };

package/src/components/DualListSelector/__tests__/DualListSelector.test.tsx

@@ -1,6 +1,37 @@
-import { render } from '@testing-library/react';
+import { render, screen } from '@testing-library/react';
+import styles from '@patternfly/react-styles/css/components/DualListSelector/dual-list-selector';
+import { DualListSelector } from '../DualListSelector';
 import { DualListSelectorPane } from '../DualListSelectorPane';
 import { SearchInput } from '../../SearchInput';
+
+// The following tests can be removed as part of https://github.com/patternfly/patternfly-react/issues/11838
+describe('Opt-in animations', () => {
+  test(`Does not render with class ${styles.modifiers.animateExpand} by default`, () => {
+    render(<DualListSelector data-testid="test-id" />);
+
+    expect(screen.getByTestId('test-id')).not.toHaveClass(styles.modifiers.animateExpand);
+  });
+
+  test(`Does not render with class ${styles.modifiers.animateExpand} when hasAnimations is true and isTree is false`, () => {
+    render(<DualListSelector hasAnimations data-testid="test-id" />);
+
+    expect(screen.getByTestId('test-id')).not.toHaveClass(styles.modifiers.animateExpand);
+  });
+
+  test(`Does not render with class ${styles.modifiers.animateExpand} by default when isTree is true`, () => {
+    render(<DualListSelector isTree data-testid="test-id" />);
+
+    expect(screen.getByTestId('test-id')).not.toHaveClass(styles.modifiers.animateExpand);
+  });
+
+  test(`Renders with class ${styles.modifiers.animateExpand} when both isTree and hasAnimations are true`, () => {
+    render(<DualListSelector isTree hasAnimations data-testid="test-id" />);
+
+    expect(screen.getByTestId('test-id')).toHaveClass(styles.modifiers.animateExpand);
+  });
+});
+
+// Following tests should be moved to a separate DualListSelectorPane test file
 describe('DualListSelector', () => {
   test('basic', () => {
     const { asFragment } = render(<DualListSelectorPane id="basicTest" />);

package/src/components/DualListSelector/__tests__/DualListSelectorTreeItem.test.tsx

@@ -0,0 +1,55 @@
+import { render, screen } from '@testing-library/react';
+import styles from '@patternfly/react-styles/css/components/DualListSelector/dual-list-selector';
+import { DualListSelectorTreeItem } from '../DualListSelectorTreeItem';
+
+// The following tests checking for children to not be/to be rendered will need to be refactored
+// as part of https://github.com/patternfly/patternfly-react/issues/11838
+test('Does not render children by default', () => {
+  render(
+    <DualListSelectorTreeItem id="item-id" text="Test text">
+      <div>Children content</div>
+    </DualListSelectorTreeItem>
+  );
+
+  expect(screen.queryByText('Children content')).not.toBeInTheDocument();
+});
+
+test('Renders children when defaultExpanded is true', () => {
+  render(
+    <DualListSelectorTreeItem defaultExpanded id="item-id" text="Test text">
+      <div>Children content</div>
+    </DualListSelectorTreeItem>
+  );
+
+  expect(screen.getByText('Children content')).toBeVisible();
+});
+
+test('Renders children when hasAnimations is true', () => {
+  render(
+    <DualListSelectorTreeItem hasAnimations id="item-id" text="Test text">
+      <div>Children content</div>
+    </DualListSelectorTreeItem>
+  );
+
+  expect(screen.getByText('Children content')).toBeVisible();
+});
+
+test('Renders children with inert attribute by default when hasAnimations is true', () => {
+  render(
+    <DualListSelectorTreeItem hasAnimations id="item-id" text="Test text">
+      <div>Children content</div>
+    </DualListSelectorTreeItem>
+  );
+
+  expect(screen.getByText('Children content')).toHaveAttribute('inert', '');
+});
+
+test('Does not render children with inert attribute when hasAnimations and defaultExpanded are true', () => {
+  render(
+    <DualListSelectorTreeItem hasAnimations defaultExpanded id="item-id" text="Test text">
+      <div>Children content</div>
+    </DualListSelectorTreeItem>
+  );
+
+  expect(screen.getByText('Children content')).not.toHaveAttribute('inert');
+});

package/src/components/DualListSelector/examples/DualListSelectorTree.tsx

@@ -283,7 +283,7 @@ export const DualListSelectorComposableTree: React.FunctionComponent<ExampleProp
   };
 
   return (
-    <DualListSelector isTree>
+    <DualListSelector hasAnimations isTree>
       {buildPane(false)}
       <DualListSelectorControlsWrapper>
         <DualListSelectorControl

package/src/components/ExpandableSection/ExpandableSection.tsx

@@ -32,7 +32,7 @@ export interface ExpandableSectionProps extends Omit<React.HTMLProps<HTMLDivElem
   toggleId?: string;
   /** Display size variant. Set to "lg" for disclosure styling. */
   displaySize?: 'default' | 'lg';
-  /** Indicates the expandable section has a detached toggle. */
+  /** Flag indicating that the expandable section and expandable toggle are detached from one another. */
   isDetached?: boolean;
   /** Flag to indicate if the content is expanded. */
   isExpanded?: boolean;
@@ -64,6 +64,10 @@ export interface ExpandableSectionProps extends Omit<React.HTMLProps<HTMLDivElem
    * variant, the expandable content will be truncated after 3 lines by default.
    */
   variant?: 'default' | 'truncate';
+  /** Sets the direction of the expandable animation when isDetached is true. If this prop is not passed,
+   * animation will not occur.
+   */
+  direction?: 'up' | 'down';
 }
 
 interface ExpandableSectionState {
@@ -72,6 +76,11 @@ interface ExpandableSectionState {
   previousWidth: number;
 }
 
+const directionClassMap = {
+  up: styles.modifiers.expandTop,
+  down: styles.modifiers.expandBottom
+};
+
 const setLineClamp = (lines: number, element: HTMLDivElement) => {
   if (!element || lines < 1) {
     return;
@@ -198,6 +207,7 @@ class ExpandableSection extends Component<ExpandableSectionProps, ExpandableSect
       variant,
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
       truncateMaxLines,
+      direction,
       ...props
     } = this.props;
 
@@ -258,6 +268,8 @@ class ExpandableSection extends Component<ExpandableSectionProps, ExpandableSect
           displaySize === 'lg' && styles.modifiers.displayLg,
           isWidthLimited && styles.modifiers.limitWidth,
           isIndented && styles.modifiers.indented,
+          isDetached && direction && directionClassMap[direction],
+          isDetached && direction && 'pf-m-detached',
           variant === ExpandableSectionVariant.truncate && styles.modifiers.truncate,
           className
         )}

package/src/components/ExpandableSection/ExpandableSectionToggle.tsx

@@ -28,6 +28,8 @@ export interface ExpandableSectionToggleProps extends Omit<React.HTMLProps<HTMLD
   isExpanded?: boolean;
   /** Callback function to toggle the expandable content. */
   onToggle?: (isExpanded: boolean) => void;
+  /** Flag indicating that the expandable section and expandable toggle are detached from one another. */
+  isDetached?: boolean;
 }
 
 export const ExpandableSectionToggle: React.FunctionComponent<ExpandableSectionToggleProps> = ({
@@ -39,6 +41,7 @@ export const ExpandableSectionToggle: React.FunctionComponent<ExpandableSectionT
   toggleId,
   direction = 'down',
   hasTruncatedContent = false,
+  isDetached,
   ...props
 }: ExpandableSectionToggleProps) => (
   <div
@@ -46,6 +49,7 @@ export const ExpandableSectionToggle: React.FunctionComponent<ExpandableSectionT
       styles.expandableSection,
       isExpanded && styles.modifiers.expanded,
       hasTruncatedContent && styles.modifiers.truncate,
+      isDetached && 'pf-m-detached',
       className
     )}
     {...props}
@@ -63,7 +67,7 @@ export const ExpandableSectionToggle: React.FunctionComponent<ExpandableSectionT
             <span
               className={css(
                 styles.expandableSectionToggleIcon,
-                isExpanded && direction === 'up' && styles.modifiers.expandTop
+                isExpanded && direction === 'up' && styles.modifiers.expandTop // TODO: next breaking change move this class to the outer styles.expandableSection wrapper
               )}
             >
               <AngleRightIcon />

package/src/components/ExpandableSection/__tests__/ExpandableSection.test.tsx

@@ -1,9 +1,8 @@
-import { Fragment } from 'react';
 import { render, screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 
 import { ExpandableSection, ExpandableSectionVariant } from '../ExpandableSection';
-import { ExpandableSectionToggle } from '../ExpandableSectionToggle';
+import styles from '@patternfly/react-styles/css/components/ExpandableSection/expandable-section';
 
 const props = { contentId: 'content-id', toggleId: 'toggle-id' };
 
@@ -22,7 +21,7 @@ test('Renders ExpandableSection expanded', () => {
   expect(asFragment()).toMatchSnapshot();
 });
 
-test('ExpandableSection onToggle called', async () => {
+test('Calls onToggle when clicked', async () => {
   const mockfn = jest.fn();
   const user = userEvent.setup();
 
@@ -32,6 +31,21 @@ test('ExpandableSection onToggle called', async () => {
   expect(mockfn.mock.calls).toHaveLength(1);
 });
 
+test('Does not call onToggle when not clicked', async () => {
+  const mockfn = jest.fn();
+  const user = userEvent.setup();
+
+  render(
+    <>
+      <ExpandableSection onToggle={mockfn}> test </ExpandableSection>
+      <button onClick={() => {}}>Test clicker</button>
+    </>
+  );
+
+  await user.click(screen.getByRole('button', { name: 'Test clicker' }));
+  expect(mockfn).not.toHaveBeenCalled();
+});
+
 test('Renders Uncontrolled ExpandableSection', () => {
   const { asFragment } = render(
     <ExpandableSection {...props} toggleText="Show More">
@@ -42,20 +56,6 @@ test('Renders Uncontrolled ExpandableSection', () => {
   expect(asFragment()).toMatchSnapshot();
 });
 
-test('Detached ExpandableSection renders successfully', () => {
-  const { asFragment } = render(
-    <Fragment>
-      <ExpandableSection isExpanded isDetached {...props}>
-        test
-      </ExpandableSection>
-      <ExpandableSectionToggle isExpanded direction="up" {...props}>
-        Toggle text
-      </ExpandableSectionToggle>
-    </Fragment>
-  );
-  expect(asFragment()).toMatchSnapshot();
-});
-
 test('Disclosure ExpandableSection', () => {
   const { asFragment } = render(
     <ExpandableSection {...props} displaySize="lg" isWidthLimited>
@@ -75,22 +75,22 @@ test('Renders ExpandableSection indented', () => {
   expect(asFragment()).toMatchSnapshot();
 });
 
-test('Does not render with pf-m-truncate class when variant is not passed', () => {
+test(`Does not render with ${styles.modifiers.truncate} class when variant is not passed`, () => {
   render(<ExpandableSection>test</ExpandableSection>);
 
-  expect(screen.getByText('test').parentElement).not.toHaveClass('pf-m-truncate');
+  expect(screen.getByText('test').parentElement).not.toHaveClass(styles.modifiers.truncate);
 });
 
-test('Does not render with pf-m-truncate class when variant is not truncate', () => {
+test(`Does not render with ${styles.modifiers.truncate} class when variant is not truncate`, () => {
   render(<ExpandableSection variant={ExpandableSectionVariant.default}>test</ExpandableSection>);
 
-  expect(screen.getByText('test').parentElement).not.toHaveClass('pf-m-truncate');
+  expect(screen.getByText('test').parentElement).not.toHaveClass(styles.modifiers.truncate);
 });
 
-test('Renders with pf-m-truncate class when variant is truncate', () => {
+test(`Renders with ${styles.modifiers.truncate} class when variant is truncate`, () => {
   render(<ExpandableSection variant={ExpandableSectionVariant.truncate}>test</ExpandableSection>);
 
-  expect(screen.getByText('test').parentElement).toHaveClass('pf-m-truncate');
+  expect(screen.getByText('test').parentElement).toHaveClass(styles.modifiers.truncate);
 });
 
 test('Renders with value passed to contentId', () => {
@@ -129,3 +129,65 @@ test('Renders with ARIA attributes when contentId and toggleId are passed', () =
   expect(wrapper).toContainHTML('aria-labelledby="toggle-id"');
   expect(wrapper).toContainHTML('aria-controls="content-id"');
 });
+
+test(`Does not render with classes ${styles.modifiers.expandTop} nor ${styles.modifiers.expandBottom} by default`, () => {
+  render(<ExpandableSection>Test content</ExpandableSection>);
+
+  expect(screen.getByText('Test content').parentElement).not.toHaveClass('pf-m-expand-top');
+  expect(screen.getByText('Test content').parentElement).not.toHaveClass('pf-m-expand-bottom');
+});
+
+test(`Does not render with classes ${styles.modifiers.expandTop} nor ${styles.modifiers.expandBottom} when only isDetached is true`, () => {
+  render(<ExpandableSection isDetached>Test content</ExpandableSection>);
+
+  expect(screen.getByText('Test content').parentElement).not.toHaveClass('pf-m-expand-top');
+  expect(screen.getByText('Test content').parentElement).not.toHaveClass('pf-m-expand-bottom');
+});
+
+test(`Does not render with class ${styles.modifiers.expandTop} when direction="up" and isDetached is false`, () => {
+  render(<ExpandableSection direction="up">Test content</ExpandableSection>);
+
+  expect(screen.getByText('Test content').parentElement).not.toHaveClass('pf-m-expand-top');
+});
+
+test(`Does not render with class ${styles.modifiers.expandBottom} when direction="down" and isDetached is false`, () => {
+  render(<ExpandableSection direction="down">Test content</ExpandableSection>);
+
+  expect(screen.getByText('Test content').parentElement).not.toHaveClass('pf-m-expand-bottom');
+});
+
+test(`Renders with class ${styles.modifiers.expandTop} when isDetached is true and direction="up"`, () => {
+  render(
+    <ExpandableSection isDetached direction="up">
+      Test content
+    </ExpandableSection>
+  );
+
+  expect(screen.getByText('Test content').parentElement).toHaveClass('pf-m-expand-top');
+});
+
+test(`Renders with class ${styles.modifiers.expandBottom} when isDetached is true and direction="down"`, () => {
+  render(
+    <ExpandableSection isDetached direction="down">
+      Test content
+    </ExpandableSection>
+  );
+
+  expect(screen.getByText('Test content').parentElement).toHaveClass('pf-m-expand-bottom');
+});
+
+test('Does not render with class pf-m-detached when isDetached is true and direction is not passed', () => {
+  render(<ExpandableSection isDetached>Test content</ExpandableSection>);
+
+  expect(screen.getByText('Test content').parentElement).not.toHaveClass('pf-m-detached');
+});
+
+test('Renders with class pf-m-detached when isDetached is true and direction is passed', () => {
+  render(
+    <ExpandableSection isDetached direction="up">
+      Test content
+    </ExpandableSection>
+  );
+
+  expect(screen.getByText('Test content').parentElement).toHaveClass('pf-m-detached');
+});

package/src/components/ExpandableSection/__tests__/ExpandableSectionToggle.test.tsx

@@ -0,0 +1,32 @@
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { ExpandableSectionToggle } from '../ExpandableSectionToggle';
+import styles from '@patternfly/react-styles/css/components/ExpandableSection/expandable-section';
+
+test('Renders without children', () => {
+  render(<ExpandableSectionToggle></ExpandableSectionToggle>);
+
+  expect(screen.getByRole('button')).toBeInTheDocument();
+});
+
+test('Renders with children', () => {
+  render(<ExpandableSectionToggle>Toggle test</ExpandableSectionToggle>);
+
+  expect(screen.getByRole('button')).toHaveTextContent('Toggle test');
+});
+
+test('Does not render with class pf-m-detached by default', () => {
+  render(<ExpandableSectionToggle data-testid="test-id">Toggle test</ExpandableSectionToggle>);
+
+  expect(screen.getByTestId('test-id')).not.toHaveClass('pf-m-detached');
+});
+
+test('Renders with class pf-m-detached when isDetached is true', () => {
+  render(
+    <ExpandableSectionToggle data-testid="test-id" isDetached>
+      Toggle test
+    </ExpandableSectionToggle>
+  );
+
+  expect(screen.getByTestId('test-id')).toHaveClass('pf-m-detached');
+});

package/src/components/ExpandableSection/__tests__/__snapshots__/ExpandableSection.test.tsx.snap

@@ -1,67 +1,5 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`Detached ExpandableSection renders successfully 1`] = `
-<DocumentFragment>
-  <div
-    class="pf-v6-c-expandable-section pf-m-expanded"
-  >
-    <div
-      aria-labelledby="toggle-id"
-      class="pf-v6-c-expandable-section__content"
-      id="content-id"
-      role="region"
-    >
-      test
-    </div>
-  </div>
-  <div
-    class="pf-v6-c-expandable-section pf-m-expanded"
-  >
-    <div
-      class="pf-v6-c-expandable-section__toggle"
-    >
-      <button
-        aria-controls="content-id"
-        aria-expanded="true"
-        class="pf-v6-c-button pf-m-link"
-        data-ouia-component-id="OUIA-Generated-Button-link-5"
-        data-ouia-component-type="PF6/Button"
-        data-ouia-safe="true"
-        id="toggle-id"
-        type="button"
-      >
-        <span
-          class="pf-v6-c-button__icon pf-m-start"
-        >
-          <span
-            class="pf-v6-c-expandable-section__toggle-icon pf-m-expand-top"
-          >
-            <svg
-              aria-hidden="true"
-              class="pf-v6-svg"
-              fill="currentColor"
-              height="1em"
-              role="img"
-              viewBox="0 0 256 512"
-              width="1em"
-            >
-              <path
-                d="M224.3 273l-136 136c-9.4 9.4-24.6 9.4-33.9 0l-22.6-22.6c-9.4-9.4-9.4-24.6 0-33.9l96.4-96.4-96.4-96.4c-9.4-9.4-9.4-24.6 0-33.9L54.3 103c9.4-9.4 24.6-9.4 33.9 0l136 136c9.5 9.4 9.5 24.6.1 34z"
-              />
-            </svg>
-          </span>
-        </span>
-        <span
-          class="pf-v6-c-button__text"
-        >
-          Toggle text
-        </span>
-      </button>
-    </div>
-  </div>
-</DocumentFragment>
-`;
-
 exports[`Disclosure ExpandableSection 1`] = `
 <DocumentFragment>
   <div
@@ -285,7 +223,7 @@ exports[`Renders Uncontrolled ExpandableSection 1`] = `
       <button
         aria-controls="content-id"
         class="pf-v6-c-button pf-m-link"
-        data-ouia-component-id="OUIA-Generated-Button-link-4"
+        data-ouia-component-id="OUIA-Generated-Button-link-5"
         data-ouia-component-type="PF6/Button"
         data-ouia-safe="true"
         id="toggle-id"

package/src/components/ExpandableSection/examples/ExpandableSection.md

@@ -32,6 +32,8 @@ import CheckCircleIcon from '@patternfly/react-icons/dist/esm/icons/check-circle
 
 When passing the `isDetached` property into `<ExpandableSection>`, you must also manually pass in the same `toggleId` and `contentId` properties to both `<ExpandableSection>` and `<ExpandableSectionToggle>`. This will link the content to the toggle via ARIA attributes.
 
+By default animations will not be enabled for a detached `<ExpandableSection>`. You must manually pass the `direction` property with an appropriate value based on where the expandable content is rendered. If the expandable content is above the expandable toggle, `direction="up"` must be passed like in this example.
+
 ```ts file="ExpandableSectionDetached.tsx"
 
 ```

package/src/components/ExpandableSection/examples/ExpandableSectionDetached.tsx

@@ -13,7 +13,7 @@ export const ExpandableSectionDetached: React.FunctionComponent = () => {
   return (
     <Stack hasGutter>
       <StackItem>
-        <ExpandableSection isExpanded={isExpanded} isDetached toggleId={toggleId} contentId={contentId}>
+        <ExpandableSection isExpanded={isExpanded} isDetached direction="up" toggleId={toggleId} contentId={contentId}>
           This content is visible only when the component is expanded.
         </ExpandableSection>
       </StackItem>

package/src/components/Form/FormFieldGroupExpandable.tsx

@@ -12,6 +12,11 @@ export interface FormFieldGroupExpandableProps extends Omit<React.HTMLProps<HTML
   isExpanded?: boolean;
   /** Aria-label to use on the form field group toggle button */
   toggleAriaLabel?: string;
+  /** Flag indicating whether an expandable form field group has animations. This will always render
+   * nested field group content rather than dynamically rendering them. This prop will be removed in
+   * the next breaking change release in favor of defaulting to always-rendered items.
+   */
+  hasAnimations?: boolean;
 }
 
 export const FormFieldGroupExpandable: React.FunctionComponent<FormFieldGroupExpandableProps> = ({
@@ -20,6 +25,7 @@ export const FormFieldGroupExpandable: React.FunctionComponent<FormFieldGroupExp
   header,
   isExpanded = false,
   toggleAriaLabel,
+  hasAnimations,
   ...props
 }: FormFieldGroupExpandableProps) => {
   const [localIsExpanded, setIsExpanded] = useState(isExpanded);
@@ -32,6 +38,7 @@ export const FormFieldGroupExpandable: React.FunctionComponent<FormFieldGroupExp
       isExpanded={localIsExpanded}
       toggleAriaLabel={toggleAriaLabel}
       onToggle={() => setIsExpanded(!localIsExpanded)}
+      hasAnimations={hasAnimations}
       {...props}
     >
       {children}

package/src/components/Form/InternalFormFieldGroup.tsx

@@ -18,6 +18,11 @@ export interface InternalFormFieldGroupProps extends Omit<React.HTMLProps<HTMLDi
   onToggle?: () => void;
   /** Aria-label to use on the form field group toggle button */
   toggleAriaLabel?: string;
+  /** Flag indicating whether an expandable form field group has animations. This will always render
+   * nested field group content rather than dynamically rendering them. This prop will be removed in
+   * the next breaking change release in favor of defaulting to always-rendered items.
+   */
+  hasAnimations?: boolean;
 }
 
 export const InternalFormFieldGroup: React.FunctionComponent<InternalFormFieldGroupProps> = ({
@@ -28,6 +33,7 @@ export const InternalFormFieldGroup: React.FunctionComponent<InternalFormFieldGr
   isExpanded,
   onToggle,
   toggleAriaLabel,
+  hasAnimations,
   ...props
 }: InternalFormFieldGroupProps) => {
   const headerTitleText = header ? header.props.titleText : null;
@@ -40,7 +46,12 @@ export const InternalFormFieldGroup: React.FunctionComponent<InternalFormFieldGr
   }
   return (
     <div
-      className={css(styles.formFieldGroup, isExpanded && isExpandable && styles.modifiers.expanded, className)}
+      className={css(
+        styles.formFieldGroup,
+        isExpanded && isExpandable && styles.modifiers.expanded,
+        hasAnimations && isExpandable && styles.modifiers.expandable,
+        className
+      )}
       role="group"
       {...(headerTitleText && { 'aria-labelledby': `${header.props.titleText.id}` })}
       {...props}
@@ -59,8 +70,13 @@ export const InternalFormFieldGroup: React.FunctionComponent<InternalFormFieldGr
         </GenerateId>
       )}
       {header && header}
-      {(!isExpandable || (isExpandable && isExpanded)) && (
-        <div className={css(styles.formFieldGroupBody)}>{children}</div>
+      {(!isExpandable || (isExpandable && isExpanded) || (hasAnimations && isExpandable)) && (
+        <div
+          className={css(styles.formFieldGroupBody)}
+          {...(hasAnimations && isExpandable && !isExpanded && { inert: '' })}
+        >
+          {children}
+        </div>
       )}
     </div>
   );