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

package/src/components/Button/examples/Button.md

@@ -23,25 +23,27 @@ import QuestionCircleIcon from '@patternfly/react-icons/dist/esm/icons/question-
 PatternFly supports several button styling variants to be used in different scenarios as needed. The following button variants can be assigned using the `variant` property.
 
 ```ts file="./ButtonVariations.tsx"
+
 ```
 
-| Variant | Description|
-| --- | ---|
-| Primary | Primary buttons are the most visually prominent variant. Use for the most important call to action.|
-| Secondary | Secondary buttons are less visually prominant than primary buttons. Use for general actions on a page that require less emphasis than primary buttons. |
-| Tertiary | Tertiary buttons are the least visually prominent variant. Use to retain a classic button format with less emphasis than primary or secondary buttons.  |
-| Danger | Danger buttons may be used for actions that are potentially destructive or difficult/impossible to undo. Danger is an independent variant, but all button variants may use the the `isDanger` property to apply similar styling. |
-| Warning | Warning buttons may be used for actions that change an important setting or behavior, but not in a destructive or irreversible way. |
-| Link | Links are labeled, but have no background or border. Use for actions that require less emphasis, actions that navigate users to another page within the same window, and/or actions that navigate to external pages in a new window. Links may be placed inline with text using the `isInline` property.|
-| Plain | Plain buttons have no styling and are intended to be labeled with icons. |
-| Control | Control buttons can be labeled with text or icons. Primarily intended to be paired with other controls in an [input group](/components/input-group). |
-| Stateful | Stateful buttons are ideal for displaying the state of notifications. They have 3 states: `read`, `unread` and `attention`.
+| Variant   | Description                                                                                                                                                                                                                                                                                              |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Primary   | Primary buttons are the most visually prominent variant. Use for the most important call to action.                                                                                                                                                                                                      |
+| Secondary | Secondary buttons are less visually prominant than primary buttons. Use for general actions on a page that require less emphasis than primary buttons.                                                                                                                                                   |
+| Tertiary  | Tertiary buttons are the least visually prominent variant. Use to retain a classic button format with less emphasis than primary or secondary buttons.                                                                                                                                                   |
+| Danger    | Danger buttons may be used for actions that are potentially destructive or difficult/impossible to undo. Danger is an independent variant, but all button variants may use the the `isDanger` property to apply similar styling.                                                                         |
+| Warning   | Warning buttons may be used for actions that change an important setting or behavior, but not in a destructive or irreversible way.                                                                                                                                                                      |
+| Link      | Links are labeled, but have no background or border. Use for actions that require less emphasis, actions that navigate users to another page within the same window, and/or actions that navigate to external pages in a new window. Links may be placed inline with text using the `isInline` property. |
+| Plain     | Plain buttons have no styling and are intended to be labeled with icons.                                                                                                                                                                                                                                 |
+| Control   | Control buttons can be labeled with text or icons. Primarily intended to be paired with other controls in an [input group](/components/input-group).                                                                                                                                                     |
+| Stateful  | Stateful buttons are ideal for displaying the state of notifications. They have 3 states: `read`, `unread` and `attention`.                                                                                                                                                                              |
 
 ### Disabled buttons
 
 To indicate that an action is currently unavailable, all button variations can be disabled using the `isDisabled` property.
 
 ```ts file="./ButtonDisabled.tsx"
+
 ```
 
 ### Small buttons
@@ -49,13 +51,15 @@ To indicate that an action is currently unavailable, all button variations can b
 To fit into tight spaces, primary, secondary, tertiary, danger, and warning button variations can be made smaller using the `"sm"` value for the `size` property.
 
 ```ts file="./ButtonSmall.tsx"
+
 ```
 
 ### Call to action (CTA) buttons
 
-CTA buttons and links direct users to complete an action. Primary, secondary, tertiary, and link button variants can be styled as CTAs using the `"lg"` value for the `size` property. 
+CTA buttons and links direct users to complete an action. Primary, secondary, tertiary, and link button variants can be styled as CTAs using the `"lg"` value for the `size` property.
 
 ```ts file="./ButtonCallToAction.tsx"
+
 ```
 
 ### Block level buttons
@@ -63,13 +67,15 @@ CTA buttons and links direct users to complete an action. Primary, secondary, te
 Block level buttons span the full width of the parent element and can be enabled using the `isBlock` property.
 
 ```ts file="./ButtonBlock.tsx"
+
 ```
 
 ### Progress indicators
 
