chore(Alert): updated examples to enable animations (#11705)

* chore(Alert): updated examples to enable animations

* Updated docs verbiage per Erin

Author: thatblindgeye

packages/react-core/src/components/Alert/examples/Alert.md

@@ -15,19 +15,23 @@ import ServerIcon from '@patternfly/react-icons/dist/esm/icons/server-icon';
 import LaptopIcon from '@patternfly/react-icons/dist/esm/icons/laptop-icon';
 import buttonStyles from '@patternfly/react-styles/css/components/Button/button';
 
+Micro animations have been added for `<Alert>` components within an `<AlertGroup>`. By default, you must opt into animations, since they can require updates to tests. To enable or disable animations as needed, use the `hasAnimations` property. With animations enabled, we recommend you ensure that dynamically-added alerts are prepended to a list of alerts, rather than appended to the end of it.
+
+Micro animations are turned on for all examples and demos where alerts are dynamically added.
+
 ## Alert examples
 
 ### Alert variants
 
 PatternFly supports several alert variants for different scenarios. Each variant has an associated status icon, background, and alert title coded to communicate the severity of an alert. Use the `variant` property to apply the following styling options. If no `variant` is specified, then the variant will be set to "custom".
 
-| Variant | Description |
-|---|---|
-| Custom | Use for generic messages that should have a custom color set by the associated CSS variable. Should be used when the message has no associated severity. |
-| Info | Use for general informational messages |
-| Success | Use to indicate that a task or process has been completed successfully |
-| Warning | Use to indicate that a non-critical error has occurred|
-| Danger | Use to indicate that a critical or blocking error has occurred |
+| Variant | Description                                                                                                                                              |
+| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Custom  | Use for generic messages that should have a custom color set by the associated CSS variable. Should be used when the message has no associated severity. |
+| Info    | Use for general informational messages                                                                                                                   |
+| Success | Use to indicate that a task or process has been completed successfully                                                                                   |
+| Warning | Use to indicate that a non-critical error has occurred                                                                                                   |
+| Danger  | Use to indicate that a critical or blocking error has occurred                                                                                           |
 
 ```ts
 import { Fragment } from 'react';
@@ -148,7 +152,7 @@ const AlertTimeout: React.FunctionComponent = () => {
       <Button variant="secondary" onClick={() => setAlerts([])}>
         Remove all alerts
       </Button>
-      <AlertGroup isLiveRegion>{alerts}</AlertGroup>
+      <AlertGroup hasAnimations isLiveRegion>{alerts}</AlertGroup>
     </Fragment>
   );
 };
@@ -405,11 +409,11 @@ An alert group stacks and positions 2 or more alerts in a live region, either in
 
 Alert groups can be one of the following variants:
 
-| Variant | Description |
-| --- | --- |
+| Variant       | Description                                                                                                                                                                                                 |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Static inline | Static inline alert groups contain alerts that appear when the page loads, and are seen within the normal page content flow. These groups should not contain alerts that will dynamically appear or update. |
-| Toast | Toast alert groups contain alerts that typically appear in response to an asynchronous event or user action. These groups are positioned on top of other content at the top right of the page.|
-| Dynamic | Dynamic alert groups contain alerts that typically appear in response to a user action, and are seen within the normal page content flow.|  
+| Toast         | Toast alert groups contain alerts that typically appear in response to an asynchronous event or user action. These groups are positioned on top of other content at the top right of the page.              |
+| Dynamic       | Dynamic alert groups contain alerts that typically appear in response to a user action, and are seen within the normal page content flow.                                                                   |
 
 Dynamic alerts that are generated after the page initially loads must be appended to either a toast or dynamic `AlertGroup`, both of which must use the `isLiveRegion` property. New alerts appended to a toast or dynamic group will be announced by assistive technologies the moment the change happens. For information about customizing this announcement, read the [aria-atomic and aria-relevant](/components/alert/accessibility#aria-atomic-and-aria-relevant) section of the alert accessibility documentation.
 

packages/react-core/src/components/Alert/examples/AlertAsyncLiveRegion.tsx

@@ -51,7 +51,7 @@ export const AsyncLiveRegionAlert: React.FunctionComponent = () => {
           onChange={() => setIsActive(false)}
         />
       </ToggleGroup>
-      <AlertGroup isLiveRegion>
+      <AlertGroup hasAnimations isLiveRegion>
         {alerts.map(({ title, variant, key }) => (
           <Alert variant={variant} title={title} key={key} />
         ))}

packages/react-core/src/components/Alert/examples/AlertDynamicLiveRegion.tsx

@@ -52,7 +52,7 @@ export const DynamicLiveRegionAlert: React.FunctionComponent = () => {
           Add single danger alert
         </button>
       </InputGroup>
-      <AlertGroup isLiveRegion aria-live="polite" aria-relevant="additions text" aria-atomic="false">
+      <AlertGroup hasAnimations isLiveRegion aria-live="polite" aria-relevant="additions text" aria-atomic="false">
         {alerts.map(({ title, variant, key }) => (
           <Alert variant={variant} title={title} key={key} />
         ))}

packages/react-core/src/components/Alert/examples/AlertGroupAsync.tsx

@@ -58,7 +58,7 @@ export const AlertGroupAsync: React.FunctionComponent = () => {
           </button>
         </InputGroupItem>
       </InputGroup>
-      <AlertGroup isToast isLiveRegion aria-live="assertive">
+      <AlertGroup hasAnimations isToast isLiveRegion aria-live="assertive">
         {alerts.map(({ title, variant, key }) => (
           <Alert
             variant={AlertVariant[variant]}

packages/react-core/src/components/Alert/examples/AlertGroupMultipleDynamic.tsx

@@ -42,7 +42,7 @@ export const AlertGroupMultipleDynamic: React.FunctionComponent = () => {
           </button>
         </InputGroupItem>
       </InputGroup>
-      <AlertGroup isToast isLiveRegion>
+      <AlertGroup hasAnimations isToast isLiveRegion>
         {alerts.map(({ title, variant, key }) => (
           <Alert
             variant={AlertVariant[variant]}

packages/react-core/src/components/Alert/examples/AlertGroupSingularDynamic.tsx

@@ -56,7 +56,7 @@ export const AlertGroupSingularDynamic: React.FunctionComponent = () => {
           </button>
         </InputGroupItem>
       </InputGroup>
-      <AlertGroup isLiveRegion>
+      <AlertGroup hasAnimations isLiveRegion>
         {alerts.map(({ title, variant, key }) => (
           <Alert
             isInline

packages/react-core/src/components/Alert/examples/AlertGroupSingularDynamicOverflow.tsx

@@ -75,7 +75,7 @@ export const AlertGroupSingularDynamicOverflow: React.FunctionComponent = () =>
           </button>
         </InputGroupItem>
       </InputGroup>
-      <AlertGroup isLiveRegion onOverflowClick={onOverflowClick} overflowMessage={overflowMessage}>
+      <AlertGroup hasAnimations isLiveRegion onOverflowClick={onOverflowClick} overflowMessage={overflowMessage}>
         {alerts.slice(0, maxDisplayed).map(({ key, variant, title }) => (
           <Alert
             isInline

packages/react-core/src/components/Alert/examples/AlertGroupToast.tsx

@@ -56,7 +56,7 @@ export const AlertGroupToast: React.FunctionComponent = () => {
           </button>
         </InputGroupItem>
       </InputGroup>
-      <AlertGroup isToast isLiveRegion>
+      <AlertGroup hasAnimations isToast isLiveRegion>
         {alerts.map(({ key, variant, title }) => (
           <Alert
             variant={AlertVariant[variant]}

packages/react-core/src/components/Alert/examples/AlertGroupToastOverflowCapture.tsx

@@ -75,7 +75,13 @@ export const AlertGroupToastOverflowCapture: React.FunctionComponent = () => {
           </button>
         </InputGroupItem>
       </InputGroup>
-      <AlertGroup isToast isLiveRegion onOverflowClick={onOverflowClick} overflowMessage={overflowMessage}>
+      <AlertGroup
+        hasAnimations
+        isToast
+        isLiveRegion
+        onOverflowClick={onOverflowClick}
+        overflowMessage={overflowMessage}
+      >
         {alerts.slice(0, maxDisplayed).map(({ key, variant, title }) => (
           <Alert
             variant={AlertVariant[variant]}

packages/react-core/src/demos/examples/AlertGroup/AlertGroupToastWithNotificationDrawer.tsx

@@ -365,7 +365,13 @@ export const AlertGroupToastWithNotificationDrawer: React.FunctionComponent = ()
         />
       </PageSection>
       <PageSection>
-        <AlertGroup isToast isLiveRegion onOverflowClick={onAlertGroupOverflowClick} overflowMessage={overflowMessage}>
+        <AlertGroup
+          hasAnimations
+          isToast
+          isLiveRegion
+          onOverflowClick={onAlertGroupOverflowClick}
+          overflowMessage={overflowMessage}
+        >
           {alerts.slice(0, maxDisplayed)}
         </AlertGroup>
       </PageSection>