-Progress indicators can be added to buttons to identify that an action is in progress after a click. 
+Progress indicators can be added to buttons to identify that an action is in progress after a click.
 
 ```ts file="./ButtonProgress.tsx"
+
 ```
 
 ### Links as buttons
@@ -77,6 +83,7 @@ Progress indicators can be added to buttons to identify that an action is in pro
 Buttons that link to another resource may take the form of primary, secondary, tertiary, or link variants. Use `component="a"` and an `href` property to designate the button's target link.
 
 ```ts file="./ButtonLinks.tsx"
+
 ```
 
 ### Inline link as span
@@ -84,6 +91,7 @@ Buttons that link to another resource may take the form of primary, secondary, t
 Inline links should use `component="span"` and the `isInline` property to wrap inline with surrounding text.
 
 ```ts file="./ButtonInlineSpanLink.tsx"
+
 ```
 
 ### Custom component
@@ -91,6 +99,7 @@ Inline links should use `component="span"` and the `isInline` property to wrap i
 In addition to being able to pass a string to the `component` property, you can provide more fine-tuned customization by passing a callback that returns a component.
 
 ```ts file="./ButtonCustomComponent.tsx"
+
 ```
 
 ### Aria-disabled examples
@@ -102,6 +111,7 @@ Buttons that are aria-disabled are similar to normal disabled buttons, except th
 Unlike normal disabled buttons, aria-disabled buttons can support tooltips. Furthermore, aria-disabled buttons can operate as links, which also support tooltips.
 
 ```ts file="./ButtonAriaDisabled.tsx"
+
 ```
 
 ### Button with count
@@ -109,6 +119,7 @@ Unlike normal disabled buttons, aria-disabled buttons can support tooltips. Furt
 Buttons can display a `count` in the form of a badge to indicate some value or number by passing in the `countOptions` prop as a `BadgeCountObject` object. The `BadgeCountObject` object will handle `count`, `isRead`, and `className` props for the badge count.
 
 ```ts file="./ButtonWithCount.tsx"
+
 ```
 
 ### Plain with no padding
@@ -116,6 +127,7 @@ Buttons can display a `count` in the form of a badge to indicate some value or n
 To display a plain/icon button inline with text, use `noPadding` prop in addition to `variant="plain"`.
 
 ```ts file="./ButtonPlainHasNoPadding.tsx"
+
 ```
 
 ### Stateful
@@ -123,6 +135,37 @@ To display a plain/icon button inline with text, use `noPadding` prop in additio
 Stateful buttons are ideal for displaying the state of notifications. Use `variant="stateful"` alongside with the `state` property, which can have these 3 values: `read`, `unread` (used as default) and `attention` (which means unread and requires attention).
 
 ```ts file="./ButtonStateful.tsx"
+
+```
+
+## Animated examples
+
+The following `<Button>` implementations have animations built into them. When using one of the following implementations, the `icon` property will be overridden due to the animations needing specific icons internally.
+
+### Favorite
+
+You can pass both the `isFavorite` and `variant="plain"` properties into the `<Button>` to create a favorite button. Passing the `isFavorited` property will determine the current favorited state and update styling accordingly.
+
+```ts file = "./ButtonFavorite.tsx"
+
+```
+
+### Settings
+
+For a "settings" button with animations on hover and focus, you can pass the `isSettings` property into either a `variant="plain"` or `variant="control"` button.
+
+```ts file="./ButtonSettings.tsx"
+
+```
+
+### Hamburger
+
+For a "hamburger" button (`fa-bars`) that will animate based on the `hamburgerVariant` property, you can pass the `isHamburger` property. This will render the default icon for a hamburger button, and updating the `hamburgerVariant` property with a value of either "expand" or "collapse" will change the icon accordingly with an animation on hover and focus.
+
+When used within a PatternFly `<Masthead>`, the animations and icon updates will occur automatically. See one of our [full screen page demos](/components/page/react-demos) to see this in action.
+
+```ts file="./ButtonHamburger.tsx"
+
 ```
 
 ## Using router links
@@ -133,4 +176,4 @@ Router links can be used for in-app linking in React environments to prevent pag
 <Button variant="link" component={(props: any) => <Link {...props} to="#" />}>
   Router link
 </Button>
-```
+```

package/src/components/Button/examples/ButtonFavorite.tsx

@@ -0,0 +1,18 @@
+import { useState } from 'react';
+import { Button } from '@patternfly/react-core';
+
+export const ButtonFavorite: React.FunctionComponent = () => {
+  const [isFavorited, setIsFavorited] = useState(false);
+  const toggleFavorite = () => {
+    setIsFavorited(!isFavorited);
+  };
+  return (
+    <Button
+      variant="plain"
+      aria-label={isFavorited ? 'Favorite example favorited' : 'Favorite example not favorited'}
+      isFavorite
+      isFavorited={isFavorited}
+      onClick={toggleFavorite}
+    />
+  );
+};

package/src/components/Button/examples/ButtonHamburger.tsx

@@ -0,0 +1,9 @@
+import { Button, Flex } from '@patternfly/react-core';
+
+export const ButtonHamburger: React.FunctionComponent = () => (
+  <Flex>
+    <Button variant="plain" isExpanded={false} aria-label="Hamburger example" isHamburger />
+    <Button variant="plain" isExpanded={false} aria-label="Hamburger example" isHamburger hamburgerVariant="expand" />
+    <Button variant="plain" isExpanded={true} aria-label="Hamburger example" isHamburger hamburgerVariant="collapse" />
+  </Flex>
+);

package/src/components/Button/examples/ButtonSettings.tsx

@@ -0,0 +1,10 @@
+import { Button, Flex } from '@patternfly/react-core';
+
+export const ButtonSettings: React.FunctionComponent = () => (
+  <Flex>
+    <Button isSettings variant="plain" aria-label="Settings" />
+    <Button isSettings variant="control">
+      Settings
+    </Button>
+  </Flex>
+);

package/src/components/Button/hamburgerIcon.tsx

@@ -0,0 +1,13 @@
+import styles from '@patternfly/react-styles/css/components/Button/button';
+import { css } from '@patternfly/react-styles';
+
+// Because this is such a specific icon that requires being wrapped in a pf-v[current version]-c-button element,
+// we don't want to export this to consumers nor include it in the react-icons package as a custom icon.
+export const hamburgerIcon = (
+  <svg viewBox="0 0 10 10" className={css(styles.buttonHamburgerIcon, 'pf-v6-svg')} width="1em" height="1em">
+    <path className={css(styles.buttonHamburgerIconTop)} d="M1,1 L9,1"></path>
+    <path className={css(styles.buttonHamburgerIconMiddle)} d="M1,5 L9,5"></path>
+    <path className={css(styles.buttonHamburgerIconArrow)} d="M1,5 L1,5 L1,5"></path>
+    <path className={css(styles.buttonHamburgerIconBottom)} d="M9,9 L1,9"></path>
+  </svg>
+);

package/src/components/Card/examples/Card.md

@@ -131,7 +131,7 @@ You must avoid rendering any other interactive content within the `<Card>` when
 
 ### Single selectable
 
-When a group of single selectable cards are related, you must pass the same `name` property to each card's `selectableActions` property.
+When a group of single selectable cards are related, you must pass the same `name` property to each card's `selectableActions` property. For more guidance on selectable cards with hidden input, see our [cards as tiles examples](#cards-as-tiles).
 
 ```ts file='./CardSingleSelectable.tsx'
 

package/src/components/Card/examples/CardSelectable.tsx

@@ -5,7 +5,8 @@ export const SelectableCard: React.FunctionComponent = () => {
   const [isChecked1, setIsChecked1] = useState(false);
   const [isChecked2, setIsChecked2] = useState(false);
   const [isChecked3, setIsChecked3] = useState(false);
-  const [isSecondary, setIsSecondary] = useState<boolean>(false);
+  const [isSecondary, setIsSecondary] = useState(false);
+  const [displayCheckbox, setDisplayCheckbox] = useState(false);
 
   const id1 = 'selectable-card-input-1';
   const id2 = 'selectable-card-input-2';
@@ -31,6 +32,10 @@ export const SelectableCard: React.FunctionComponent = () => {
     setIsSecondary(checked);
   };
 
+  const toggleHide = (checked: boolean) => {
+    setDisplayCheckbox(checked);
+  };
+
   return (
     <>
       <Checkbox
@@ -40,68 +45,76 @@ export const SelectableCard: React.FunctionComponent = () => {
         id="toggle-variant-selectable"
         name="toggle-variant"
       />
-      <div style={{ marginTop: '15px' }}>
-        <Gallery hasGutter>
-          <Card
-            id="selectable-card-example-1"
-            isSelectable
-            isSelected={isChecked1}
-            variant={isSecondary ? 'secondary' : 'default'}
+      <Checkbox
+        label="Hide checkbox"
+        isChecked={displayCheckbox}
+        onChange={(_event, checked) => toggleHide(checked)}
+        id="selectable-toggle-hide-checkbox"
+        name="toggle-hide"
+      />
+      <Gallery hasGutter style={{ marginTop: '15px' }}>
+        <Card
+          id="selectable-card-example-1"
+          isSelectable
+          isSelected={isChecked1}
+          variant={isSecondary ? 'secondary' : 'default'}
+        >
+          <CardHeader
+            selectableActions={{
+              selectableActionId: id1,
+              selectableActionAriaLabelledby: 'selectable-card-example-1',
+              name: id1,
+              onChange,
+              hasNoOffset: true,
+              isHidden: displayCheckbox
+            }}
           >
-            <CardHeader
-              selectableActions={{
-                selectableActionId: id1,
-                selectableActionAriaLabelledby: 'selectable-card-example-1',
-                name: id1,
-                onChange,
-                hasNoOffset: true
-              }}
-            >
-              <CardTitle>First card</CardTitle>
-            </CardHeader>
-            <CardBody>This card is selectable.</CardBody>
-          </Card>
-          <Card
-            id="selectable-card-example-2"
-            isSelectable
-            isSelected={isChecked2}
-            variant={isSecondary ? 'secondary' : 'default'}
+            <CardTitle>First card</CardTitle>
+          </CardHeader>
+          <CardBody>This card is selectable.</CardBody>
+        </Card>
+        <Card
+          id="selectable-card-example-2"
+          isSelectable
+          isSelected={isChecked2}
+          variant={isSecondary ? 'secondary' : 'default'}
+        >
+          <CardHeader
+            selectableActions={{
+              selectableActionId: id2,
+              selectableActionAriaLabelledby: 'selectable-card-example-2',
+              name: id2,
+              onChange,
+              hasNoOffset: true,
+              isHidden: displayCheckbox
+            }}
           >
-            <CardHeader
-              selectableActions={{
-                selectableActionId: id2,
-                selectableActionAriaLabelledby: 'selectable-card-example-2',
-                name: id2,
-                onChange,
-                hasNoOffset: true
-              }}
-            >
-              <CardTitle>Second card</CardTitle>
-            </CardHeader>
-            <CardBody>This card is selectable.</CardBody>
-          </Card>
-          <Card
-            id="selectable-card-example-3"
-            isSelectable
-            isDisabled
-            isSelected={isChecked3}
-            variant={isSecondary ? 'secondary' : 'default'}
+            <CardTitle>Second card</CardTitle>
+          </CardHeader>
+          <CardBody>This card is selectable.</CardBody>
+        </Card>
+        <Card
+          id="selectable-card-example-3"
+          isSelectable
+          isDisabled
+          isSelected={isChecked3}
+          variant={isSecondary ? 'secondary' : 'default'}
+        >
+          <CardHeader
+            selectableActions={{
+              selectableActionId: id3,
+              selectableActionAriaLabelledby: 'selectable-card-example-3',
+              name: id3,
+              onChange,
+              hasNoOffset: true,
+              isHidden: displayCheckbox
+            }}
           >
-            <CardHeader
-              selectableActions={{
-                selectableActionId: id3,
-                selectableActionAriaLabelledby: 'selectable-card-example-3',
-                name: id3,
-                onChange,
-                hasNoOffset: true
-              }}
-            >
-              <CardTitle>Third card</CardTitle>
-            </CardHeader>
-            <CardBody>This card is selectable but disabled.</CardBody>
-          </Card>
-        </Gallery>
-      </div>
+            <CardTitle>Third card</CardTitle>
+          </CardHeader>
+          <CardBody>This card is selectable but disabled.</CardBody>
+        </Card>
+      </Gallery>
     </>
   );
 };

package/src/components/Card/examples/CardSingleSelectable.tsx

@@ -1,63 +1,80 @@
 import { useState } from 'react';
-import { Card, CardHeader, CardTitle, CardBody, Gallery } from '@patternfly/react-core';
+import { Card, CardHeader, CardTitle, CardBody, Gallery, Checkbox } from '@patternfly/react-core';
 
 export const SingleSelectableCard: React.FunctionComponent = () => {
   const [isChecked, setIsChecked] = useState('');
   const id1 = 'single-selectable-card-input-1';
   const id2 = 'single-selectable-card-input-2';
   const id3 = 'single-selectable-card-input-3';
+  const [displayRadioButton, setDisplayRadioButton] = useState(false);
 
   const onChange = (event: React.FormEvent<HTMLInputElement>) => {
     setIsChecked(event.currentTarget.id);
   };
 
+  const toggleHide = (checked: boolean) => {
+    setDisplayRadioButton(checked);
+  };
+
   return (
-    <Gallery hasGutter>
-      <Card id="single-selectable-card-example-1" isSelectable isSelected={isChecked === id1}>
-        <CardHeader
-          selectableActions={{
-            selectableActionId: id1,
-            selectableActionAriaLabelledby: 'single-selectable-card-example-1',
-            name: 'single-selectable-card-example',
-            variant: 'single',
-            onChange,
-            hasNoOffset: true
-          }}
-        >
-          <CardTitle>First card</CardTitle>
-        </CardHeader>
-        <CardBody>This card is single selectable.</CardBody>
-      </Card>
-      <Card id="single-selectable-card-example-2" isSelectable isSelected={isChecked === id2}>
-        <CardHeader
-          selectableActions={{
-            selectableActionId: id2,
-            selectableActionAriaLabelledby: 'single-selectable-card-example-2',
-            name: 'single-selectable-card-example',
-            variant: 'single',
-            onChange,
-            hasNoOffset: true
-          }}
-        >
-          <CardTitle>Second card</CardTitle>
-        </CardHeader>
-        <CardBody>This card is single selectable.</CardBody>
-      </Card>
-      <Card id="single-selectable-card-example-3" isSelectable isDisabled isSelected={isChecked === id3}>
-        <CardHeader
-          selectableActions={{
-            selectableActionId: id3,
-            selectableActionAriaLabelledby: 'single-selectable-card-example-3',
-            name: 'single-selectable-card-example',
-            variant: 'single',
-            onChange,
-            hasNoOffset: true
-          }}
-        >
-          <CardTitle>Third card</CardTitle>
-        </CardHeader>
-        <CardBody>This card is single selectable but disabled.</CardBody>
-      </Card>
-    </Gallery>
+    <>
+      <Checkbox
+        label="Hide radio button"
+        isChecked={displayRadioButton}
+        onChange={(_event, checked) => toggleHide(checked)}
+        id="single-select-toggle-hide-radio-button"
+        name="toggle-hide"
+      />
+      <Gallery hasGutter style={{ marginTop: '15px' }}>
+        <Card id="single-selectable-card-example-1" isSelectable isSelected={isChecked === id1}>
+          <CardHeader
+            selectableActions={{
+              selectableActionId: id1,
+              selectableActionAriaLabelledby: 'single-selectable-card-example-1',
+              name: 'single-selectable-card-example',
+              variant: 'single',
+              onChange,
+              hasNoOffset: true,
+              isHidden: displayRadioButton
+            }}
+          >
+            <CardTitle>First card</CardTitle>
+          </CardHeader>
+          <CardBody>This card is single selectable.</CardBody>
+        </Card>
+        <Card id="single-selectable-card-example-2" isSelectable isSelected={isChecked === id2}>
+          <CardHeader
+            selectableActions={{
+              selectableActionId: id2,
+              selectableActionAriaLabelledby: 'single-selectable-card-example-2',
+              name: 'single-selectable-card-example',
+              variant: 'single',
+              onChange,
+              hasNoOffset: true,
+              isHidden: displayRadioButton
+            }}
+          >
+            <CardTitle>Second card</CardTitle>
+          </CardHeader>
+          <CardBody>This card is single selectable.</CardBody>
+        </Card>
+        <Card id="single-selectable-card-example-3" isSelectable isDisabled isSelected={isChecked === id3}>
+          <CardHeader
+            selectableActions={{
+              selectableActionId: id3,
+              selectableActionAriaLabelledby: 'single-selectable-card-example-3',
+              name: 'single-selectable-card-example',
+              variant: 'single',
+              onChange,
+              hasNoOffset: true,
+              isHidden: displayRadioButton
+            }}
+          >
+            <CardTitle>Third card</CardTitle>
+          </CardHeader>
+          <CardBody>This card is single selectable but disabled.</CardBody>
+        </Card>
+      </Gallery>
+    </>
   );
 };

package/src/components/ClipboardCopy/ClipboardCopy.tsx

@@ -204,7 +204,7 @@ class ClipboardCopy extends Component<ClipboardCopyProps, ClipboardCopyState> {
     const shouldTruncate = variant === ClipboardCopyVariant.inlineCompact && truncation;
     const inlineCompactContent = shouldTruncate ? (
       <Truncate
-        refToGetParent={this.clipboardRef}
+        tooltipProps={{ triggerRef: this.clipboardRef }}
         content={copyableText}
         {...(typeof truncation === 'object' && truncation)}
       />
@@ -223,6 +223,7 @@ class ClipboardCopy extends Component<ClipboardCopyProps, ClipboardCopyState> {
           className
         )}
         ref={this.clipboardRef}
+        {...(shouldTruncate && { tabIndex: 0 })}
         {...divProps}
         {...getOUIAProps(ClipboardCopy.displayName, ouiaId, ouiaSafe)}
       >

package/src/components/ClipboardCopy/ClipboardCopyToggle.tsx

@@ -27,7 +27,7 @@ export const ClipboardCopyToggle: React.FunctionComponent<ClipboardCopyTogglePro
     onClick={onClick}
     id={id}
     aria-labelledby={`${id} ${textId}`}
-    aria-controls={contentId}
+    aria-controls={isExpanded ? contentId : undefined}
     aria-expanded={isExpanded}
     {...props}
     icon={

package/src/components/ClipboardCopy/__tests__/ClipboardCopyToggle.test.tsx

@@ -44,9 +44,15 @@ test('Renders with aria-labelledby concatenated from id and textId props', () =>
   expect(screen.getByRole('button')).toHaveAccessibleName('Toggle content Test content');
 });
 
-test('Renders with aria-controls with passed in contentId prop', () => {
+test('Does not render with aria-controls when isExpanded is false', () => {
   render(<ClipboardCopyToggle {...requiredProps} />);
 
+  expect(screen.getByRole('button')).not.toHaveAttribute('aria-controls');
+});
+
+test('Renders with aria-controls with passed in contentId prop when isExpanded is true', () => {
+  render(<ClipboardCopyToggle isExpanded {...requiredProps} />);
+
   expect(screen.getByRole('button')).toHaveAttribute('aria-controls', requiredProps.contentId);
 });
 

package/src/components/ClipboardCopy/__tests__/__snapshots__/ClipboardCopyToggle.test.tsx.snap

@@ -3,7 +3,6 @@
 exports[`Matches snapshot 1`] = `
 <DocumentFragment>
   <button
-    aria-controls="content-id"
     aria-expanded="false"
     aria-labelledby="main-id text-id"
     class="pf-v6-c-button pf-m-control"

package/src/components/DualListSelector/DualListSelector.tsx

@@ -17,13 +17,19 @@ export interface DualListSelectorProps {
   isTree?: boolean;
   /** Content to be rendered in the dual list selector. */
   children?: React.ReactNode;
+  /** 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;
 }
 
 class DualListSelector extends Component<DualListSelectorProps> {
   static displayName = 'DualListSelector';
   static defaultProps: PickOptional<DualListSelectorProps> = {
     children: '',
-    isTree: false
+    isTree: false,
+    hasAnimations: false
   };
 
   constructor(props: DualListSelectorProps) {
@@ -31,13 +37,21 @@ class DualListSelector extends Component<DualListSelectorProps> {
   }
 
   render() {
-    const { className, children, id, isTree, ...props } = this.props;
+    const { className, children, id, isTree, hasAnimations, ...props } = this.props;
 
     return (
-      <DualListSelectorContext.Provider value={{ isTree }}>
+      <DualListSelectorContext.Provider value={{ isTree, hasAnimations }}>
         <GenerateId>
           {(randomId) => (
-            <div className={css(styles.dualListSelector, className)} id={id || randomId} {...props}>
+            <div
+              className={css(
+                styles.dualListSelector,
+                hasAnimations && isTree && styles.modifiers.animateExpand,
+                className
+              )}
+              id={id || randomId}
+              {...props}
+            >
               {children}
             </div>
           )}

package/src/components/DualListSelector/DualListSelectorContext.ts

@@ -1,7 +1,8 @@
 import { createContext } from 'react';
 export const DualListSelectorContext = createContext<{
   isTree?: boolean;
-}>({ isTree: false });
+  hasAnimations?: boolean;
+}>({ isTree: false, hasAnimations: false });
 
 export const DualListSelectorListContext = createContext<{
   setFocusedOption?: (id: string) => void;